termal.in

AI 代理 · Codex CLI

让 Codex 通过 SSH 访问你的服务器，无需交出密钥

Codex 在你电脑上的沙箱里执行 shell 命令。只要 ~/.ssh 里有密钥，它现在就能 ssh 出去，不受限制，也没有记录。Termalin 是更安全的接入方式。

OpenAI 的 Codex CLI 支持 MCP，而 Termalin 是一款内置 MCP 服务器的 SSH 客户端。在 config.toml 里加一项，Codex 就能真正地操作你的服务器：执行命令、读写文件，自己开会话，也可以接入你的会话。代理始终拿不到你的密钥，而它的每一步你都看得见。

下载 Termalin 完整 MCP 参考 →

Free 版 · 14 天 Pro 试用 · Windows、macOS、Linux 和 iOS

01  /  3 步完成设置

三步让 Codex 连上你的服务器

Termalin 自带真正的 MCP 服务器：内置的 termalin-mcp 二进制文件为 AI 代理提供对你所选主机的 SSH 和 SFTP 访问，认证通过应用的密钥代理完成。参见 MCP 工具完整列表（英文）。

  • 1选择主机。安装 Termalin，在“设置 → 代理访问 (MCP)”中选择要开放的主机。每台主机都只以代理认证方式写出，不会有密码落到磁盘上。顺便为每台主机设置代理策略：完全访问、命令允许列表或禁止。
  • 2注册服务器。Codex 从 ~/.codex/config.toml 的 mcp_servers 部分读取 MCP 服务器，加一项指向该二进制文件：
[mcp_servers.termalin]
command = "<path>/termalin-mcp"

较新版本的 Codex 也可以用命令行注册：codex mcp add termalin -- <path>/termalin-mcp。同一份配置也作用于 IDE 中的 Codex。

  • 3让它做点实事。代理会列出你的主机并开始工作：查看日志、重启服务、检查磁盘、修改配置、部署。

想看完整版？请参阅 Codex 完整设置指南（英文）。

02  /  自己的会话，或你的会话

代理可以自己开会话，也可以接入你的会话

大多数 MCP 服务器封装的是某个 API，Termalin 封装的是你的服务器。AI 代理像你一样操作它们，用的是真正的会话、文件和隧道：

  • ▸自己的会话：代理开一个会话在后台运行，表现为一个高亮的标签页，你可以随时查看。Free 版即包含。
  • ▸或接入你的会话：代理直接进入你已打开的会话，与你并肩工作，操作时边框会发光。需经你同意，有独立的开关。
  • ▸完整的工作流：一次性命令、可复用的持久 SSH 会话、SFTP 读写，以及端口转发（到服务器后面某个服务的本地隧道，或 SOCKS 代理）。

03  /  密钥托管与授权

密钥留在你手里，未经同意什么都不会执行

Codex 在你的电脑上执行终端命令。所以只要你的密钥以解锁状态放在 ~/.ssh 里，或在运行中的 ssh-agent 里，ssh prod 现在就能成功，你在没做决定的情况下就交出了服务器的完全访问权。Termalin 的密钥托管方取代了这种安排：代理提出请求，托管方完成认证。你解锁一次，Termalin 代表代理签名，没有可供代理读取的密钥文件，也就无从泄露；对于值得保护的主机，你的磁盘上也不需要散放的密钥。代理访问默认关闭；允许代理在你正在进行的会话中输入，是另一个单独的开关；而且只有你在“设置 → 代理访问 (MCP)”中导出的主机才可访问，每台主机都有自己的访问级别：完全访问、命令允许列表或禁止。

04  /  监督

每一步都看得见：实时查看、全程录制、记入日志

监控网格把每个打开的会话以实时窗格并排镜像，由代理操作的会话会高亮发光，让你实时看到它的工作，必要时覆盖一整批服务器。

  • ▸在录制中标记：代理的每条命令都会在回放时间轴上有自己的绿色标记，“代理做了什么？”可以拖动时间轴找到答案。详细了解会话录制 →
  • ▸写入审计日志：每次登录、主机连接、文件操作和代理命令，连同来源（IP · 国家）和所用设备，全部记录。

05  /  无需运行应用

为运行在云端的 AI 代理准备的托管 MCP 端点

对于通过 Connector 接入的服务器，Codex 无需运行桌面应用就能使用 Termalin 的托管服务器：用 URL 添加它——codex mcp add termalin --url https://termal.in/mcp——Codex 会立即在浏览器中打开 Termalin 的登录页（之后用 codex mcp login termalin 可再次登录）。托管那一侧需要一个 Pro 或 14 天试用的账户。

代理运行在没人能登录的地方，比如 CI？在网页控制台中创建一个 API 密钥，指向 https://termal.in/api/v1/mcp，并带上 Authorization: Bearer tk_live_…。即使你的电脑上什么都没开，它也能在你接入隧道的服务器上执行命令、读写文件。这些服务器指运行了一行安装代理的机器（通过 termal.in/account →“添加 Connector”接入；桌面应用中的主机不算），认证使用短期证书，不分发任何密钥。密钥可以限定到特定服务器，设置命令策略（完全、允许列表或只读），设定有效期（30 / 90 / 365 天），并可随时吊销；托管运行有速率限制和时长限制。两条路径访问的主机不同：本地服务器操作你从应用中导出的主机清单，托管端点操作你接入隧道的服务器。初次了解这个思路？从面向 AI 代理的 SSH 开始，或直接查看完整 MCP 参考。

常见问题

怎样把 Codex 连接到我的服务器？

Codex 通过 MCP 服务器访问服务器——可以是一个独立的 SSH MCP，把密钥保存在它运行的地方（例如 tufantunc/ssh-mcp），也可以是 SSH 客户端自带的那一个。用 Termalin：安装 Termalin，在“设置 → 代理访问 (MCP)”中选择要开放的主机，然后把 Codex 的 MCP 配置指向内置的 termalin-mcp 二进制文件，也就是在 ~/.codex/config.toml 的 mcp_servers 部分加一项。之后 Codex 就能列出这些主机、执行命令，并通过 SSH 和 SFTP 读写文件。对于通过 Connector 接入的服务器，你可以跳过桌面应用，改为添加托管服务器 https://termal.in/mcp。完整参考 →

Codex 会拿到我的 SSH 密钥吗？

不会。AI 代理通过 Termalin 的密钥托管方（替你保管密钥、代为签名的中间层）进行认证：你解锁一次，Termalin 就代表代理签名，私钥从不交给代理或模型。托管端点更进一步，用短期证书代替密钥。了解安全机制 →

能限制 Codex 在某台主机上执行什么吗？

能。代理访问默认关闭，只有你在“设置 → 代理访问 (MCP)”中导出的主机才可访问，而且每台主机都有自己的代理策略：完全访问、命令允许列表或禁止。对于你在意的主机，从允许列表开始最合适。

我能看到代理在做什么吗？

能。每个打开的会话都会实时镜像到监控网格中，由代理操作的会话会高亮发光，代理的每条命令都会在会话录制中标记出来，所有操作都会写入审计日志。

MCP 服务器免费吗？

免费。Free 版就是完整的桌面应用，仅限本地，主机数量不限，并且包含能自己开会话的 MCP 代理。代理还可以接入你已经打开的会话。Pro（按年付费 $8/月，按月付费 $10/月）增加加密云服务和托管 MCP 服务器。每个新账户都从 14 天 Pro 试用开始，无需绑卡。查看价格 →

给你的 AI 代理一个真正的终端，免费

Free 版就是完整的桌面应用，主机数量不限，并内置 MCP 服务器。新账户可免费试用 Pro 14 天。

下载 Termalin 完整 MCP 参考 →

Free 版 · 14 天 Pro 试用 · MCP 参考 · 面向 AI 代理的 SSH