qoderwake离线部署需通过中转机下载全量安装包，校验后传输至内网服务器，解压并检查目录结构，修改配置为0.0.0.0监听，开放防火墙端口，最后执行start.sh启动服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您需要在无外网连接的环境中部署 QoderWake，但无法直接从官网下载安装包或执行在线安装，则需通过中转机获取离线安装包并完成局域网内部署。以下是完成该任务的具体步骤：
一、准备中转机并下载离线安装包
中转机用于在外网环境下载完整离线包，包含运行所需全部依赖、模型权重与启动脚本，确保内网服务器无需联网即可完成初始化。该包应为官方发布的全量归档格式，非精简版或仅 CLI 工具包。
1、在可联网的 Windows 或 Linux 中转机上，打开浏览器访问 https://qoder.com/download。
2、查找标有 QoderWake-offline-full 或 QoderWake-v2.3.1-standalone.tar.gz 的下载项（以实际官网最新发布命名为准）。
3、点击下载按钮，保存至中转机本地目录，例如 D:\qoderwake\（Windows）或 ~/Downloads/（Linux/macOS）。
4、校验文件完整性：使用官网提供的 SHA256 校验值（通常位于下载页下方或 release notes 中），执行命令比对：
Linux/macOS 示例：
sha256sum QoderWake-v2.3.1-standalone.tar.gz
Windows 示例（PowerShell）：
Get-FileHash -Algorithm SHA256 .\QoderWake-v2.3.1-standalone.tar.gz
二、传输安装包至目标内网服务器
将离线包安全导入内网服务器是部署前提，需避免解压或修改原始压缩包内容，确保路径权限与结构一致性。
1、确认目标服务器操作系统为 Ubuntu 22.04 LTS 或 CentOS 7.9+，且已启用 SSH 服务。
2、使用 scp 命令将安装包上传至服务器 /opt/qoder 目录：
scp QoderWake-v2.3.1-standalone.tar.gz user@192.168.10.50:/opt/qoder/
3、登录内网服务器，检查文件归属与权限：
ls -l /opt/qoder/QoderWake-v2.3.1-standalone.tar.gz
4、若属主非当前用户，执行 chown 修改：
sudo chown $USER:$USER /opt/qoder/QoderWake-v2.3.1-standalone.tar.gz
三、解压并验证目录结构
解压操作必须在指定路径下进行，以保证内置路径引用正确；解压后需核对关键子目录是否存在，防止传输损坏导致后续启动失败。
1、进入安装包所在目录：
cd /opt/qoder
2、执行解压命令：
tar -zxvf QoderWake-v2.3.1-standalone.tar.gz
3、确认生成根目录名称为 qoderwake-core（非带版本号的嵌套名）：
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
ls -F
4、进入解压后目录并检查必需组件：
cd qoderwake-core && ls config/ models/ webui.py start.sh environment.yml
四、配置局域网访问参数
默认绑定 127.0.0.1 将导致其他局域网设备无法访问 WebUI，必须显式修改监听地址与端口，并开放对应防火墙策略。
1、编辑启动配置文件：
nano config/settings.yaml
2、定位 host 字段，将其值由 "127.0.0.1" 改为 "0.0.0.0"。
3、定位 port 字段，确认其值为 8080（或其他未被占用端口，如 8001）。
4、保存退出后，执行防火墙放行（Ubuntu ufw 示例）：
sudo ufw allow 8080
5、验证规则生效：
sudo ufw status | grep 8080
五、启动服务并验证本地响应
启动过程不依赖 pip install 或 conda activate，所有依赖已预编译打包进离线包；首次启动将自动初始化模型缓存与日志目录。
1、赋予启动脚本执行权限：
chmod +x start.sh
2、后台运行服务：
nohup ./start.sh > logs/start.log 2>&1 &
3、检查进程是否存活：
ps aux | grep "python.*webui.py"
4、在内网任一终端执行连通性测试：
curl -I http://192.168.10.50:8080
5、若返回 HTTP/1.1 200 OK，则表示服务已在局域网内就绪。
