快速上手

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

一分钟跑起来

# 下载并解压（以 amd64 为例，详见「手动运行二进制」）
curl -fLO https://cnb.cool/liumou_site/GoPanel/-/releases/download/<tag>/GoPanel-linux-amd64.tar.gz
tar -xzf GoPanel-linux-amd64.tar.gz
chmod +x GoPanel-linux-amd64
./GoPanel-linux-amd64

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

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

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

需要准备什么？

项目	要求
运行方式	宿主机直接跑二进制（systemd 常驻见 一键脚本安装）
数据库	默认 SQLite（个人与小规模首选，无需单独部署）；也可换 MySQL 5.7+ / MariaDB / PostgreSQL
端口	默认 12395，可自定义
系统	Linux（amd64 / arm64 / arm 软浮点）；Windows / macOS 可自行编译

完整说明见 环境要求。

完整安装方式

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

• 一键脚本安装 —— 下载 Release 二进制，可选注册 systemd 服务
• 手动运行二进制 —— 自己下载、自己跑，适合临时试用
• 从源码构建 —— 需要 Go ≥ 1.26 与 Node.js ≥ 22，仓库根 go build -o GoPanel . 即可

下一步

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