Windows 11 中 WSL2 访问 Docker 本地主机：轻松解决常见障碍

在 Windows 11 中使用 WSL2 访问 Docker 本地主机

问题

在 Windows 11 中使用 WSL2 访问 Docker 中的本地主机可能会遇到一些障碍。本文将引导你逐步解决此问题，让你轻松访问 localhost。

解决方案

验证 WSL 配置

1. 确保已启用 WSL 的 localhost 转发。打开 .wslconfig 文件并添加以下行：

[wsl2]
localhostforwarding=true

设置 Docker 环境变量

2. 在 Dockerfile 中，删除或注释以下行：

#EXPOSE 3000
#ENV PORT 3000
#ENV HOSTNAME localhost

配置 Docker 端口映射

3. 在 docker-compose.yml 文件中，将端口映射配置为：

ports:
  - "3000:3000/tcp"

重新启动 Docker 服务

4. 使用以下命令重新启动 Docker 服务：

docker-compose up --build

访问本地主机

5. 使用以下 URL 访问你的本地主机：

http://localhost:3000

步骤分解

• 验证 WSL 配置： 确保 WSL 配置为将 localhost 请求转发到 Windows 主机。
• 设置 Docker 环境变量： 删除或注释 Dockerfile 中不必要的环境变量，因为它们可能会干扰 localhost 转发。
• 配置 Docker 端口映射： 正确配置端口映射，将 Docker 容器的端口映射到 Windows 主机的端口。
• 重新启动 Docker 服务： 重新启动 Docker 服务以应用配置更改。
• 访问本地主机： 使用 localhost:3000 URL 访问 Docker 中运行的应用程序。

常见问题解答

1. 我仍然无法访问 localhost，该怎么办？

• 检查防火墙设置，确保允许 Docker 访问网络。
• 尝试禁用 Windows Defender，看是否能解决问题。
• 确保你的 Docker 容器已正确运行。

2. 为何要在 Dockerfile 中删除环境变量？

• 这些环境变量会干扰 WSL 中的 localhost 转发。

3. 我在哪里可以找到 .wslconfig 文件？

• 在 Windows 资源管理器中，导航至 C:\Users\{你的用户名}\.wslconfig。

4. 如何配置 WSL2 的 localhost 转发？

• 编辑 .wslconfig 文件并添加以下行：

[wsl2]
localhostforwarding=true

5. 为什么我需要重新启动 Docker 服务？

• 重新启动 Docker 服务是应用配置更改所必需的。