|
|
# 浩景CNC机床数据采集分析系统 - 部署指南
|
|
|
|
|
|
## 文档信息
|
|
|
|
|
|
| 项目 | 内容 |
|
|
|
|------|------|
|
|
|
| 版本 | v1.0.0 |
|
|
|
| 日期 | 2026-04-13 |
|
|
|
| 部署方式 | 使用 deploy.ps1 一键构建 + IIS 手动配置 |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 目录
|
|
|
|
|
|
1. [部署流程概述](#1-部署流程概述)
|
|
|
2. [第一步：运行部署脚本](#2-第一步运行部署脚本)
|
|
|
3. [第二步：配置数据库](#3-第二步配置数据库)
|
|
|
4. [第三步：复制文件到 IIS 目录](#4-第三步复制文件到-iis-目录)
|
|
|
5. [第四步：IIS 配置](#5-第四步iis-配置)
|
|
|
6. [第五步：修改生产配置](#6-第五步修改生产配置)
|
|
|
7. [第六步：验证部署](#7-第六步验证部署)
|
|
|
8. [故障排查](#8-故障排查)
|
|
|
|
|
|
---
|
|
|
|
|
|
## 1. 部署流程概述
|
|
|
|
|
|
### 目录结构（扁平化）
|
|
|
|
|
|
```
|
|
|
C:\wwwroot\haoliang\ ← IIS 网站根目录
|
|
|
├── Haoliang.Api.exe # 后端 API 主程序
|
|
|
├── Haoliang.Api.dll
|
|
|
├── appsettings.json # 开发配置
|
|
|
├── appsettings.Production.json # 生产配置 ← 需修改
|
|
|
├── web.config # IIS 配置文件
|
|
|
├── logs\ # 日志目录
|
|
|
├── data\ # 数据目录
|
|
|
├── admin\ # 管理后台 (访问 /admin/*)
|
|
|
│ ├── index.html
|
|
|
│ └── assets\
|
|
|
└── dashboard\ # BI 大屏 (访问 /dashboard/*)
|
|
|
├── index.html
|
|
|
└── assets\
|
|
|
```
|
|
|
|
|
|
### 访问地址
|
|
|
|
|
|
| 应用 | URL |
|
|
|
|------|-----|
|
|
|
| API | http://localhost:5000/api/v1/* |
|
|
|
| Admin | http://localhost:5000/admin |
|
|
|
| Dashboard | http://localhost:5000/dashboard |
|
|
|
| Swagger | http://localhost:5000/swagger |
|
|
|
|
|
|
### 部署流程
|
|
|
|
|
|
```
|
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
|
│ 1. 运行 deploy.ps1 构建项目 │
|
|
|
│ 输出: publish\wwwroot\ │
|
|
|
└─────────────────────────────────────────────────────────────┘
|
|
|
↓
|
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
|
│ 2. 配置数据库 (MariaDB) │
|
|
|
│ ├─ 创建数据库和用户 │
|
|
|
│ └─ 导入 cnc_business.sql / cnc_log_fixed.sql │
|
|
|
└─────────────────────────────────────────────────────────────┘
|
|
|
↓
|
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
|
│ 3. 复制文件到 IIS 目录 │
|
|
|
│ └─ publish\wwwroot\* → C:\wwwroot\haoliang\ │
|
|
|
└─────────────────────────────────────────────────────────────┘
|
|
|
↓
|
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
|
│ 4. IIS 配置（极简：仅 1 个网站） │
|
|
|
│ └─ 网站 Haoliang，物理路径 C:\wwwroot\haoliang │
|
|
|
└─────────────────────────────────────────────────────────────┘
|
|
|
↓
|
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
|
│ 5. 修改生产配置 │
|
|
|
│ └─ 修改 appsettings.Production.json 数据库连接 │
|
|
|
└─────────────────────────────────────────────────────────────┘
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 2. 第一步：运行部署脚本
|
|
|
|
|
|
### 2.1 执行构建
|
|
|
|
|
|
```powershell
|
|
|
cd D:\git\git\haoliang
|
|
|
.\deploy.ps1
|
|
|
```
|
|
|
|
|
|
### 2.2 构建输出
|
|
|
|
|
|
```
|
|
|
D:\git\git\haoliang\publish\wwwroot\
|
|
|
├── Haoliang.Api.exe # 后端主程序
|
|
|
├── Haoliang.Api.dll
|
|
|
├── appsettings.json
|
|
|
├── appsettings.Production.json # ← 稍后修改
|
|
|
├── web.config
|
|
|
├── logs\
|
|
|
├── data\
|
|
|
├── admin\ # /admin 访问
|
|
|
│ ├── index.html
|
|
|
│ └── assets\
|
|
|
└── dashboard\ # /dashboard 访问
|
|
|
├── index.html
|
|
|
└── assets\
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 3. 第二步：配置数据库
|
|
|
|
|
|
### 3.1 登录 MariaDB
|
|
|
|
|
|
```powershell
|
|
|
mysql -u root -p
|
|
|
```
|
|
|
|
|
|
### 3.2 创建数据库和用户
|
|
|
|
|
|
```sql
|
|
|
-- 创建专用数据库用户（请修改密码）
|
|
|
CREATE USER 'haoliang'@'localhost' IDENTIFIED BY 'YourStrongPassword123!';
|
|
|
CREATE USER 'haoliang'@'127.0.0.1' IDENTIFIED BY 'YourStrongPassword123!';
|
|
|
|
|
|
-- 创建业务库
|
|
|
CREATE DATABASE cnc_business CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
|
|
|
|
|
-- 创建日志库
|
|
|
CREATE DATABASE cnc_log CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
|
|
|
|
|
-- 授权
|
|
|
GRANT ALL PRIVILEGES ON cnc_business.* TO 'haoliang'@'localhost';
|
|
|
GRANT ALL PRIVILEGES ON cnc_log.* TO 'haoliang'@'localhost';
|
|
|
|
|
|
FLUSH PRIVILEGES;
|
|
|
```
|
|
|
|
|
|
### 3.3 导入数据库脚本
|
|
|
|
|
|
```powershell
|
|
|
cd D:\git\git\haoliang\database
|
|
|
|
|
|
mysql -u haoliang -p cnc_business < cnc_business.sql
|
|
|
mysql -u haoliang -p cnc_log < cnc_log_fixed.sql
|
|
|
```
|
|
|
|
|
|
### 3.4 验证数据库
|
|
|
|
|
|
```powershell
|
|
|
mysql -u haoliang -p -e "USE cnc_business; SHOW TABLES;"
|
|
|
mysql -u haoliang -p -e "USE cnc_log; SHOW TABLES;"
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 4. 第三步：复制文件到 IIS 目录
|
|
|
|
|
|
### 4.1 创建目标目录
|
|
|
|
|
|
```powershell
|
|
|
New-Item -ItemType Directory -Path "C:\wwwroot\haoliang" -Force
|
|
|
New-Item -ItemType Directory -Path "C:\wwwroot\haoliang\logs" -Force
|
|
|
New-Item -ItemType Directory -Path "C:\wwwroot\haoliang\data" -Force
|
|
|
```
|
|
|
|
|
|
### 4.2 复制文件
|
|
|
|
|
|
```powershell
|
|
|
Copy-Item -Path "D:\git\git\haoliang\publish\wwwroot\*" -Destination "C:\wwwroot\haoliang\" -Recurse -Force
|
|
|
```
|
|
|
|
|
|
### 4.3 验证目录结构
|
|
|
|
|
|
```
|
|
|
C:\wwwroot\haoliang\
|
|
|
├── Haoliang.Api.exe
|
|
|
├── web.config
|
|
|
├── appsettings.json
|
|
|
├── appsettings.Production.json
|
|
|
├── logs\
|
|
|
├── data\
|
|
|
├── admin\
|
|
|
│ ├── index.html
|
|
|
│ └── assets\
|
|
|
└── dashboard\
|
|
|
├── index.html
|
|
|
└── assets\
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 5. 第四步：IIS 配置
|
|
|
|
|
|
### 5.1 创建应用程序池
|
|
|
|
|
|
```powershell
|
|
|
New-WebAppPool -Name "HaoliangApi"
|
|
|
Set-ItemProperty -Path "IIS:\AppPools\HaoliangApi" -Name "managedRuntimeVersion" -Value ""
|
|
|
Set-ItemProperty -Path "IIS:\AppPools\HaoliangApi" -Name "managedPipelineMode" -Value "Integrated"
|
|
|
Start-WebAppPool -Name "HaoliangApi"
|
|
|
```
|
|
|
|
|
|
### 5.2 创建网站（重要：直接指向根目录）
|
|
|
|
|
|
```powershell
|
|
|
New-WebSite -Name "Haoliang" -PhysicalPath "C:\wwwroot\haoliang" -Port 5000 -ApplicationPool "HaoliangApi"
|
|
|
Start-WebSite -Name "Haoliang"
|
|
|
```
|
|
|
|
|
|
> **注意**：物理路径直接指向 `C:\wwwroot\haoliang`，不是子目录。admin 和 dashboard 是文件目录，不需要创建 IIS 子应用。
|
|
|
|
|
|
### 5.3 设置目录权限
|
|
|
|
|
|
```powershell
|
|
|
# API 目录权限
|
|
|
icacls "C:\wwwroot\haoliang" /grant "IIS AppPool\HaoliangApi:(OI)(CI)M"
|
|
|
icacls "C:\wwwroot\haoliang\logs" /grant "IIS AppPool\HaoliangApi:(OI)(CI)M"
|
|
|
icacls "C:\wwwroot\haoliang\data" /grant "IIS AppPool\HaoliangApi:(OI)(CI)M"
|
|
|
|
|
|
# 前端目录权限
|
|
|
icacls "C:\wwwroot\haoliang\admin" /grant "IIS_IUSRS:(OI)(CI)RX"
|
|
|
icacls "C:\wwwroot\haoliang\dashboard" /grant "IIS_IUSRS:(OI)(CI)RX"
|
|
|
```
|
|
|
|
|
|
### 5.4 防火墙配置（如需要）
|
|
|
|
|
|
```powershell
|
|
|
New-NetFirewallRule -DisplayName "Haoliang API" -Direction Inbound -Protocol TCP -LocalPort 5000 -Action Allow -Profile Any
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 6. 第五步：修改生产配置
|
|
|
|
|
|
### 6.1 编辑配置文件
|
|
|
|
|
|
打开 `C:\wwwroot\haoliang\appsettings.Production.json`
|
|
|
|
|
|
### 6.2 修改数据库连接
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
"ConnectionStrings": {
|
|
|
"CNCBusinessDB": "Server=localhost;Database=cnc_business;User=haoliang;Password=YourStrongPassword123!;CharSet=utf8mb4;",
|
|
|
"CNCLLogDB": "Server=localhost;Database=cnc_log;User=haoliang;Password=YourStrongPassword123!;CharSet=utf8mb4;"
|
|
|
}
|
|
|
}
|
|
|
```
|
|
|
|
|
|
### 6.3 重启应用程序池
|
|
|
|
|
|
```powershell
|
|
|
Restart-WebAppPool -Name "HaoliangApi"
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 7. 第六步：验证部署
|
|
|
|
|
|
### 7.1 检查服务状态
|
|
|
|
|
|
```powershell
|
|
|
Get-WebSiteState -Name "Haoliang"
|
|
|
Get-WebAppPoolState -Name "HaoliangApi"
|
|
|
```
|
|
|
|
|
|
### 7.2 浏览器访问测试
|
|
|
|
|
|
| URL | 预期结果 |
|
|
|
|-----|----------|
|
|
|
| http://localhost:5000/ | API 响应 |
|
|
|
| http://localhost:5000/api/v1/health | 健康检查 JSON |
|
|
|
| http://localhost:5000/admin | 管理后台登录页 |
|
|
|
| http://localhost:5000/dashboard | BI 大屏首页 |
|
|
|
|
|
|
### 7.3 查看日志
|
|
|
|
|
|
```powershell
|
|
|
Get-Content "C:\wwwroot\haoliang\logs\stdout_*.log" -Tail 20
|
|
|
Get-Content "C:\wwwroot\haoliang\logs\app-*.log" -Tail 20
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 8. 故障排查
|
|
|
|
|
|
### 8.1 常见错误
|
|
|
|
|
|
| 错误 | 原因 | 解决方案 |
|
|
|
|------|------|----------|
|
|
|
| 500.19 | web.config 语法错误 | 检查 web.config |
|
|
|
| 500.21 | .NET Core 模块未安装 | 安装 Hosting Bundle |
|
|
|
| 502.5 | 应用程序启动失败 | 检查数据库连接 |
|
|
|
| 404 | 路径不存在 | 检查物理路径配置 |
|
|
|
|
|
|
### 8.2 排查步骤
|
|
|
|
|
|
```powershell
|
|
|
# 1. 检查应用程序池状态
|
|
|
Get-WebAppPoolState -Name "HaoliangApi"
|
|
|
|
|
|
# 2. 查看错误日志
|
|
|
Get-Content "C:\wwwroot\haoliang\logs\stdout_*.log" | Select-String "Error"
|
|
|
|
|
|
# 3. 测试数据库连接
|
|
|
mysql -u haoliang -p -e "USE cnc_business; SELECT 1;"
|
|
|
|
|
|
# 4. 检查端口占用
|
|
|
netstat -an | findstr ":5000"
|
|
|
```
|
|
|
|
|
|
### 8.3 快速重启
|
|
|
|
|
|
```powershell
|
|
|
Restart-WebAppPool -Name "HaoliangApi"
|
|
|
Start-WebSite -Name "Haoliang"
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 部署清单
|
|
|
|
|
|
```
|
|
|
[ ] 1. 运行 deploy.ps1 构建成功
|
|
|
[ ] 2. MariaDB 数据库已创建
|
|
|
[ ] 3. 数据库用户 haoliang 已创建并授权
|
|
|
[ ] 4. 数据库脚本已导入
|
|
|
[ ] 5. 文件已复制到 C:\wwwroot\haoliang
|
|
|
[ ] 6. 应用程序池 HaoliangApi 已创建
|
|
|
[ ] 7. 网站 Haoliang 已创建 (端口 5000，物理路径指向根目录)
|
|
|
[ ] 8. 目录权限已设置
|
|
|
[ ] 9. appsettings.Production.json 数据库连接已修改
|
|
|
[ ] 10. 应用程序池已重启
|
|
|
[ ] 11. 浏览器访问测试通过
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
*文档最后更新：2026-04-13*
|