服务器与部署参考

本文讲的是 Web BYOS 流程的技术面:你提供的服务器需要能做到什么、引导安装会在上面放什么、 以及如何检验结果。

具体细节因运行时、应用版本和账号而异。以客户端在安装过程中显示的内容为准; 这里解释的是整个过程的形态,好让你能分辨"真的出问题了"和"这是正常的一步"。

服务器要求

网络要求

出站访问是必需的。 安装期间服务器要从公开来源下载软件包和运行时二进制。 如果主机禁止出站、或者出站被代理拦截,安装会中途失败。

入站端口通常不需要。 当部署使用 Cloudflare Tunnel 时,服务器上会装一个隧道代理, 由它主动向外连接到 Cloudflare;流量经由这条连接到达你的 agent。 在这种配置下,你不需要开放任何入站端口,开了也没有帮助。

安装所运行的服务监听在服务器自己的回环或本地接口上 —— 它们是通过隧道被访问的, 而不是直接暴露到公网。

安装会在服务器上放什么

取决于你选择的运行时和当前流程的版本,安装可能会放置下列组合:

• 一个 agent 运行时 —— 你所选的那个 CLI agent。受支持的有多种,具体出现哪些取决于当前应用和账号。
• 一个网关服务,受支持的客户端通过它连接。
• 一个小型管理服务,用于查看状态、重启等运行时操作。
• 一个隧道代理(当部署使用隧道时),向外建立连接,从而在不开放入站端口的情况下暴露网关。
• 某些配置下还会有一个本地 Web 服务器挡在网关前面。

这些都以系统服务方式运行,因此重启后仍会存活。具体的服务名称因版本而异, 请从安装输出里读取,不要想当然。

验证部署

1. 把安装输出看到结束。 它会报告每一步以及任何失败。 耗时取决于服务器、软件源和网络状况。
2. 确认客户端能连上 agent —— 从受支持的 AgentAura 客户端打开它, 发一个能真正用到你所配置的模型服务商的请求。
3. 确认它能扛住重启。 在主机商控制台重启服务器,然后检查 agent 是否无需人工干预就恢复可用。 这是"它正在跑"和"它已经装好了"之间的区别。

安装失败时

按顺序排查,每一步都会排除掉一部分可能:

1. 服务器真的起来了、并且能接受 SSH 吗? 刚刚创建的服务器可能还没准备好。 这是最常见的原因:主机在控制台里已经存在,但仍在启动、或者还没跑完自己的首次开机初始化。 等一等,先自己 SSH 上去确认,再重试。
2. 凭证在你自己的机器上能用吗? 用同样的地址、端口、用户名和凭证手动连一次。 如果连不上,那问题在凭证或主机商的防火墙,而不是安装流程。
3. 出站流量被允许吗? 如果 SSH 正常、但安装卡在拉取软件包的阶段, 多半是主机在拦截或阻断出站连接。
4. 是不是有别的进程占着包管理器? 云镜像常常在首次开机时跑无人值守升级,这会锁住 apt。 安装流程能容忍一段时间,但一次长时间的升级可能超出它的等待。等服务器安定下来再重试。
5. 发行版真的是 Debian/Ubuntu 系、架构真的是 amd64 吗? 这里不匹配时, 失败的表象往往看起来毫不相关。

日常运行

重新连接过期的凭证。 你为模型服务商配置的凭证可能过期或被吊销。 发生时,即便服务器和各项服务都还在正常运行,agent 也会不再响应请求 —— 这种故障看起来像 agent 坏了,而不像是认证问题。 如果客户端为该 agent 提供了重新连接/重新授权的控件,请使用它; 它会在服务器上刷新凭证,无需重新部署。

更新。 运行时更新应通过客户端里的流程进行,而不是手工去改服务器上的文件。 手动改动已安装的服务,可能会被后续操作覆盖。

服务器始终是你的。 操作系统更新、防火墙规则、存储、备份和删除, 都留在你自己的主机商控制台里。在 AgentAura 里移除一个 agent,不会取消或抹掉那台服务器。

值得了解的边界

• agent 运行时在你的服务器上执行,但这并不意味着每一条数据流都留在本地。 平台服务会参与账号、安装和连接流程。
• 你所选的模型服务商会收到你通过 agent 发送的提示词和回复,并按其自身条款处理。
• 使用隧道时,隧道服务商承载着你的客户端与服务器之间的连接。

---