手把手：用 agent-template.sh 做模板、开新 agent、连接 T3 Code

四个子命令和整体流程

agent-01（快照 proxy_ok：系统 + 代理）
   │  ① 下载脚本 → install → 重新登录 → check
   │  ② 准备：Mac 公钥、Claude 通用配置、公开仓库（都不登录）
   │  ③ 拍快照 dev_tools
   │
   │  从 dev_tools 完整克隆
   ▼
9000 tpl-agent ── ④ cleanup（agent-01 先关机）→ 转换成模板
   │
   │  完整克隆
   ▼
agent-02、03 … ── ⑤ init agent-0N → 重新登录 → check → ⑥ 连接 T3 Code

第一步：下载脚本

SSH 登录 agent 虚拟机后执行（后面的 ?t=… 是为了避免拿到缓存里的旧版本，更新脚本时也用这条）：

curl -fsSL "https://pages.chenos.dev/workstation/scripts/agent-template.sh?t=$(date +%s)" -o ~/agent-template.sh
bash ~/agent-template.sh            # 不带参数：显示用法，确认下载的是完整的新版

想先看内容：less ~/agent-template.sh（按 q 退出）。

第二步：install（模板源机器）

想从干净状态测试的话，先在 PVE 里把 agent-01 回滚到 proxy_ok 快照（回滚后要点“启动”）。然后：

bash ~/agent-template.sh install        # 中途会要求输入 dev 的密码

每一部分开头会显示蓝色的 == 标题 ==，完成的项显示绿色 ✓。全部跑完后：

1. 退出 SSH 重新登录：让 docker 用户组和代理变量生效
2. 执行 bash ~/agent-template.sh check（见下一步）

第三步：check（随时检查）

bash ~/agent-template.sh check

最后显示 “全部通过（N 项）” 就对了；有 ✗ 时退出码不为 0。常见的 ✗ 和修法：

第四步：做模板前的准备，拍快照

这些做进模板，以后每台克隆机就都自带了：

然后在 PVE：agent-01 → 快照 → 做快照，名称 dev_tools（只能用字母、数字、-、_，以字母开头），不勾选“包括内存”。

第五步：cleanup，转换成模板

1. 右键 agent-01 → 克隆：快照选 dev_tools，VM ID 9000，名称 tpl-agent，模式完整克隆（从快照克隆只能完整克隆）
2. 把 agent-01 关机：9000 的身份和 agent-01 一样，同时开机会抢同一个 IP
3. 启动 9000，从 Mac SSH 登录（用 agent-01 原来的 IP），执行：

   bash ~/agent-template.sh cleanup

   发现登录凭证时会列出来，确认删除；最后选“关机”。关机前不要重启它，否则会重新生成 machine-id 和密钥
4. 右键 9000 → 转换成模板
5. 重新启动 agent-01

第六步：克隆新 agent，init

1. 右键 tpl-agent → 克隆：VM ID 如 201，名称 agent-02，完整克隆。日常 agent 可以在 硬件 里把内存改成 8G、CPU 4 核
2. 启动后在 概要 页看 IP，Mac 上 ssh dev@<IP>（提示主机密钥变了就先 ssh-keygen -R <IP>）
3. 执行：

   bash ~/agent-template.sh init agent-02

init 会依次问这些问题：

完成后：退出重新登录 → bash ~/agent-template.sh check；路由器里按 MAC 绑定固定 IP；Mac 的 ~/.ssh/config 加一段别名。

第七步：连接 T3 Code（浏览器、Mac、手机）

7.1浏览器访问（默认端口 3773）

后台服务默认只监听 127.0.0.1，局域网访问不了；默认 PATH 也不含 ~/.local/bin，会找不到 claude / codex / opencode。新版 init 已自动处理；手动补的话：

mkdir -p ~/.config/systemd/user/t3code.service.d
cat > ~/.config/systemd/user/t3code.service.d/agent.conf <<EOF
[Service]
Environment=T3CODE_HOST=0.0.0.0
Environment=PATH=$HOME/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/snap/bin
EOF
systemctl --user daemon-reload
t3 service restart
sleep 3; ss -ltnp | grep 3773        # 应该是 0.0.0.0:3773 或 *:3773
t3 pair                              # 生成配对链接

把配对链接在 Mac 浏览器里打开（链接里是 127.0.0.1 / localhost 的话换成虚拟机 IP），之后直接访问 http://<IP>:3773。每台虚拟机各用自己的 IP，端口都是 3773。

7.2确认是后台服务在提供 3773

systemctl --user status t3code --no-pager | head -12      # active (running)，进程树里有 t3 __service-launcher
PID=$(ss -ltnp | grep 3773 | grep -o 'pid=[0-9]*' | cut -d= -f2)
ps -o pid,cmd -p $(ps -o ppid= -p $PID)                    # 上一级是 t3 __service-launcher 就对了

最可靠的验证：sudo reboot，不登录 SSH，直接在浏览器打开地址，能打开说明开机自启和 linger 都没问题。

7.3Mac 桌面 App（SSH）

1. Mac 上确认：ssh dev@<IP> 'sh -lc "command -v claude codex opencode t3"' 能打印 4 行路径
2. T3 Code → Settings → Connections → Add environment → SSH，填 dev@<IP> 或 SSH 别名
3. 添加项目，比如 /home/dev/NocoBase/nocobase3；Ctrl+J 打开的终端运行在虚拟机里

7.4手机（T3 Connect）

1. 手机装 T3 Code App（App Store / Google Play）
2. 每台虚拟机执行一次 t3 connect：在浏览器打开它给的链接，核对短码，批准。所有虚拟机用同一个 T3 Connect 账号
3. 手机 App 登录同一个账号，列表里就是全部 agent。在家会自动走局域网直连，在外面走 T3 Connect 中转，手机上不用开 Tailscale

不想用 T3 Connect：在 Mac 终端里 SSH 进虚拟机执行 t3 pair，用手机 App 扫屏幕上的二维码（只在家里 Wi-Fi 或手机开着 Tailscale 时能用）。

日常维护

实际踩过的坑