qoder与docker compose集成提供五种模式：单节点轻量集成、混合构建定制agent、qoder驱动多阶段子栈、离线安全增强部署、远程沙箱桥接，分别适配验证、企业定制、超大规模、强合规及本地硬件加速场景。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望快速构建一个具备多服务协同、环境隔离与可复现性的分布式开发环境，但手动编排Qoder及其依赖组件耗时易错，则可能是由于服务间网络、启动顺序与配置耦合导致初始化失败。以下是实现Qoder与Docker Compose集成的多种可行路径：
一、基于官方镜像的轻量级单节点集成
该方法适用于本地验证与快速上手，直接复用Qoder官方发布的ghcr.io/qoder/qoder镜像，配合PostgreSQL与Redis容器构成最小可用闭环，避免源码构建开销。
1、创建docker-compose.yml文件，定义qoder、database、cache三个服务，其中qoder服务设置depends_on指向database和cache，并声明healthcheck检测其就绪状态。
2、为qoder服务挂载本地配置目录，如./config:/app/config，并通过environment传入CODER_ACCESS_URL、QODER_DB_URL、REDIS_URL等必需变量。
3、执行docker-compose up -d启动栈，等待所有容器状态变为healthy后，访问http://localhost:7080确认Qoder Web界面加载成功。
4、在Qoder界面中新建Workspace，选择内置的“Python+TensorFlow”模板，验证容器内环境自动注入与Jupyter连接能力。
二、混合构建模式：定制化Qoder Agent镜像 + 标准化依赖服务
该方法适用于需嵌入私有插件、修改默认Agent行为或适配特定企业认证体系的场景，通过Dockerfile分层构建Qoder Agent运行时，再由Compose统一调度。
1、准备Dockerfile，以ghcr.io/qoder/agent:latest为基础镜像，COPY私有插件到/opt/qoder/plugins/，并RUN chmod +x /opt/qoder/plugins/*.sh。
2、在docker-compose.yml中将qoder-agent服务的image字段替换为本地构建标签，如qoder/agent-enterprise:25.11，并添加build上下文路径。
3、为qoder-agent服务配置volumes，映射宿主机的/workspace-data:/workspace与/.ssh:/root/.ssh，确保代码持久化与Git免密拉取。
4、添加init容器init-db，使用alpine/sqlcmd镜像，在qoder-agent启动前执行SQL脚本初始化schema与默认用户权限表。
三、多阶段协同编排：Qoder作为控制平面驱动下游Docker Compose子栈
该方法适用于超大型分布式开发环境，Qoder自身不承载业务负载，而是作为任务调度中枢，动态生成并触发独立的子Comopse栈（如AI训练栈、数据中台栈），实现资源按需伸缩。
1、部署Qoder主实例时启用--enable-remote-composer标志，并挂载宿主机的docker.sock与/usr/bin/docker-compose二进制文件到容器内。
2、在Qoder Workspace模板中定义compose-substack.yaml文件，包含spark-master、flink-jobmanager、kafka等服务，且network_mode设为"bridge"以隔离网络域。
3、当用户在Qoder UI中点击“启动AI训练环境”，Qoder后台调用docker-compose -f /workspace/compose-substack.yaml up -d命令，拉起子栈。
4、Qoder持续监听子栈容器健康状态，通过docker-compose ps --format "{{.Name}} {{.Status}}"实时采集输出，并将日志流式转发至Web Terminal。
四、离线安全增强模式：全组件镜像预置与证书签名验证
该方法专为金融、政务等强合规场景设计，所有镜像均提前下载并导入私有Registry，启动过程不依赖外部网络，且每个镜像SHA256摘要经内部CA签名认证。
1、使用skopeo copy将ghcr.io/qoder/qoder:25.11、postgres:17-alpine、redis:7.2-alpine等镜像同步至harbor.internal/qoder/命名空间。
2、在docker-compose.yml中所有image字段替换为harbor.internal/qoder/前缀，并为每个service添加credential_spec指向本地证书卷。
3、编写verify-images.sh脚本，调用cosign verify --certificate-oidc-issuer https://auth.internal --certificate-identity qoder@internal $IMAGE，作为entrypoint前置检查。
4、在Qoder容器启动命令中插入set -e && /app/verify-images.sh && exec "$@"，确保任一镜像校验失败即终止启动流程。
五、远程沙箱桥接模式：Qoder托管调度 + 本地Docker Compose执行
该方法解决Qoder云端实例无法直连本地GPU设备或特殊硬件的问题，将Qoder作为UI与任务分发器，实际容器在开发者本地Docker引擎中运行，通过WebSocket隧道双向通信。
1、在本地执行docker-compose -f qoder-bridge.yml up -d，该栈仅含bridge-agent服务，监听localhost:9001并建立TLS加密WebSocket连接至云端Qoder实例。
2、bridge-agent容器内安装nvidia-container-toolkit，并将宿主机/dev/nvidia*、/usr/lib/x86_64-linux-gnu/libcuda.so等路径映射进运行时。
3、Qoder收到用户提交的“CUDA加速训练任务”后，生成带nvidia.com/gpu: "all" resource限制的compose片段，通过WebSocket下发至bridge-agent。
4、bridge-agent接收指令后，动态写入临时docker-compose.task.yml，执行docker-compose -f docker-compose.task.yml up -d，并将容器IP与端口回传至Qoder UI供JupyterLab直连。
