在银河麒麟 V10 上使用 Docker 和 Compose 部署 .NET 8 WebAPI

如果在 Windows 开发机上做：

winget install Microsoft.DotNet.SDK.8
mkdir KylinDotNetWebAPI
cd KylinDotNetWebAPI
dotnet new webapi -n KylinDotNetWebAPI -o .
dotnet new gitignore
dotnet run
# 访问 http://localhost:5200/WeatherForecast 测试

如果想在服务器上直接创建并预览，下载安装脚本：

wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh -c 8.0 --install-dir /usr/share/dotnet
export DOTNET_ROOT=/usr/share/dotnet
export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
mkdir -p /opt/dotnet/KylinDotNetWebAPI
cd /opt/dotnet/KylinDotNetWebAPI
dotnet new webapi -n KylinDotNetWebAPI -o .
dotnet run

项目结构大概是这样：

KylinDotNetWebAPI/
├── Controllers/       # 示例控制器
├── Properties/        # 启动配置
├── appsettings.json
├── appsettings.Development.json
├── Program.cs
├── KylinDotNetWebAPI.csproj
└── .gitignore

Dockerfile 与 Compose 配置

在项目根目录创建 Dockerfile，使用多阶段构建缩小最终镜像体积：

# 阶段 1：构建
FROM mcr.microsoft.com/dotnet/sdk:8.0-alpine AS build
WORKDIR /src
COPY ["KylinDotNetWebAPI.csproj", "./"]
RUN dotnet restore "./KylinDotNetWebAPI.csproj"
COPY . .
WORKDIR "/src/"
RUN dotnet build "KylinDotNetWebAPI.csproj" -c Release -o /app/build
RUN dotnet publish "KylinDotNetWebAPI.csproj" -c Release -o /app/publish /p:UseAppHost=false

# 阶段 2：运行
FROM mcr.microsoft.com/dotnet/aspnet:8.0-alpine AS base
WORKDIR /app
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
COPY --from=build /app/publish .
EXPOSE 5000
EXPOSE 5001
ENV ASPNETCORE_URLS=http://+:5000;https://+:5001
ENTRYPOINT ["dotnet", "KylinDotNetWebAPI.dll"]

同时添加 .dockerignore 文件，避免把不必要的文件打包进上下文：

bin/
obj/
*.swp
*.swo
*~
logs/
*.log
*Tests*/
*.Tests.csproj
.env
.env.local
.env.development.local
.env.test.local
.env.production.local
.idea/
.vscode/
*.suo
*.ntvs*
*.njsproj
*.sln
*.sw?

再用 Compose 管理容器，创建 docker-compose.yml：

version: '3.8'
services:
  kylin-webapi:
    image: kylin-dotnet-webapi:latest
    container_name: kylin-dotnet-webapi
    restart: always
    build:
      context: .
      dockerfile: Dockerfile
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - ASPNETCORE_HTTP_PORTS=5000
      - ASPNETCORE_HTTPS_PORTS=5001
    ports:
      - "5000:5000"
      - "5001:5001"
    volumes:
      - ./logs:/app/logs
    networks:
      - dotnet-network

networks:
  dotnet-network:
    driver: bridge

构建、运行与验证

进入项目目录，先构建镜像：

cd /opt/dotnet/KylinDotNetWebAPI
docker-compose build

或者直接用 docker 命令：

docker build -t kylin-dotnet-webapi:latest .

启动服务：

docker-compose up -d

也可以不用 Compose，手动运行：

docker run -d \
  --name kylin-dotnet-webapi \
  --restart always \
  -p 5000:5000 \
  -p 5001:5001 \
  -e ASPNETCORE_ENVIRONMENT=Production \
  kylin-dotnet-webapi:latest

查看容器状态与日志：

docker-compose ps
docker-compose logs -f
# 或
docker ps
docker logs -f kylin-dotnet-webapi

服务启动后，用 curl 测试 API：

curl http://localhost:5000/WeatherForecast

如果从外部访问，用服务器的 IP，浏览器打开 http://服务器IP:5000/WeatherForecast 即可。HTTPS 首次访问时可能有证书警告，生产环境请换正式证书。

健康检查可以简单发个 HEAD 请求：

curl -I http://服务器IP:5000/WeatherForecast

应该返回 200。

配置与优化

应用配置主要通过 appsettings.json 和环境变量。修改配置文件后需要重建镜像并重启容器：

docker-compose up -d --build

环境变量可以在 docker-compose.yml 里加，例如数据库连接：

environment:
  - ConnectionStrings__DefaultConnection=Server=db;Database=WebAPIDemo;User=sa;Password=YourStrongPassword123!

日志配置在 appsettings.json 中：

"Logging": {
  "LogLevel": {
    "Default": "Information",
    "Microsoft.AspNetCore": "Warning"
  },
  "File": {
    "LogLevel": { "Default": "Information" },
    "Path": "/app/logs/webapi.log",
    "RollingInterval": "Day"
  }
}

如果想追求更高性能，可以考虑启用 AOT 编译（.NET 7+ 支持），但需要修改项目文件和发布命令，编译时长会变长，启动更快，镜像更小。这里不展开，可以自行查阅文档。

开机自启动

容器已经设置了 restart: always，但要保证 Docker 服务本身是开机自启的：

sudo systemctl enable docker

如果用了 Compose，可以创建一个 systemd 单元，让服务器重启时自动拉起 Compose 服务：

cat > /etc/systemd/system/kylin-dotnet-webapi.service <<EOF
[Unit]
Description=Kylin .NET 8 WebAPI Docker Service
Requires=docker.service
After=docker.service

[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/opt/dotnet/KylinDotNetWebAPI
ExecStart=/usr/local/bin/docker-compose up -d
ExecStop=/usr/local/bin/docker-compose down
TimeoutStartSec=0

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable kylin-dotnet-webapi
sudo systemctl start kylin-dotnet-webapi
sudo systemctl status kylin-dotnet-webapi

常见问题

端口被占用：用 netstat -tuln | grep 5000 查占用的进程，杀掉即可。

容器启动失败：查看日志 docker-compose logs -f 或 docker events --since 1h。

API 返回 500：进容器看应用日志 docker exec -it kylin-dotnet-webapi tail -f /app/logs/webapi.log。

依赖项问题：在项目目录执行 dotnet restore 和 dotnet build。

数据库连接不上：检查连接字符串和数据库服务是否正常，网络是否互通。

高级功能

HTTPS 配置

生成自签名证书（仅测试用）：

openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes
export password=YourCertificatePassword123!
openssl pkcs12 -export -out certificate.pfx -inkey key.pem -in cert.pem -passout pass:$password

然后在 Compose 里挂载证书并设置密码：

volumes:
  - ./certificate.pfx:/app/certificate.pfx
environment:
  - ASPNETCORE_Kestrel__Certificates__Default__Password=YourCertificatePassword123!
  - ASPNETCORE_Kestrel__Certificates__Default__Path=/app/certificate.pfx

集成数据库（以 MySQL 为例）

在 Compose 中添加 MySQL 服务，并让 WebAPI 依赖它：

services:
  kylin-webapi:
    # ... 已有配置
    depends_on:
      - mysql
  mysql:
    image: mysql:8.0
    container_name: mysql
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=YourRootPassword123!
      - MYSQL_DATABASE=WebAPIDemo
      - MYSQL_USER=webapi
      - MYSQL_PASSWORD=YourStrongPassword123!
    ports:
      - "3306:3306"
    volumes:
      - mysql-data:/var/lib/mysql
    networks:
      - dotnet-network

volumes:
  mysql-data:

Nginx 反向代理

如果需要通过域名访问，可以在前面加一层 Nginx，配置如下：

cat > /opt/docker/nginx/conf/conf.d/webapi.example.com.conf <<EOF
server {
  listen 80;
  server_name webapi.example.com;
  location / {
    proxy_pass http://服务器IP:5000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection keep-alive;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_cache_bypass $http_upgrade;
  }
}
EOF

以上就是部署的全过程，从环境准备到服务跑起来，再到加自启动和扩展功能都覆盖了。如果只跑个简单的 API，其实用不到这么多步骤，按需裁剪即可。参考资料放在文末，有问题可以查阅。

参考资料

• .NET 8 官方文档
• Docker 官方文档
• 银河麒麟 v10 服务器版官方文档
• ASP.NET Core WebAPI 文档