Docker容器无法分配请求地址[::1]:50051问题求助

问题描述 #

尝试在Docker容器中运行基于Rust的gRPC应用，执行命令cargo run --bin helloworld-server时出现错误：

Error: tonic::transport::Error(Transport, hyper::Error(Listen, Os { code: 99, kind: AddrNotAvailable, message: "Cannot assign requested address" }))

使用netstat检查地址未发现占用情况，相关代码及Docker配置如下：

src/server.rs #

use tonic::{transport::Server, Request, Response, Status};

use hello_world::greeter_server::{Greeter, GreeterServer};
use hello_world::{HelloReply, HelloRequest};

pub mod hello_world {
    tonic::include_proto!("helloworld");
}

#[derive(Debug, Default)]
pub struct MyGreeter {}

#[tonic::async_trait]
impl Greeter for MyGreeter {
    async fn say_hello(
        &self,
        request: Request<HelloRequest>,
    ) -> Result<Response<HelloReply>, Status> {
        println!("Got a request: {:?}", request);

        let reply = hello_world::HelloReply {
            message: format!("Hello {}!", request.into_inner().name).into(),
        };

        Ok(Response::new(reply))
    }
}

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let addr = "[::1]:50051".parse()?;
    let greeter = MyGreeter::default();

    Server::builder()
        .add_service(GreeterServer::new(greeter))
        .serve(addr)
        .await?;

    Ok(())
}

Dockerfile #

FROM rust:1.69.0 AS build
RUN apt-get update
RUN apt install -y protobuf-compiler
WORKDIR /helloworld-tonic
COPY . ./helloworld-tonic/
ENTRYPOINT ["tail", "-f", "/dev/null"]

原因分析 #

• 代码中绑定的[::1]:50051是IPv6环回地址，Docker容器默认未启用IPv6支持，导致无法分配该地址。
• 即使容器支持IPv6，绑定环回地址仅能在容器内部访问，不符合gRPC服务对外提供的需求；且容器网络命名空间与宿主机隔离，宿主机netstat检测无法反映容器内的地址状态。
• 当前Dockerfile仅完成依赖安装和代码复制，未编译应用程序，也未配置正确的启动命令，无法直接运行服务。

解决方案 #

1. 修改服务绑定地址 #

将监听地址改为0.0.0.0:50051，让服务监听容器内所有IPv4接口，既保证容器内可正常绑定，也支持通过端口映射对外提供服务。

修改后的src/server.rs中main函数片段：

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let addr = "0.0.0.0:50051".parse()?;
    let greeter = MyGreeter::default();

    Server::builder()
        .add_service(GreeterServer::new(greeter))
        .serve(addr)
        .await?;

    Ok(())
}

2. 完善Dockerfile #

采用多阶段构建减小镜像体积，同时完成编译和启动配置：

# 构建阶段
FROM rust:1.69.0 AS build
RUN apt-get update && apt install -y protobuf-compiler
WORKDIR /app
COPY . .
RUN cargo build --release --bin helloworld-server

# 运行阶段
FROM debian:bookworm-slim
WORKDIR /app
COPY --from=build /app/target/release/helloworld-server .
EXPOSE 50051
ENTRYPOINT ["./helloworld-server"]

3. 构建并运行容器 #

执行以下命令完成镜像构建和容器运行：

# 构建镜像
docker build -t helloworld-grpc .

# 运行容器并映射端口
docker run -p 50051:50051 helloworld-grpc

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