Skip to content

v0.1.0 — 首个可用版本

Choose a tag to compare

@XneoZero XneoZero released this 11 Nov 10:30
· 20 commits to main since this release

首个可用版本:两条通道、版本回滚、本地控制台。

安装

需要 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。