方舟codingplan容器化部署需五步:一、确认内核≥3.10、安装docker并加用户至docker组;二、拉取官方镜像,配置国内加速器;三、用docker run启动容器并挂载目录;四、用docker-compose.yml声明式部署;五、克隆源码定制构建私有镜像。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已在Linux服务器上准备运行方舟CodingPlan,但尚未完成容器化部署,则可能是由于基础环境缺失、镜像不可用或服务端口未正确映射所致。以下是实现该目标的具体操作路径:
一、确认系统与Docker基础环境
此步骤确保宿主机满足运行CodingPlan容器的最低要求,包括内核版本、Docker引擎及必要权限配置。缺少任一条件均会导致后续构建或启动失败。
1、执行命令检查Linux内核版本是否≥3.10:uname -r
2、验证Docker是否已安装并运行:sudo docker info
3、若未安装Docker,根据发行版执行对应命令:Ubuntu/Debian用户运行 sudo apt install docker-ce docker-ce-cli containerd.io -y;CentOS/RHEL用户运行 sudo yum install docker-ce docker-ce-cli containerd.io -y
4、将当前用户加入docker组以避免每次使用sudo:sudo usermod -aG docker $USER && newgrp docker
二、获取并验证CodingPlan官方镜像
直接使用方舟官方发布的Docker镜像可跳过源码编译环节,显著降低部署复杂度,并确保运行时环境与生产一致。
1、拉取最新稳定版CodingPlan镜像:sudo docker pull codingplan/codingplan:latest
2、查看本地镜像列表,确认拉取成功:sudo docker images | grep codingplan
3、若拉取失败,尝试指定国内镜像加速地址(如阿里云):sudo mkdir -p /etc/docker && echo '{ "registry-mirrors": ["https://
4、重启Docker守护进程使配置生效:sudo systemctl restart docker
三、通过Docker CLI直接运行容器
适用于快速验证服务可用性或单实例轻量部署,所有配置通过命令行参数传入,无需额外文件。
1、创建持久化数据目录:mkdir -p /opt/codingplan/data /opt/codingplan/config
2、运行容器并绑定关键端口与卷:sudo docker run -d --name codingplan-server -p 8080:8080 -p 8443:8443 -v /opt/codingplan/data:/app/data -v /opt/codingplan/config:/app/config -e CODINGPLAN_ENV=prod --restart=unless-stopped codingplan/codingplan:latest
3、检查容器运行状态:sudo docker ps | grep codingplan
4、查看容器日志确认初始化完成:sudo docker logs -f codingplan-server
四、使用docker-compose.yml声明式部署
适用于需长期维护、多服务协同或需版本控制的场景,支持配置复用、依赖编排与环境变量集中管理。
1、在任意目录新建文件 docker-compose.yml,内容如下:
version: "3.8"
services:
codingplan:
在无 root/sudo 权限的环境(云容器、VPS、隔离主机)中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景:...
image: codingplan/codingplan:latest
container_name: codingplan-server
ports:
- "8080:8080"
- "8443:8443"
volumes:
- /opt/codingplan/data:/app/data
- /opt/codingplan/config:/app/config
environment:
- CODINGPLAN_ENV=prod
- TZ=Asia/Shanghai
restart: unless-stopped
2、执行部署命令:sudo docker compose up -d
3、验证服务响应:curl -I http://localhost:8080/health
4、若返回HTTP 200 OK,说明服务已就绪;否则检查 /opt/codingplan/config 下是否存在必需的 application.yml 配置文件
五、手动构建定制化镜像(含私有模型集成)
当需要嵌入企业私有大模型API密钥、修改默认UI资源或适配特定GPU驱动时,必须基于官方源码构建自定义镜像。
1、克隆官方代码仓库:git clone https://github.com/codingplan/codingplan.git && cd codingplan
2、编辑根目录下 Dockerfile,在 COPY . /app 后添加敏感信息注入指令:RUN echo 'LLM_API_KEY=sk-xxx' >> /app/.env
3、执行构建命令并打标签:sudo docker build -t my-codingplan:v1.2.0 .
4、运行自定义镜像:sudo docker run -d --name codingplan-custom -p 8080:8080 -v /opt/codingplan/data:/app/data my-codingplan:v1.2.0










