Super Agent Party Docker部署完全指南：登录网关与API Key管理轻松搞定
【免费下载链接】super-agent-party⭐全能型AI伴侣！AI桌面女友 + AI虚拟主播 + AI即时通讯机器人 + AI浏览器 + AI智能家居 + AI游戏 等你能想到的一切功能！项目地址: https://gitcode.com/heshengtao/super-agent-party
Super Agent Party（SAP）是一款全能型AI伴侣，集 AI桌面女友、AI虚拟主播、AI即时通讯机器人、AI浏览器、AI智能家居 等功能于一体。本文带你完成它的Docker部署：从最简单的单容器一键启动，到带登录网关的 Compose 双容器方案，再到 API Key 管理与 OpenAI 格式接口调用，一篇讲透。
为什么 Docker 是最省心的启动方式？
SAP 对硬件要求极低：CPU 2核、内存 2GB 即可流畅运行（官方在 2核2G 的云服务器上实测通过）。原因在于所有模型均可选——你可以调用本地推理引擎，也可以全部走云端 API。
Docker 镜像已把 Python 3.12、Node.js 20 等全部依赖打包完毕，无需配置任何运行环境，拉取镜像即可运行。镜像定义见 Dockerfile。
一键启动：单容器部署（无登录网关）
如果部署在自己电脑上或内网环境，最简单的方式是单容器运行：
docker pull ailm32442/super-agent-party:latest docker run -d -p 3456:3456 -v ./super-agent-data:/app/data ailm32442/super-agent-party:latest启动后访问http://localhost:3456/即可使用。
⭐ 注意：./super-agent-data可换成任意本地文件夹，Docker 启动后所有数据都会缓存在这个文件夹中，不会上传到任何地方。
Docker Compose 部署：多一个登录网关，安全翻倍
如果打算把 SAP 部署到公网服务器，强烈建议使用 Compose 方案。它会自动启动两个容器：
| 容器 | 作用 |
|---|---|
sap-backend | 后端服务，不对外暴露端口，只被网关访问 |
sap-gateway | 登录网关，对外暴露 3456 端口，负责登录鉴权 |
部署步骤：
git clone https://gitcode.com/heshengtao/super-agent-party cd super-agent-party docker-compose up -d⭐ 默认账号是root，默认密码是pass，首次登录后请尽快修改密码。
网关的关键配置项都在 docker-compose.yml 中：
JWT_SECRET：登录令牌签名密钥，请务必改成一串随机字符串INIT_USER/INIT_PASS：初始账号密码FORCE_RESET：忘记密码时设置为true重启容器，密码会重置为 root/pass，重置完记得改回./gateway-data：持久化保存你修改后的密码状态
API Key 管理：给 AI 换"大脑"
Docker 版本默认不内置任何大模型，你需要在设置里填入自己购买的模型 API Key（各大云厂商或中转服务均可）。配置好 base_url 和 API Key 后，AI 桌面女友、虚拟主播、IM 机器人等全部功能即刻生效。
把 SAP 当 API 用：完全兼容 OpenAI 格式
部署完成后，SAP 还会暴露一套兼容 OpenAI 格式的接口，把你自己养的 AI 伴侣直接接进任何项目里，无需修改调用代码：
from openai import OpenAI client = OpenAI( api_key="你的API密钥", base_url="http://localhost:3456/v1" )此外还支持通过http://127.0.0.1:3456/mcp调用本地 MCP 服务，让其他 AI 工具直接指挥你的 SAP。
小结
- 🐳内网/自用→ 单容器
docker run，一条命令启动 - ☁️公网部署→
docker-compose up -d，自带登录网关 - 🔑模型能力→ 填入云端 API Key，或接入本地推理引擎
- 📡对外调用→ 兼容 OpenAI 格式的
/v1接口 + MCP 服务
更多细节可参考项目文档 README.md。
【免费下载链接】super-agent-party⭐全能型AI伴侣！AI桌面女友 + AI虚拟主播 + AI即时通讯机器人 + AI浏览器 + AI智能家居 + AI游戏 等你能想到的一切功能！项目地址: https://gitcode.com/heshengtao/super-agent-party
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
