【免费下载链接】AgentXAgentX 致力于让小白也能无门槛通过自然语言打造属于自己的 Agent。AgentX 采用了自研 MCP 网关模型高可用组件打造高可用项目地址https://gitcode.com/gh_mirrors/agentx/AgentX点击查看免费下载AgentX是一个让小白也能通过自然语言打造专属 Agent 的智能体构建平台内置自研 MCP 网关与模型高可用组件。本文面向新手手把手带你用Docker Compose完成 AgentX 生产环境部署覆盖一键启动、.env安全配置、数据备份与常见故障排查帮助你把 AgentX 稳定地跑在生产服务器上。一、部署前AgentX 架构与运行环境一览生产部署前先花 1 分钟了解 AgentX 由哪些服务组成出问题时才知道该看哪里服务作用生产端口agentx前端 后端Next.js 15 界面 Spring Boot API打包为一体化镜像3000/8088PostgreSQL 15业务数据 向量存储RAG5432RabbitMQ异步消息队列定时任务、RAG 处理等5672/15672管理台API Premium Gateway可选模型高可用网关多 Key 自动容灾8081最低配置建议4 核 8G 内存、50G 以上磁盘、已安装 Docker Docker Compose v2。仓库中与部署相关的核心文件生产环境编排production/docker-compose.yml一键部署配置含开发/生产/外部库三种模式deploy/docker-compose.yml官方部署说明deploy/README.md生产环境配置模板deploy/.env.production.example二、快速上手两条命令启动 AgentX 生产环境方式 1一体化镜像一键启动推荐新手无需下载源码一个docker run命令即可拉起前端、后端、数据库和消息队列# 1. 获取配置模板并修改 cp .env.example .env vim .env # 至少修改 JWT_SECRET、管理员密码、数据库密码 # 2. 一键启动 docker run -d \ --name agentx \ -p 3000:3000 \ -p 8088:8088 \ -p 5432:5432 \ -p 5672:5672 \ -p 15672:15672 \ --env-file .env \ -v agentx-data:/var/lib/postgresql/data \ -v agentx-storage:/app/storage \ -v /var/run/docker.sock:/var/run/docker.sock \ --add-hostlocalhost:host-gateway \ ghcr.nju.edu.cn/lucky-aeon/agentx:latest 镜像采用智能适配设计前端会自动根据浏览器访问的 IP/域名连接后端 API无论本地、内网还是公网服务器都无需改动配置。 AgentX 的容器工作台功能依赖 Docker因此需要挂载/var/run/docker.sock。默认账号生产环境请立即修改管理员adminagentx.ai/admin123测试用户testagentx.ai/test123如需启用 API 高可用功能可额外启动网关容器docker run -d --name agentx-gateway -p 8081:8081 ghcr.io/lucky-aeon/api-premium-gateway:latest方式 2Docker Compose 源码部署适合需要二次开发或升级镜像的版本控制git clone https://gitcode.com/gh_mirrors/agentx/AgentX cd AgentX/deploy ./start.sh production # 生产模式也可选 local / external / dev四种部署模式的区别见 deploy/README.mdproduction内置库中小型生产、external外部 PostgreSQL大型生产、local开发调试、dev开发 Adminer 管理界面。三、安全配置生产环境必改的 5 个关键项.env是所有配置的核心。官方模板 deploy/.env.production.example 已按生产场景预置启动前请逐项确认#配置项说明1JWT_SECRETJWT 密钥至少 32 位随机字符串必改2AGENTX_ADMIN_PASSWORD管理员密码建议同时修改AGENTX_ADMIN_EMAIL为你的域名邮箱3DB_PASSWORDPostgreSQL 密码必改4RABBITMQ_PASSWORD消息队列密码必改5AGENTX_TEST_ENABLEDfalse生产环境务必禁用内置测试账号其他生产加固项模板中已默认开启SPRING_PROFILES_ACTIVEprod JPA_DDL_AUTOvalidate # 校验表结构避免运行时意外改表 SHOW_SQLfalse LOG_LEVEL_ROOTwarn # 降低日志量 LOG_LEVEL_APPinfo NEXT_PUBLIC_API_BASE_URLhttps://your-domain.com/apiJPA_DDL_AUTOvalidate是生产部署的一个重要细节首次启动会自动建表之后若直接改表结构validate 模式会让启动直接报错而不是静默修改数据。网络安全三件套HTTPS在 Nginx 等反向代理上配置 SSL 证书只对外暴露 80/443 端口收紧端口5432数据库、15672MQ 管理台仅允许内网访问通过防火墙或POSTGRES_PORT等环境变量避免暴露到公网最小权限应用镜像默认以非 root 用户运行数据库启用scram-sha-256认证相关定义可见 docker/backend/Dockerfile 与 production/docker-compose.yml。四、数据管理备份、恢复与卷说明所有数据都存放在 Docker volumes 中备份只需关注三处卷名内容postgres-data一体化镜像为agentx-data数据库数据最重要rabbitmq-data消息队列数据storage-data一体化镜像为agentx-storage用户上传文件# 备份数据库 docker exec agentx-postgres pg_dump -U agentx_user agentx agentx-backup.sql # 恢复数据库 docker exec -i agentx-postgres psql -U agentx_user agentx agentx-backup.sql⚠️ 使用外部 PostgreSQL 模式时需先手动执行初始化脚本 docs/sql/01_init.sql 建库建表。建议为备份加上定时任务如 crontab 每天凌晨执行一次pg_dump并将备份文件异地存放。五、故障排查AgentX 常见问题快速定位清单症状排查命令解决方案页面打不开docker compose ps查看状态确认容器Updocker compose logs -f agentx-backend看报错端口冲突lsof -i :3000/lsof -i :8088在.env中修改FRONTEND_PORT、BACKEND_PORT等后重启后端反复重启docker compose logs postgres数据库未就绪或密码错误核对DB_PASSWORD数据库连不上docker exec agentx-postgres pg_isready -U agentx_user检查DB_HOST/DB_PORTexternal 模式确认网络可达配置不生效docker compose config校验 YAML 语法与变量拼写重启容器使新.env生效响应变慢docker stats看资源占用调整 JVM 参数默认-Xmx1024m与连接池大小日常运维命令速查docker compose ps # 查看服务状态 docker compose logs -f agentx-backend # 跟踪后端日志 docker compose restart agentx-backend # 重启单个服务 docker compose down # 停止全部服务健康检查接口可直接用浏览器或 curl 验证http://服务器IP:8088/api/health接口实现见 AgentX/src/main/java/org/xhy/interfaces/api/HealthController.java。六、总结生产上线检查清单 ✅已修改JWT_SECRET、管理员/数据库/MQ 密码禁用测试账号通过 Nginx 配置了 HTTPS数据库与管理端口未暴露公网配置了每日数据库备份并验证过恢复流程docker compose ps全部Up/api/health返回正常日志级别调为warn/info确认SHOW_SQLfalse可选部署 API Premium Gateway 并开启HIGH_AVAILABILITY_ENABLEDtrue获得多 Key 模型高可用按这份清单走完你的 AgentX 平台已经具备了生产级部署的核心要素。更多架构细节可参考 docs/develop_document.md。赞分享【免费下载链接】AgentXAgentX 致力于让小白也能无门槛通过自然语言打造属于自己的 Agent。AgentX 采用了自研 MCP 网关模型高可用组件打造高可用项目地址https://gitcode.com/gh_mirrors/agentx/AgentX点击查看免费下载相关推荐react-materialize完全指南用Material Design打造React应用的终极方案react materialize完全指南用Material Design打造React应用的终极方案 react materialize是一个基于MaterUI库/组件前端终极Django-Storages部署指南生产环境最佳实践与故障排除全攻略终极Django Storages部署指南生产环境最佳实践与故障排除全攻略 Django Storages是一个功能强大的Django扩展库它为Django后端对象存储Rack-Throttle终极指南如何在Rails应用中实现HTTP请求速率限制Rack Throttle终极指南如何在Rails应用中实现HTTP请求速率限制 Rack Throttle是一款强大的Rack中间件专为限制HTTP请求速创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考