需用docker轻量cli镜像部署qoderwake：先验证docker版本≥24.0.0，拉取26.4.0-cli镜像；创建配置目录并写入lightmode.json禁用沙盒；运行容器映射8080/9000端口；或用docker-compose编排服务；再配置云端模型路由，内存峰值可压至1.1gb。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在资源受限设备上快速部署QoderWake数字员工，但受限于本地环境配置复杂度或系统兼容性问题，则可能是由于未采用容器化隔离方式启动轻量实例。以下是使用Docker镜像快速构建QoderWake轻量化运行环境的操作路径：
一、拉取并运行官方轻量CLI镜像
该方法利用QoderWake官方维护的Linux CLI镜像，跳过GUI依赖与沙盒初始化流程，直接在Docker中启动无界面、低内存占用的核心执行器，适用于4GB内存及以下设备。
1、确保已安装Docker 24.0.0+，执行docker --version验证版本；
2、从阿里云容器镜像服务拉取轻量CLI镜像：docker pull registry.cn-hangzhou.aliyuncs.com/qoder/qoderwake:26.4.0-cli；
3、创建专用配置挂载目录：mkdir -p ~/.qoderwake/config && echo '{"sandbox":"disabled","multi_agent":false}' > ~/.qoderwake/config/lightmode.json；
4、运行容器并映射配置与端口：docker run -d --name qoderwake-light -v ~/.qoderwake/config:/root/.qoderwake/config -p 8080:8080 -p 9000:9000 registry.cn-hangzhou.aliyuncs.com/qoder/qoderwake:26.4.0-cli；
5、检查容器状态：docker ps | grep qoderwake-light，确认STATUS为Up且端口映射正常。
二、基于Docker Compose编排最小化服务栈
该方法通过声明式编排文件统一管理QoderWake核心组件与依赖服务（如事件总线、日志采集器），避免手动启动多个容器，提升部署一致性与可复现性。
1、新建docker-compose.yml文件，内容如下：
version: '3.8'
services:
wake-core:
image: registry.cn-hangzhou.aliyuncs.com/qoder/qoderwake:26.4.0-cli
volumes:
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- ~/.qoderwake/config:/root/.qoderwake/config
ports:
- "8080:8080"
- "9000:9000"
restart: unless-stopped
2、在文件所在目录执行docker-compose up -d启动服务；
3、查看服务日志确认初始化完成：docker-compose logs -f wake-core | grep "Session账本已就绪"；
4、访问http://localhost:8080验证管理界面是否响应HTTP 200状态码。
三、启用云端模型路由跳过本地推理加载
该方法通过覆盖默认模型加载策略，强制QoderWake在启动时跳过Qwen3.5-9B等大模型的本地预加载，改由运行时按需调用阿里百炼API，将内存峰值压降至1.1GB以内。
1、编辑挂载的配置文件~/.qoderwake/config/lightmode.json，追加模型路由字段：
"model_router": {"provider": "aliyun-bailian", "endpoint": "https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation"}
2、重启容器使配置生效：docker restart qoderwake-light；
3、在容器内执行健康检查命令：docker exec qoderwake-light qodercli health check --skip-model-load；
4、确认输出中包含model_load_status: skipped与memory_usage_peak: 1087MB字样。
