部署教程

本教程指导你把 火花宝自动化系统（Go 版） 部署到自己的服务器并完成授权绑定，全程约 15 分钟。

① 环境要求

项目	要求
服务器	Linux x86_64（CentOS 7+ / Ubuntu / Debian），1核2G 起步
面板	宝塔面板（推荐，管理更省心）
数据库	MySQL 5.7 及以上（宝塔软件商店一键安装）
浏览器内核	Chromium（自动化引擎依赖，交付包内附安装说明）
域名	一个已解析到你服务器 IP 的域名（授权按域名绑定）

② 上传程序

1. 把交付的程序文件上传到服务器，例如 /www/server/hanhua_go/ 目录；
2. 赋予执行权限：chmod +x /www/server/hanhua_go/hanbao_huohua2.0

③ 创建数据库

宝塔「数据库」页新建数据库（库名如 dy_huohua），记下 用户名 / 密码，下一步要用。

④ 配置 config.json

在程序同目录创建 config.json：

{
  // 监听地址：保持默认即可
  "listen": "127.0.0.1:84",
  // 数据库连接：改成你刚创建的库名、账号、密码
  "db": "dy_huohua:数据库密码@tcp(127.0.0.1:3306)/dy_huohua",
  // 站点名称（显示在页面上）
  "site_name": "火花宝自动化系统",
  // 登录密码加密盐：一串随机字符，部署后不要再改
  "salt": "0ae3085fbfc7b8b48a4226372a97c86c",
  // Chromium 浏览器路径
  "chrome_exe": "/www/server/dybrowser/chromium126/chrome-linux64/chrome",
  // 站点根目录（存放运行截图等运行数据）
  "site_dir": "/www/wwwroot/你的域名",
  // ★ 授权域名：必须与授权中心登记的域名完全一致
  "site_domain": "your-domain.com"
}

⑤ 启动程序

宝塔方式（推荐）：宝塔 → 网站 → Go项目 → 添加Go项目，启动命令填：

/www/server/hanhua_go/hanbao_huohua2.0 serve

面板会自动运行并守护进程（崩溃自动拉起、开机自启）。

命令行方式：

nohup /www/server/hanhua_go/hanbao_huohua2.0 serve > /www/server/hanhua_go/run.log 2>&1 &

⑥ 建站反代

1. 宝塔 → 网站 → 添加站点，绑定你的域名；
2. 站点设置 → 反向代理 → 目标 URL 填 http://127.0.0.1:84；
3. 建议在站点设置里申请免费的 SSL 证书，开启 https。

⑦ 开通授权

1. 把你的 站点域名 提供给管理员开通授权（或使用「卡密开通」自助激活）；
2. 确保 config.json 里 site_domain 与授权域名一致；
3. 启动程序，系统会自动连授权中心验证——后台首页显示授权状态正常即成功。

⑧ 日常使用与更新

入口	地址
前台登录	https://你的域名
管理后台	https://你的域名/admin/index.php?a=login

程序升级：登录管理后台 → 授权与更新 → 检查更新 → 一键更新（自动下载、校验、备份旧版并重启，全程无需登录服务器）。

常见问题

Q：提示授权验证失败？
检查 config.json 的 site_domain 是否与授权域名完全一致（不含 http:// 前缀）；服务器需能访问外网。

Q：页面打不开？
先确认 Go 项目在宝塔里是运行状态、端口 84 被反代正确；查看面板项目日志定位。

Q：想更换域名？
在首页使用「更换授权」自助换绑，然后更新 config.json 的 site_domain 并重启程序。