更新

README.md

@@ -47,19 +47,31 @@ dotnet run --project src/Jiaowu.Api
 
 ## MySQL 8.4 生产部署
 
-非 Development 环境只允许使用 MySQL。`dotnet publish` 会自动执行 `npm ci` 和 `npm run build`，并将 Vue 静态文件放入发布目录的 `wwwroot`：
+非 Development 环境只允许使用 MySQL。构建发布包与数据库配置相互独立：
+`dotnet publish` 不需要数据库连接串、JWT 密钥或生产环境变量，也不会把这些配置写入发布包。
+它会自动执行 `npm ci` 和 `npm run build`，并将 Vue 静态文件放入发布目录的
+`wwwroot`：
 
 ```powershell
-$env:ASPNETCORE_ENVIRONMENT = 'Production'
-$env:Database__Provider = 'MySql'
-$env:ConnectionStrings__MySql = 'Server=db.example.edu.cn;Port=3306;Database=jiaowu;User=YOUR_USER;Password=YOUR_PASSWORD;SslMode=VerifyFull;SslCa=C:\certs\mysql-ca.pem;'
-$env:Jwt__Key = '至少32字节的随机生产密钥'
-$env:AllowedHosts = 'jiaowu.example.edu.cn'
 dotnet publish src/Jiaowu.Api -c Release -o .artifacts/publish
 ```
 
 如需在特殊流水线中跳过自动前端构建，可传入 `-p:BuildFrontendOnPublish=false`。
 
+将发布包复制到目标服务器后，再通过 Windows 服务、容器编排平台或密钥管理系统，
+为 **应用运行进程** 注入配置。下面仅演示在当前 PowerShell 会话中配置；变量只对该
+会话及其启动的子进程生效：
+
+```powershell
+$env:ASPNETCORE_ENVIRONMENT = 'Production'
+$env:Database__Provider = 'MySql'
+$env:Jwt__Key = '至少32字节的随机生产密钥'
+$env:AllowedHosts = 'jiaowu.example.edu.cn'
+```
+
+这些值由 `Jiaowu.Api` 在每次启动时读取。不要把真实连接串或密钥写入仓库中的
+`appsettings*.json`，证书路径也必须是目标服务器上的实际路径。
+
 数据库应明确使用 `utf8mb4`；MySQL 8.4 的默认排序规则为
 `utf8mb4_0900_ai_ci`。新建数据库时可执行：
 
@@ -69,15 +81,18 @@ CREATE DATABASE `jiaowu`
   COLLATE utf8mb4_0900_ai_ci;
 ```
 
-发布前使用具备 DDL 权限的迁移账号单独执行迁移：
+首次部署或版本升级时，先在目标服务器设置具备 DDL 权限的迁移账号连接串，并单独
+执行迁移：
 
 ```powershell
+$env:ConnectionStrings__MySql = 'Server=db.example.edu.cn;Port=3306;Database=jiaowu;User=MIGRATION_USER;Password=MIGRATION_PASSWORD;SslMode=VerifyFull;SslCa=C:\certs\mysql-ca.pem;'
 & '.artifacts\publish\Jiaowu.Api.exe' --migrate-only
 ```
 
-迁移成功后，改用仅具备应用所需 DML 权限的运行账号并启动服务：
+迁移成功后，将连接串替换为仅具备应用所需 DML 权限的运行账号，再启动服务：
 
 ```powershell
+$env:ConnectionStrings__MySql = 'Server=db.example.edu.cn;Port=3306;Database=jiaowu;User=APP_USER;Password=APP_PASSWORD;SslMode=VerifyFull;SslCa=C:\certs\mysql-ca.pem;'
 & '.artifacts\publish\Jiaowu.Api.exe'
 ```