环境准备

在部署 Sun-Panel-Helper 之前，需要确保你的环境满足以下要求。

系统要求

硬件要求

• CPU: 1 核心以上
• 内存: 512MB 以上
• 硬盘空间: 100MB 以上

软件要求

• Docker 19.03 或更高版本
• Sun-Panel 已安装并正常运行
• 支持的操作系统：
  • Linux (推荐)
  • Windows
  • macOS

前置条件

1. Docker 环境

确保 Docker 已正确安装并运行：

# 检查 Docker 版本
docker -v

# 检查 Docker 服务状态
systemctl status docker  # Linux
docker info             # Windows/macOS

2. Sun-Panel 配置

• Sun-Panel 已正常运行
• 可以访问 Sun-Panel 的配置目录
• 确认 custom 目录位置：

  # 常见位置示例
  /path/to/sunpanel/conf/custom     # 标准路径
  /vol1/@appshare/sunpanel/conf/custom  # 飞牛OS
  /var/apps/Sun-Panel/var/web/custom   #飞牛OS应用商店版固定为此路径

3. 网络要求

• 确保以下端口可用：
  • 33002: Helper 前端访问端口（可自定义）
  • 3001: Helper 后端服务端口（可自定义）
• 如果使用反向代理，需要：
  • 支持 WebSocket
  • 正确配置 SSL（如果使用 HTTPS）

4. 权限要求

• Docker 运行权限
• Sun-Panel custom 目录的读写权限
• 端口绑定权限（如果不使用 root 用户）

配置检查清单

在开始部署前，请检查以下项目：

• [ ] Docker 正常运行
• [ ] Sun-Panel 可以正常访问
• [ ] 已确认 custom 目录位置
• [ ] 所需端口未被占用
• [ ] 具备必要的文件权限
• [ ] 网络连接正常

特殊场景准备

IPv6 环境

如果需要在 IPv6 环境下使用：

• 确保 Docker 支持 IPv6
• 准备使用 Host 网络模式
• 检查 IPv6 连接性

反向代理

如果计划使用反向代理：

• 准备好域名（可选）
• 配置好 SSL 证书（如果使用 HTTPS）
• 确认代理服务器支持 WebSocket

下一步

• 查看 Docker 部署 开始标准安装
• 了解 Docker Compose 部署 使用编排部署