三步装起来
部署服务端，装 Agent，接上你的 AI 助手。
# 1. 部署服务端
$ docker load -i argus-trial-images.tar
$ ./argus.sh up
# 2. 在现场机器上安装 Agent（控制台生成安装链接）
# 3. 把 Argus 接入你的 AI 助手
$ claude mcp add --transport http argus http://你的服务器地址:8080/api/mcp第一步
部署服务端
Docker
获取部署包
Docker Hub 镜像
服务器能上网时用。一条命令拉取。
镜像地址开放后在这里给出。
离线包
服务器不能上网时用。下载后导入。
下载地址开放后在这里给出。
需要准备：一台装好 Docker 的服务器，现场机器能主动连到它。部署包已包含数据库、对象存储和网页入口。
注意：Argus 没有默认的管理员账号。你在第 4 步创建管理员账号。
第 1 步和第 2 步的命令：
# 导入镜像
docker load -i argus-trial-images.tar
# 启动（首次会自动生成密钥和证书）
./argus.sh up
- 导入镜像。
- 启动服务端。
- 用浏览器打开
http://服务器地址:8080。 - 按首启向导填访问地址、创建管理员账号、生成证书。
- 登录控制台。
- 配置发信邮箱：在系统设置里填 SMTP。Argus 用它发登录验证码和 AI 高危操作的验证码。如果不配置，L2 和 L3 工具不能用。
默认端口
| 端口 | 用途 |
|---|---|
| 8080 | 控制台和接口的入口 |
| 29443 | Agent 接入端口，现场机器主动连它 |
常用命令
| 命令 | 作用 |
|---|---|
./argus.sh up | 启动 |
./argus.sh down | 停止，数据保留 |
./argus.sh status | 查看各服务状态 |
./argus.sh logs | 查看日志 |
./argus.sh restart | 重启 |
./argus.sh recert | 服务器换 IP 或加域名后重签证书，已装的 Agent 不掉线 |
第二步
安装 Agent
Windows / Linux / macOS
- 用管理员账号在控制台的「系统设置 → Agent 安装」里创建安装链接。
- 在现场机器上打开这个链接。
- 选择操作系统，下载安装包。
- 运行安装脚本。
- 按提示粘贴页面上显示的 6 位安装码。
脚本把 Agent 注册成系统服务并启动。之后这台机器出现在控制台里。
| 系统 | 安装后的运行方式 |
|---|---|
| Windows | 系统服务 |
| Linux | systemd 服务 |
| macOS | launchd 服务 |
安装链接可以设置有效期、最多可用次数和审批方式。审批方式有两种：
- 自动通过：适合自己的机器。
- 管理员批准：机器先进入待批准列表，管理员批准后上线。适合装在别人环境里的机器。
现场机器不需要开放入站端口，Agent 主动连到你的服务器。
如果机器不能上外网，用 U 盘把安装包拷过去安装。这台机器要连得到你的服务器。
第三步
接入 AI 助手
Argus 的 MCP 地址是 http://你的服务器地址:8080/api/mcp。支持 MCP 协议的客户端都可以接入，包括 Claude Code、Claude Desktop 和 Cursor。
Claude Code
claude mcp add --transport http argus http://你的服务器地址:8080/api/mcp
说明：默认是 HTTP。要用 HTTPS，请自己在前面配反向代理和证书。
两种登录方式
- 浏览器授权（OAuth）：Claude Desktop、Cursor 这类客户端用这种方式。第一次使用时，客户端打开 Argus 的授权页面，登录并同意后即可使用。
- MCP Key：在控制台的「设置 → MCP → 我的 Keys」里创建一个 Key，填进客户端的配置。用成员账号建这把 Key。Key 只在创建时显示一次。
接入后，AI 助手能看到的机器和能用的工具，由这个账号所在工作组的权限决定。
首次 L2 / L3 验证是什么样
Argus 把每个 MCP 工具按风险分为三级。L1 只读，直接执行。
AI 助手调用 L2 或 L3 工具时，Argus 把 6 位验证码发到操作者本人的邮箱。把验证码告诉 AI 助手，这次调用才执行。完整过程见 AI 闸门。
每一次调用都记入审计。在「设置 → MCP」里可以查看自己的请求历史。
常见安装问题
启动时提示端口被占用怎么办？
改部署目录 .env 里对应的端口项，再执行 ./argus.sh up。控制台入口默认是 8080，Agent 接入端口默认是 29443。
服务器换了 IP 或者加了域名，Agent 连不上了怎么办？
把新地址写进 .env 的 ARGUS_SERVER_ADDRS，执行 ./argus.sh recert。这个命令只重签服务器证书，已装的 Agent 不用重装。
停止服务会不会丢数据？
./argus.sh down 只停止服务，数据保留在数据卷里。备份或迁移时，要带上部署目录里的 .env。它保存着数据库和对象存储的密钥，丢了就打不开原来的数据。
AI 说验证码已发出，但邮箱里没有收到？
先检查系统设置里的 SMTP 是否填对并能发信，再看垃圾邮件箱。验证码发到当前操作账号自己的邮箱。
现场机器在客户内网，没有公网地址，能装吗？
能。Agent 主动向外连接。这台机器只要能访问你的服务器的 Agent 接入端口，就能装。
Agent 支持哪些系统？
Agent 支持 Windows、Linux 和 macOS。AI 助手操作桌面界面的能力目前只在 Windows 上提供（仅 Windows）。