快速上手

从零到能用的最短路径：装一个容器 → 打开浏览器 → 走一遍安装向导 → 用管理员账号登录。

一分钟跑起来

docker run -d \
  --name gopanel \
  -p 12395:12395 \
  -v $(pwd)/config:/app/config \
  docker.cnb.cool/liumou_site/gopanel/backend:latest

然后浏览器打开 http://localhost:12395/：

1. 系统尚未初始化时，根路径会直接跳到安装向导（/#/setup）；
2. 在向导里选择数据库类型、填写连接信息、设置管理员账号密码；
3. 完成后用该账号登录即可。

为什么第一次打开不是登录页：此时系统内还没有任何可用账号，先设置好账号再登录才不会卡在登录表单上。

需要准备什么？

项目	要求
运行方式	Docker（推荐）或宿主机直接跑二进制
数据库	MySQL 5.7+ / MariaDB / PostgreSQL / SQLite 任选一种；SQLite 适合个人与小规模
端口	默认 12395，可自定义
系统	Linux（amd64 / arm64 / armv7）；Windows / macOS 可自行编译

完整说明见 环境要求。

完整安装方式

安装方式总览 里列出了五种方式，按场景挑一种即可：

• Docker 一键运行（推荐）—— 单体镜像，最省事
• 一键脚本安装 —— 下载 Release 二进制，可选注册 systemd 服务
• 手动运行二进制 —— 自己下载、自己跑，适合临时试用
• 从源码构建 —— 需要 Go ≥ 1.26 与 Node.js ≥ 22，仓库根 go build -o GoPanel . 即可
• Docker Compose 编排 —— 前后端分离部署、自带数据库容器

下一步

• 部署自检与排障 → 部署自检与排障
• 打不开后台 / 忘记入口 → 常用地址与安全入口
• 忘记管理员密码 → 安装向导与账号