SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

如何用手机访问运行在VPS上的Hermes agent

Hermes agent运行在VPS上时,您可通过Tailscale私有网络、带TLS和登录的公共HTTPS端点或SSH从手机访问,并在手机丢失后立即撤销访问权限。

通过手机访问 Hermes 代理的三种方式

要通过手机访问 Hermes 代理,需要使用其 Web 控制面板。真正需要决定的是控制面板前面采用什么方式。第一种方式是私有网状网络,控制面板只监听 Tailscale 地址,不向互联网暴露端口。第二种方式是通过带 TLS(传输层安全)的反向代理和登录保护的公网端点;此时,该登录是保护服务器终端的唯一措施。第三种方式是通过终端应用使用 SSH(安全外壳),配置最少,但授予的访问权限最多。

本指南承接在自己的 VPS 上运行 Hermes 代理。代理已完成安装,可以在命令行响应请求,现在需要在手机上访问它。

以下命令针对标签 v2026.8.3 编写。该标签于 3 August 2026 发布,发行说明中标记为 v0.20.0。Hermes 发布频繁,因此应将计算机固定到某个标签,而不是跟随 main。安装程序接受提交:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/v2026.8.3/scripts/install.sh | bash -s -- --commit 3c27eb6234bf
hermes --version

使用该标签中的安装程序来完成固定版本。当前安装程序需要较新的 PM 依赖系统。hermes --version 会显示实际安装的内容。在信任本页中的任何标志前,请将其与该标签进行比较。

仓库发布了什么,以及没有发布什么

Hermes 仓库不包含 iOS 或 Android 应用。原生客户端是 hermes desktop(别名为 hermes gui),这是一个支持 macOS、Windows 和 Linux 的 Electron 应用。它可以连接远程 agent,而不是本地 agent:在 Settings 的 Gateway 下将远程 URL 设置为 http://<server-address>:9119,或在启动前导出 HERMES_DESKTOP_REMOTE_URL=http://<server-address>:9119。这样可以解决使用第二台笔记本电脑的需求,但无法用于手机。

手机端使用的是 hermes dashboard,即浏览器界面。它可以管理配置、会话、cron 任务、技能、日志和消息平台,并内置终端:服务器会在 PTY(伪终端)后启动 hermes --tui,再将输出流式传输到页面中。在窄屏上,会话切换器会折叠为滑出式面板,因此页面布局仍适合手机使用。

较新的版本还支持通过 hermes webapp 在浏览器中使用 Desktop 工作区。这是一个独立的网关界面,有自己的端口和公网 URL 设置;下面的说明介绍的是 dashboard。

默认情况下,dashboard 监听 127.0.0.1:9119,并在服务器本机打开浏览器标签页。这对无头 VPS(虚拟专用服务器)没有用处。启动时禁用浏览器,然后查看套接字:

hermes dashboard --no-open
ss -lntp | grep 9119

监听 127.0.0.1:9119 时,只能从服务器访问。监听 0.0.0.0:9119 时,连接到该计算机的所有网络都可以访问它,包括公网。仅这一行就决定了服务的暴露范围,因此应查看实际监听地址,不要凭默认设置判断。

选项 1:使用 Tailscale 构建私有网状网络

除非有明确原因,否则请选择此方案。Tailscale 是基于 WireGuard 构建的网状 VPN(虚拟专用网络)。每台加入的设备都会获得一个稳定地址,并直接连接到其他设备,或通过加密中继连接。您的手机也加入同一个网状网络,因此仪表板完全不需要开放公网端口。

在服务器上:

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
tailscale ip -4

在手机上安装 Tailscale 应用,并使用同一个账户登录。然后在服务器上运行 tailscale status,即可按名称列出手机。现在,将仪表板绑定到 tailscale ip -4 输出的地址:

hermes dashboard --host 100.101.102.103 --port 9119 --no-open

绑定网状网络地址,而不是绑定到 0.0.0.0,表示套接字只接受发往该网状 IP 的连接。扫描您的公网 IP 地址时,不会在 9119 上发现任何服务,因为该地址上没有进程监听。但这并不会将套接字限制到 Tailscale 接口。Linux 内核文档对此有明确说明:IP 地址属于整个主机,而不属于特定接口。从同一服务商网络中的计算机发出、目标为 100.101.102.103 并通过公网接口到达的数据包,仍然可以访问仪表板。若要同时限制接口,请保持 ufw 对入站流量使用默认拒绝策略,并仅通过 sudo ufw allow in on tailscale0 to any port 9119 proto tcp 在网状网络接口上允许该端口。再次使用 ss -lntp | grep 9119 确认监听状态。

绑定地址还会决定身份验证方式,这是很多人容易忽略的部分。在 v2026.8.3 中,绑定到 127.0.0.1 的仪表板即使配置了 public_url,也不会启用登录。在其他任何地址上,身份验证网关都是必需的;如果未配置身份验证提供程序,服务器会拒绝启动。项目将这种行为称为故障关闭。首次运行时,请以交互方式启动它。程序会立即提示您设置用户名和密码,并将其保存为 dashboard.basic_auth,位置为 ~/.hermes/config.yaml。您也可以通过 ~/.hermes/.env 配置相同的提供程序,项目自己的示例就是这样做的:

HERMES_DASHBOARD_BASIC_AUTH_USERNAME=you
HERMES_DASHBOARD_BASIC_AUTH_PASSWORD_HASH=scrypt$16384$8$1$...
HERMES_DASHBOARD_BASIC_AUTH_SECRET=a-long-random-string

使用 openssl rand -base64 32 生成该密钥。这是项目仪表板文档使用的命令(配置注释要求使用 32 个或更多随机字节,并采用 base64 或十六进制格式)。生成后不要再修改它。该密钥用于签署密码提供程序的会话令牌,因此修改后,所有使用该提供程序的设备都会退出登录。同一个文件还保存模型 API 密钥,因此请使用 chmod 600 ~/.hermes/.env 保护其权限。

在信任该配置前,从网状网络中的另一台计算机检查身份验证网关:

curl -s http://100.101.102.103:9119/api/status | jq '.auth_required, .auth_providers'

true 后跟 ["basic"] 表示网关已启用,并且当前响应请求的是密码提供程序。项目文档对该提供程序的定位说明得很直接:它适用于受信任的网络或 VPN,不适合面向公网的仪表板。在网状网络环境中,您正好属于前一种情况。

若要在 tailnet 内使用 HTTPS,下面的 Tailscale Serve 配置要求使用较新的版本,并且该版本的 Host 和 WebSocket Origin 检查支持 public_url。在 v2026.8.3 固定版本上无法使用:环回绑定只接受环回 Host 名称,与 public_url 无关。在该固定版本上,请继续使用上面的直接网状 IP。升级并验证这些检查后,Serve 会将请求代理到此处的环回地址。因此,对于此配置,请将仪表板启动在 127.0.0.1,而不是网状地址上,然后执行:

sudo tailscale serve --bg localhost:9119
sudo tailscale serve status

当前的 Hermes 仪表板文档随后要求使用 tailscale serve status 输出的 HTTPS 来源作为公网 URL:

dashboard:
  public_url: "https://vps.tail1234.ts.net"

没有这一行,仪表板会拒绝 Host 标头中的 MagicDNS 名称。由于该名称不是环回主机,即使后端监听环回地址,身份验证网关仍会启用。Tailscale 会使用为计算机 MagicDNS 名称签发的证书终止 TLS,因此浏览器不再显示警告,且会话 Cookie 会获得 Secure 标志。请先在 Tailscale 管理控制台的 DNS 页面启用 MagicDNS 和 HTTPS Certificates,并在该页面阅读确认信息:您的计算机名称和 tailnet DNS 名称会发布到公开的证书透明度日志中,任何人都可以读取。

这里真正需要权衡的是协调服务器。手机与 VPS 之间的流量始终进行端到端加密,即使经过 Tailscale DERP 中继也是如此;但决定哪些设备属于该网状网络的账户并不存储在您的硬件上。如果这点很重要,可以使用 Headscale,自托管的 Tailscale 控制服务器自行运行控制平面,并通过 tailscale up --login-server https://headscale.example.com 指定客户端连接到它。如果您希望放弃网状网络并手动配置对等端,请参阅纯 WireGuard 与 Tailscale 的比较,了解需要放弃哪些功能。

选项 2:公共 HTTPS 端点,以及其中隐藏的陷阱

有时无法使用网状网络。工作手机可能不允许安装 VPN 客户端。此时,应将仪表板置于反向代理之后。此回环 HTTPS 配置同样需要上文所述的新版公共主机名支持;public_url无法让它在 v2026.8.3 上运行。让仪表板继续监听回环地址,并由 Caddy 管理证书:

hermes.example.com {
  reverse_proxy 127.0.0.1:9119
}

Caddy 会自行获取和续期证书。其 reverse_proxy 会直接转发 WebSocket 升级请求,无需额外指令。仪表板的嵌入式终端需要此功能。使用 nginx 时,必须自行添加 Upgrade 和 Connection 标头。在 nginx 上使用 Certbot 申请 Let's Encrypt 证书介绍了其中的 TLS 配置部分。告诉 Hermes 它的公共名称,使登录回调指向正确的主机:

dashboard:
  public_url: "https://hermes.example.com"

现在来看陷阱。身份验证门控依据的是绑定地址,而不是请求来源地址。当前版本还会在 dashboard.public_url(或 HERMES_DASHBOARD_PUBLIC_URL)指定非回环主机时启用门控,即使后端仍监听回环地址也是如此。因此,上面的设置会启用门控;在配置身份提供商之前,仪表板无法启动。保持 public_url 未设置,门控就会保持关闭,但代理本身不会决定谁可以访问。仪表板还会检查 Host 标头。在此回环配置中,当前版本接受回环名称以及 public_url 声明的主机,其他请求则返回 400。固定版本 v2026.8.3 在此处只接受回环名称,且从不检查 public_url。Caddy 会原样转发浏览器的 Host,因此上方不含 public_url 的代码块会被拒绝,而不会提供服务。危险在于代理重写 Host,将其改为后端地址。nginx 默认会执行此操作,发送 proxy_pass 目标;除非自行设置 proxy_set_header Host。这种请求会通过检查,并访问一个没有登录保护的仪表板。终端的 WebSocket 还会进行 Origin 检查:在该固定版本中,如果存在 HTTP 或 HTTPS Origin 标头,则其目标必须是绑定的主机。这可以阻止来自公共主机名的浏览器请求,但完全不发送 Origin 的脚本仍可通过检查。无论你的配置是什么,都应检查实际发布的内容:

curl -s https://hermes.example.com/api/status | jq '.auth_required'

如果输出 false,则互联网上的任何人只需访问一个 URL,就能打开服务器上的终端。这里不涉及漏洞利用,日志中也不会出现任何异常。如果请求改为返回 400,则说明 Host 检查拒绝了该请求。在支持公共主机名的版本中,应通过设置 public_url 并配置登录提供商来修复,而不是围绕该检查重写标头。在 v2026.8.3 上,应使用直接的网状网络 IP 路由,或先升级。对于开放的仪表板,有两种修复方式,至少应采用一种。可以将身份验证放在代理中,通过 forward auth 在其前面配置 Authentik 作为自托管单点登录提供商;也可以配置仪表板自身的 OIDC(OpenID Connect)提供商:

HERMES_DASHBOARD_OIDC_ISSUER=https://auth.example.com/application/o/hermes/
HERMES_DASHBOARD_OIDC_CLIENT_ID=hermes-dashboard
HERMES_DASHBOARD_OIDC_SCOPES="openid profile email"

即使配置正确,此选项也有无法降低的安全下限。公共登录页面任何人都可以访问和攻击,而其后端是 VPS 上的 shell。用户名和密码对此类入口的保护力度有限,因此文档建议对公共绑定使用 OAuth 或 OIDC。限制登录速率,保持 ufw 仅对代理端口和 SSH 开放,并定期查看访问日志。

选项 3:通过移动终端使用 SSH 和 mosh

这是最省事的方式:在手机上安装终端应用,将 SSH 密钥加载到应用中,然后使用代理自身的文本界面。

ssh you@vps.example.com
tmux new -A -s phone
hermes --tui

tmux new -A -s phone会连接到名为 phone 的会话;如果该会话不存在,则创建会话。这样,即使连接中断,代理也会继续运行;下次连接时,您会回到原来的位置。其模式与通过手机驱动 Claude Code相同。

通过移动网络使用普通 SSH 不够稳定,因为手机切换网络地址或进入休眠时,连接都会断开。mosh 可以解决这个问题。它通过 UDP(用户数据报协议)运行,并同步终端状态,而不是传输字节流。因此,从 Wi-Fi 切换到蜂窝网络时,会话仍可保持:

sudo apt install -y mosh
sudo ufw allow 60000:61000/udp

在手机上运行 mosh you@vps.example.com。mosh 会通过现有的 SSH 登录启动 mosh-server,然后将会话迁移到 60000 到 61000 之间的 UDP 端口,因此需要开放这个端口范围。每个会话只需要一个端口。如果服务器上的并发会话很少,也可以缩小范围,例如仅开放 60000 到 60010。

安全风险很明确。SSH 会话就是 shell,而 shell 可以执行该账户有权执行的所有操作。此时,代理的批准提示就成了被盗且已解锁的手机与您的文件之间的最后一道防线。请为此使用专用的非 root 账户,并且仅使用密钥认证。在将密钥放到随身携带的设备上之前,请先完成VPS 上的 SSH 加固。

移动网络下哪些功能会失效

有 4 种情况,而且没有一种能通过配置修复。

您没有操作时,控制面板会将您登出。 具体时间取决于登录提供方。用户名和密码提供方会签发默认有效期为 12 小时的访问令牌,该期限由 session_ttl_seconds 在 dashboard.basic_auth 下设置。但该值只控制控制面板在后台刷新的频率,不控制登录状态的持续时间。每次刷新都会生成新的 30 天刷新令牌,因此密码登录会持续到连续 30 天未刷新为止。如果未通过 HERMES_DASHBOARD_BASIC_AUTH_SECRET 或 dashboard.basic_auth.secret 配置稳定的签名密钥,后端重启也会结束登录状态,因为 Hermes 每次启动时都会生成新的签名密钥。Nous Portal OAuth 提供方会签发 TTL(生存时间)为 15 分钟的访问令牌,并在后台使用每次都会轮换的刷新令牌续期。因此,单独的访问令牌过期不会将您返回 /login。真正会导致这种情况的是刷新会话丢失。在 v0.21.3 之前的版本(标签 v2026.9.14,发布于 14 September 2026),手机从后台恢复时可能会同时发出多个请求,重放刚刚轮换的刷新令牌,触发提供方的重复使用检测,导致整个会话被撤销。您回到登录界面时,正在输入的内容也会丢失。v0.21.3 会让这些请求共享一次刷新操作。在 Nous Portal 端,刷新会话现在会在每次轮换时延长其 30 天有效期,但连续空闲 30 天仍会使会话结束。如果您一直使用本页顶部的 v2026.8.3 固定版本,请预期偶尔需要强制重新登录。这不是故障。重新登录即可。

默认情况下,嵌入式终端无法在后台标签页中保持运行。 控制面板文档所述的终端连接会在 PTY 后台启动 TUI(文本用户界面),并在标签页关闭时将其正常回收;重新打开时会启动新的终端。移动浏览器会丢弃后台标签页以释放内存,因此切换到其他应用的时间过长会结束该终端。您的聊天历史不会丢失,因为会话存储在服务器上,hermes sessions list 仍会显示这些会话。固定版本的服务器还支持使用附件令牌的可选保活连接,可让已分离的 PTY 保持 30 分钟。如果您需要能够持续保持的会话,请通过 SSH 使用 tmux。

空闲连接会静默断开。 移动运营商会丢弃空闲 TCP 连接,以回收 NAT(网络地址转换)表项;屏幕关闭后,手机也几乎会完全停止处理网络流量。长时间没有数据传输的 WebSocket 通常在您解锁手机时已经断开,页面只有在您触摸屏幕后才会重新连接。这也是 mosh 在手机上比 SSH 使用体验更好的原因:mosh 从未依赖一条可能断开的连接。

不会推送任何通知。 控制面板和 SSH 会话都无法唤醒您的手机。设备上没有 Hermes 应用,因此无法连接到平台的推送服务。长时间运行的代理任务完成后,您只能在下次查看时发现结果。

通知通过消息网关送达

最后一个问题的解决方案是网关。网关提供了完全不同的代理访问方式。hermes gateway可将代理连接到 Telegram、Discord、Slack、WhatsApp、Signal 和电子邮件等消息平台。这样,您可以直接在手机上已有推送通道的应用中与代理通信。应用会处理后台消息投递,也能应对网络中断。

hermes gateway setup
hermes gateway install
hermes gateway status

hermes gateway install会将网关注册为 systemd 服务,因此系统重启后网关会自动恢复。安装程序的网关阶段可以代您执行这一步,但安装程序不会为 hermes dashboard 创建服务单元,因此重启后仪表板不会自动恢复。请为所依赖的组件分别编写服务单元;在 VPS 上编写 systemd 服务和计时器介绍了服务单元文件本身。

计划任务也可以用相同方式推送结果,无需进行对话:

hermes send -t telegram -s "Backup report" -f /home/you/report.txt

这里默认拒绝授权。如果未设置允许列表或已批准的配对,并且 GATEWAY_ALLOW_ALL_USERS 未设置,则所有用户都会被拒绝。这是正确的初始配置。请在 ~/.hermes/.env 中填写需要允许的账户:

TELEGRAM_ALLOWED_USERS=123456789
GATEWAY_ALLOWED_USERS=123456789

您也可以使用基于代码的配对,而不是粘贴数字 ID。对于聊天式 DM 平台,这是默认方式;您也可以在 ~/.hermes/config.yaml 中通过 unauthorized_dm_behavior: pair 显式启用。未知账户向代理发送消息后,会收到一个 8 个字符的代码。在您批准之前,不会发生其他操作:

hermes pairing list
hermes pairing approve telegram ABC12DEF
hermes pairing revoke telegram 123456789

代码在 1 小时后过期。用户每 10 分钟只能请求 1 个代码。5 次尝试失败后,该账户会被锁定。

限制被盗手机的影响范围

能够访问 agent 的手机,也能够在服务器上执行命令,而手机可能丢失。现在就确定持有手机的人可以执行哪些操作。

保持审批功能开启。approvals.mode 的默认值是 smart,它会请求辅助模型评估风险,并仅自动批准低风险命令。将其设置为 off,等同于使用 --yolo 运行所有操作;HERMES_YOLO_MODE=1 则通过环境变量实现相同效果。不要让能够与 agent 通信的手机处于这种状态。设置 approvals.cron_mode: deny,这样计划任务在您休息时无法自行批准操作。

approvals:
  mode: smart
  cron_mode: deny

缩小 agent 可以破坏的范围。terminal.backend: docker 会在容器中运行命令,删除除少量指定能力之外的所有 Linux capabilities,设置 no-new-privileges,并限制进程数量,使容器成为边界,而不是依赖提示词。terminal.cwd 固定工作目录。HERMES_WRITE_SAFE_ROOT 将 write_file 和 patch 限制在您指定的目录内;对这些目录之外的写入会被阻止,且无法通过审批绕过。

export HERMES_WRITE_SAFE_ROOT=/home/you/projects:/home/you/.hermes

Hermes 已经阻止对 ~/.ssh、~/.aws、~/.kube 和 /etc/sudoers 的写入,也会阻止写入其自身的机密存储,例如 ~/.hermes/.env。磁盘其他位置的项目 .env 文件无法读取,但仍可写入。无论审批设置如何,它还会拒绝执行一组固定的破坏性命令。将这些限制视为最低防线,而不是完整方案。使用普通用户运行 agent,绝不要使用 root。相同原则也适用于无人值守运行的其他 coding agent;在 VPS 上安全运行 Claude Code对此有更详细的说明。

然后在需要之前写下撤销步骤。从 Tailscale 管理控制台移除设备后,网状网络访问会立即中断。更改 HERMES_DASHBOARD_BASIC_AUTH_SECRET 并重启后,所有设备上的 password-provider dashboard 会话都会失效,因为该值用于签署 provider 的会话令牌。从 ~/.ssh/authorized_keys 删除手机的 public key 后,使用该密钥的新 SSH 登录会被阻止;现有的 SSH 和 mosh 会话需要单独终止。hermes pairing revoke telegram <user-id> 会删除 messaging account。如果设备上保存了任何能够读取 provider keys 的内容,请使用 hermes auth logout <provider> 撤销这些密钥,并在上游签发新密钥。

检查结果,不要凭猜测判断。以下命令应在您自己的服务器上运行,输出内容取决于您的配置:

tailscale status
hermes pairing list
hermes logs gateway -n 100
hermes status --deep

日志位于 ~/.hermes/logs/ 下。发生安全事件后读取这些日志;没有发生事件时,也应定期读取。

FAQ

Hermes 是否提供适用于 iOS 或 Android 的官方移动应用?

不提供。Hermes 代码库提供命令行界面、Web 控制面板,以及适用于 macOS、Windows 和 Linux 的 Electron 桌面客户端。Hermes 没有官方 iOS 或 Android 构建版本。在手机上,您可以通过浏览器使用 Web 控制面板,使用 SSH 客户端,或通过 hermes gateway 连接消息平台。第三方移动客户端确实存在,但它们属于会持有您代理凭据的第三方代码,因此安装前应先阅读源代码。

为什么 Hermes 控制面板会在手机上将我注销?

这取决于登录提供商。Nous Portal OAuth 提供商签发 TTL 为 15 分钟的访问令牌,并在后台通过轮换刷新令牌续期,因此仅访问令牌过期不会将您重定向到 /login。在 v0.21.3(标签 v2026.9.14)之前的版本中,手机从后台恢复时可能会同时发起多个请求,重放刚刚轮换的刷新令牌,并导致整个会话被撤销,从而强制重新登录。v0.21.3 修复了此问题,但闲置 30 天的刷新会话仍会过期。用户名和密码提供商默认使用 12 小时的访问令牌,由 session_ttl_seconds 设置;该设置只控制控制面板在后台刷新令牌的频率。控制面板通过 30 天的刷新令牌续期,并在每次刷新时重新签发该令牌,因此密码登录不会在 12 小时后结束。使用该提供商时,请将 HERMES_DASHBOARD_BASIC_AUTH_SECRET 设置为稳定的随机值。如果该变量或 dashboard.basic_auth.secret 中没有稳定的密钥,Hermes 会在每次启动时生成新的签名密钥,导致您在每次重启后都被注销。

可以安全地将 Hermes 控制面板放到公网吗?

只有在您自行验证身份验证配置后才可以。身份验证门禁会根据绑定地址启用;在当前版本中,如果 dashboard.public_url 指定了非环回主机,也会启用身份验证。因此,如果控制面板绑定到 127.0.0.1,并位于未设置公网 URL 的反向代理后方,就不会要求登录。在 v2026.8.3 固定版本中,设置 public_url 既不会启用环回身份验证门禁,也不会通过 Host 和 WebSocket Origin 检查允许公网主机名。请使用直接的 mesh IP 路由,或升级到支持公网主机名的版本,然后再配置 HTTPS 代理。其 Host 检查会拒绝转发您公网主机名的代理,但不会拒绝将 Host 重写为后端地址的代理,因为 nginx 默认就是这样处理的。运行 curl -s https://your-host/api/status | jq '.auth_required' 并查看返回结果。请使用 OAuth 或 OIDC,而不是用户名和密码,因为项目文档说明密码提供商适用于受信任网络和 VPN。使用私有 mesh 可以完全避免这一问题,因此更适合作为默认方案。

我需要 Tailscale 账户吗?还是可以自行托管控制平面?

您可以自行托管。Headscale 是 Tailscale 协调服务器的开放实现,官方 Tailscale 客户端可通过 tailscale up --login-server https://headscale.example.com 连接到它。这样,允许加入 mesh 的设备列表由您自行管理。代价是您需要运行并备份该服务器;服务器停止运行期间,您无法注册新设备或重新对设备进行身份验证。

代理完成任务后,如何在手机上收到通知?

请使用消息网关。控制面板和 SSH 都无法唤醒手机,因为设备上没有 Hermes 应用来接收推送通知。通过 hermes gateway setup 将代理连接到 Telegram、Signal、Discord 或其他受支持的平台,然后由该平台自己的应用发送通知。cron 任务也可以通过 hermes send -t telegram -s "Job done" -f /path/to/report.txt 推送一条消息,发送时不会调用模型。

这篇文章对您有帮助吗?