PilotDeck Docker部署指南：从零搭建生产级AI智能体平台的完整配置清单

PilotDeck Docker部署指南从零搭建生产级AI智能体平台的完整配置清单【免费下载链接】PilotDeckTask-oriented AI Agent productivity platform项目地址: https://gitcode.com/OpenBMB/PilotDeckPilotDeck 是 OpenBMB 社区开源的任务型 AI Agent 生产力平台支持 WorkSpace 项目级隔离、白盒记忆与智能模型路由。本篇 Docker 部署指南带你从零搭建生产级 PilotDeck 服务覆盖环境检查、一键启动、模型配置与数据持久化——无需在宿主机安装 Node.js、无需手工调环境3 条命令即可拉起你的 AI 智能体平台。 一、为什么选 Docker运行 PilotDeck 最省事的方式容器内PilotDeck 以两个协作的 Node.js 进程运行UI ServerWeb 前端 REST/WebSocket 适配层监听3001端口GatewayAI Agent 智能体运行时监听18789端口浏览器 (localhost:3001) ──► UI Server (3001) ──► Gateway (18789)运行时 supervisor 会先启动 UI Server待模型配置就绪后再启动 Gateway见 webRuntimeSupervisor.js因此首次配置可以直接在浏览器中完成。相比源码安装Docker 方式有三个明显优势零宿主依赖镜像内置 Node.js 22按仓库锁文件安装依赖不依赖宿主机的 Node 版本与 CPU 架构一键可复现Dockerfile 采用多阶段构建产出生产级运行时镜像任何服务器执行相同命令得到相同结果数据不丢Compose 将全部状态持久化到pilotdeck-home卷会话、记忆、技能在重启后原样保留。✅ 二、动手之前30 秒环境检查前置条件只有两项Docker v20 与 Docker Compose v2。macOS/Windows 请先启动 Docker Desktop 并等待引擎就绪然后确认守护进程正在运行docker info首次构建有两个常见情况要提前知道拉取镜像慢或报context deadline exceeded构建需拉取node:22-bookworm等基础镜像。建议在 Docker DesktopSettings → Docker Engine或 Linux 的/etc/docker/daemon.json中配置 registry mirror 后重试临时办法先从可访问的镜像源拉取所需 Node 镜像并打成本仓库 Dockerfile 使用的名称docker pull mirror.gcr.io/library/node:22-bookworm docker pull mirror.gcr.io/library/node:22-bookworm-slim docker tag mirror.gcr.io/library/node:22-bookworm node:22-bookworm docker tag mirror.gcr.io/library/node:22-bookworm-slim node:22-bookworm-slim另外注意构建过程还会在镜像内下载 Debian 与 npm 软件包网络受限时建议同时配置代理见第五节配置清单。 三、一键启动从代码到生产只要 3 步第 1 步获取代码git clone https://gitcode.com/OpenBMB/PilotDeck cd PilotDeck第 2 步声明模型配置方式见第四节任选其一第 3 步构建并启动docker compose up -d --build打开浏览器访问http://localhost:3001若第 2 步已提供 API Key保存后 Gateway 自动启动可直接开始对话若未提供 Key页面会进入onboarding引导流程在浏览器里选择模型服务商、粘贴 API Key、测试连接并保存。PilotDeck 会自动写入配置并启动 Gateway全程无需手工改文件接口细节可参考 onboarding-api.md。 四、模型配置两种方式二选一方式 A环境变量配置新手推荐在 docker-compose.yml 的 environment 中或.env文件设置三个变量。首次启动时docker-entrypoint.sh 会自动生成一份完整的配置文件无需手写 YAMLPILOTDECK_MODELopenai/gpt-4.1 PILOTDECK_API_KEYsk-your-api-key PILOTDECK_API_URLhttps://api.openai.com/v1如果想让智能路由的轻量模型走另一个服务商可再补充PILOTDECK_LIGHT_MODEL与PILOTDECK_LIGHT_API_KEY/PILOTDECK_LIGHT_API_URL。方式 BYAML 文件配置生产推荐先在宿主机创建配置文件再取消 docker-compose.yml 中以pilotdeck.yaml:ro结尾的只读挂载行注释schemaVersion: 1 agent: model: openai/gpt-4.1 model: providers: openai: protocol: openai url: https://api.openai.com/v1 apiKey: sk-your-api-key配置显式可见、可纳入版本管理多实例部署时更方便统一维护。 五、生产级配置清单以下是 Docker 部署支持的核心环境变量与默认值建议对照检查后再上线变量作用默认值PILOTDECK_MODEL主模型标识格式provider/modelopenrouter/deepseek/deepseek-v4-flashPILOTDECK_LIGHT_MODEL智能路由/判别用轻量模型openrouter/qwen/qwen3-8bPILOTDECK_API_KEY主服务商 API Key省略则走 onboarding 配置—PILOTDECK_API_URL主服务商 API Base URLhttps://openrouter.ai/api/v1PILOTDECK_LIGHT_API_KEY轻量模型 Key回退到PILOTDECK_API_KEYPILOTDECK_LIGHT_API_URL轻量模型 Base URL回退到PILOTDECK_API_URLPILOTDECK_PROXYHTTP/HTTPS 代理网络受限环境—SERVER_PORTUI 服务端口3001PILOTDECK_GATEWAY_PORTGateway 端口18789PILOT_HOME容器内状态目录/root/.pilotdeck三条额外生产建议开启登录认证取消注释PILOTDECK_DISABLE_LOCAL_AUTH0要求用户登录后才能访问避免内网被匿名使用保留重启策略docker-compose.yml 中默认的restart: unless-stopped可让服务在崩溃后自动恢复生产环境不要删除配好代理如需出网代理设置PILOTDECK_PROXY启动脚本会自动转发到http_proxy等标准变量。️ 六、把宿主机项目挂进容器让智能体操作你的代码智能体默认运行在容器内。若希望它直接读写宿主机上的项目取消 docker-compose.yml 中/workspace一行的注释volumes: - pilotdeck-home:/root/.pilotdeck - ${PILOTDECK_WORKSPACE:-${PWD}}:/workspace也可以在启动前设置PILOTDECK_WORKSPACE/path/to/project指定项目路径。启动后可在 Web 控制台的 Files 页面浏览和管理文件图中即~/.pilotdeck状态目录包含projects、memory、router、skills、config.yaml、permissions.json等子项。它们连同认证数据库、会话与路由统计一起全部由pilotdeck-home卷持久化——重建容器或升级镜像后数据不会丢失可放心长期运行。 七、进阶手动构建运行与常见问题排查不想用 Compose 时也可以手动构建镜像并运行docker build -t pilotdeck:latest . docker run -d --name pilotdeck -p 3001:3001 \ -v pilotdeck-home:/root/.pilotdeck \ -e PILOTDECK_MODELopenai/gpt-4.1 \ -e PILOTDECK_API_KEYsk-your-api-key \ -e PILOTDECK_API_URLhttps://api.openai.com/v1 \ pilotdeck:latest配置文件挂载、工作区挂载与代理参数与 Compose 版一一对应卷改用-v传入环境变量改用-e传入。常见问题速查症状处理方式拉取镜像慢 /context deadline exceeded配置 Docker registry mirror 后重跑docker compose up -d --build端口3001被占用修改 compose 中宿主机端口映射或调整SERVER_PORT模型服务商连接慢 / 超时设置PILOTDECK_PROXY代理变量怀疑启动异常用docker compose logs -f实时查看日志 八、延伸资料Docker 部署官方文档README_DOCKER.zh.md镜像构建定义Dockerfile · 容器编排配置docker-compose.yml配置自动生成逻辑docker-entrypoint.sh项目总览与核心能力README.zh.md一次搭好长期受益。把生产级 PilotDeck 跑起来之后不妨给它一个真实任务看看这个任务型 AI 智能体平台还能为你做什么。【免费下载链接】PilotDeckTask-oriented AI Agent productivity platform项目地址: https://gitcode.com/OpenBMB/PilotDeck创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考