1. 为什么 Hermes Agent 部署完第一件事不是接模型而是加固服务器Hermes Agent 这类常驻型智能体有个特点它需要长期在线、需要读写文件、需要调用外部 API很多玩家会把它直接跑在一台公网 VPS 上。问题就出在这里——一台默认配置的 Linux 服务器暴露在公网22 端口每天被扫描几千次是常态密码登录被撞库、SSH 被爆破、Agent 的配置文件被读取这些都不是危言耸听。我见过太多人把 Hermes Agent 跑起来之后注意力全在模型能不能通、技能库怎么装结果服务器本身是「裸奔」状态。聊天记录、API Key、config.toml里的通道凭据全都躺在一个随时可能被攻破的环境里。所以这篇教程的顺序是反过来的先把服务器安全基线做扎实再谈 TaoToken 的接入配置。这篇会围绕三项必做防护展开——SSH 端口与密钥登录、UFW 防火墙、Fail2Ban 自动封禁每一项都给可复制的配置骨架和验证命令。然后在这个安全底座上交付 Hermes Agent 的config.toml与settings.json配置骨架以及 TaoToken 统一 Key/API 通道的接入与验证步骤。适合已经部署完 Hermes Agent、准备把它长期挂在服务器上的读者也适合任何一台公网 Linux 机器的持有者。三项防护的核心逻辑很简单SSH 决定「谁能进来」UFW 决定「哪些门开着」Fail2Ban 决定「反复试探的人怎么处理」。三者叠加能挡掉绝大多数无差别自动化攻击。2. TaoToken 前置准备统一 Key 与 API 通道在动服务器配置之前先把模型通道这块理清楚因为后面的config.toml骨架需要填这些值。TaoToken 的作用是把多个模型的调用收敛到一个统一的 Key 和 API 地址上Hermes Agent 只需要认一个入口不用为每个模型单独维护一套凭据。你需要准备的东西一个 TaoToken 账号登录后进入控制台在控制台里创建一个 API Key这个 Key 就是 Hermes Agent 的通行证记住 API 基础地址https://taotoken.net/api控制台地址是https://taotoken.net/consoleAPI Key 管理页面在https://taotoken.net/api-keys。创建 Key 的时候建议按用途命名比如hermes-agent-prod这样以后要轮换或者吊销时不会误伤其他服务。注意API Key 只显示一次创建后立刻复制保存到密码管理器里。不要把它写进会提交到 Git 仓库的文件.env这类文件要加进.gitignore。如果你还没决定用哪个模型可以先到模型对话页面https://taotoken.net/models试一下不同模型的响应风格确认哪个适合你的 Agent 场景再回到控制台创建对应权限的 Key。对于长期跑编码类任务的 Agent可以关注 Coding Plan 相关的额度方案避免按次调用把成本跑飞。拿到 Key 之后先别急着写进 Hermes Agent用一条 curl 命令确认通道是通的curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ | head -c 500预期返回一个 JSON里面包含可用模型列表。如果返回 401说明 Key 没填对或者被吊销了如果超时检查服务器出站网络是否被 UFW 拦了后面配置 UFW 时会专门放行出站。3. 可复制配置SSH、UFW、Fail2Ban 三项加固这一章是全文的核心每一项都给完整命令和配置骨架。操作前请务必在云厂商控制台创建一次快照或者确认你能通过 VNC/救援模式登录。整个过程中不要关闭当前 SSH 窗口所有验证都在另一个终端里做。3.1 SSH 改端口 禁用密码登录第一步备份现有 SSH 配置sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak.$(date %F)第二步选一个 20000–65535 之间的高位端口比如39221。先确认它没被占用sudo ss -tlnp | grep 39221没有输出说明端口空闲。然后编辑/etc/ssh/sshd_config修改或新增这几行Port 39221 PubkeyAuthentication yes PasswordAuthentication no PermitRootLogin prohibit-password先别急着重启 SSH。在云厂商安全组里放行39221同时暂时保留 22 端口然后用sshd -t检查语法sudo sshd -t echo config ok输出config ok才继续。重新加载服务sudo systemctl reload sshd sudo ss -tlnp | grep -E 39221|:22预期看到 39221 正在监听。此时新开一个终端用新端口登录测试ssh -p 39221 youruseryour-server-ip登录成功、确认密钥认证生效后再回到原窗口把 22 端口从配置和安全组里移除。回滚方法把sshd_config.bak.*覆盖回去systemctl reload sshd即可。如果你还没有密钥对在本地生成 Ed25519ssh-keygen -t ed25519 -C hermes-agent ssh-copy-id -p 39221 youruseryour-server-ip私钥永远留在本地只把公钥传到服务器。3.2 UFW 防火墙配置骨架UFW 的原则是「默认拒绝入站、允许出站」然后按需放行。配置前先看清楚当前业务端口别把正在用的服务关在门外sudo ss -tlnp假设你的 Hermes Agent 只对外提供 SSH那么放行规则就是sudo ufw default deny incoming sudo ufw default allow outgoing sudo ufw allow 39221/tcp comment ssh-new-port sudo ufw allow 443/tcp comment https-outbound-related sudo ufw enable sudo ufw status verbose预期输出里能看到Status: active以及你放行的端口列表。这里有个坑ufw enable会提示可能中断现有 SSH 连接如果你已经放行了新端口直接确认即可如果还没放行就 enable当前连接会断。注意出站方向默认允许所以 TaoToken 的 API 调用不会被 UFW 拦。如果你之前手动设过出站拒绝规则记得放行 443。回滚方法sudo ufw disable或者sudo ufw delete allow 39221/tcp删掉单条规则。3.3 Fail2Ban 保护 SSH 端口Fail2Ban 监控日志发现某个 IP 反复试错就自动封禁。安装sudo apt update sudo apt install -y fail2ban新建/etc/fail2ban/jail.local写入[DEFAULT] bantime 1h findtime 10m maxretry 5 backend systemd [sshd] enabled true port 39221 logpath %(sshd_log)s这里的maxretry5、findtime10m、bantime1h就是「10 分钟内错 5 次封 1 小时」。重启并检查sudo systemctl restart fail2ban sudo fail2ban-client status sshd预期输出里Currently banned和Total banned会有数字File list指向你的 SSH 日志。想看某个 IP 是否被封sudo fail2ban-client status sshd | grep Banned手动解封sudo fail2ban-client set sshd unbanip 1.2.3.4。4. Hermes Agent 配置骨架与验证请求服务器加固完成后回到 Hermes Agent 本身。下面是config.toml的骨架重点是模型通道部分指向 TaoToken[server] host 127.0.0.1 port 8787 [model] provider openai-compatible base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY default_model your-preferred-model [security] allow_shell false allowed_paths [/root/hermes-wiki, /root/.hermes/skills]对应的settings.json骨架{ agent: { name: hermes-agent, profile: default }, model: { base_url: https://taotoken.net/api, api_key_env: TAOTOKEN_API_KEY, timeout_seconds: 60 }, logging: { level: info, path: /root/.hermes/logs } }把 Key 写进环境变量而不是配置文件echo export TAOTOKEN_API_KEYsk-你的key ~/.bashrc source ~/.bashrc验证通道是否打通用一条最小请求curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: your-preferred-model, messages: [{role: user, content: ping}] } | head -c 300预期返回包含choices字段的 JSON。如果 Hermes Agent 启动后报模型不可用先跑这条 curl能区分是通道问题还是 Agent 配置问题。5. 本篇常见错排查SSH 改端口后连不上九成是安全组没放行新端口或者sshd_config里Port写了两行导致只生效一个。用sshd -t检查用ss -tlnp确认监听。别关旧窗口这是保命线。UFW enable 后当前连接断开说明你 enable 之前没放行 SSH 端口。通过云控制台 VNC 进去ufw allow 39221/tcp再ufw reload。Fail2Ban 显示 banned 但 IP 还能连检查jail.local里的port是否和实际 SSH 端口一致端口写错会导致规则匹配不上。另外确认backend systemd和你的系统日志方式匹配。TaoToken 返回 401Key 没生效。确认echo $TAOTOKEN_API_KEY有值且没有多余空格或引号。如果是在 systemd 服务里跑 Hermes Agent环境变量要在 service 文件里用Environment单独声明~/.bashrc对它不生效。TaoToken 返回超时先curl -v https://taotoken.net/api/v1/models看卡在哪一步。如果是 UFW 出站被限制sudo ufw allow out 443/tcp。如果是 DNS 问题检查/etc/resolv.conf。Hermes Agent 读不到配置确认config.toml和settings.json在 Agent 的工作目录下且权限是600属主是运行 Agent 的用户。权限过宽有些框架会直接拒绝加载。6. 后续怎么走把通道和额度管起来服务器三项防护做完你的 Hermes Agent 就有了一个相对干净、可控的运行底座。接下来真正影响长期体验的是模型通道的稳定性和额度管理。如果你还在选模型阶段建议先到模型对话页面实际跑几轮确认响应质量和延迟符合预期再固化到config.toml里。地址是https://taotoken.net/models。如果你的 Agent 要长期跑编码、自动化任务这类高频调用场景按次计费容易失控可以了解一下 Coding Plan 的额度方案把成本锁在可预期范围内。入口在https://taotoken.net/coding-plan。日常管理 Key、查看用量、轮换凭据都在控制台完成https://taotoken.net/console。Key 的创建和吊销在https://taotoken.net/api-keys。接入过程中遇到参数问题文档里有完整的字段说明https://taotoken.net/doc。最后提醒一句安全加固不是一次性动作。每次改 SSH 配置、加新服务端口、装新依赖都回头看一眼 UFW 规则和 Fail2Ban 状态。我自己的习惯是每月跑一次sudo ufw status verbose和sudo fail2ban-client status sshd确认规则没被意外改动。这个习惯比任何一次性配置都管用。
