T3 Code 是什么：客户端操控另一台机器上的 Agent
部署 T3 Code 远程访问
让客户端能到达执行环境，同时把文件和凭据留在服务器端
部署 T3 Code 远程访问知识学习CN编辑简报更新 2026-10-04
你将学会
- 选择连接路线
- 分清进程所有权
- 准备版本与恢复
开始前需要
- 服务器环境上有一个可丢弃项目
- 一个已登录的支持 Provider
在连接重要仓库之前，把可丢弃试用转化为证据
先看结论
- 远程传输不会搬迁执行位置。
- 托管 UI 不会代理不可达服务器。
- 客户端与服务器版本可能不同。
选择连接路线
远程指南提供 T3 Connect、私有局域网或 tailnet 配对、Tailscale HTTPS 和桌面端管理的 SSH。它们改变的是到达同一环境的路线，不会创造另一个执行模型。
托管 Web 页面需要浏览器可访问的 HTTPS 环境地址。它直接连接服务器；托管配对链接不能让不可达的后端变得可达，也不能把纯 HTTP 局域网服务自动升级为 HTTPS。
分清进程所有权
命令行主机可用 `t3 serve` 在不打开浏览器的情况下运行；macOS 或 Linux 上可用 `t3 service install` 保持后台运行。桌面 SSH 连接还能启动远端服务并转发端口。
SSH 断开时，只应停止由桌面启动器拥有的服务；如果服务原本就在运行，它有独立的生命周期。排障或清理前要先记清谁启动了进程。
准备版本与恢复
远程客户端和环境可以各自升级。架构要求客户端依据服务器宣告的能力协商，进程替换由更新协议处理。
首次部署应固定两端版本，从第二设备测试配对、撤销测试设备，并模拟服务器重启。本文没有部署服务或验证 T3 Connect。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
选择可达的 HTTPS、私有网络或 SSH 路线。
- 2
记录执行环境进程由谁启动和停止。
- 3
测试配对、撤销、重启及版本差异。
可复制示例
yaml
执行环境: 固定服务器版本
客户端: 固定桌面或Web版本
路线: 私有网络或HTTPS
进程所有者: 明确记录
配对撤销: 已测试常见问题
托管 Web 能从任何地方访问纯 HTTP 局域网服务吗？
不能。浏览器需要可达的 HTTPS 环境地址。
SSH 断开总会停止服务器吗？
不会。清理逻辑区分启动器拥有的服务和原本就存在的服务。
资料来源
- T3 Code / docs/user/remote-access.md来源核查 2026-10-04
- T3 Code / docs/user/background-service.md来源核查 2026-10-04
- T3 Code / docs/internals/remote.md来源核查 2026-10-04
- T3 Code / docs/internals/server-updates.md来源核查 2026-10-04
- T3 Code / docs/user/install.md来源核查 2026-10-04