远程VPS上Rust项目Docker构建失败：域名解析错误

问题背景 #

本地MacBook上docker build .可正常执行，但远程Debian 11 VPS上构建时，cargo无法解析index.crates.io域名，而VPS宿主机通过ping、curl等命令能正常访问该域名。

解决思路与操作步骤 #

1. 临时指定构建时的DNS服务器 #

构建命令中直接指定公共DNS，绕过Docker默认配置：

docker build --dns 8.8.8.8 --dns 1.1.1.1 .

2. 修改Docker全局DNS配置 #

若需永久解决，编辑Docker daemon配置文件：

• 创建或编辑/etc/docker/daemon.json，添加：

  {
    "dns": ["8.8.8.8", "1.1.1.1"]
  }
  

• 重启Docker服务：

  systemctl restart docker
  

之后重新执行docker build .即可。

3. 使用宿主机网络进行构建 #

让构建过程直接复用宿主机的网络栈，包括DNS配置：

docker build --network host .

4. 在Dockerfile中手动设置DNS #

修改build阶段的Dockerfile，先覆盖容器内的DNS配置：

ARG RUST_VERSION=1.74.1
ARG APP_NAME=redis-rest
FROM rust:${RUST_VERSION}-slim-bullseye AS build
ARG APP_NAME
WORKDIR /app
# 手动设置DNS服务器
RUN echo "nameserver 8.8.8.8" > /etc/resolv.conf
RUN --mount=type=bind,source=src,target=src \
    --mount=type=bind,source=Cargo.toml,target=Cargo.toml \
    --mount=type=bind,source=Cargo.lock,target=Cargo.lock \
    --mount=type=cache,target=/app/target/ \
    --mount=type=cache,target=/usr/local/cargo/registry/ \
    <<EOF
set -e
cargo build --locked --release
cp ./target/release/$APP_NAME /bin/server
EOF
# 后续final阶段内容不变...

5. 验证Docker容器的DNS解析能力 #

先运行测试容器确认Docker本身的DNS是否正常：

docker run --rm busybox ping -c 3 index.crates.io

如果该命令也失败，说明Docker的网络配置存在问题，优先排查Docker的网络环境（比如防火墙、VPS的网络策略）。

内容的提问来源于stack exchange，提问作者Aaron