如何在预发布与生产服务器复用.NET应用Docker镜像并配置不同参数

下面是几种常用的实现方式，都能让同一镜像在预发布、生产环境使用不同配置：

方法1：用环境变量覆盖配置项（推荐） #

.NET原生支持通过环境变量覆盖appsettings.json里的配置，不需要替换整个文件。注意环境变量里要把配置路径的冒号:换成双下划线__（Docker环境变量不支持冒号）。

预发布容器启动命令： #

docker run -d \
  -e ASPNETCORE_ENVIRONMENT=Staging \
  -e ConnectionStrings__DefaultConnection="Server=staging-db;Database=app;User Id=staging-user;Password=staging-pass" \
  -e S3__AccessKey=staging-s3-key \
  -e S3__SecretKey=staging-s3-secret \
  your-registry/your-app-image:latest

生产容器启动命令： #

docker run -d \
  -e ASPNETCORE_ENVIRONMENT=Production \
  -e ConnectionStrings__DefaultConnection="Server=prod-db;Database=app;User Id=prod-user;Password=prod-pass" \
  -e S3__AccessKey=prod-s3-key \
  -e S3__SecretKey=prod-s3-secret \
  your-registry/your-app-image:latest

.NET会自动优先读取环境变量的配置，覆盖appsettings.json的默认值；如果你的镜像里包含appsettings.Staging.json或appsettings.Production.json，它还会根据ASPNETCORE_ENVIRONMENT加载对应文件，再叠加环境变量的配置。

方法2：挂载外部配置文件到容器 #

如果需要使用完整的环境专属appsettings文件，可以把预发布、生产的配置文件分别放在对应服务器上，启动容器时挂载到容器内的配置目录。

预发布启动命令： #

docker run -d \
  -e ASPNETCORE_ENVIRONMENT=Staging \
  -v /opt/config/appsettings.Staging.json:/app/appsettings.Staging.json \
  your-registry/your-app-image:latest

生产启动命令： #

docker run -d \
  -e ASPNETCORE_ENVIRONMENT=Production \
  -v /opt/config/appsettings.Production.json:/app/appsettings.Production.json \
  your-registry/your-app-image:latest

注意：容器内的路径要和你的.NET应用发布后配置文件的实际路径一致，通常默认是/app目录。

方法3：Docker Configs（适用于Swarm集群部署） #

如果用Docker Swarm管理集群，可以用Docker Configs来统一管理不同环境的配置文件，避免在服务器上手动维护文件。

创建预发布配置： #

docker config create app-settings-staging /本地路径/appsettings.Staging.json

创建生产配置： #

docker config create app-settings-prod /本地路径/appsettings.Production.json

部署预发布服务： #

docker service create \
  --name app-staging \
  --env ASPNETCORE_ENVIRONMENT=Staging \
  --config source=app-settings-staging,target=/app/appsettings.Staging.json \
  your-registry/your-app-image:latest

部署生产服务： #

docker service create \
  --name app-prod \
  --env ASPNETCORE_ENVIRONMENT=Production \
  --config source=app-settings-prod,target=/app/appsettings.Production.json \
  your-registry/your-app-image:latest

关键注意事项 #

• 绝对不要把数据库密码、S3密钥这类敏感信息硬编码到镜像里，用环境变量或外部挂载的方式管理，防止泄露。
• 优先用环境变量覆盖单个配置项，比替换整个文件更灵活，也更容易在CI/CD流程中集成。
• 确保ASPNETCORE_ENVIRONMENT变量设置正确，这是.NET加载对应环境配置的核心开关。

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