部署、授权与升级

部署需要什么

一台 Linux 服务器（Ubuntu 22.04 / Debian 11+ / CentOS 7+），至少 2 GB 空闲内存、10 GB 空闲磁盘，已安装 Docker。系统自带 MySQL 8，跑在独立端口，不会和你机器上已有的数据库冲突。

1. 安装 Docker（已有可跳过）
2. 上传安装包并解压
3. sudo ./install.sh --check 检查环境（不做任何改动）
4. sudo ./install.sh 安装，首次约 3–8 分钟
5. 看到「saasgo 已启动」即完成

让外网能访问

安装完成后服务只监听 127.0.0.1，避免和你机器上的其他站点抢 80/443。反代与证书由你（或按我们的说明）加：把域名反代到 http://127.0.0.1:3000，健康检查 /api/health 返回 ok 即通。

心跳与授权

实例上线后会定时上报心跳：实例 ID、指纹、域名、版本、服务器系统与配置。心跳只收这些字段，多传业务数据会被拒绝——经营数据不出你的服务器。

我们在授权中心能看到每个实例的版本、最后心跳与授权状态；续期也在授权中心操作，到期时间以内核返回为准。

升级怎么推

下发后 30 分钟版本仍没变化，记录会标成「客户机无响应」并写明原因，不会一直显示「进行中」。升级只替换程序，数据库数据保留。

1. 我们在授权中心登记新版本
2. 选择实例下发升级（同一实例同时只允许一个进行中的升级）
3. 你的机器下次心跳收到目标版本，自动拉取并重启
4. 新版本心跳上报后，升级记录变为成功

出问题看哪里

安装失败：脚本会说明卡在哪一步（Docker、端口占用、镜像拉取），按提示处理。

实例不在线：授权中心会显示最后心跳时间；超过 7 天没有心跳会标红。

升级失败：升级记录里有失败原因，也可以回滚到上一个版本后重新下发。