qwen serve 参数索引
按连接、工作区、资源、MCP 与执行策略查找 daemon 启动配置。
This page has not been translated into English yet. The original Chinese version is shown below.
qwen serve 的默认值属于 daemon，不应直接套用独立 TUI。以下列出已在官方主章明确说明的参数；行为和例子按专题链接展开。
连接和界面
| 参数 | 默认 | 作用 |
|---|---|---|
| --port | 4170 | 0 让操作系统分配端口 |
| --hostname | 127.0.0.1 | 非 loopback 配置或生成 bearer |
| --token | 取 QWEN_SERVER_TOKEN | 显式 flag 优先，trim 后使用 |
| --require-auth | false | 要求令牌，health 也加入认证 |
| --allow-origin | 无 | 可重复的浏览器跨域白名单 |
| --web / --no-web | 开启 | 内置 Web Shell；资源缺失时实际 API-only |
| --open | false | 启动后尝试打开浏览器 |
| --open-with-auth | false | loopback 下带认证打开，必要时生成临时 token |
| --token-qr / --no-token-qr | 依交互终端和 token 来源 | 控制 quickstart QR，不控制 Local Control QR |
| --tls-cert / --tls-key | 无 | 必须成对的 PEM 证书与私钥 |
| --local-control | false | 选定 LAN IPv4 上的可撤销配对访问 |
| --local-control-address | 无 | 多个候选 LAN 地址时明确选择 |
工作区和执行
--workspace 必须是绝对路径，可重复，首个 primary；省略取 process.cwd()。--memory-project-scope 默认 workspace，可设兼容的 git-root。--channel 接实例名或 all，all 不能与其他名称混用且只作用 primary。
--http-bridge 默认 true，托管 ACP 子进程；当前不因关闭或更改它就获得尚在后续计划中的原生进程内实现。--enable-session-shell 默认 false，开启后直接会话 Shell 仍要求有效、绑定该 session 的 X-Qwen-Client-Id，以及相应可信 loopback 或 bearer 权限。
--experimental-lsp 控制托管会话 LSP；模型和客户端查询该功能时应使用实际资源快照，不把空 server 列表当启动失败。
资源和期限
- --max-sessions、--max-total-sessions、--max-pending-prompts-per-session、--max-connections 分别约束工作区、daemon、prompt 和原始连接，见容量。
- --initialize-timeout-ms、--session-restore-timeout-ms、--prompt-deadline-ms、--writer-idle-timeout-ms、--permission-response-timeout-ms 分别约束不同生命周期，不能互相代替。
- --memory-budget-mb、--memory-pressure-mode、--child-heap-mode 管预算、观察与 child 准入，见内存预算。
- --event-ring-size、--compacted-replay-max-bytes、--max-journal-events、--max-journal-bytes 管有限实时回放，不限制或取代磁盘 transcript。
- --channel-idle-timeout-ms 默认 0，影响没有 live session 后 ACP 的空闲保留时间；并非 Channels 平台消息等待时间。
MCP 与外部裁决
--mcp-client-budget 与 --mcp-budget-mode 控制 live MCP 连接预算，作用范围取决于 mcp_workspace_pool capability；详见运行时 MCP。
--external-tool-guard-mode 默认 off，required 需 endpoint、token 和成功握手；--external-tool-guard-timeout-ms 默认 3000。该机制不是 Shell 沙箱，覆盖范围见Tool Guards。
启动环境还可配置工作区容量、live-state 轮询、文件 mode、附件根和日志。它们的读取时机不同，按各专题说明重启，不要假设所有 settings.env 都能覆盖 daemon 启动策略。