选择部署方式
单用户可信本机使用 local 模式与受管理启动器,参阅本地工作区。网络部署使用 hosted 模式,显式提供身份、存储和稳定凭据入口。不要通过把 local 管理服务直接绑定公网来替代 hosted 身份设置。 一个部署需要:Node 22.19+、PostgreSQL、对应加密密钥、管理 API/Console、worker、独立预览入口和独立凭据 listener。当前 main 入口组装 API 与 worker,不要求凭空启动一个不存在的独立 worker 命令。源码与编译分发
源码依赖使用npm ci。维护者可以生成本地分发:
npm ci --omit=dev 后,local 模式可使用其附带的 local 管理脚本。产物包括编译代码、Runtime 与 Console 资源及锁定依赖,不包括你的数据库和凭据,也不自动发布软件。
hosted 启动要求
通过部署环境的私有配置机制提供上述值,不将真实值写入 shell 历史或示例。
HEXAGON_BOOTSTRAP_TOKEN 不是任意字符串:入口会查询数据库确认 owner 身份。当前 hosted 不提供完整组织 / 登录开通服务,需要先完成受支持的身份迁移或部署方身份准备;空数据库加一个随机 Token 不能直接启动成功。
在已准备身份、正确密钥、网络和数据库的源码部署中:
npm run dev 是前台入口,不自动提供服务管理、TLS 或备份。由部署环境管理进程退出、重启和日志,保留数据库与密钥。公开服务前配置独立入口,并用明确 URL / Token 连接 SDK。
按依赖顺序启动和检查
- 准备目标数据库、匹配的加密密钥与已有 owner 身份;提供服务前,先对该目标运行迁移。
- 将稳定凭据域名路由到凭据 listener;API/Console 与预览使用独立入口,不经凭据路由暴露管理服务。
- 由部署的进程监督器启动入口。检查鉴权健康响应中的数据库、worker 与凭据后端状态,不只看端口监听。
- 配置并验证 Sandbox/模型连接,分别用两套 SDK 运行要求的云任务;另外检查预览与保留产物。
- 结束活动工作并确认云清理后,重启同一部署,验证保留记录与凭据解密;升级前保存备份与恢复记录。