更新教程

更新前注意事项

请确保已备份重要数据
更新过程中服务会短暂中断
如遇问题可查看使用教程或加群咨询
v2.0.5+ 版本需要挂载额外的数据目录，详见下文

重要提示 - v2.0.5+ 版本目录变更

从 v2.0.5 版本开始，Sun-Panel-Helper 引入了新的目录结构，必须挂载 /app/backend/data、/app/backend/backups 和 /app/backend/custom 目录。其中 data 和 backups 目录是 Helper 自己的数据目录，需要您自己创建；而 custom 目录必须指向 Sun-Panel 的 custom 目录。如果您是从旧版本升级，请参考数据迁移教程。

配置说明

33002:80 - 前端访问端口
- 注意: 容器内端口80不可修改
- 只能修改映射端口33002为其他值
BACKEND_PORT=3001 - 后端端口，可自定义修改
必须挂载的目录（v2.0.5+ 版本）：
- /app/backend/data - Helper的数据目录（需要您自己创建，不是Sun-Panel的目录）
- /app/backend/backups - Helper的备份目录（需要您自己创建，不是Sun-Panel的目录）
- /app/backend/custom - Sun-Panel的custom目录 (最重要!)

custom 目录特别说明

/app/backend/custom 必须挂载到 Sun-Panel 的 custom 目录，这是 Helper 与 Sun-Panel 交互的关键。如果此目录挂载错误，Helper 的所有修改都不会在 Sun-Panel 中生效！

如果 Sun-Panel 的 custom 目录不存在，需要手动在 Sun-Panel 的 conf 目录下创建。

v2.0.5+ 版本更新命令

Docker命令更新

bash

# 拉取最新镜像
docker pull madrays/sun-panel-helper:latest

# 停止并删除旧容器
docker stop sun-panel-helper
docker rm sun-panel-helper

# 使用新的目录结构创建容器
docker run -d \
  --name sun-panel-helper \
  -p 33002:80 \
  -e BACKEND_PORT=3001 \
  # Helper自己的数据目录（需要您自己创建）
  -v /your/helper/path/data:/app/backend/data \
  # Helper自己的备份目录（需要您自己创建）
  -v /your/helper/path/backups:/app/backend/backups \
  # 必须指向Sun-Panel的custom目录
  -v /path/to/sunpanel/conf/custom:/app/backend/custom \
  madrays/sun-panel-helper:latest

注意

上述命令中，/path/to/sunpanel/conf/custom 必须替换为您的 Sun-Panel 实际 custom 目录的绝对路径！而 /your/helper/path/data 和 /your/helper/path/backups 是您为 Helper 创建的数据目录，建议放在易于管理的位置。

Docker Compose更新

bash

# 确保您的docker-compose.yml包含了所有必要的挂载目录
# 然后执行:
docker-compose pull
docker-compose up -d

v2.0.4及更早版本升级到v2.0.5+

如果您使用的是v2.0.4或更早版本，请先参考数据迁移教程进行数据迁移，然后再使用上述命令更新。

更新检查

更新完成后，请检查：

访问界面是否正常
所有组件是否正常工作
备份功能是否可用
Helper设置的所有自定义组件和美化是否在Sun-Panel中正确显示

如果发现问题，请：

查看容器日志：docker logs sun-panel-helper
确认所有挂载目录权限正确
特别检查 custom 目录是否正确指向了 Sun-Panel 的 custom 目录
参考数据迁移教程中的故障排除部分

更新教程 ​

更新前注意事项 ​

配置说明 ​

v2.0.5+ 版本更新命令 ​

Docker命令更新 ​

Docker Compose更新 ​

v2.0.4及更早版本升级到v2.0.5+ ​

更新检查 ​