Repository navigation
v0.1.0 — 首个可用版本
首个可用版本:两条通道、版本回滚、本地控制台。
安装
需要 Node.js ≥ 24——直接运行 TypeScript,靠内置类型剥离,没有构建步骤。
git clone https://github.com/l1217974476/airlock.git
cd airlock && npm install不想 clone 就用下面的附件:
npm i -g ./airlock-0.1.0.tgz两条通道
两台机器之间只跑一条 SSH 连接,stdin/stdout 接一个 JSON Lines 协议。请求侧说得越少,能被滥用的面就越小。
remote-dev —— 读写服务器上的工作区。12 个固定 op:读(status / list / read / git-status / git-diff)、
写(lease-acquire / lease-release / apply)、执行(check / job-status / job-cancel)、
交接(release-request)。另有 host-runtime 端口:4 个服务槽位 + 3 个动作(restart / reload / status),
请求侧只能给槽位 id,不能给命令或单元名。
deploy —— 本地构建产物到服务器。只认「应用 id + 版本号 + 归档」:
启停命令、健康检查、目录结构全部来自服务器本地配置,本机传不了命令进服务器。
发布通道的形态
<root>/releases/<version>/ 每个版本一个目录
<root>/current 指向当前版本
<root>/backups/<version>.tar.gz
<root>/state.json installed / deployed / failed / rolled_back
<root>/deploy.log
- 健康检查不过就自动退回上一版,状态记
rolled_back - 落点可改;Windows 默认管理员桌面,其他平台默认
~/Desktop/<app> - 默认只回滚代码。要连数据一起保,就在归档配置里声明
backupPaths,
并把状态目录放在releases/之外(Minecraft 的世界数据就是这么做的) install/activate/rollback全在服务器侧执行,本机只发请求
本地控制台
双击 airlock-ui.cmd(或跑 ./airlock-ui.sh)。绑 127.0.0.1,带一次性 token 的 URL。
能看每个项目的发布记录、每个服务器的版本列表,手动发布与回退,改发布落点,
加项目(原生文件夹对话框,自动探测构建产物目录)、加服务器,
以及连不上服务器时给出一段可以直接交给 agent 的接入提示词。
服务器侧
scripts/provision-windows.ps1:建专用部署账号(默认 ag-ssh)、把公钥写进真实的 profile 目录、
配 sshd 的 ForceCommand 门禁。完整接入流程见 docs/ONBOARDING.md,踩坑记录见 docs/DEPLOY.md。
已验证
- 隔离测试 78 个全绿:协议编解码、路径白名单与穿越、CAS 与租约、归档摘要一致性、
宿主服务动作白名单、激活失败自动回退、数据备份恢复、落点校验与写回。 - 真实服务器端到端跑通:Windows + OpenSSH
ForceCommand、版本切换与自动回滚、多服务器切换、
有状态服务(Minecraft Fabric 服务端,世界数据靠 junction 留在releases/之外)。
未验证
Linux 服务器上的完整链路、多客户端并发、慢链路下的大包传输稳定性、
带数据库迁移的回滚、macOS 作为控制台宿主。
已知的取舍
- 不执行任意命令、不给交互式 PTY、不管理数据库、不
tail -f日志。 - 不托管凭据:私钥在本机 ssh agent 或受保护文件里,profile 只存路径。
- 不负责构建:
deploy推的是已经构建好的目录,构建是调用方的事。 - 历史说明:本 tag 之前曾有一次性接入脚本误入版本库(含真实公钥与 IP),
推送前已用filter-branch从全部历史清除,因此旧 commit hash 与常见教程里的不同属正常。
附件
airlock-0.1.0.tgz —— npm pack 产物,58 个文件,127.9 KB,可直接 npm i -g。
SHA-256 AA0C8A2D7C40AB74495CA939C8D2F4B7F8ADCB02CC7A836EC774117D206F7373
许可:MIT。