起因:22 端口只认一个 IP

我的两台云服务器都做了同样的事:安全组里 22 端口只放行家宽的出口 IP,其余全部丢弃。理由很直接——公网上每天扫 22 端口的流量太多,密钥认证再稳也不想把 sshd 暴露给所有人。

代价也很直接:离开这个出口,就进不了终端。

在宿舍或家里没问题;去实验室、用手机热点、在外面临时想改个配置,就只能干看着。更麻烦的是主机不止两台。把当时要管的东西列出来:

主机 网络位置 用途 接入的麻烦
云服务器 A 公网 反代、frps、Gitea、监控 安全组只放行家宽 IP
云服务器 B 公网 Halo、Gitea、1Panel 同上,且经 frp 暴露
NAS 局域网 Docker 宿主 容器回连宿主不能用内网 IP
路由器 局域网 WISP 上联、DHCP 只在内网可达
NAS 虚拟机 独立网段 测试环境 macvtap,地址不在主网段
NAS 存储 VM 独立网段 iSCSI 同样只在 host-only 网段
Windows 局域网 本机、WSL 宿主 Scoop junction 在 SSH 会话里不可信
WSL 局域网(非默认端口) Linux 工具链 端口不是 22

八台机器、五种用户名、三种网络位置、两套私钥。真正麻烦的不是「记不住密码」,而是换一台设备就要重新铺一遍环境:私钥拷过去、~/.ssh/config 写一遍、内网地址换个地方就不通。

我需要的东西其实很朴素:一个固定入口,一套凭据,在哪台设备上打开都能用。

先把需求拆成三件事

后来我意识到,这类需求经常被混成一个词「远程访问」,其实是三件独立的事:

  1. 网络可达:从当前位置能不能到目标主机的 22 端口。
  2. 凭据可用:到了之后,用哪把钥匙、以哪个用户登录。
  3. 操作可查:谁在什么时候进了哪台机器、执行了什么。

VPN 或组网解决第一件,SSH agent 转发解决第二件,审计系统解决第三件。三者可以分开选,也可以找一个把它们装在一起的东西。

我选的是后者。原因很实际:三件分开做,维护成本是乘法的;而我的规模只有八台机器,不值得为每一层单独搭一套。

为什么是 Termix

先把候选方案摆出来对比:

方案 网络 客户端 凭据集中 审计 移动端 维护成本
Tailscale / WireGuard 组网 每台设备装客户端 否 部分 要装 App 中
纯 SSH ProxyJump 跳板 系统 ssh 否(仍要私钥) 靠日志 差 低
Teleport 跳板 + 证书 tsh 是 强 一般 高
ShellHub 跳板 浏览器 是 中 好 中
云厂商 Session Manager 云内 厂商 CLI 是 强 差 低(只限该云)
Termix 跳板 浏览器 + CLI 是 中 好 中

几个排除理由:

  • Tailscale / WireGuard:组网思路是对的,但它解决的是「网络可达」,不解决「凭据在哪」。手机、临时借用的电脑、虚拟机都要单独装客户端;而且它不会告诉你谁在什么时候登录了哪台机器。
  • 纯 SSH ProxyJump:目标机只允许跳板机访问,这是标准做法。但跳板机本身还是要一个公网入口,本地仍然要维护 ~/.ssh/config 和私钥;换设备等于重来一遍。
  • Teleport:能力最全,证书短时有效、审计完整,但对八台机器的个人环境来说,部署和证书轮换的成本过高。
  • 云厂商 Session Manager:只覆盖该云内的机器,跨阿里云、腾讯云、NAS、路由器就断了。
  • 面板自带的 Web 终端:1Panel 的终端只能进它自己那台,跨主机还是得再开 SSH。

Termix 的定位刚好卡在中间:自托管的 Web SSH 客户端,带主机清单、凭据管理、SFTP、端口隧道、会话审计和命令片段。把这些东西放进一个网页,手机上也能用。

代价是它自己变成了一个高价值目标——这点后面单独说。

部署:入口只留 443

最终的链路是这样:

浏览器 → ESA/OpenResty 443 → 阿里云 frps(隧道端口)
       → frpc(NAS 主动建连)→ Termix:8080 → SSH 22 → 各主机

Termix 跑在 NAS 上,镜像 ghcr.io/termix-ssh/termix:26.11.1。实际的 compose 关键部分:

services:
  termix:
    image: ghcr.io/termix-ssh/termix:26.11.1
    restart: unless-stopped
    ports:
      - "${NAS_LAN_IP}:8080:8080"   # 局域网
      - "127.0.0.1:8080:8080"       # NAS 中转服务回源
    environment:
      - TZ=Asia/Shanghai
      - PUID=1000
      - PGID=1000
      - HTTPS_PROXY=${OUTBOUND_PROXY}
      - HTTP_PROXY=${OUTBOUND_PROXY}
      - NO_PROXY=localhost,127.0.0.1,::1,${NAS_LAN_IP}
    volumes:
      - ./data:/app/data
    mem_limit: 1g
    cpus: 1.0

几个决定值得说明:

不绑 0.0.0.0。 第二条端口映射是被坑出来的:绿联 UGOS 的远程中转回源时走的是宿主机的 127.0.0.1,只绑内网 IP 的话,局域网访问正常,外网中转却报「连接被拒绝」。同时绑内网 IP 和回环,既不让容器监听所有网卡,又兼顾两条入口。

数据和程序分开。 ./data 里是加密数据库、插件、上传文件和备份,当前大约 47 MB:

db.sqlite.encrypted
db.sqlite.encrypted.tmp-*     # 升级/写入时的临时副本
plugins/
plugin-data/
uploads/
backups/

数据库是加密的,但这不意味着备份可以随便放。这个目录等价于八台机器的钥匙串,备份必须和私钥同等级别:加密、离线、且真的演练过一次恢复。

出站代理是为了插件,不是为了 SSH。 Termix 的插件索引放在 raw.githubusercontent.com,NAS 直连会被 RST。代理失效只影响插件注册表和更新检查,已装插件和现有 SSH 连接照常工作——这一点在排查时很关键,别把插件页打不开误判成整个服务挂了。

公网入口是 termix.example.com(示例域名),走阿里云的 frps。frpc 从 NAS 主动连出去,所以家里不需要端口映射,云上也不用为 Termix 单独开高端口——对外仍然只有 443。

暴露面:只有 443 是公网的

部署完成后,从攻击面角度再看一遍:

端口 谁可以访问 说明
443 公网 ESA → OpenResty → frps,只有 HTTPS
隧道映射端口 仅云服务器本机 frps 接收 termix 隧道,不直接对公网
frps 控制端口 公网 只接受带 token 的 frpc 注册
8080 局域网 + 回环 不监听 0.0.0.0
22 家宽 IP 两台云服务器只对白名单开放

这张表是这套方案最实在的收益:为了随时能连终端,我没有把任何一台机器的 22 端口对公网打开。

第一课:它确实是跳板机,但不是「穿透」

部署完我先去云服务器上看 auth.log。所有 SSH 登录的来源都是同一个家宽出口 IP,而不是云服务器自己的地址:

Accepted publickey for admin from <家宽出口 IP> port 16306 ssh2
Accepted publickey for ubuntu from <家宽出口 IP> port 15968 ssh2

这说明 Termix 里的 SSH 是从 NAS 发起的,出口就是家里的宽带。所以它能连上,不是因为「绕过了防火墙」,而是因为这个出口 IP 本来就在白名单里。

这条区分很重要:

容易误解的说法 实际发生的事
22 只开 NAS 的 IP 开的是家宽的公网 IP,NAS 和你电脑共享它
Termix 能穿透防火墙 不能。它只是把 SSH 的源 IP 换成了家里的出口
有了 Termix 就不怕 IP 变 一样怕。出口 IP 变了,Termix 里的 SSH 全部超时

判断方法也很简单:IP 变了以后,云服务器 auth.log 里不会有任何连接记录——包在安全组就被丢了。这时候有三条路:

  1. 去控制台更新白名单(最快,但下次还会变);
  2. 换组网方案(Tailscale/WireGuard),彻底摆脱 IP 依赖;
  3. 保留一个带外入口(云厂商 VNC),至少不会完全失联。

我选了 1 + 3。第 2 条以后如果机器再多,会认真考虑。

第二课:认证模型比想象中复杂

Termix 的 CLI(我这里是 1.3.2)对自动化很有用,但它的两条通道认证方式不同:

# REST:session token 或 API key 都行
termix exec 8 'hostname; uptime'

# WebSocket PTY:只认 session token
termix ssh 8 --command 'hostname'
# → needs a session token: API keys cannot open WebSocket connections

CLI 的 ssh 子命令打开的是交互式 PTY,服务端的 WebSocket 端点只接受登录会话;API key 这条路径没有接进去。所以想用 API key 做无人值守,只能用 exec,一次一条命令。

我实测过两种凭据的行为:

凭据 exec(REST) ssh(WebSocket) 存储位置 有效期
session token 可用 可用 本机 config.json 明文 JWT 30 天
API key tmx_... 可用 拒绝 服务端数据库(只在创建时显示一次) 默认 90 天

有一个容易被忽略的事实:CLI 的 session token 是明文存在本机 config.json 里的 JWT,claims 只有 userId、sessionId、iat、exp。任何能读这个文件的进程,都等于拿到了管理员会话。它不是设计缺陷,但决定了这台机器的磁盘加密、账户权限和共享使用要按同一级别对待。

服务端版本也有差异。我这里的 Termix 26.11.1 创建 API key 时没有 scope 概念(scopes: null),--scope full 会报 Unknown API key scope;帮助里写的 read / actions-read / actions-run / full 是 26.11.2+ 的模型。升级服务端之前,别照新版文档配旧版。

第三课:CLI 是「核心 + 插件」两层

termix --help 列出的命令分两类:

  • 核心命令:login、logout、whoami、hosts、exec、ssh、files、tunnel、sessions、credentials、alerts、audit-logs、users、api-keys、status、plugins、api。
  • 插件提供的命令:docker、fleets、snippets、ops 等,取决于服务端装了哪些插件。

我这边装了 24 个插件,启用 21 个:

alerts / classic-layout / classic-themes / credential-tools / docker
file-manager / host-metrics / host-status / import-export
operations-center / remote-desktop / snippets / ssh-terminal
telemetry / totp / tunnels / webauthn / workspaces / ai
secret-sources / termix-identity
(禁用:serial / sso / sync)

所以 termix fleets 报 Fleets is not installed on this server 不是 CLI 坏了,而是服务端没装这个插件。判断方法就是 termix plugins,它会列出每个插件启用的命令。

另一个实测数据:termix exec 一次往返大约 12 秒,而本机 ssh aliyun true 也要 11.5 秒。也就是说,慢的不是 Termix,而是到阿里云的 SSH 首连本身(大概率是 sshd 的反向解析或链路 RTT)。这条对比很有用——否则很容易把服务器侧的问题算到跳板头上。

输出质量也差很多:

  • termix exec 走 REST,stdout/stderr 干净,退出码就是远端命令的退出码。
  • termix ssh --command 走 PTY,zsh 的行编辑会把命令重绘两三遍,最后才是结果。它适合人看,不适合脚本抓。

还有一个细节:主机清单里的 id 和显示名不是一回事。termix hosts list --json 返回的 id 才是命令参数,用名字会直接报错。

第四课:主机接入的坑,都是网络位置问题

用下来踩到的坑,几乎都和「容器在哪、它看到的是哪个地址」有关。

1. 容器回连宿主机,不能用宿主的内网 IP。 Termix 里那台 nas 主机,地址要用容器看到的网桥网关,而不是 NAS 的局域网 IP。Docker 的 hairpin NAT 让容器访问宿主内网 IP: 端口时不通,回环网桥地址才行。

2. NAS 上的虚拟机分两种网络。 nas-ubuntu/nas-istores 是 macvtap,地址在单独的 host-only 网段;Windows 宿主机和 Termix 容器都能直连,但别指望它们出现在主网段。另一种 VMware 虚拟机走 NAT,Termix 容器经 Windows 宿主访问时,日志里看到的来源是宿主的 NAT 网关——排查「为什么登录来源不是 NAS」时要知道这一点。

3. Windows 上的 Scoop 在 SSH 会话里会报「不受信任的装入点」。 本地 PowerShell 一切正常,从 Termix 连进去执行 git --version,shim 却报无法创建进程。原因是 Scoop 的 current 是 junction,SSH 登录令牌穿不过这类重解析点。临时办法是直接用真实版本路径,长期办法是在本地会话里重建 junction——但别为此关掉 Windows 的挂载点安全检查。

4. 不是所有主机都支持 Host Metrics。 路由器、部分虚拟机开启指标采集后会不断刷连接池超时,关掉即可。

5. WSL 的 SSH 端口要单独记。 Windows 宿主是 22,WSL 是 2222,两者共用同一把凭据。Termix 的主机清单里它们是两条记录,标签分别是 windows-ssh 和 wsl——不这样分,凭主机名根本认不出谁是谁。

这些问题的共同点:Termix 本身没坏,坏的是它所在的位置和它看到的网络。

第五课:插件、升级与供应链

插件系统是 Termix 从「Web SSH」变成「运维面板」的原因,也是新的风险面。

插件带来的能力:Docker 容器管理、主机指标、文件管理、远程桌面、端口隧道、命令片段、TOTP、WebAuthn、SSO、密钥源、AI 辅助。它们不是核心代码,而是运行时安装的扩展。

插件带来的风险:插件的代码在服务端进程里跑,权限和 Termix 后端相同。装一个来源不明的插件,等于给它一份主机凭据的访问权。所以我的原则是只装官方注册表里的插件,装之前看一眼它启用了哪些 CLI 命令和需要哪些权限。

升级要读版本差异。例如 26.11.1 不支持 cap_drop / read_only 这类 compose 加固项,26.11.2 才支持。升级前先看 release notes,别直接把新文档里的配置抄到旧版本上。

升级流程我固定成三步:

# 1. 备份 data 目录(加密后离线保存)
tar -czf termix-data-$(date +%F).tar.gz /volume2/docker/termix/data

# 2. 改 tag,拉镜像
docker compose pull

# 3. 起新容器,检查健康状态
docker compose up -d
docker compose ps
docker logs --tail 50 termix

数据目录里已经出现了几个 db.sqlite.encrypted.tmp-* 残留(升级或写入中断时的临时副本),它们不是运行必需的。清理前先确认容器已停止、备份可用——这类文件删错了就是数据库回滚。

第六课:集中凭据的另一面

把八台主机的访问收进一个网页之后,收益立刻能感觉到:换设备不用重新配私钥,手机上也能看容器日志,SFTP 拖文件不用记 scp 参数。

但同一个变化也意味着:Termix 的 admin 账号,等价于这八台机器的访问权。

所以部署时做了几件事:

  • 第一次启动立刻创建管理员,然后关闭注册;
  • 开 TOTP;
  • 公网只暴露 443,22 继续只对家宽开放;
  • 数据目录按「密钥」的标准备份;
  • 定期看 termix sessions,把不认识的设备撤掉。

termix sessions 的输出值得定期扫一眼。我这边长期只有两个会话:一个 Web(Edge/Windows),一个 Desktop,都是 30 天有效期。如果哪天多出一个不认识的 deviceInfo,那比任何告警都直接。

还有一条底线:不要把唯一的访问路径,放在一个自托管服务上。 Termix 自己是单点——它挂了、NAS 断电、frps 失联,远程入口就没了。所以本地 SSH 别名、云厂商 VNC 控制台都保留。跳板机是主路径,不是唯一路径。

日常怎么用

日常在电脑前,我还是用本地 ssh 别名,延迟最低。Termix 接管的是另外几种场景:

  • 在外面用手机查容器:打开网页 → Docker 插件 → 看容器状态和日志。不用在手机上装私钥。
  • 临时借一台电脑:登录网页就能进终端,不在别人机器上留任何密钥。
  • 多主机对照:同时开几个标签,一边看 OpenResty 的 error.log,一边看 Halo 的容器日志,排查链路问题。
  • SFTP:从 NAS 往云服务器传一个文件,用文件管理面板比记 scp -P 直观。
  • 端口隧道:termix tunnel 管理已配置的隧道;我这台目前是空的,因为跨网访问都走域名反代了。
  • 命令片段:把「查磁盘、查容器、看最近登录」这类固定检查存成 snippets,换机器时不用重新想命令。
  • 状态总览:termix status 一次看所有主机在线情况。当前 8 台在线、1 台离线(那台是已停用的实验环境,正好验证了状态检测是准的)。

它的价值不在于替代 ssh 命令,而在于替代「在异地打开终端」这件事。

故障模式表

自托管服务最怕的不是坏,而是坏了以后不知道坏在哪。把这段时间遇到和预演过的情况整理成表:

症状 最可能的原因 判断方法 处置
网页打不开 阿里云 frps 挂了 / NAS 断电 局域网 NAS局域网IP:8080 是否可访问 局域网可用 → 查 frps;不可用 → 查 NAS
网页能开,SSH 全超时 家宽出口 IP 变了 云服务器 auth.log 无连接记录 更新安全组白名单,或换组网
单台主机连不上 该主机离线 / 地址变了 termix status 修主机或改地址
插件页 0 个、提示无法连接注册表 出站代理失效 容器内 curl raw.githubusercontent.com 修代理;已装插件不受影响
某台机器指标一直转圈 Host Metrics 不支持 关掉该主机的指标采集 只对 Linux 主机开启
termix exec 很慢 目标机 SSH 握手慢 本机直连同一台对比 两个都慢 → 查 sshd/网络,不是 Termix
升级后容器起不来 新版本配置项不兼容 docker logs termix 回退 tag,读 release notes

这张表比任何「一键部署」都更有用,因为它把「服务坏了」拆成了几个可以独立验证的分支。

成本与取舍

用了几天,我对这套方案的判断是:它解决的是「入口」问题,不解决「高可用」问题。

得到的东西:

  • 一个固定的 HTTPS 入口,任何设备都能用;
  • 一套集中凭据,换设备不用搬私钥;
  • 一层跳板,云上 22 端口可以长期不对公网开放;
  • 一些顺手的运维能力:容器、文件、隧道、片段、审计。

付出的东西:

  • 多了一个要维护的服务,以及它的升级、备份、证书、代理;
  • 多了一个高价值目标,安全配置不能松懈;
  • 多了一个故障点,NAS 或 frps 挂了,远程入口就没了;
  • CLI 的 token 明文落盘、API key 版本差异、插件供应链,都需要自己判断。

如果只是两三台机器、且都在同一个云上,我不会上 Termix——云厂商的 Session Manager 或一个跳板机加 ProxyJump 就够了。它的价值在「跨云 + 内网 + 移动端 + 凭据集中」同时存在的时候才显现。

结论

用 Termix 这几天,最大的收获不是多了一个面板,而是把访问结构理顺了:

一个入口(443)
一份凭据(共享私钥)
一层跳板(NAS 出口)
一组被收窄的暴露面(22 只对家宽)

这套结构里,Termix 只是最上面那层界面。真正起作用的是「所有 SSH 从同一个出口发起」这个事实——它让云上的 22 端口可以长期不对公网开放,同时又不牺牲随时可用的终端。

自托管服务的通病也一样成立:你得到了控制权,也接手了它全部的故障模式。Termix 挂掉、NAS 断电、frps 失联、家宽 IP 变化,任何一项都会让「随时能连」变成「暂时连不上」。所以本地 SSH 别名和云厂商的 VNC 控制台,我都留着——跳板机是主路径,不是唯一路径。

如果让我给准备上手的人一句建议:先把「谁需要访问什么」列清楚,再决定装什么。 Termix 不是目的,它只是把「八台机器、五个用户、三种网络」收敛成一个入口的副产物。结构清楚了,工具换哪个都不难。