SUN-PANEL Docker 容器化部署指南

872次阅读

共计 4555 个字符，预计需要花费 12 分钟才能阅读完成。

概述

SUN-PANEL 是一款多功能的服务器与 NAS 导航面板，同时也可作为 Homepage 和浏览器首页使用。它提供直观的界面，帮助用户集中管理服务器资源、NAS 文件导航以及常用网页入口，适用于个人用户、家庭 NAS 用户及小型企业环境。SUN-PANEL 支持多语言界面，提供丰富的自定义选项，能够整合各类服务链接与系统状态监控，为用户打造个性化的网络导航中心。

环境准备

Docker 环境安装

部署 SUN-PANEL 前需确保服务器已安装 Docker 环境。推荐使用以下一键安装脚本，适用于主流 Linux 发行版（Ubuntu、Debian、CentOS、Fedora 等）：

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

安装完成后，可通过以下命令验证 Docker 是否正常运行：

docker --version  # 查看 Docker 版本
docker info       # 查看 Docker 系统信息

镜像准备

镜像拉取命令

docker pull xxx.xuanyuan.run/hslr/sun-panel:latest

说明：latest为推荐标签（RECOMMENDED_TAG），如需指定其他版本，可将 latest 替换为具体标签，如 v1.0.0 等。

查看可用镜像标签

SUN-PANEL 提供多个版本标签，可通过以下链接查看所有可用标签：
SUN-PANEL 镜像标签列表

选择标签时建议考虑以下因素：

生产环境优先选择稳定版本标签（如v1.2.3）
测试环境可尝试最新开发版本（如 dev 或beta标签）
避免使用无版本标识的 latest 标签用于关键生产环境

验证镜像拉取结果

拉取完成后，通过以下命令验证镜像是否成功下载：

docker images | grep sun-panel

预期输出示例：

xxx.xuanyuan.run/hslr/sun-panel   latest    abc12345   2 weeks ago   150MB

容器部署

基础部署命令

以下是 SUN-PANEL 的基础容器启动命令，包含必要的端口映射与数据持久化配置：

docker run -d \
  --name sun-panel \
  --restart=always \
  -p 80:80 \
  -v /opt/sun-panel/data:/app/data \
  xxx.xuanyuan.run/hslr/sun-panel:latest

命令参数说明：

-d：后台运行容器
--name sun-panel：指定容器名称为 sun-panel，便于后续管理
--restart=always：设置容器开机自启，并在异常退出时自动重启
-p 80:80：端口映射（主机端口: 容器端口），此处假设容器内使用 80 端口提供 Web 服务（具体端口请参考官方文档确认）
-v /opt/sun-panel/data:/app/data：数据卷挂载，将容器内数据目录持久化到主机的 /opt/sun-panel/data 目录

高级配置选项

根据实际需求，可添加以下高级配置参数：

自定义端口映射

若主机 80 端口已被占用，可修改端口映射为其他端口，例如使用 8080 端口：

-p 8080:80

环境变量配置

SUN-PANEL 可能支持通过环境变量调整配置，例如设置时区、日志级别等（具体支持的环境变量请参考官方文档）：

-e TZ="Asia/Shanghai" \
-e LOG_LEVEL="info"

资源限制

为避免容器过度占用系统资源，可添加资源限制参数：

--memory=512m \
--cpus=0.5

上述配置限制容器最大使用 512MB 内存和 0.5 个 CPU 核心。

容器状态验证

部署完成后，通过以下命令检查容器运行状态：

docker ps | grep sun-panel

健康运行的容器状态应为Up，示例输出：

abc123456789   xxx.xuanyuan.run/hslr/sun-panel:latest   "/entrypoint.sh"   5 minutes ago   Up 5 minutes   0.0.0.0:80->80/tcp   sun-panel

功能测试

访问 Web 界面

在浏览器中输入服务器 IP 地址（或域名）及映射端口，访问 SUN-PANEL 界面：

若使用默认 80 端口：http://< 服务器 IP>
若使用自定义端口（如 8080）：http://< 服务器 IP>:8080

首次访问可能需要完成初始化设置，例如创建管理员账户、设置语言偏好等。

基础功能验证

完成初始化后，建议验证以下核心功能：

界面加载测试：确认页面元素加载完整，无明显布局错乱
导航链接添加：尝试添加一个新的导航链接（如 NAS 文件服务地址），验证保存功能正常
主题切换：测试深色 / 浅色主题切换功能（如有）
响应式布局：通过调整浏览器窗口大小，验证移动端适配效果
数据持久化测试：添加测试数据后重启容器，确认数据未丢失

# 重启容器命令（用于测试数据持久化）docker restart sun-panel

登录与权限验证

若系统包含用户认证功能，测试以下场景：

使用管理员账户登录，确认具备全部操作权限
尝试使用错误凭据登录，验证权限控制有效
（如有）创建普通用户，测试权限分级效果

生产环境建议

数据安全强化

数据备份策略
- 定期备份持久化目录/opt/sun-panel/data，建议每日自动备份
- 备份命令示例：mkdir -p /var/backups/sun-panel cp -r /opt/sun-panel/data /var/backups/sun-panel/$(date +%Y%m%d)
权限控制
- 限制主机数据目录权限，仅允许必要用户访问：chmod -R 700 /opt/sun-panel/data chown -R root:root /opt/sun-panel/data

网络安全配置

端口安全
- 避免直接暴露 80/443 端口到公网，建议通过反向代理（如 Nginx）转发
- 配置防火墙，仅允许特定 IP 段访问 SUN-PANEL 服务：# UFW 防火墙示例（允许 192.168.1.0/24 网段访问 80 端口）ufw allow from 192.168.1.0/24 to any port 80
HTTPS 加密
通过 Nginx 或 Traefik 等反向代理配置 HTTPS，示例 Nginx 配置片段：server {listen 443 ssl; server_name panel.example.com; ssl_certificate /etc/nginx/certs/fullchain.pem; ssl_certificate_key /etc/nginx/certs/privkey.pem; location / { proxy_pass http://localhost:80; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr;} }

容器管理优化

监控集成
- 使用 Prometheus+Grafana 监控容器资源使用情况
- 配置容器健康检查：docker run -d \ --name sun-panel \ --restart=always \ -p 80:80 \ -v /opt/sun-panel/data:/app/data \ --health-cmd "curl -f http://localhost/ || exit 1" \ --health-interval 30s \ --health-timeout 10s \ --health-retries 3 \ xxx.xuanyuan.run/hslr/sun-panel:latest
日志管理
- 配置日志轮转，避免日志文件过大：# 创建日志轮转配置文件 cat > /etc/logrotate.d/docker-sun-panel << EOF /var/lib/docker/containers/*/*-json.log {daily rotate 7 compress delaycompress missingok copytruncate} EOF

高可用部署

对于关键业务场景，可考虑以下高可用方案：

使用 Docker Compose 管理多容器部署
结合 Kubernetes 实现容器编排与自动扩缩容
跨节点数据同步（如使用 rsync 或分布式存储）

故障排查

常见问题及解决方法

容器启动失败
- 检查日志：docker logs sun-panel
- 常见原因及解决：
  - 端口冲突：更换主机端口（如-p 8080:80）
  - 数据目录权限问题：修复目录权限chmod -R 777 /opt/sun-panel/data（临时测试用，生产环境需使用最小权限）
  - 镜像损坏：重新拉取镜像docker pull xxx.xuanyuan.run/hslr/sun-panel:latest
Web 界面无法访问
- 检查网络连接：# 检查容器端口是否监听 docker exec sun-panel netstat -tuln # 检查主机端口映射 netstat -tuln | grep 80
- 防火墙规则：确保防火墙允许对应端口访问
- 容器健康状态：docker inspect --format='{{.State.Health.Status}}' sun-panel
数据丢失问题
- 确认数据卷挂载正确：docker inspect -f '{{.Mounts}}' sun-panel
- 检查宿主机目录是否存在数据文件：ls -la /opt/sun-panel/data
- 恢复最近备份：从 /var/backups/sun-panel 目录恢复数据
性能问题
- 检查资源使用情况：docker stats sun-panel
- 增加资源限制：调整 --memory 和--cpus参数
- 优化宿主机性能：关闭不必要的服务，增加系统资源