安装向导详解
安装向导只有三步:数据库 → 授权码 → 管理员密码,全部大白话中文。部署模式、授权服务器地址等都不需要你填——由程序自动处理。
打开向导
程序第一次启动没有配置时,会自动开启安装向导,并打印安装链接(终端 / 日志 / setup-url 文件三处任取其一,以宝塔安装为例见 快速安装向导 第 4 步)。链接形如:
http://1.2.3.4:8080/?t=xxxxxxxxi安装页令牌保护
链接末尾的 ?t= 是一次性访问凭证(crypto/rand 生成),只打印在服务器终端与服务日志里(宝塔用户在「Go 项目 → 设置 → 项目日志」里搜 ?t= 即可),必须整段复制。无令牌的扫描者既拿不到预填的数据库信息,也无法抢先完成安装接管系统。完成安装后,令牌与预填文件自动删除。
向导三步
-
① 数据库
填主机 / 端口 / 账号 / 密码 / 库名(端口与账号默认即可,库不用自己建),点「测试连接并自动建库」,看到绿色成功提示即可。MySQL 的 root 密码在 宝塔面板 → 数据库 → 上方「root密码」处查看;连不上会给大白话提示告诉你去哪找。
没测就点了「完成安装」?向导会先自动补测一次,连不上会停在第 1 步提示你,不会静默失败。
-
② 授权码
有授权码:粘贴进去,点「验证授权码」在线核验。暂时没有:留空直接跳过——先到第 3 步完成安装,装完可进后台,前台网站暂不开放;之后拿到授权码,在后台「系统更新」页或前台停服页激活即可。页面顶部的「机器码」买授权码时发给客服。
-
③ 管理员密码
设置后台登录密码(至少 8 位,账号固定
admin),点「完成安装」。库里已有管理员账号时,这一步会显示「沿用原密码」提示,设置新密码即覆盖。
无需你决策的部分
| 项目 | 说明 |
|---|---|
| 对外访问方式 | 程序按服务器环境自动判定(80 空闲→域名直连;宝塔 / 其它 nginx 占 80→反代),详见 域名解析与访问 |
| 授权服务器地址 | 固定为编译期注入的官方地址,无需填写 |
| 向导端口 | 默认 8080;被占用时自动避让(8081+),页面顶部会醒目提示当前端口 |
完成安装后
- 程序自动执行:写配置(0600 权限)→ 建库建表(全部幂等)→ 创建管理员 → 自动拉起正式服务(宝塔直跑 / 手动运行模式同样自动,无需手动启动);
- 页面显示「服务正在自动重启」,探活就绪后自动跳转登录页;
- 长时间未跳转(自动拉起失败):页面会给出手动启动指引(如回宝塔 Go 项目点「启动」),按提示操作一次即可。
习惯命令行?
加 --cli-wizard 可回到终端交互式向导(适合纯 ssh 无浏览器的环境),步骤与内容一致。