AgentAura 网页快速入门

连接一台您已在运行的 Linux 服务器，选择代理向其模型进行身份验证的方式，然后进行部署——本指南包含流程所需的具体字段和命令。

网页快速入门

网页流程会将一个 AI 代理运行时安装到一台您已有的服务器上。它不创建、销售或管理该服务器。

这就是整个流程的形态，值得坦率地说明：提供商选择器已从网页部署流程中移除。没有“选择 Hetzner，挑选规格”这样的步骤。您需要提供地址和凭据；AgentAura 会通过 SSH 将其安装到您的服务器上。

原生应用构建版本可能提供与网页版不同的部署选项。本页面仅描述网页流程。请遵循您面前的应用实际显示的步骤。

一台由您管理的 Linux 服务器。 Debian 或 Ubuntu 系列——安装过程使用 apt 并安装 .deb 软件包，因此没有这些工具的发行版将无法工作。Ubuntu 22.04 和 24.04 是构建和运行所针对的版本。

管理员 SSH 访问权限。 您需要提供地址、用户，以及密码或私钥。支持非默认端口。

该服务器的出站互联网连接。 通常不需要入站端口：部署会建立一个 Cloudflare Tunnel，因此无需在防火墙中打开任何端口即可访问网关。如果您发现自己需要打开入站端口来解决连接问题，请先检查您的部署是否使用了隧道——打开端口会增加风险，但无法解决根本原因。

模型的凭据。 可以是 API key，也可以是 subscription 登录信息。详情如下，因为这是人们容易出错的步骤。

您仍然对服务器负责：包括其账单、SSH 访问、防火墙、操作系统更新、存储、备份和生命周期。AgentAura 只是将软件安装到服务器上，并不会接管任何这些责任。

这里没有公布固定的最低要求，因为坦率地说，这取决于您运行哪个代理以及您要求它做什么。一个小实例足以进行尝试；一个构建软件的代理比一个回答问题的代理需要更多内存。从小处着手——您可以随时调整其大小。

打开 AgentAura 并登录。在开始部署前，请完成显示的任何验证步骤。

这是最重要的选择，有两种不同的类型。

您直接向模型提供商按使用量付费。目前在网页流程中提供的选项有：

代理使用您已付费的账户登录，而非使用 API key。

Claude Code — 使用来自您 Claude subscription 的 OAuth 令牌，而非 API key。在您自己的机器上生成它：
```
claude setup-token
```
该命令会打印一个以 sk-ant-oat01-… 开头的令牌。将其粘贴到 AgentAura 中。这是 Claude Code 部署的默认路径。
Codex — 使用您的 ChatGPT 账户。从您已登录 Codex 的机器上，粘贴 ~/.codex/auth.json 文件的全部内容。

这两种都是账户凭据，而非限定范围的 API key。请像对待该账户的密码一样对待它们，并且在需要时重新生成而不是分享它们。

API-key 字段每次都刻意留空，绝不会从已保存的值中预先填充。静默地重新部署一个过期的密钥比输入一个新密钥更糟糕。密钥也可以在部署后设置。

部署表单需要填写以下信息：

您之前使用过的服务器可以被保存并重新选择，无需重新输入。

开始部署并在运行时阅读其输出。它会报告每一步以及任何失败。这是这里最有用的习惯：一个在第三步失败的部署会告诉你原因，而一个你没有观察的部署事后看起来就只是坏了。

完成后，从客户端打开代理并确认它有响应。一个已完成安装但没有任何客户端能连接上的部署，不算是一个完成的部署。

一个账户对应一个子域名。将另一个代理部署到您已设置好的服务器上，会将其添加到该服务器，并重用现有的子域名和隧道，而不会配置任何新东西。

应用商店的定价与网页版不同。您面前的结账或购买页面决定了最终价格和计费周期。服务器托管和模型使用是独立的费用，由这些提供商向您收取——它们不属于此处的任何套餐。请参阅定价。

部署中途失败。 阅读它停止的步骤。最常见的原因是 SSH 问题：端口错误、用户没有安装权限，或者在服务器期望密码时使用了密钥认证。

已安装但客户端无法连接。 检查隧道而不是您的防火墙。在这里，打开入站端口几乎永远不是解决方法。

代理响应身份验证错误。 模型凭据已过期或被拒绝。特别是 Subscription 令牌会过期——使用 claude setup-token 生成一个新的并重新设置。