如何快速自部署Routa：Docker Compose一键搭建团队级AI多Agent协作平台完整指南-北京尧图网络

【免费下载链接】routaWorkspace-first multi-agent coordination platform for AI development, with shared Specs, Kanban orchestration, and MCP/ACP/ A2A support across web and desktop.项目地址https://gitcode.com/gh_mirrors/ro/routa点击查看免费下载Routa 是一个 Workspace 优先Workspace-first的 AI 多 Agent 协作平台支持共享 Spec、Kanban 看板编排以及 MCP / ACP / A2A 协议同时覆盖 Web 与桌面端。想让团队共享一个 Routa 实例通过 Docker Compose 一键搭建是最快的路径——无需本地安装 Node 环境一条命令即可在服务器或本机拉起服务几分钟后就能通过浏览器访问完整的看板与多 Agent 会话界面。本文面向新手和普通用户带你完成 Routa 自部署的完整流程。一、Routa 自部署前的准备工作部署开始前确认你的机器满足以下条件条件说明Docker Docker Compose需要较新版本 Compose配置文件使用了profiles与required: false等特性端口默认占用3000Web 服务PostgreSQL 模式额外占用5432磁盘空间镜像构建约需 3~5 GB建议预留 10 GBRouta 仓库中已内置完整的容器化部署文件核心只有两个docker-compose.yml服务编排文件定义了应用、数据库、迁移三个服务Dockerfile多阶段构建基于node:22-alpine最终运行一个精简的 standalone 生产镜像值得留意的是Dockerfile 还特意在镜像里安装了git和ca-certificates因为 Web 端的仓库克隆功能/api/clone接口依赖容器内的git clone/git pull所以你部署后可以直接在界面里克隆远程仓库。二、获取代码并一键启动SQLite 默认模式第 1 步克隆仓库git clone https://gitcode.com/gh_mirrors/ro/routa cd routa第 2 步启动服务docker compose up -d --build就这么简单。docker-compose.yml 中的默认配置使用SQLite 数据库ROUTA_DB_DRIVERsqlite数据存放在容器内/app/data/routa.db并挂载到名为routa_data的 Docker 卷中——不需要任何外部数据库。第 3 步验证服务健康Compose 文件已内置健康检查你可以随时查看服务状态docker compose ps curl http://localhost:3000/api/health看到{status:ok,timestamp:...}的响应对应实现见 src/app/api/health/route.ts就说明 Routa 已成功运行。三、生产级部署启用 PostgreSQL 数据库SQLite 模式适合小团队和快速试用。如果是多用户的团队级部署建议启用随 Compose 文件捆绑的 PostgreSQL 16docker compose --profile postgres up -d --build这会在 docker-compose.yml 中额外启动两个服务migrate一次性容器启动前自动执行数据库结构同步db:pushpostgrespostgres:16-alpine带健康检查数据落在postgres_data卷中生产环境必改项——创建.env文件修改数据库密码默认密码是routa_secret见 docker-compose.ymlPOSTGRES_PASSWORD你的强密码如果你的团队已有外部 PostgreSQL 实例也可以直接指定连接串跳过捆绑的数据库DATABASE_URLpostgresql://用户:密码你的主机:5432/库名 ROUTA_DB_DRIVERpostgres 小贴士应用服务带有restart: unless-stopped策略服务器重启后服务会自动恢复。四、部署完成后打开界面创建团队工作区启动成功后浏览器访问http://localhost:3000你会看到 Routa 的 Kanban 看板界面——这就是团队共享任务与 Agent 编排的核心面板看板上可以直观看到每张任务卡片的执行状态、负责该任务的 Agent 角色如 CRAFTER、CRAFT 等以及所使用的 Provider。顶部还显示了 Kanban 健康度、运行中/排队中的会话数方便团队随时掌握整体进度。部署后建议按以下顺序完成首次配置更多细节参考快速开始文档创建 Workspace工作区是 Routa 的核心组织单元团队共享同一个工作区启用一个 Provider进入Providers配置一个可用的 AI 提供方即可不需要全部配置挂载仓库关联团队代码仓库支持界面内直接克隆远程仓库启动 Session从一次简单的会话开始例如让 Agent 解释仓库架构确认链路完全打通五、配置 AI Provider环境变量与界面两种方式Routa 支持多种 AI 提供方接入团队部署时最常用的方式是在容器里注入 API Key。修改 docker-compose.yml 中app服务的environment段添加你使用的变量即可环境变量作用ANTHROPIC_API_KEY启用 Claude 系模型OPENAI_API_KEY启用 OpenAI 系模型CODEX_API_KEY启用 Codex 流程OPENCODE_SERVER_URL/OPENCODE_API_KEY启用 OpenCode SDK 执行路径完整变量说明可参考环境变量文档和提供方与模型文档。官方建议很实际只配置你实际使用的提供方一个可用的 Provider 就足够跑起来。你也可以不碰环境变量直接在 Web 界面的Providers页面填写凭据——两种方式等效。六、会话追踪确认多 Agent 在协同工作会话跑起来后左侧的 Traces 入口是验证部署质量的最好方式——它可以浏览和分析所有 Agent 执行轨迹左侧列出全部历史会话图中示例已有 433 个点击任意会话可以展开完整时间线用户指令、Agent 的每一次工具调用Bash、Read、Edit、MCP 工具等都清晰可查。对于团队管理者来说这是排查 Agent 行为、审计执行过程的关键面板。七、数据持久化与日常运维速查数据都存在哪里SQLite 模式routa_data卷容器内/app/data/routa.dbPostgreSQL 模式postgres_data卷常用运维命令# 查看服务状态 docker compose ps # 查看应用日志 docker compose logs -f app # 升级拉取新代码后重建 git pull docker compose up -d --build常见问题速查症状排查方向服务反复重启docker compose logs app查看启动错误确认 3000 端口未被占用PostgreSQL 模式启动失败检查.env中POSTGRES_PASSWORD是否已设置确认 migrate 服务已成功退出界面无法克隆仓库容器内需可访问远程仓库网络镜像已内置 git检查出站网络策略总结三步完成团队级部署回顾一下整个流程Routa 的自部署其实只有三步git clonedocker compose up -d --buildSQLite 模式最快路径需要生产级数据库时加--profile postgres并在.env中修改密码浏览器访问http://localhost:3000创建 Workspace、配置 Provider、挂载仓库至此一个团队共享的 AI 多 Agent 协作平台就上线了看板驱动任务编排Spec 保持上下文共享MCP / ACP / A2A 协议支撑 Agent 间通信。更多使用方式可以参考使用 Routa 文档和自托管文档把团队真正带入 AI 协作时代。赞分享【免费下载链接】routaWorkspace-first multi-agent coordination platform for AI development, with shared Specs, Kanban orchestration, and MCP/ACP/ A2A support across web and desktop.项目地址https://gitcode.com/gh_mirrors/ro/routa点击查看免费下载相关推荐OpenProject快速搭建团队协作平台的完整指南OpenProject快速搭建团队协作平台的完整指南还在为团队沟通不畅、任务分配混乱而困扰吗想要快速搭建一个高效的团队协作空间却无从下手本教程将带你从零开后端前端项目管理企业应用协同办公智能AI团队快速部署实战从零搭建自动化协作平台智能AI团队快速部署实战从零搭建自动化协作平台 CrewAI 是一个前沿框架用于协调具有角色扮演能力的自主 AI 代理通过促进协作智能使代理能够无缝协作人工智能AI AgentAgent 框架多智能体工作流自动化后端OpenProject终极部署指南5分钟快速搭建团队协作平台OpenProject终极部署指南5分钟快速搭建团队协作平台还在为项目管理工具的复杂安装而头疼吗OpenProject作为领先的开源项目管理软件现在只需后端前端项目管理企业应用协同办公创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

如何快速自部署Routa：Docker Compose一键搭建团队级AI多Agent协作平台完整指南

相关推荐

企业推荐FDE讲师避坑指南：候选清单里反复出现的名字，先过四关再签约

MATLAB与HFSS联合仿真偶极子天线：自动化优化全流程解析

LaMa + OpenVINO 图像修复实践：从掩码处理到 CPU 部署

更多资讯

RabbitMQ高级实战：一条消息不丢的全链路可靠性与高可用策略

ANSYS有限元分析入门：模块选型、APDL命令流与网格无关性验证

双格式蜗牛数据集：VOC与YOLO标注转换及目标检测训练实战

大规模MIMO落地三大工程死结：导频复用、统计CSI、低秩预编码

5G核心网Option2独立组网数据配置：从网元规划到注册会话打通

信用卡管理App的PRD怎么写？从还款提醒到埋点避坑指南

今日更新

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？