起因: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 写一遍、内网地址换个地方就不通。
我需要的东西其实很朴素:一个固定入口,一套凭据,在哪台设备上打开都能用。
先把需求拆成三件事
后来我意识到,这类需求经常被混成一个词「远程访问」,其实是三件独立的事:
- 网络可达:从当前位置能不能到目标主机的 22 端口。
- 凭据可用:到了之后,用哪把钥匙、以哪个用户登录。
- 操作可查:谁在什么时候进了哪台机器、执行了什么。
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 里不会有任何连接记录——包在安全组就被丢了。这时候有三条路:
- 去控制台更新白名单(最快,但下次还会变);
- 换组网方案(Tailscale/WireGuard),彻底摆脱 IP 依赖;
- 保留一个带外入口(云厂商 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 不是目的,它只是把「八台机器、五个用户、三种网络」收敛成一个入口的副产物。结构清楚了,工具换哪个都不难。
评论交流
欢迎留下你的想法