Windows11 Pro下Linux Docker容器中.NET8 WebAPI证书持久化问询

针对你遇到的证书问题，以下是基于docker-compose.yml和Dockerfile的完整解决方案，覆盖证书生成、容器挂载、环境配置及EF Core连接SQL Server的适配：

1. 本地生成兼容Linux容器的HTTPS证书 #

先在Windows本地生成符合要求的证书，避免容器内生成的麻烦：

• 生成PFX格式证书（带自定义密码）：

  dotnet dev-certs https -ep "%USERPROFILE%/.aspnet/https/AccSol.pfx" -p YourSecureDevPassword
  

• 信任该证书：双击生成的PFX文件，按照向导导入到「受信任的根证书颁发机构」存储区。

2. 修改Dockerfile配置 #

确保基础镜像预留证书目录，并配置.NET证书环境变量：

# 基础运行镜像
FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
USER app
WORKDIR /app
EXPOSE 8080
EXPOSE 8081

# 创建容器内证书存储目录
RUN mkdir -p /home/app/.aspnet/https

# 设置Kestrel证书路径与密码
ENV ASPNETCORE_Kestrel__Certificates__Default__Path=/home/app/.aspnet/https/AccSol.pfx
ENV ASPNETCORE_Kestrel__Certificates__Default__Password=YourSecureDevPassword

# 构建镜像
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
ARG BUILD_CONFIGURATION=Release
WORKDIR /src
COPY ["AccSol/AccSol.csproj", "AccSol/"]
RUN dotnet restore "./AccSol/AccSol.csproj"
COPY . .
WORKDIR "/src/AccSol"
RUN dotnet build "./AccSol.csproj" -c $BUILD_CONFIGURATION -o /app/build

# 发布镜像
FROM build AS publish
ARG BUILD_CONFIGURATION=Release
RUN dotnet publish "./AccSol.csproj" -c $BUILD_CONFIGURATION -o /app/publish /p:UseAppHost=false

# 最终镜像
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "AccSol.dll"]

3. 配置docker-compose.yml #

通过Volume挂载本地证书到容器，同时配置服务依赖与环境变量：

version: '3.8'

services:
  accsol-api:
    build:
      context: .
      dockerfile: AccSol/Dockerfile
    ports:
      - "8080:8080"
      - "8081:8081"
    volumes:
      # 挂载本地证书目录到容器（只读模式避免误修改）
      - ${USERPROFILE}/.aspnet/https:/home/app/.aspnet/https:ro
    environment:
      - ASPNETCORE_ENVIRONMENT=Development
      - ASPNETCORE_Kestrel__Certificates__Default__Path=/home/app/.aspnet/https/AccSol.pfx
      - ASPNETCORE_Kestrel__Certificates__Default__Password=YourSecureDevPassword
    depends_on:
      - sql-server

  sql-server:
    image: mcr.microsoft.com/mssql/server:2022-latest
    environment:
      - ACCEPT_EULA=Y
      - SA_PASSWORD=YourStrongSqlPassword123
    ports:
      - "1433:1433"
    volumes:
      - sql-server-data:/var/opt/mssql

volumes:
  sql-server-data:

4. EF Core连接SQL Server适配 #

由于SQL Server容器默认使用自签名证书，需在连接字符串中添加TrustServerCertificate=True，绕过SSL验证失败问题：

// appsettings.json中的连接字符串示例
"ConnectionStrings": {
  "DefaultConnection": "Server=sql-server,1433;Database=AccSolDb;User Id=sa;Password=YourStrongSqlPassword123;TrustServerCertificate=True;"
}

关键注意事项 #

• 路径一致性：本地证书必须放在%USERPROFILE%/.aspnet/https目录，容器内对应路径为/home/app/.aspnet/https，确保Volume挂载路径完全匹配。
• 密码统一：证书密码需在生成命令、Dockerfile、docker-compose.yml中保持一致。
• Hyper-V模式兼容：该方案完全适配Hyper-V隔离模式，证书通过Volume物理挂载到容器，无需依赖Windows进程空间。

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