# 每次更新之后都连不上 wsl remote, 只能删掉 ~/.qoder-server 才能连上

**URL:** <https://forum.qoder.com/t/wsl-remote-qoder-server/4200>\
**Category:** Bug Reports\
**Tags:** others\
**Created:** [December 18, 2025, 1:54am UTC](https://forum.qoder.com/t/wsl-remote-qoder-server/4200 "2025-12-18T01:54:47Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Author:** ![Blues\_King](https://yyz2.discourse-cdn.com/flex010/user_avatar/forum.qoder.com/blues_king/32/86_2.png) [@Blues\_King](https://forum.qoder.com/u/Blues_King)\
**Post date:** [December 18, 2025, 1:54am UTC](https://forum.qoder.com/t/wsl-remote-qoder-server/4200/1 "2025-12-18T01:54:47Z")

</div>

每次更新之后都连不上 wsl remote, 只能删掉 ~/.qoder-server 才能连上.

---

<div class="post-metadata">

**Author:** ![Austin\_Parker](https://yyz2.discourse-cdn.com/flex010/user_avatar/forum.qoder.com/austin_parker/32/5805_2.png) [@Austin\_Parker](https://forum.qoder.com/u/Austin_Parker)\
**Post date:** [December 18, 2025, 2:59am UTC](https://forum.qoder.com/t/wsl-remote-qoder-server/4200/2 "2025-12-18T02:59:58Z")

</div>

感谢反馈，下次报错连不上的时候，在这里联系我，我们收集下日志，看下什么原因？排查下是否由于WSL的空间不足导致的解压失败等这些原因 🫡

---

<div class="post-metadata">

**Author:** ![Blues\_King](https://yyz2.discourse-cdn.com/flex010/user_avatar/forum.qoder.com/blues_king/32/86_2.png) [@Blues\_King](https://forum.qoder.com/u/Blues_King)\
**Post date:** [December 18, 2025, 5:21am UTC](https://forum.qoder.com/t/wsl-remote-qoder-server/4200/3 "2025-12-18T05:21:01Z")

</div>

用 GPT 找了一下原因. WSL: Ubuntu 22.04, Qode: 2025.12.16 最新版本

* * *

## Bug / Incident Report: Qoder WSL server install fails due to corrupted tarball download

### Summary

在 Windows 上通过 Qoder 连接 WSL（`ubuntu-22.04`）时，Qoder 自动安装远端 `qoder-server` 失败，报错：

- `Error while extracting server contents`

- 远端解压阶段出现 `tar: Unexpected EOF in archive` / `gzip: invalid compressed data--format violated`

### Impact

无法完成 Qoder Remote WSL 初始化，导致无法连接 WSL 开发环境。

### Evidence / Logs

失败目录：  
`~/.qoder-server/bin/12be359badc94dd256ec6160db7a03cb18175025/`

失败时 tar 包校验：

- `gzip -t qoder-server.tar.gz` → `invalid compressed data--format violated`

- `tar -tzf qoder-server.tar.gz` → `Unexpected EOF in archive`

失败包大小异常：

- 损坏包大小约 **376MB** ，但 `file` 显示原始解压尺寸约 **493,066,240 bytes** （提示下载/文件内容不完整或被破坏）。

系统侧还观察到 WSL 提示：

- `A localhost proxy configuration was detected but not mirrored into WSL. WSL in NAT mode does not support localhost proxies.`  
这表明 Windows 存在本机代理设置，但 WSL NAT 模式无法镜像 localhost 代理，可能导致下载链路异常/中断。

### Root Cause (Most likely)

Qoder 安装脚本使用 `wget --continue` 下载 server tarball。结合现象判断：

- 下载过程中发生中断或代理/网络链路问题；

- `--continue` 续传可能将不完整/错误内容拼接进已有文件；

- 最终得到“文件体积看似正常但 gzip/tar 内部损坏”的 tar.gz，导致解压报错。

### Resolution / Workaround

手动删除损坏 tarball 并使用 `curl` 重新下载（不使用断点续传）后问题解决：

```auto
cd ~/.qoder-server/bin/12be359badc94dd256ec6160db7a03cb18175025
rm -f qoder-server.tar.gz

URL="https://download.qoder.com/server/0.2.22/qoder-reh-linux-x64-0.2.22.tar.gz"
curl -L --retry 5 --connect-timeout 15 -D headers.txt -o qoder-server.tar.gz "$URL"

gzip -t qoder-server.tar.gz
tar -tzf qoder-server.tar.gz | head

```

重新下载后 tar.gz 大小为 **126MB** ，`gzip -t` 通过，`tar -tzf` 能正常列出内容。

下载响应头（节选，完整见 `headers.txt`）：

- `HTTP/1.1 200 OK`

- `Server: AliyunOSS`

- `Content-Length: 131105248`

- `Accept-Ranges: bytes`

- `ETag: "BA6A5BB57CED06B40FA0554E37042D11-52"`

### Suggested Fix (for Qoder)

1. 安装脚本下载建议避免默认 `wget --continue`，或在续传前做校验：

2. 下载完成后增加完整性检查（例如 `gzip -t`），失败则自动重试（不续传）。

3. 若检测到 Windows localhost proxy 且 WSL NAT 不支持，提示用户可能影响远端下载，并提供替代下载策略。

---

<div class="post-metadata">

**Author:** ![Blues\_King](https://yyz2.discourse-cdn.com/flex010/user_avatar/forum.qoder.com/blues_king/32/86_2.png) [@Blues\_King](https://forum.qoder.com/u/Blues_King)\
**Post date:** [January 21, 2026, 9:26am UTC](https://forum.qoder.com/t/wsl-remote-qoder-server/4200/4 "2026-01-21T09:26:54Z")

</div>

最新 0.3.1 又出现这个问题了, 不是更新脚本回退了吧 🥲

---

<div class="post-metadata">

**Author:** ![Austin\_Parker](https://yyz2.discourse-cdn.com/flex010/user_avatar/forum.qoder.com/austin_parker/32/5805_2.png) [@Austin\_Parker](https://forum.qoder.com/u/Austin_Parker)\
**Post date:** [January 21, 2026, 9:29am UTC](https://forum.qoder.com/t/wsl-remote-qoder-server/4200/5 "2026-01-21T09:29:51Z")

</div>

感谢反馈 我来本地测试复现下这个问题 😀

---

<div class="post-metadata">

**Author:** ![胜强\_肖](https://yyz2.discourse-cdn.com/flex010/user_avatar/forum.qoder.com/%E8%83%9C%E5%BC%BA_%E8%82%96/32/3107_2.png) [@胜强\_肖](https://forum.qoder.com/u/%E8%83%9C%E5%BC%BA_%E8%82%96)\
**Post date:** [March 4, 2026, 9:53am UTC](https://forum.qoder.com/t/wsl-remote-qoder-server/4200/6 "2026-03-04T09:53:32Z")

</div>

我每次也出现这个问题，现在我都不敢更新了

---

<div class="post-metadata">

**Author:** ![胜强\_肖](https://yyz2.discourse-cdn.com/flex010/user_avatar/forum.qoder.com/%E8%83%9C%E5%BC%BA_%E8%82%96/32/3107_2.png) [@胜强\_肖](https://forum.qoder.com/u/%E8%83%9C%E5%BC%BA_%E8%82%96)\
**Post date:** [March 4, 2026, 9:53am UTC](https://forum.qoder.com/t/wsl-remote-qoder-server/4200/7 "2026-03-04T09:53:34Z")

</div>

我每次也出现这个问题，现在我都不敢更新了

---

<div class="post-metadata">

**Author:** ![sili\_chen](https://yyz2.discourse-cdn.com/flex010/user_avatar/forum.qoder.com/sili_chen/32/4977_2.png) [@sili\_chen](https://forum.qoder.com/u/sili_chen)\
**Post date:** [August 4, 2026, 2:29am UTC](https://forum.qoder.com/t/wsl-remote-qoder-server/4200/8 "2026-08-04T02:29:40Z")

</div>

我也是，更新完就连不上WSL了，不知做了什么鬼操作，才能恢复