需用docker容器化部署qoderwake数字员工：先验证docker及compose版本，拉取cli镜像并创建工作目录；单实例通过docker-compose配置端口映射与卷挂载；多实例需复制配置、差异化端口与路径；记忆持久化须挂载宿主机稳定路径；https接入需nginx反向代理并配置tls证书。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在本地或服务器上快速部署QoderWake数字员工，同时确保运行环境纯净、依赖不冲突、权限边界清晰，则需借助Docker容器化技术构建隔离沙盒。以下是实现该目标的具体操作路径：
一、准备基础镜像与运行时环境
Docker容器的启动依赖于官方提供的轻量CLI镜像与宿主机Docker引擎的协同，必须先确认镜像可用性及运行时版本兼容性，避免因底层环境不匹配导致容器无法拉起或功能缺失。
1、执行docker --version命令，确认输出版本不低于Docker 24.0.0；
2、执行docker-compose --version命令，确认输出版本不低于v2.20.0；
3、从阿里云容器镜像服务拉取QoderWake CLI镜像：docker pull registry.cn-hangzhou.aliyuncs.com/qoder/qoderwake:26.4.0-cli；
4、运行docker images | grep qoderwake验证镜像已成功下载并显示标签26.4.0-cli；
5、创建专用工作目录/opt/qoder-docker，并将后续配置文件统一存放于此。
二、配置独立容器实例（单账号模式）
每个QoderWake数字员工应运行于独立容器中，通过端口映射、卷挂载与环境变量注入实现身份绑定与状态持久化，防止多实例间配置污染或记忆混用。
1、在/opt/qoder-docker下新建docker-compose.yml文件；
2、写入以下内容：image: registry.cn-hangzhou.aliyuncs.com/qoder/qoderwake:26.4.0-cli，ports: - "8081:8080"，volumes: - ./config:/app/config - ./memory:/app/memory；
3、在./config目录中新建config.yaml，设置auth.token为有效GitHub Personal Access Token；
4、执行docker-compose up -d启动容器；
5、执行docker logs -f qoder-docker-qoderwake-1观察初始化日志，确认出现✅ Harness initialized标识。
三、启用多实例并发容器组（多账号模式）
当需在同一台宿主机运行多个数字员工服务时，须通过命名空间隔离、差异化端口分配与独立配置卷实现逻辑与物理双重隔离，确保各实例具备唯一身份与独立技能上下文。
1、复制docker-compose.yml为docker-compose-empa.yml和docker-compose-empb.yml；
2、在docker-compose-empa.yml中将ports改为- "8081:8080"，volumes中的路径改为./config-a:/app/config与./memory-a:/app/memory；
3、在docker-compose-empb.yml中将ports改为- "8082:8080"，volumes中的路径改为./config-b:/app/config与./memory-b:/app/memory；
4、分别为./config-a/config.yaml与./config-b/config.yaml填入不同账号的auth.token及identity.role字段；
5、分别执行docker-compose -f docker-compose-empa.yml up -d与docker-compose -f docker-compose-empb.yml up -d启动两组容器。
四、挂载外部存储实现记忆持久化
QoderWake的长期记忆依赖本地文件系统写入，若容器重启后记忆丢失，说明未正确挂载持久化卷。必须将/app/memory路径绑定至宿主机稳定路径，确保跨生命周期数据连续。
1、在宿主机创建目录/data/qoder/memory-empa与/data/qoder/memory-empb；
2、修改对应docker-compose文件中的volumes项，将./memory-a:/app/memory替换为/data/qoder/memory-empa:/app/memory；
3、确认宿主机目录权限为755，且所属用户与Docker守护进程一致；
4、执行docker exec -it qoder-docker-qoderwake-1 ls /app/memory，验证目录非空且含session.db与episodic/子目录；
5、手动向/data/qoder/memory-empa/episodic/写入测试文件，重启容器后检查该文件是否仍存在。
五、配置反向代理与HTTPS接入
为使QoderWake管理界面可通过域名安全访问，需在容器外部署Nginx反向代理，并终止TLS连接，避免容器内嵌HTTPS带来的证书管理复杂度与端口冲突。
1、在宿主机安装Nginx，确保版本不低于1.20；
2、在/etc/nginx/conf.d/qoder.conf中配置server_name qoder-empa.internal，proxy_pass http://127.0.0.1:8081；
3、使用Certbot申请泛域名证书，存于/etc/letsencrypt/live/internal.qoder/；
4、在Nginx配置中添加ssl_certificate与ssl_certificate_key指向证书路径；
5、执行nginx -t && systemctl reload nginx，随后在浏览器访问https://qoder-empa.internal验证管理界面可加载且地址栏显示锁形图标。
