1019 字

5 分钟

wsl2的docker 开启代理

2026-01-15

代理

proxy

/

linux

/

docker

/

wsl2

/

clash

/

grobid

在 WSL2 + ARM64 环境下通过 Windows Clash 代理成功运行 GROBID#

关键词：WSL2、Clash for Windows、Docker 代理、GROBID、ARM64、局域网代理、connection refused 解决方案

背景#

最近我尝试在 Windows 11 的 WSL2（Ubuntu） 中部署 GROBID —— 一个用于学术 PDF 解析的强大工具。我的目标是：

利用 Windows 上运行的 Clash 作为全局代理；
在 WSL2 的 ARM64 环境（如树莓派或 ARM 云服务器模拟环境）中拉取并运行 GROBID；
避免直接在 Linux 中配置复杂网络。

然而，过程中遇到了多个典型问题：

curl 能通，但 docker pull 失败；
localhost:7890 无法访问；
/etc/resolv.conf 中的 nameserver IP（如 10.255.255.254）不能用于 TCP 连接；
Docker daemon 不走 shell 代理。

本文将完整记录 从零到成功运行 GROBID 的全过程，供同样在 WSL2 + 代理环境下挣扎的朋友参考。

一、环境说明#

组件	版本/说明
主机系统	Windows 11
子系统	WSL2 (Ubuntu 22.04)
网络模式	NAT 模式（非镜像网络）
代理工具	Clash for Windows（开启 Allow LAN）
目标应用	GROBID `0.8.2-crf`（轻量版，适配 ARM64）
设备架构	ARM64（需注意镜像兼容性）

二、关键问题与解决方案#

❌ 问题 1：WSL2 无法通过 `localhost` 访问 Windows 服务#

现象：

1
curl -x http://localhost:7890 https://httpbin.org/ip
2
# Connection refused

原因：
你的 WSL2 运行在 NAT 模式（非 Windows 11 默认的“镜像网络”），此时 localhost 仅指向 Linux 自身，无法访问 Windows 上的服务。

⚠️ 即使 netstat 显示 Clash 监听 0.0.0.0:7890，WSL2 NAT 模式下仍无法通过 localhost 连接。

✅ 解决方案：
使用 Windows 的真实局域网 IP（如 192.168.137.1）。

在 Windows 执行：
Terminal window
```
1
ipconfig
```
找到当前网络的 IPv4 地址（例如 192.168.137.1）。

在 WSL 中设置代理：

1
export WIN_IP=192.168.137.1
2
export HTTP_PROXY="http://$WIN_IP:7890"
3
export HTTPS_PROXY="http://$WIN_IP:7890"

测试：

1
curl -x http://$WIN_IP:7890 https://httpbin.org/ip
2
# 返回公网 IP，说明代理成功！

❌ 问题 2：Docker 拉取镜像失败（`connection refused`）#

现象：

1
sudo docker run ... grobid/grobid:0.8.2-crf
2
# Error: Get "https://registry-1.docker.io/v2/": connection refused

原因：
虽然你在终端设置了代理，但 Docker daemon 是 systemd 服务，不继承 shell 环境变量，因此无法走代理。

✅ 解决方案：为 Docker daemon 配置系统级代理。

1
# 创建配置目录
2
sudo mkdir -p /etc/systemd/system/docker.service.d
3

4
# 写入代理配置
5
sudo tee /etc/systemd/system/docker.service.d/proxy.conf <<EOF
6
[Service]
7
Environment="HTTP_PROXY=http://192.168.137.1:7890"
8
Environment="HTTPS_PROXY=http://192.168.137.1:7890"
9
Environment="NO_PROXY=localhost,127.0.0.1,.local"
10
EOF
11

12
# 重载并重启 Docker
13
sudo systemctl daemon-reload
14
sudo systemctl restart docker

验证是否生效：

1
sudo systemctl show --property=Environment docker
2
# 应包含你设置的代理地址

❌ 问题 3：权限错误（`permission denied`）#

现象：

1
docker run ...
2
# permission denied while trying to connect to the Docker daemon socket

原因：当前用户不在 docker 用户组。

✅ 解决方案（可选）：

1
sudo usermod -aG docker $USER
2
# 然后重启 WSL 或重新登录

或者始终使用 sudo docker（简单但不够优雅）。

三、成功运行 GROBID#

完成上述配置后，执行：

1
# 拉取并运行轻量版（推荐 ARM64）
2
sudo docker run --rm --init --ulimit core=0 -p 8070:8070 grobid/grobid:0.8.2-crf

首次启动需等待 30–60 秒（加载模型），看到日志：

1
Started GROBID ... in X seconds

即可在浏览器访问：

1
http://localhost:8070

或通过 API 测试：

1
curl -d "citations=Smith, J. (2020). Deep Learning." \
2
     -X POST http://localhost:8070/api/processCitation

四、关于 `-full` 与 `-crf` 版本的选择#

版本	适用场景	是否支持 ARM64	GPU
`0.8.2-full`	高精度、有 GPU、资源充足	✅（但依赖复杂）	✅
`0.8.2-crf`	快速、低资源、批量处理	✅（推荐）	❌

💡 ARM64 设备（如树莓派）强烈推荐使用 -crf 版本，体积小、内存占用低、启动快。

五、总结#

通过本次实践，我们明确了几个关键点：

WSL2 NAT 模式下，必须使用 Windows 局域网 IP（如 192.168.137.1），不能用 localhost 或 /etc/resolv.conf 中的 nameserver IP；
Docker daemon 需要单独配置代理，不能依赖 shell 环境变量；
Clash 必须开启 Allow LAN 并监听 0.0.0.0，Windows 防火墙需放行 7890 端口；
ARM64 环境优先选择 grobid:0.8.2-crf 镜像。

现在，你可以在 WSL2 中无缝使用 Windows 代理，高效部署各类 Docker 应用！

附录：常用命令速查#

1
# 设置代理（WSL）
2
export WIN_IP=192.168.137.1
3
export HTTP_PROXY="http://$WIN_IP:7890"
4
export HTTPS_PROXY="http://$WIN_IP:7890"
5

6
# 配置 Docker 代理
7
sudo mkdir -p /etc/systemd/system/docker.service.d
8
sudo tee /etc/systemd/system/docker.service.d/proxy.conf <<< '[Service]
9
Environment="HTTP_PROXY=http://192.168.137.1:7890"
10
Environment="HTTPS_PROXY=http://192.168.137.1:7890"'
11

12
sudo systemctl daemon-reload
13
sudo systemctl restart docker
14

15
# 运行 GROBID（轻量版）
16
docker run --rm --init --ulimit core=0 -p 8070:8070 grobid/grobid:0.8.2-crf