Docker 部署 Sun-Panel Helper导航面板 🐳

📋 目录导航

🎯 项目简介

Sun-Panel 是一款基于 Vue 和 Go 语言开发的轻量级导航面板，可以作为服务器、NAS导航面板、Homepage或浏览器首页使用。该项目具有界面简洁、资源占用少的特点，支持Docker部署和ARM架构，无需外部数据库，非常适合个人和企业内部使用。

🛠️ 核心特性

特性类别 功能描述 优势
🍉 界面简洁 直观清晰的界面设计，资源消耗低 提供清爽的用户体验
🍊 易于使用 可视化操作，零代码使用 无需技术背景即可上手
🍠 网络模式切换 一键切换内部和外部网络模式链接 灵活适应不同网络环境
🐳 Docker支持 支持容器化部署，兼容ARM系统 跨平台部署便捷
👥 多账户隔离 支持多账号隔离使用 适合团队协作使用
📊 系统状态监控 支持查看CPU、内存和硬盘状态 实时掌握系统运行状况
🎨 个性化定制 支持自定义JS、CSS和丰富图标样式 高度可定制化界面
🪟 小窗口模式 支持网页内置小窗口打开 提升多任务操作效率
💾 无需外部数据库 简单使用可以无需连接外部数据库 简化部署和维护流程

🐳 一、Docker 部署 Sun-Panel Helper

1. 创建部署目录和 docker-compose.yml 文件 📁

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
mkdir -p /data/sun-panel-helper/ && cd $_ && \
cat > docker-compose.yml <<'EOF'
services:
   sun-panel:
      image: hslr/sun-panel:latest
      container_name: sun-panel
      network_mode: bridge
      restart: always
      volumes:
         - ./conf:/app/conf
         - /var/run/docker.sock:/var/run/docker.sock
         - /vol1:/vol1
         - /vol2:/vol2
         - /vol3:/vol3
      ports:
         - 3002:3002

   sun-panel-helper:
      image: madrays/sun-panel-helper:latest
      container_name: sun-panel-helper
      network_mode: bridge
      restart: always
      environment:
         - BACKEND_PORT=3111
      ports:
         - 33002:80
      volumes:
         - ./conf/custom:/app/backend/custom
         - ./helper/data:/app/backend/data
         - ./helper/backups:/app/backend/backups
EOF

2. 拉取镜像并启动容器 🚀

1
docker-compose up -d

🚀 二、使用 Sun-Panel Helper

1. 访问 Web 界面 🌐

部署完成后，通过以下方式访问：

  • 本地访问: http://localhost:3002
  • 域名访问: https://sun-panel.example.com（配置反向代理后）

默认登录信息：

  • 👑 用户名：admin@sun.cc
  • 🔑 密码：12345678

2. 初始配置步骤 🎯

步骤 操作 说明
1 修改默认密码 登录后立即修改默认密码，确保安全
2 添加导航项目 点击页面上的”+”号添加常用网站或应用
3 分组管理 在”系统应用”设置中创建和管理导航分组
4 个性化设置 配置界面风格、时间显示、搜索框等

3. 添加 Docker 应用 📦

  1. 在Sun-Panel中添加Docker应用链接
  2. 设置打开方式为”弹窗打开”
  3. 系统会自动获取应用图标，也可手动上传自定义图标

🌐 三、Nginx 反向代理配置

访问地址示例：https://sun-panel.example.com

1. 创建 Nginx 配置文件 🔧

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
mkdir -p /etc/nginx/conf.d && \
cat > /etc/nginx/conf.d/sun-panel.conf <<'EOF'
server {
    listen 443 ssl;
    listen [::]:443 ssl;

    server_name sun.example.com;  # 🌐 请替换为您的实际域名

    # SSL 证书配置
    ssl_certificate /etc/nginx/ssl/cert.pem;
    ssl_certificate_key /etc/nginx/ssl/key.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers on;
    ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384;

    # 安全头部
    add_header X-Frame-Options DENY;
    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";

    # 文件上传大小限制
    client_max_body_size 10M;

    location / {
        proxy_pass http://localhost:3002;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header Range $http_range;
        proxy_set_header If-Range $http_if_range;
        proxy_redirect off;
        proxy_buffering on;
        proxy_http_version 1.1;
        
        # 超时设置
        proxy_connect_timeout 300s;
        proxy_send_timeout 300s;
        proxy_read_timeout 300s;
    }

    # 错误页面处理
    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}
EOF

2. 测试并重载 Nginx 🔄

1
sudo nginx -t && sudo systemctl reload nginx

🔧 四、容器维护命令

1. Docker Compose 命令 🐳

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# 进入项目目录（请替换为您的实际目录）
cd /path/to/your/project

# 停止并删除容器
docker-compose down

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 仅启动指定服务（请替换 <service_name> 为实际服务名）
docker-compose up -d <service_name>

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

# 跟踪服务日志
docker-compose logs -f

# 查看指定服务日志（请替换 <service_name> 为实际服务名）
docker-compose logs <service_name>

# 完整升级流程
docker-compose down && \
docker-compose pull && \
docker-compose up -d && \
docker image prune -f

2. Docker 容器命令 📦

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器（请替换 <container_name> 为实际容器名）
docker stop <container_name>      # 停止容器
docker start <container_name>     # 启动容器  
docker restart <container_name>   # 重启容器

# 删除容器
docker rm <container_name>        # 删除已停止容器
docker rm -f <container_name>     # 强制删除运行中容器

# 进入容器Shell
docker exec -it <container_name> sh      # 使用sh进入容器
docker exec -it <container_name> bash    # 使用bash进入容器

# 以root身份进入容器  
docker exec -u 0 -it <container_name> sh

# 在容器中执行命令
docker exec <container_name> ls -la

# 查看容器详情和资源使用
docker inspect <container_name>     # 查看详细配置
docker stats <container_name>       # 实时资源监控

## 容器日志管理
docker logs <container_name>           # 查看日志
docker logs -f <container_name>        # 实时跟踪日志
docker logs --tail 100 <container_name>  # 查看最后100行
docker logs -t <container_name>        # 带时间戳的日志

# 密码重置
docker exec -it sun-panel ./sun-panel -password-reset

3. Docker 镜像管理 📀

1
2
3
4
docker images                  # 列出所有镜像
docker rmi <image_name:tag>    # 删除指定镜像（请替换为实际镜像名和标签）
docker image prune -f          # 清理悬空镜像
docker image prune -a -f       # 清理所有未使用镜像

🌟 启航导航，效率无限

通过本文档，你已经成功使用 Docker 部署了 Sun-Panel 导航面板，并借助 Nginx 反向代理实现了安全便捷的远程访问。现在，你可以：

🌐 统一入口 集中管理所有常用网站和应用，打造个性化的导航首页
📊 状态监控 实时掌握系统运行状况，CPU、内存和硬盘使用情况一目了然
🎨 个性定制 自由搭配图标样式，支持自定义 JS 和 CSS，打造专属界面风格

导航之路，是一场与效率同行的便捷旅程。愿 Sun-Panel 成为你高效的导航助手，陪伴你在每一次快速访问和资源管理的重要时刻。

从现在开始，高效导航，便捷访问——构建你统一高效的操作入口吧！🚀

📌 持续迭代：建议关注 Sun-Panel 官方更新，及时获取新功能与优化。
🐛 反馈与互助：使用中如有疑问或建议，可前往 GitHub Issues 提出。

祝你使用愉快，效率倍增！🎉