企业官网建设流程全解析

Qwen Code 部署与上手：从本地安装到生产守护进程的 4 条路径

【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code

Qwen Code 是终端里的开源 AI 编码智能体，本文解决一个问题：从本地第一次跑通，到以qwen serve守护进程形式稳定运行，各阶段该选哪种部署方式。四条路径——独立安装、容器沙箱、无头 CI、生产部署——下面各给可照抄的最小命令。

先选路：哪类场景该用哪种方式

本地装好并跑起来

三种安装方式选其一

独立安装（推荐）：打包了私有 Node.js 运行时，装完即用，适合不装 Node 的机器。Linux/macOS 执行：

curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

Windows 在 PowerShell 中执行：

irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

已有 Node 22+ 环境时，用 npm 全局安装：

npm install -g @qwen-code/qwen-code@latest

macOS 也可以用brew install qwen-code。装完重启终端，确认qwen --version有输出。

配置模型提供方，跑第一个会话

首次运行qwen会进入引导；之后随时用/auth切换。支持阿里云 ModelStudio、多种第三方提供方，以及自定义提供方（可接 Ollama / vLLM 等本地模型）：

qwen # 进入交互式终端 /auth # 选择提供方并填入 API Key

详细配置见 快速入门文档。

离线环境怎么装

把对应平台的独立安装归档（如qwen-code-linux-x64.tar.gz）和SHA256SUMS放到同一目录，用--archive走本地安装：

bash install-qwen-standalone.sh --archive ./qwen-code-linux-x64.tar.gz

需要固定版本时设置QWEN_INSTALL_VERSION；离线机无法下载归档时，可准备一个私有镜像源后用--base-url指向它。

贡献者：从源码运行

git clone https://gitcode.com/GitHub_Trending/qw/qwen-code cd qwen-code npm install npm run build npm run start

需要 Node 22+。这是 monorepo，npm run start直接跑 CLI 开发构建；提交前用npm run preflight一次跑完测试与 lint。

容器里如何跑起来：沙箱隔离

qwen -s让智能体在容器内执行，把 shell 命令和文件修改的影响范围关在工作区里。Linux/Windows 上使用 Docker 或 Podman，macOS 默认走轻量的 Seatbelt：

qwen -s -p "analyze the code structure"

CI 或脚本里建议用环境变量对整个 shell 会话生效：

export QWEN_SANDBOX=true qwen -p "run the test suite"

沙箱会把当前工作区和~/.qwen目录挂载进容器，认证与设置在多次运行间保留；镜像默认自动拉取，tag 跟随 CLI 版本（如ghcr.io/qwenlm/qwen-code:0.22.3）。规则细节见 沙箱文档。

直接跑官方镜像

不走 CLI 沙箱、直接在容器里用交互式终端：

docker run --rm -it -v $(pwd):/workspace ghcr.io/qwenlm/qwen-code:0.22.3

无头与 CI：在流水线里跑 qwen -p

无头模式用-p或标准输入传提示词，不启动 UI，适合脚本和流水线。--continue可接着本项目最近一次会话的上下文继续跑：

qwen -p "what files changed in the current repo?" qwen --continue -p "run the tests again and summarize failures"

GitHub Actions 场景有两个入口：在qwen会话里输入/setup-github自动生成工作流；或手动写流水线步骤，把 API Key 存为 CI 密钥：

steps: - name: Run Qwen Code headless env: QWEN_API_KEY: ${{ secrets.QWEN_API_KEY }} run: qwen -p "review the latest commit"

Action 支持用qwen_cli_version固定 CLI 版本（latest、preview、nightly或具体版本号）；在仓库根目录放一份QWEN.md可注入项目约定。接入细节见 GitHub Action 文档。

如何把它跑进生产环境：qwen serve 部署

qwen serve把 Qwen Code 变成 HTTP 守护进程：多个客户端经 HTTP + SSE 共享同一个智能体会话，根路径直接服务浏览器 Web Shell，无需反代第二个端口。默认绑定127.0.0.1:4170。

本地启动与验证

在项目目录下启动，另开终端探活：

qwen serve

curl http://127.0.0.1:4170/health # 应返回 {"status":"ok"}

本机加鉴权最省事的方式是qwen serve --open-with-auth：自动生成一次性 bearer token 并随打开的 Web Shell 传递。

暴露到局域网与令牌鉴权

绑定非回环地址时守护进程强制要求 token，否则拒绝启动：

export QWEN_SERVER_TOKEN="$(openssl rand -hex 32)" qwen serve --hostname 0.0.0.0 --port 4170

共享开发机或 CI runner 上建议加--require-auth，让/health、/capabilities等所有路由都走 bearer 校验。客户端请求带Authorization: Bearer $QWEN_SERVER_TOKEN头。

日常观测看哪里

健康面用GET /daemon/status：内存、会话数、SSE/ACP 连接、速率限制计数一次取回；?detail=full额外给出逐会话诊断。文件日志稳定写入~/.qwen/debug/daemon/daemon.log，10 MiB 自动轮转：

tail -F ~/.qwen/debug/daemon/daemon.log

多仓库共用一个守护进程时重复--workspace注册多个隔离工作区；跨用户、需要独立令牌与审计边界时，应为每个用户起独立进程。完整路由与容量参数见 守护进程文档。

选型要点

• 机器上没有 Node.js：选独立安装脚本；已有 Node 22+：npm 或 Homebrew。
• 会执行有副作用命令的环境（尤其 CI）：加-s或QWEN_SANDBOX=true，别裸跑。
• qwen serve默认是回环免鉴权 ⚠️ 共享机器暴露时必须配QWEN_SERVER_TOKEN+--require-auth。
• 并发调高时，--max-sessions（默认 32）与--max-connections（默认 256）要一起看，否则单侧放开没有意义。
• 离线交付：归档 +SHA256SUMS同目录，--archive安装，QWEN_INSTALL_VERSION锁版本。

【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code