Skip to content

Deploy Linux

supdger edited this page Sep 30, 2026 · 1 revision

部署到 Linux amd64

目标是在自己的 Linux x86_64 服务器启动已构建的项目,再验收业务。先在开发机构建并验证,取得整个 dist-aot/;服务器需具备项目要求的数据库、网络和资源,准备获授权的部署目录、连接参数及空闲监听端口。已有服务与数据库由操作者按自己的部署权限处理。

放置产物与配置

  1. 将整个 dist-aot/ 复制到选定目录;不要只复制 server。保留可执行权限,核对传输前后的 server SHA-256。
  2. 在目标目录准备项目需要的 .env。源码中的 .env 不会自动打包;数据库、账号和密钥由部署者提供。检查外置 config/ 中监听地址、端口、路径及日志配置,确认运行账号可写项目需要的 runtime/。详见产物与配置。
  3. 在 Linux 的 dist-aot/ 根目录检查平台和产物:
uname -srm
sha256sum ./server
file ./server

应为 Linux x86_64、ELF 64-bit x86-64 静态程序。更完整静态与隔离业务检查见Linux 进阶验收。

启动与验收

在同一目录前台启动,观察原生启动日志:

./start.sh

确认日志无错误,监听配置的端口,按项目真实地址检查健康接口、数据库访问、静态资源和主要业务接口。SaiAdmin 还需检查验证码、登录、登录后用户信息及权限拒绝。启动成功不等于业务验收通过。

需要后台运行时使用 ./start.sh --daemon;停止本目录实例使用 ./stop.sh。这些命令会实际启停服务,应由有该服务器权限的操作者执行。这里不提供虚构的统一业务 URL,接口与端口以项目配置为准。

成功结果与下一步

同一份 ELF 在该服务器静态检查通过、正常启动,并在部署配置与数据下通过项目接口回归,才可记录目标机业务验收完成。保留版本、ELF 摘要、系统信息和接口结果。更新外置配置后重新验收受影响业务;修改业务源码则返回开发机重新构建。失败按常见问题处理。

Clone this wiki locally