需借助docker容器技术实现标准化打包与环境固化：一、用预构建cli镜像启动单实例；二、基于dockerfile本地构建定制镜像；三、多实例隔离部署；四、nginx反向代理接入https。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将QoderWake数字员工从开发环境快速迁移至测试或生产服务器，同时确保依赖、配置与运行时状态完全一致，则需借助Docker容器技术实现标准化打包与环境固化。以下是完成该目标的多种部署路径：
一、使用预构建CLI镜像启动单实例容器
该方法直接复用阿里云镜像仓库中已签名验证的轻量CLI镜像，规避本地构建耗时与模型权重下载不确定性，适用于对启动速度与环境一致性要求高的场景。
1、执行docker --version确认宿主机Docker版本不低于24.0.0；
2、执行docker-compose --version确认Compose版本不低于v2.20.0；
3、拉取官方CLI镜像：docker pull registry.cn-hangzhou.aliyuncs.com/qoder/qoderwake:26.4.0-cli；
4、创建工作目录/opt/qoder-docker并进入该目录；
5、新建docker-compose.yml，写入image、端口映射（如"8081:8080"）及卷挂载（./config:/app/config、./memory:/app/memory）；
6、在./config下创建config.yaml，填入有效的GitHub Personal Access Token并设置auth.token字段；
7、执行docker-compose up -d启动容器；
8、执行docker logs -f qoder-docker-qoderwake-1，确认日志中出现✅ Harness initialized标识。
二、基于Dockerfile本地构建定制化镜像
该方法适用于需嵌入私有模型、替换推理后端（如切换至llama.cpp）、或审计全部组件来源的场景，所有构建步骤与依赖版本均可追溯，满足强合规要求。
1、克隆QoderWake源码仓库：git clone https://github.com/aliyun/qoderwake-cli.git && cd qoderwake-cli；
2、确认项目根目录存在Dockerfile及models/子目录，若无模型文件需手动放入兼容GGUF格式的权重；
3、执行构建命令：docker build -t qoderwake:custom --build-arg MODEL_PATH=./models/qwen2.5-7b-instruct.Q4_K_M.gguf .；
4、构建完成后运行docker images | grep qoderwake:custom验证镜像存在；
5、启动容器时挂载宿主机路径：docker run -d -p 8082:8080 -v $(pwd)/config:/app/config -v $(pwd)/memory:/app/memory qoderwake:custom；
6、检查容器运行状态：docker ps | grep qoderwake:custom，确认端口映射与状态为up。
三、启用多实例隔离部署（差异化端口+独立卷）
该方法通过复制配置文件、修改端口绑定与挂载路径，在同一台宿主机上运行多个逻辑独立的QoderWake实例，各实例拥有专属记忆空间、配置上下文与网络端点，防止状态交叉污染。
1、复制原始docker-compose.yml为docker-compose-empa.yml和docker-compose-empb.yml；
2、在docker-compose-empa.yml中修改ports为"8081:8080"、volumes中路径改为./config-empa与./memory-empa；
3、在docker-compose-empb.yml中修改ports为"8082:8080"、volumes中路径改为./config-empb与./memory-empb；
4、分别为./config-empa/config.yaml与./config-empb/config.yaml配置不同的auth.token；
5、依次执行docker-compose -f docker-compose-empa.yml up -d与docker-compose -f docker-compose-empb.yml up -d；
6、分别执行docker logs -f qoder-docker-empa-qoderwake-1与docker logs -f qoder-docker-empb-qoderwake-1，确认两个实例均输出✅ Harness initialized。
四、接入HTTPS反向代理（Nginx + TLS证书）
该方法通过Nginx作为入口网关，将外部HTTPS请求转发至内部HTTP容器端口，并终止TLS握手，满足企业级安全策略与域名访问需求，同时避免容器内直接处理证书复杂性。
1、在宿主机创建/etc/nginx/conf.d/qoderwake.conf，写入server块，监听443端口并配置ssl_certificate与ssl_certificate_key路径；
2、在server块内添加location / { proxy_pass http://localhost:8081; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; }；
3、获取有效TLS证书，存放至/etc/nginx/ssl/qoderwake.crt与/etc/nginx/ssl/qoderwake.key；
4、执行nginx -t验证配置语法正确性；
5、重启Nginx服务：systemctl restart nginx；
6、确认可通过https://your-domain.com正常访问QoderWake管理界面，浏览器地址栏显示锁形图标与“连接安全”提示。
