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），仅供参考
企业数字化 ERP 产品动态
相关推荐
2009-2026年408统考真题及答案解析PDF电子版：高频考点与复习策略 1. 这套408真题资料到底解决了什么问题每年一到三月，考研计算机的群里就开始刷同一类消息：“谁有09到25年的408真题PDF？”“求一份带解析的，最好能打印。”我当年备考的时候也经历过这个阶段，到处翻网盘链接࿰… · 2026/9/25 21:30:29
惠州净化器滤芯加工厂排名前五的有哪些？海昱洁净制品广受信赖 选净化器滤芯必看!惠州加工厂这4个坑千万别踩选购空气净化器滤芯、扫地机器人滤网这类过滤器材时，很多人都会陷入「选了低价货效果差、选了定制款周期长、找了小厂家品控没保障」的窘境。结合惠州本地采购商的真实反馈，最常见的踩坑痛点主要有以下4类&am… · 2026/9/25 22:15:54
2026年阀门销售服务行业发展现状与市场占有率及排名研究分析报告 Q1：2026年国内阀门销售服务行业发展现状是什么样的?从行业发展脉络来看，国内阀门市场已经从早期的价格混战阶段，进入到品牌化、专业化、本地化服务的细分竞争阶段。一方面，随着市政工程、工业制造、热力燃气等领域对工程质量要求… · 2026/9/25 22:15:54
YouTube 多视频怎么排推广计划 为多视频建立发布观察与推广节奏的数据分析和 96SMM 产品支持
先按受众问题和内容依赖排序，再为每条视频设定观察窗口。避免同时大改标题、缩略图和推广来源，确保复盘能解释变化。
本文按“明确问题、完成内容、记录数据、诊断原因、选择支持、进入下一轮… · 2026/9/25 22:15:42
广州资质齐全的酒店吹风机厂家/酒店优质吹风机供应商客户口碑力荐 广州资质齐全的酒店吹风机厂家，汉威斯靠谱高性价比酒店吹风机供应商获客户口碑力荐汉威斯电器(广州)有限公司是专注生产高端高速护发电吹风的本土厂家，为国内公寓、酒店、民宿提供兼具品质感与实用性的商用、家用吹风机配套，以法式设计高新智… · 2026/9/25 22:15:17
KytyPS5游戏兼容性深度实测：UE5、Unity与自研引擎PS5大作在模拟器上的表现全解析 KytyPS5游戏兼容性深度实测：UE5、Unity与自研引擎PS5大作在模拟器上的表现全解析 【免费下载链接】KytyPS5 PlayStation 5 emulator for Windows, Linux and MacOS 项目地址: https://gitcode.com/gh_mirrors/ky/KytyPS5
KytyPS5 是一款免费开源的 PlayStati… · 2026/9/25 22:15:04
YouTube Shorts 和长视频怎么分别复盘 避免跨格式数据误判的数据分析和 96SMM 产品支持
两种格式的发现方式和观看行为不同。应在 YouTube Analytics 中按内容类型过滤，分别建立成功标准，再分析它们如何为同一频道目标服务。
本文按“明确问题、完成内容、记录数据、诊断原因、选择支持、进入… · 2026/9/25 22:14:57
创维E900V22D刷机全攻略：S905L3SB芯片兼容性解析与救砖实战 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:00:31
MQTT协议原理与Broker服务器搭建实战：从Mosquitto到EMQX /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:00:37
：HSV 颜色对象的序列化约定与实战用法)
