Arch Linux (WSL2) Docker 环境踩坑记

1. 基础安装

Bash

sudo pacman -Syu docker docker-compose docker-buildx --overwrite "*"

2. 踩坑 1：Glibc 名字解析死锁导致 docker info 卡顿 96 秒

病灶 ：/etc/nsswitch.conf 中默认带有 resolve [!UNAVAIL=return] 等插件，在未开启完整 systemd 的 WSL2 中会导致严重的超时等待。

Bash

sudo nano /etc/nsswitch.conf

将 hosts: 行精简修改为文件与 DNS 优先模式：

Plaintext

hosts: files dns myhostname

3. 踩坑 2：新版 Docker Desktop 代理套接字对齐与免 sudo 权限

病灶 ：新版 Docker Desktop 在 WSL 内部将本地通道整合为了 docker.proxy.sock，导致默认的 /var/run/docker.sock 变成死链。

Bash

# 1. 强制建立指向真正代理套接字的软链接
sudo ln -sf /mnt/wsl/docker-desktop/shared-sockets/guest-services/docker.proxy.sock /var/run/docker.sock

# 2. 赋予当前非 root 用户免 sudo 的读写权限
sudo chmod 666 /var/run/docker.sock

# 3. 验证基础响应速度
time docker info

4. 踩坑 3：新版 Docker CLI 找不到 Compose 插件 (unknown command)

病灶 ：Arch 的 docker 升级到前沿大版本后，对外部插件的扫描极其严格。如果权限不对或未置于黄金路径，会直接报 unknown flag/command。

Bash

# 1. 确保 pacman 安装的官方插件目录具备全局"可执行"权限
sudo chmod -R +x /usr/lib/docker/cli-plugins/

# 2. 强行在当前用户家目录下建立 Docker CLI 无法拒绝的黄金路径软链接
mkdir -p ~/.docker/cli-plugins
ln -sf /usr/lib/docker/cli-plugins/docker-compose ~/.docker/cli-plugins/docker-compose
ln -sf /usr/lib/docker/cli-plugins/docker-buildx ~/.docker/cli-plugins/docker-buildx

# 3. 彻底刷新当前终端的 Zsh 命令哈希表缓存
rehash

# 4. 完美合体验证
docker compose version