Skip to content
Merged
Show file tree
Hide file tree
Changes from 11 commits
Commits
Show all changes
38 commits
Select commit Hold shift + click to select a range
8c6822c
fix(serve): let channel workers reach TLS-enabled daemons
qqqys Aug 18, 2026
04c954d
fix(serve): make the worker TLS trust injection actually establish trust
qqqys Aug 18, 2026
06f6b8d
test(serve): declare the worker TLS trust check's NODE_EXTRA_CA_CERTS…
qqqys Aug 18, 2026
c1161a7
feat(serve): hide workspace Browse on headless daemon hosts
qqqys Aug 18, 2026
cb34d1a
fix(serve): judge the worker TLS trust gaps on the whole serving file
qqqys Aug 18, 2026
2bc8676
fix(serve): judge the worker CA bundle by what Node's loader accepts
qqqys Aug 18, 2026
0162087
fix(serve): refuse a non-CA chain terminator and document the worker …
qqqys Aug 18, 2026
75bc4f3
merge: take the reviewed TLS worker-trust fixes from #9392
qqqys Aug 18, 2026
53197cf
test(serve): guard the exec-bit probe on Windows and pin the Browse… …
qqqys Aug 18, 2026
40d5240
fix(serve): judge worker CA files with the loader's own rules, on bot…
qqqys Aug 18, 2026
c805013
merge: take the loader-rule worker CA judgement from #9392
qqqys Aug 18, 2026
fb9239e
fix(serve): judge worker CA framing the way Node's loader does
qqqys Aug 19, 2026
c9d3ed4
fix(serve): take #9392's loader-rule TLS judgement and close the boot…
qqqys Aug 19, 2026
22ca724
fix(serve): let channel workers reach a concrete bind, and drive the …
qqqys Aug 19, 2026
29927d6
test(serve): pin the boot wiring, the bracket strip and the pathlen b…
qqqys Aug 19, 2026
ece78c1
fix(serve): drive the trust diagnostic off the DER structure, and unb…
qqqys Aug 20, 2026
0401027
fix(serve): dial a wildcard bind's loopback on the family it bound (R…
qqqys Aug 20, 2026
e67312f
Merge commit 'd4b54a46ff' into autofix/9406
qqqys Aug 20, 2026
4dd5273
fix(serve): align worker TLS diagnostics with runtime
qqqys Aug 20, 2026
96895fd
fix(cli): close native picker and TLS review gaps
qqqys Aug 24, 2026
c6d8d51
Merge branch 'main' into feat/native-directory-picker
qwen-code-dev-bot Aug 24, 2026
d3fc24e
Merge branch 'main' into feat/native-directory-picker
qwen-code-dev-bot Aug 24, 2026
28c9029
fix(cli): close round-12 serve worker-URL and TLS trust-gap findings …
qqqys Aug 24, 2026
dd75c24
test(cli): pin that a home env file CA never reaches channel workers …
qwen-code-dev-bot Aug 25, 2026
f61db34
fix(cli): close round-14 wildcard spelling and TLS trust-gap findings…
qwen-code-dev-bot Aug 25, 2026
337443c
Merge remote-tracking branch 'upstream/main' into feat/native-directo…
Aug 25, 2026
7adc1e9
fix(cli): register the picker env probe with the serve process-env gu…
qwen-code-dev-bot Aug 25, 2026
b020529
fix(cli): let channel workers accept concrete own-interface daemon UR…
qwen-code-dev-bot Aug 25, 2026
c01c800
fix(cli): refuse zone-scoped channel binds with the named boot diagno…
qwen-code-dev-bot Aug 25, 2026
8f80905
test(cli): let the dial oracle skip loopbacks the host does not assig…
qwen-code-dev-bot Aug 26, 2026
737e0de
Merge branch 'main' into feat/native-directory-picker
qqqys Aug 26, 2026
d780f91
Merge branch 'main' into feat/native-directory-picker
qqqys Aug 26, 2026
a7e9e1a
fix(cli): dial channel workers back on a loopback the host assigns (#…
qwen-code-dev-bot Aug 26, 2026
03b221e
fix(cli): certify channel worker URLs only against Host-gate loopback…
qwen-code-dev-bot Aug 26, 2026
9e27492
Merge branch 'main' into feat/native-directory-picker
qwen-code-dev-bot Aug 26, 2026
95bb71f
Merge branch 'main' into feat/native-directory-picker
qwen-code-dev-bot Aug 27, 2026
ecee90f
fix(cli): refuse assigned wide-loopback binds the Host gate answers 4…
qwen-code-dev-bot Aug 27, 2026
2e805e4
Merge remote-tracking branch 'origin/main' into feat/native-directory…
qwen-code-dev-bot Aug 27, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -139,3 +139,6 @@ tmp/
# Auto-generated computer-use marker can also appear under nested packages.
**/.qwen/computer-use/
.playwright-mcp/

# Tool state written to the repo root when $HOME is unset (e.g. gh CLI)
.local/
1 change: 1 addition & 0 deletions docs/developers/qwen-serve-protocol.md
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@ operator diagnostic snapshot documented below.
| `persistent_workspace_registration` | a workspace registration store is wired into the daemon. Production `runQwenServe` supplies the user-level store automatically; direct `createServeApp` embeds must inject one explicitly and own startup restoration of their workspace registry. |
| `scratch_workspace_registration` | managed scratch workspace creation is available — a runtime factory, a validated managed scratch root, and runtime disposal are wired, and every managed runtime respects the scratch root boundary. |
| `workspace_runtime_removal` | removable dynamic or persistence-restored secondary runtimes can be drained and removed through the management route. |
| `native_directory_picker` | the daemon host can open a native OS directory picker (`osascript` on macOS, PowerShell on Windows, `zenity` on a Linux host with a display). Headless hosts omit the tag so clients hide the Browse affordance instead of surfacing a guaranteed picker failure. |
| `workspace_qualified_acp` | ACP HTTP and multi-workspace runtimes are active, so the plural ACP endpoint can select a secondary runtime. |
| `workspace_qualified_voice` | multi-workspace runtimes and the shared ACP/Voice WebSocket listener are active, so every workspace-qualified Voice modality is reachable for a secondary runtime. |
| `workspace_qualified_memory` | ACP HTTP and multi-workspace runtimes are active, so workspace-qualified managed-memory routes can select a per-workspace task lane for remember, forget, and dream operations. |
Expand Down
10 changes: 6 additions & 4 deletions docs/users/qwen-serve.md
Original file line number Diff line number Diff line change
Expand Up @@ -377,6 +377,8 @@ Notes:
- **Both flags or neither** — boot fails if only one is given (a cert with no key can't start an HTTPS listener).
- **TLS is orthogonal to auth** — HTTPS encrypts the transport; the bearer token still gates every API route. Non-loopback binds require a token with or without TLS.
- **Scope is TLS termination only** — no auto-generation, no ACME / Let's Encrypt. This is a LAN / dev convenience; for internet-facing deployments terminate TLS at a reverse proxy (see the threat model below).
- **Channel workers dial the daemon back over `https://`** — so they need to trust the serving certificate too. A self-signed cert (or a fullchain that carries its own root) needs nothing: the daemon injects it into each worker's `NODE_EXTRA_CA_CERTS`. The mkcert flow above is **CA-issued**, so the leaf alone cannot anchor the chain — export `NODE_EXTRA_CA_CERTS="$(mkcert -CAROOT)/rootCA.pem"` in the daemon's launch environment before starting with `--channel`. An operator-set value is _merged_ with the daemon cert, not replaced. Without it the daemon boots green while every channel worker restart-loops on `UNABLE_TO_VERIFY_LEAF_SIGNATURE`; the daemon log names the gap at boot.
- **Rotating `--tls-cert` in place needs a daemon restart** — the daemon serves the bytes it read at boot, so until it restarts, respawned workers can load newer contents than the daemon presents and their handshakes fail.
Comment thread
qqqys marked this conversation as resolved.
Resolved

## CLI flags

Expand All @@ -385,7 +387,7 @@ Notes:
| `--port <n>` | `4170` | TCP port. `0` = OS-assigned ephemeral port. |
| `--hostname <addr>` | `127.0.0.1` | Bind interface. Anything beyond loopback requires a token. |
| `--local-control` | `false` | Share the Web Shell on one selected private IPv4 interface with a daemon-owned revocable pairing token, terminal QR code, exact browser origin, and best-effort sleep inhibition. Composes with `--token`, `--allow-origin`, and `--port 0`; conflicts with `--no-web` and non-default `--hostname`. Use `--local-control-address` when multiple LAN candidates are available, and add `--tls-cert` + `--tls-key` for secure-context browser APIs such as voice input. |
| `--local-control-address <ip>` | — | Which LAN IPv4 address to share when the host has more than one candidate. Only needed if `--local-control` reports an ambiguous choice. |
| `--local-control-address <ip>` | — | Which LAN IPv4 address to share when the host has more than one candidate. Only needed if `--local-control` reports an ambiguous choice. |
| `--token <str>` | — | Bearer token. Falls back to `QWEN_SERVER_TOKEN` env var (with leading/trailing whitespace stripped — handy for `$(cat token.txt)`). |
| `--require-auth` | `false` | Refuse to start without a bearer token, even on loopback. Hardens the `127.0.0.1` developer default for shared dev hosts / CI runners / multi-tenant workstations where any local user can hit the listener. Boots only with `--token` or `QWEN_SERVER_TOKEN` set; gates `/health` behind the bearer too. |
| `--tls-cert <path>` | — | Path to a PEM certificate file. Serve over **HTTPS** instead of HTTP. Must be paired with `--tls-key` (boot fails if only one is given). Unlocks secure-context browser APIs — voice input (`getUserMedia`), WebRTC — over a LAN IP, which browsers otherwise block on plain `http://`. TLS termination only; no auto-generation / ACME. See [HTTPS / TLS](#https--tls-for-mobile--cross-device-access) below. |
Expand Down Expand Up @@ -674,9 +676,9 @@ Agent text writes (`write_file`, `edit`, `notebook_edit`, and the shell tool's s

Operators whose deployment convention is umask-driven (e.g. a systemd unit with `UMask=0002`, shared-group repositories) can opt new files into the standard POSIX handling with:

| Env var | Values | Default | What it does |
| -------------------------- | ---------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `QWEN_SERVE_NEW_FILE_MODE` | `owner` \| `system` | `owner` | `system` creates NEW files at `0o666 & ~umask`, so agent-created files follow the daemon process's umask like any other process on the machine. `owner` keeps the umask-independent `0600` default. Values are case-insensitive; the literal `0600` is accepted as an alias for `owner` (no other octal modes are supported), and any other value is rejected with a stderr warning and the `0600` default is kept. |
| Env var | Values | Default | What it does |
| -------------------------- | ------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `QWEN_SERVE_NEW_FILE_MODE` | `owner` \| `system` | `owner` | `system` creates NEW files at `0o666 & ~umask`, so agent-created files follow the daemon process's umask like any other process on the machine. `owner` keeps the umask-independent `0600` default. Values are case-insensitive; the literal `0600` is accepted as an alias for `owner` (no other octal modes are supported), and any other value is rejected with a stderr warning and the `0600` default is kept. |

Scope and limits:

Expand Down
Loading
Loading