Sun‑Panel Docker 安装完整教程（跨平台通用）

 Sun‑Panel 是一个基于浏览器的导航面板/首页界面系统，配合 Docker 部署使用最简单、兼容性好（支持 ARM 等架构）。

 第 1 步：准备 Docker 环境

确保你的系统已有 Docker 运行环境：

验证 Docker 是否安装

docker --version

如果没有安装，根据你的系统使用合适的 Docker 安装方式（如官方脚本或系统包管理器）。

 第 2 步：创建目录用于持久化数据

在你的服务器（例如玩客云或其他机器）上创建目录保存配置：

mkdir -p ~/sun-panel/conf

mkdir -p ~/sun-panel/uploads

mkdir -p ~/sun-panel/database

 这个目录用于保存 配置、上传内容和面板数据库信息，这样容器重启或更新后数据不会丢失。

 第 3 步：拉取 Sun‑Panel Docker 镜像

docker pull hslr/sun-panel:latest

 latest 表示拉取最新版本

 也可以替换成具体版本号标签（例如：hslr/sun-panel:v1.2.0）来锁定版本。

 第 4 步：运行 Sun‑Panel 容器（最简单方式）

复制下面的命令到终端运行：

docker run -d --restart=always \

  --name sun-panel \

  -p 3002:3002 \

  -v ~/sun-panel/conf:/app/conf \

  -v ~/sun-panel/uploads:/app/uploads \

  -v ~/sun-panel/database:/app/database \

  -v /var/run/docker.sock:/var/run/docker.sock \

  hslr/sun-panel:latest

参数说明：

选项 作用

-d 后台运行

--restart=always 容器异常退出自动重启

--name sun-panel 容器名称

-p 3002:3002 将容器的 3002 端口映射到宿主机

-v … 挂载持久化数据目录

/var/run/docker.sock 让 Sun‑Panel 可以管理 Docker（可选）

 第 5 步：访问 Sun‑Panel 界面

在你的浏览器输入：

http://服务器IP:3002

例如：

http://192.168.1.10:3002

即可打开面板首页。

 默认账号

登录时初始默认账号：

账号：admin@sun.cc

密码：12345678

（可登录后在设置里修改）

进阶功能配置（可选）

 配置 Docker 管理功能

你可以在启动时挂载 Docker Socket：

-v /var/run/docker.sock:/var/run/docker.sock

这样在 Sun‑Panel 中就能查看/管理其他 Docker 容器。