### Flask Docker WSL 本机 IP 访问失败问题排查 #### 1. 确认容器内服务绑定的地址 默认情况下，Flask 应用可能会绑定到 `127.0.0.1`，这会导致服务只能在容器内部访问。需要确保 Flask 应用监听的是 `0.0.0.0` 地址，以便外部可以访问。可以通过以下方式启动 Flask 应用： ```python app.run(host='0.0.0.0', port=5000) ``` 如果使用 `gunicorn` 部署 Flask 应用，则需要指定绑定地址和端口： ```bash gunicorn -b 0.0.0.0:5000 app:app ``` #### 2. 检查 Docker 容器的端口映射 确认 Docker 容器是否正确地将容器内的端口映射到宿主机的端口。例如，运行以下命令启动容器时，需确保 `-p` 参数正确设置： ```bash docker run -p 8000:5000 flask-app ``` 上述命令将容器内的 `5000` 端口映射到宿主机的 `8000` 端口[^4]。 #### 3. 确认 WSL 的网络模式 WSL 默认使用的是 NAT 模式，这意味着 WSL 和宿主机之间的网络是隔离的。可以通过以下方法确认 WSL 的 IP 地址： ```bash ifconfig ``` 或者使用： ```bash ip addr show ``` 找到 WSL 的 IP 地址后，在宿主机浏览器中访问该 IP 地址及对应的端口（如 `http://192.168.x.x:8000`）[^3]。 #### 4. 检查防火墙设置 确保宿主机和 WSL 的防火墙没有阻止相关端口的流量。可以在宿主机上临时关闭防火墙进行测试： ```bash sudo ufw disable ``` 或者允许特定端口通过防火墙： ```bash sudo ufw allow 8000 ``` #### 5. 确认 Docker 守护进程配置 如果仍然无法访问，可能是因为 Docker 守护进程未正确配置为监听所有网络接口。可以编辑 Docker 的守护进程配置文件： ```bash sudo nano /etc/docker/daemon.json ``` 添加以下内容： ```json { "hosts": ["tcp://0.0.0.0:2375", "unix:///var/run/docker.sock"] } ``` 然后重启 Docker 服务： ```bash sudo service docker restart ``` 需要注意的是，这种方法可能会带来安全风险，建议仅在开发环境中使用[^3]。 #### 6. 使用 `localhost` 和 `127.0.0.1` 的区别 在 WSL 中，`localhost` 和 `127.0.0.1` 可能指向不同的网络接口。如果应用在容器中绑定到 `0.0.0.0`，则可以通过 WSL 的 IP 地址访问，而不能直接通过 `localhost` 或 `127.0.0.1` 访问[^1]。 #### 7. 验证容器内的服务状态 进入容器内部，验证 Flask 服务是否正常运行： ```bash docker exec -it <container_id> /bin/bash curl http://0.0.0.0:5000 ``` 如果返回正确的响应，则说明服务正常运行[^4]。 --- ### 示例代码 以下是完整的 Dockerfile 和启动命令示例： **Dockerfile** ```dockerfile FROM python:3.8-slim WORKDIR /app COPY . /app RUN pip install --no-cache-dir -r requirements.txt CMD ["gunicorn", "-b", "0.0.0.0:5000", "app:app"] ``` **启动容器** ```bash docker build -t flask-app . docker run -p 8000:5000 flask-app ``` ---