安装向导与账号
首次初始化
系统尚未完成初始化时，访问根路径会直接跳转安装向导（/#/setup），而不是先展示登录页 —— 此时系统内还没有任何可用账号，先设置好账号再登录才不会卡在登录表单上。
向导内容：
- 数据库：安装向导的「环境检测」直接显示已连接的数据库类型与库名 —— 连接信息来自配置（
db.type/GOPANEL_DB_TYPE），不设置时默认 SQLite， 开箱即可安装；需要 MySQL / MariaDB / PostgreSQL 时先改配置再启动 - 管理员账号：设置初始管理员用户名与密码
- 提交后系统自动建表并创建管理员账号
完成后根路径恢复为「未登录跳转登录页」。
账号规则
| 项目 | 规则 |
|---|---|
| 用户名 | 较宽松 |
| 密码 | 8-64 位，至少包含字母 / 数字 / 符号中的两类 |
| 注册 | 不支持，前台 / 后台均无注册入口；后台账号由管理员在「设置 → 用户管理」创建 |
安装向导中填写的管理员账号是系统唯一的初始账号。
命令行初始化（可选）
bash
# MySQL
./GoPanel init --user=root --password="root" --host="127.0.0.1:3306" \
--database=gopanel --adminUser=admin --adminPass="admin123"
# SQLite
./GoPanel init --type=sqlite --database="config/gopanel.db" \
--adminUser=admin --adminPass="admin123"忘记管理员密码
bash
./GoPanel -rp # 重置创始人为 16 位随机密码并打印
./GoPanel -rp=新密码 # 重置为指定密码
./GoPanel -rp=用户名:新密码 # 重置指定用户容器内：
bash
docker exec gopanel /home/gopanel/GoPanel -rp也可用环境变量 GOPANEL_RESET_PASSWORD=1。
数据库是 SQLite 时
数据文件位于 config/ 目录（如 config/gopanel.db）， 容器部署务必把 /app/config 挂载到宿主机，否则容器重建后数据丢失。