2026年11月20日 星期五

WSL 2 疑難排解:用 virtioproxy 修復 Codex CLI 連線,再用固定埠解決 VS Code Insiders 的 WebSocket 1006

我在 Ubuntu 24.04 裡執行 Codex CLI,啟動時卡在讀取帳戶。GitHub Copilot CLI 和 agy CLI 也有連線問題,但同一個 WSL 能正常存取 Ubuntu 套件站。最後讓三個 CLI 和 VS Code Insiders 同時恢復的設定有兩項:WSL 使用 `virtioproxy`,Insiders 的 WSL Server 固定監聽 `17653`。 這兩項設定解決的是兩段不同的連線。第一段從 WSL 連到外部服務的 TCP 443,第二段從編輯器的轉送程序連回 Linux 裡的 VS Code Server。以下是我怎麼把問題分開測出來的。 ## Codex 讀取帳戶逾時,先測 DNS 和 TCP Codex 顯示的錯誤是: ```text Error: account/read failed: account/read failed: workspace routing discovery timed out (code -32603) ``` 當時 `codex login status` 仍顯示已使用 ChatGPT 登入。我先在 Ubuntu 裡確認目前的網路模式、DNS 解析結果,以及 HTTPS 連線停在哪一層: ```bash wslinfo --networking-mode getent ahostsv4 chatgpt.com curl -4 -sS -o /dev/null --connect-timeout 5 --max-time 10 \ -w 'IP=%{remote_ip} TCP=%{time_connect} TLS=%{time_appconnect} HTTP=%{http_code}\n' \ https://chatgpt.com/ ``` WSL 的預設 DNS 把 `chatgpt.com` 解析成 `198.18.0.3`。這個位址落在 IANA 保留給網路效能測試的 `198.18.0.0/15` 網段,一般公網不會把封包路由到這裡。因此,我比對了 Windows 和 WSL 連到**同一個 IP、同一個埠**時的結果。[IANA IPv4 特殊用途位址登錄](https://www.iana.org/assignments/iana-ipv4-special-registry/iana-ipv4-special-registry.xhtml) ``` | 連線來源 | 連往 `198.18.0.3:443` 的結果 | | ----------------- | ----------------------------------------------------------- | | Windows 原生程式 | 約 62 毫秒建立 TCP 連線,通過 `chatgpt.com` 的 TLS 憑證驗證 | | WSL 2,NAT | TCP 連線逾時 | | WSL 2,mirrored | Linux 介面上觀察到 4 次 SYN,4 秒內都沒收到 SYN-ACK | | WSL 2,virtioproxy | 仍解析到同一個 IP,約 20 毫秒建立 TCP 連線,HTTP 200 | ``` Windows 為什麼能通?在連線保持開啟時檢查 Windows TCP 連線表,應用程式要求連往 `198.18.0.3:443`,實際接收端卻是本機 `[::1]` 上的 `Clir.exe`。Clir 是這台電腦上的企業端點資安軟體。這次能確認它接手了 Windows 的 TCP 連線;產生那筆 DNS 回覆的元件仍未查明。 我又在鏡像模式下做了一個對照。從 WSL 直接向 Wi-Fi 閘道查詢同一個網域,取得公網 IP。經由**同一個 Linux 網路介面**連向該 IP,約 32 毫秒就收到 SYN-ACK,也通過了 `chatgpt.com` 的 TLS 驗證。故障範圍因此縮小到 WSL 通往 `198.18.0.3` 的路徑。這也解釋了為什麼 Ubuntu 套件站始終可以使用。 ## 把 WSL 2 切換到 virtioproxy 這台電腦使用 WSL **2.6.1.0**。在 Windows 開啟 `%UserProfile%\.wslconfig`,於既有的 `[wsl2]` 區段新增或修改這一行: ```ini [wsl2] networkingMode=virtioproxy ``` `.wslconfig` 會套用到這台電腦的所有 WSL 2 發行版。新版 Microsoft 文件也使用 `consomme` 這個名稱;本文的 `virtioproxy` 是在上述版本實際套用並驗證的值。[Microsoft WSL 進階設定](https://learn.microsoft.com/en-us/windows/wsl/wsl-config) 先儲存 WSL 裡的工作,正常停止需要保留狀態的服務或容器,再到 **Windows PowerShell** 執行: ```powershell wsl --shutdown wsl --exec wslinfo --networking-mode ``` 第二行會啟動預設發行版並顯示生效的模式。我這裡回傳 `virtioproxy`。重測後,Codex 的 `account/read` 成功,Codex、Copilot 與 agy 也都能實際送出提示並取得回覆。 ## CLI 恢復了,VS Code Insiders 卻出現 WebSocket 1006 接著我用 VS Code Insiders 開啟 WSL 專案。Windows 端日誌顯示 `WebSocket close with status code 1006`,Ubuntu 端日誌卻顯示 VS Code Server 已啟動。這次要測的是 Linux 本機的 `127.0.0.1`,和前面的 ChatGPT 網域無關。 WSL 擴充套件會透過 `wsl.exe` 啟動轉送程序,再連到 Linux 裡的 VS Code Server。當時 Server 正監聽 `127.0.0.1:39609`,但從同一個 Ubuntu 連回該埠,立即收到連線拒絕。為了區分問題出在 VS Code 還是埠號的分配方式,我用同一個 Linux 帳號啟動測試服務,只改它要求的監聽埠: ``` | Linux 服務如何取得監聽埠 | 從同一個 WSL 連回的結果 | | ------------------------------------------- | ------------------------------- | | 指定 `0`,讓系統分配,得到 `38233`、`44107` | 兩次都收到 `Connection refused` | | 程式明確指定 `17653`、`17654` | 兩次都成功 | ``` 這個對照讓修正範圍縮小到 VS Code Server 的監聽埠。Windows 日誌裡顯示的 WebSocket 埠屬於另一端,照抄那個數字並不能固定 Linux Server 的埠。 ## 在 Insiders 固定 WSL Server 的監聽埠 我使用的版本是 VS Code Insiders **1.148.0-insider**,WSL 擴充套件 **1.104.7**。在 **Windows 端的 Insiders** 按 `Ctrl+Shift+P`,執行 `Preferences: Open User Settings (JSON)`,把以下屬性加入現有的 `settings.json`: ```json { "remote.WSL.experimental.serverPort": 17653 } ``` `17653` 是這台電腦上測試成功的可用埠。這是擴充套件的實驗性設定,升級版本後可以用下面的指令確認是否仍然生效。 儲存後,關閉原本連線失敗的 WSL 遠端視窗,再從 Ubuntu 的專案目錄重新開啟。舊的轉送程序可能仍沿用先前的隨機埠,重開視窗才能驗證新設定。 ```bash code-insiders . ``` 等遠端視窗開啟後,在 Ubuntu 執行: ```bash ss -lnt 'sport = :17653' curl --noproxy '*' -fsS http://127.0.0.1:17653/version ``` 這次 `ss` 顯示 `127.0.0.1:17653` 正在監聽,`/version` 也回傳對應 Insiders 版本的 commit ID。最後,遠端日誌的 `ManagementConnection` 和 `ExtensionHostConnection` 都顯示已建立連線,我也實際在 Insiders 開啟了 WSL 專案中的檔案。同一個 Ubuntu 此時連往 `chatgpt.com` 仍回傳 HTTP 200,資料庫容器也通過就緒檢查。

沒有留言: