Docker 部署（推荐）
镜像地址
镜像统一由 CNB 流水线构建并推送到 CNB Docker 制品库， 路径规则为 docker.cnb.cool/<仓库路径>/<镜像名>:<标签>：
| 镜像 | 地址 | 标签 | 平台 |
|---|---|---|---|
| 后端（前端已嵌入） | docker.cnb.cool/liumou_site/gopanel/backend | latest / <tag> | amd64 / arm64 / arm/v7 |
| 后端（前端已嵌入） | docker.cnb.cool/liumou_site/gopanel/backend | dev | arm64 |
| 前端（独立 Nginx） | docker.cnb.cool/liumou_site/gopanel/frontend | latest / <tag> | amd64 / arm64 / arm/v7 |
| 单容器版（Caddy） | docker.cnb.cool/liumou_site/gopanel/allinone | latest / <tag> | amd64 / arm64 / arm/v7 |
| 单容器版（Nginx） | docker.cnb.cool/liumou_site/gopanel/nginx-allinone | latest / <tag> | amd64 / arm64 / arm/v7 |
标签来源：
master推送 →dev（固定 arm64，开发自用）tag推送 →latest+ 同名:<tag>，多架构
登录制品库（公开制品可跳过；Token 在 https://cnb.cool/profile/token 创建）：
bash
docker login docker.cnb.cool -u cnb -p <你的 CNB_TOKEN>单体部署（推荐）
前端已嵌入后端二进制，只需一个镜像：
bash
docker run -d \
--name gopanel \
-p 12395:12395 \
-v $(pwd)/config:/app/config \
docker.cnb.cool/liumou_site/gopanel/backend:latest启动后访问 http://localhost:12395/，未初始化时会自动跳到安装向导。
数据持久化
| 目录 | 内容 |
|---|---|
/app/config | 配置文件、SQLite 数据文件、master.key 主密钥 |
/app/data | 日志、证书私钥、运行期数据 |
建议至少挂载 config；使用 SQLite 时数据文件就在 config 下。
需要管理宿主机时
想让面板管理宿主机的防火墙 / SSH / 端口（而不是容器自身），追加挂载与命名空间：
bash
docker run -d --name gopanel \
-p 12395:12395 \
-v $(pwd)/config:/app/config \
-v /:/host:ro \
-v /var/log:/var/log:ro \
--pid=host \
docker.cnb.cool/liumou_site/gopanel/backend:latest数据库连接
容器部署不需要配置文件，数据库连接由环境变量提供：
bash
docker run -d --name gopanel \
-p 12395:12395 \
-v $(pwd)/config:/app/config \
-e GOPANEL_DB_TYPE=mysql \
-e GOPANEL_DB_HOST=10.0.0.10:3306 \
-e GOPANEL_DB_USER=gopanel \
-e GOPANEL_DB_PASSWORD='your-password' \
-e GOPANEL_DB_NAME=gopanel \
docker.cnb.cool/liumou_site/gopanel/backend:latest变量清单见 环境变量。
自定义端口
bash
docker run -d --name gopanel \
-p 8080:8080 \
-e GOPANEL_PORT=8080 \
-v $(pwd)/config:/app/config \
docker.cnb.cool/liumou_site/gopanel/backend:latest修改安全入口 / 重置密码
bash
docker exec gopanel /home/gopanel/GoPanel -se # 打印安全入口地址
docker exec gopanel /home/gopanel/GoPanel -sr # 重置安全入口路径
docker exec gopanel /home/gopanel/GoPanel -rp # 重置管理员密码（随机）升级
bash
docker pull docker.cnb.cool/liumou_site/gopanel/backend:latest
docker rm -f gopanel
# 用同样的命令重新 docker run（挂载目录不变，数据与服务配置都在）面板内「系统升级」页也能检查新版本；容器内提示使用的镜像地址可用 CNB_CONTAINER_IMAGE 覆盖。