如何在Docker中运行基于Hot Chocolate的GraphQL后端

端口映射检查 #

运行容器时必须显式映射容器端口到主机端口，否则主机无法访问容器内服务：

docker run -p 5000:5000 [你的镜像名称]

这里5000:5000表示将主机的5000端口转发到容器的5000端口，和本地访问端口保持一致。

监听地址配置 #

.NET开发环境默认监听localhost，但容器内需要监听0.0.0.0才能被外部访问，两种配置方式：

1. 代码中指定：在Program.cs（或Startup.cs）的主机配置中添加UseUrls：

   public static IHostBuilder CreateHostBuilder(string[] args) =>
       Host.CreateDefaultBuilder(args)
           .ConfigureWebHostDefaults(webBuilder =>
           {
               webBuilder.UseStartup<Startup>();
               webBuilder.UseUrls("http://0.0.0.0:5000");
           });
   

2. Docker环境变量配置：在Dockerfile中添加环境变量：

   ENV ASPNETCORE_URLS=http://0.0.0.0:5000
   

标准Dockerfile示例 #

确保Dockerfile遵循多阶段构建，使用匹配的.NET镜像版本：

# 构建阶段：使用SDK镜像编译代码
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["YourProject.csproj", "."]
RUN dotnet restore "./YourProject.csproj"
COPY . .
RUN dotnet build "YourProject.csproj" -c Release -o /app/build

# 发布阶段：生成发布包
FROM build AS publish
RUN dotnet publish "YourProject.csproj" -c Release -o /app/publish /p:UseAppHost=false

# 运行阶段：使用轻量ASP.NET镜像
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENV ASPNETCORE_URLS=http://0.0.0.0:5000
EXPOSE 5000
ENTRYPOINT ["dotnet", "YourProject.dll"]

注意替换YourProject为实际项目名称，保持SDK和ASP.NET镜像版本与本地开发一致。

容器运行验证 #

查看容器日志确认服务启动状态：

docker logs [你的容器ID/名称]

如果日志显示Now listening on: http://0.0.0.0:5000，说明服务在容器内正常运行，此时检查端口映射或主机防火墙是否拦截了5000端口。

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