修复系统概览数据不准确的查询。修复交叉评查意见列表的数量查询。优化全局消息提示的层级。优化提交意见进行局部更新。
This commit is contained in:
@@ -0,0 +1,422 @@
|
||||
# Ubuntu环境下Nginx多客户端测试指南
|
||||
|
||||
## 概述
|
||||
|
||||
本指南详细说明如何在Ubuntu环境中配置和测试Nginx反向代理多客户端功能，实现根据不同端口动态切换API配置的能力。
|
||||
|
||||
## 架构说明
|
||||
|
||||
```
|
||||
客户端访问端口 Nginx代理 开发服务器
|
||||
5174 (client-a) ──→ 反向代理 ──→ 172.16.0.34:5173
|
||||
5175 (client-b) ──→ 反向代理 ──→ 172.16.0.34:5173
|
||||
5176 (client-c) ──→ 反向代理 ──→ 172.16.0.34:5173
|
||||
5177 (client-d) ──→ 反向代理 ──→ 172.16.0.34:5173
|
||||
```
|
||||
|
||||
每个端口通过 `X-Client-ID` 头部传递客户端标识，应用根据此标识动态选择对应的API配置。
|
||||
|
||||
## 环境要求
|
||||
|
||||
### 系统要求
|
||||
- Ubuntu 18.04+ 或其他Linux发行版
|
||||
- Nginx 1.18+
|
||||
- Node.js 18+
|
||||
- 网络访问权限到 172.16.0.34:5173
|
||||
|
||||
### 端口要求
|
||||
- 5174-5177：Nginx监听端口
|
||||
- 5173：开发服务器端口（需要在172.16.0.34上运行）
|
||||
|
||||
## 安装和配置步骤
|
||||
|
||||
### 1. 安装Nginx
|
||||
|
||||
```bash
|
||||
# 更新包管理器
|
||||
sudo apt update
|
||||
|
||||
# 安装Nginx
|
||||
sudo apt install nginx -y
|
||||
|
||||
# 检查Nginx版本
|
||||
nginx -v
|
||||
|
||||
# 启动Nginx服务
|
||||
sudo systemctl start nginx
|
||||
sudo systemctl enable nginx
|
||||
```
|
||||
|
||||
### 2. 配置Nginx
|
||||
|
||||
#### 2.1 备份原配置
|
||||
```bash
|
||||
# 备份默认配置
|
||||
sudo cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.backup
|
||||
sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.backup
|
||||
```
|
||||
|
||||
#### 2.2 创建多客户端配置
|
||||
```bash
|
||||
# 创建配置目录
|
||||
sudo mkdir -p /etc/nginx/conf.d
|
||||
|
||||
# 复制优化后的配置文件
|
||||
sudo cp nginx-ubuntu-optimized.conf /etc/nginx/conf.d/multi-client.conf
|
||||
|
||||
# 或者直接创建配置文件
|
||||
sudo nano /etc/nginx/conf.d/multi-client.conf
|
||||
# 然后粘贴 nginx-ubuntu-optimized.conf 的内容
|
||||
```
|
||||
|
||||
#### 2.3 创建日志目录
|
||||
```bash
|
||||
# 创建客户端专用日志目录
|
||||
sudo mkdir -p /var/log/nginx/clients
|
||||
|
||||
# 设置权限
|
||||
sudo chown -R www-data:www-data /var/log/nginx/clients
|
||||
sudo chmod -R 755 /var/log/nginx/clients
|
||||
```
|
||||
|
||||
#### 2.4 修改主配置文件
|
||||
```bash
|
||||
# 编辑主配置文件
|
||||
sudo nano /etc/nginx/nginx.conf
|
||||
```
|
||||
|
||||
确保包含以下配置：
|
||||
```nginx
|
||||
http {
|
||||
# 包含多客户端配置
|
||||
include /etc/nginx/conf.d/*.conf;
|
||||
|
||||
# 日志格式（如果主配置中没有）
|
||||
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
|
||||
'$status $body_bytes_sent "$http_referer" '
|
||||
'"$http_user_agent" "$http_x_forwarded_for"';
|
||||
|
||||
# 其他配置...
|
||||
}
|
||||
```
|
||||
|
||||
### 3. 验证配置
|
||||
|
||||
```bash
|
||||
# 测试Nginx配置语法
|
||||
sudo nginx -t
|
||||
|
||||
# 如果配置正确，重新加载Nginx
|
||||
sudo systemctl reload nginx
|
||||
|
||||
# 检查Nginx状态
|
||||
sudo systemctl status nginx
|
||||
```
|
||||
|
||||
### 4. 防火墙配置
|
||||
|
||||
```bash
|
||||
# 允许Nginx端口通过防火墙
|
||||
sudo ufw allow 5174
|
||||
sudo ufw allow 5175
|
||||
sudo ufw allow 5176
|
||||
sudo ufw allow 5177
|
||||
|
||||
# 或者允许端口范围
|
||||
sudo ufw allow 5174:5177/tcp
|
||||
|
||||
# 检查防火墙状态
|
||||
sudo ufw status
|
||||
```
|
||||
|
||||
## 应用配置修改
|
||||
|
||||
### 1. 修改api-config.ts
|
||||
|
||||
需要在开发环境配置中添加第四个客户端：
|
||||
|
||||
```typescript
|
||||
const getClientConfigs = (env: string): Record<string, Partial<ApiConfig>> => {
|
||||
if (env === 'development') {
|
||||
return {
|
||||
'client-a': {
|
||||
baseUrl: 'http://172.16.0.34:5174',
|
||||
uploadUrl: 'http://172.16.0.34:5174/admin/documents',
|
||||
// ... oauth配置
|
||||
},
|
||||
'client-b': {
|
||||
baseUrl: 'http://172.16.0.34:5175',
|
||||
uploadUrl: 'http://172.16.0.34:5175/admin/documents',
|
||||
// ... oauth配置
|
||||
},
|
||||
'client-c': {
|
||||
baseUrl: 'http://172.16.0.34:5176',
|
||||
uploadUrl: 'http://172.16.0.34:5176/admin/documents',
|
||||
// ... oauth配置
|
||||
},
|
||||
'client-d': {
|
||||
baseUrl: 'http://172.16.0.34:5177',
|
||||
uploadUrl: 'http://172.16.0.34:5177/admin/documents',
|
||||
// ... oauth配置
|
||||
}
|
||||
};
|
||||
}
|
||||
// ...
|
||||
};
|
||||
```
|
||||
|
||||
### 2. 添加客户端检测逻辑
|
||||
|
||||
在应用中添加根据请求头自动检测客户端的逻辑：
|
||||
|
||||
```typescript
|
||||
// 在服务器端或中间件中
|
||||
const detectClientFromHeaders = (request: Request): string => {
|
||||
// 从Nginx传递的头部获取客户端ID
|
||||
const clientId = request.headers.get('X-Client-ID');
|
||||
const originalPort = request.headers.get('X-Original-Port');
|
||||
|
||||
if (clientId) {
|
||||
return clientId;
|
||||
}
|
||||
|
||||
// 根据端口映射客户端ID
|
||||
const portToClient: Record<string, string> = {
|
||||
'5174': 'client-a',
|
||||
'5175': 'client-b',
|
||||
'5176': 'client-c',
|
||||
'5177': 'client-d'
|
||||
};
|
||||
|
||||
return portToClient[originalPort || ''] || 'main';
|
||||
};
|
||||
```
|
||||
|
||||
## 测试步骤
|
||||
|
||||
### 1. 启动开发服务器
|
||||
|
||||
确保在172.16.0.34机器上启动开发服务器：
|
||||
```bash
|
||||
# 在项目目录中
|
||||
npm run dev
|
||||
# 或
|
||||
pnpm dev
|
||||
# 确保服务运行在5173端口
|
||||
```
|
||||
|
||||
### 2. 测试Nginx代理
|
||||
|
||||
```bash
|
||||
# 测试各个端口的健康检查
|
||||
curl http://localhost:5174/health
|
||||
curl http://localhost:5175/health
|
||||
curl http://localhost:5176/health
|
||||
curl http://localhost:5177/health
|
||||
|
||||
# 测试代理功能
|
||||
curl -H "Accept: text/html" http://localhost:5174/
|
||||
curl -H "Accept: text/html" http://localhost:5175/
|
||||
```
|
||||
|
||||
### 3. 验证客户端标识传递
|
||||
|
||||
```bash
|
||||
# 检查请求头传递
|
||||
curl -v http://localhost:5174/api/test 2>&1 | grep "X-Client-ID"
|
||||
|
||||
# 查看Nginx访问日志
|
||||
sudo tail -f /var/log/nginx/client-a-access.log
|
||||
sudo tail -f /var/log/nginx/client-b-access.log
|
||||
```
|
||||
|
||||
### 4. 浏览器测试
|
||||
|
||||
在浏览器中访问：
|
||||
- http://172.16.0.34:5174 (Client A)
|
||||
- http://172.16.0.34:5175 (Client B)
|
||||
- http://172.16.0.34:5176 (Client C)
|
||||
- http://172.16.0.34:5177 (Client D)
|
||||
|
||||
### 5. 环境变量测试
|
||||
|
||||
```bash
|
||||
# 设置客户端ID环境变量测试
|
||||
export CLIENT_ID=client-a
|
||||
npm run dev
|
||||
|
||||
# 或在启动时指定
|
||||
CLIENT_ID=client-b npm run dev
|
||||
```
|
||||
|
||||
## 监控和调试
|
||||
|
||||
### 1. 日志监控
|
||||
|
||||
```bash
|
||||
# 实时监控所有客户端日志
|
||||
sudo tail -f /var/log/nginx/client-*-access.log
|
||||
|
||||
# 监控错误日志
|
||||
sudo tail -f /var/log/nginx/client-*-error.log
|
||||
|
||||
# 监控Nginx主错误日志
|
||||
sudo tail -f /var/log/nginx/error.log
|
||||
```
|
||||
|
||||
### 2. 性能监控
|
||||
|
||||
```bash
|
||||
# 检查Nginx进程状态
|
||||
sudo systemctl status nginx
|
||||
|
||||
# 查看端口监听状态
|
||||
sudo netstat -tlnp | grep nginx
|
||||
|
||||
# 检查连接数
|
||||
sudo ss -tuln | grep :517
|
||||
```
|
||||
|
||||
### 3. 调试工具
|
||||
|
||||
```bash
|
||||
# 使用curl测试详细信息
|
||||
curl -v -H "X-Test: true" http://localhost:5174/api/config
|
||||
|
||||
# 使用httpie（需要安装）
|
||||
sudo apt install httpie
|
||||
http GET localhost:5174/health X-Test:debug
|
||||
```
|
||||
|
||||
## 故障排除
|
||||
|
||||
### 常见问题
|
||||
|
||||
1. **端口被占用**
|
||||
```bash
|
||||
# 检查端口占用
|
||||
sudo lsof -i :5174
|
||||
# 杀死占用进程
|
||||
sudo kill -9 <PID>
|
||||
```
|
||||
|
||||
2. **权限问题**
|
||||
```bash
|
||||
# 检查Nginx用户权限
|
||||
sudo chown -R www-data:www-data /var/log/nginx/
|
||||
sudo chmod -R 755 /var/log/nginx/
|
||||
```
|
||||
|
||||
3. **配置语法错误**
|
||||
```bash
|
||||
# 详细检查配置
|
||||
sudo nginx -t -c /etc/nginx/nginx.conf
|
||||
```
|
||||
|
||||
4. **网络连接问题**
|
||||
```bash
|
||||
# 测试到开发服务器的连接
|
||||
telnet 172.16.0.34 5173
|
||||
# 或使用nc
|
||||
nc -zv 172.16.0.34 5173
|
||||
```
|
||||
|
||||
### 日志分析
|
||||
|
||||
```bash
|
||||
# 分析访问模式
|
||||
sudo awk '{print $1, $7, $9}' /var/log/nginx/client-a-access.log | sort | uniq -c
|
||||
|
||||
# 查找错误请求
|
||||
sudo grep "50[0-9]" /var/log/nginx/client-*-access.log
|
||||
|
||||
# 统计客户端访问量
|
||||
sudo grep -o 'client_id="[^"]*"' /var/log/nginx/client-*-access.log | sort | uniq -c
|
||||
```
|
||||
|
||||
## 性能优化建议
|
||||
|
||||
### 1. Nginx优化
|
||||
|
||||
```nginx
|
||||
# 在http块中添加
|
||||
worker_processes auto;
|
||||
worker_connections 1024;
|
||||
|
||||
# 启用gzip压缩
|
||||
gzip on;
|
||||
gzip_vary on;
|
||||
gzip_min_length 1024;
|
||||
gzip_types text/plain text/css application/json application/javascript;
|
||||
|
||||
# 缓存配置
|
||||
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=10g
|
||||
inactive=60m use_temp_path=off;
|
||||
```
|
||||
|
||||
### 2. 系统优化
|
||||
|
||||
```bash
|
||||
# 增加文件描述符限制
|
||||
echo "* soft nofile 65535" | sudo tee -a /etc/security/limits.conf
|
||||
echo "* hard nofile 65535" | sudo tee -a /etc/security/limits.conf
|
||||
|
||||
# 优化内核参数
|
||||
echo "net.core.somaxconn = 65535" | sudo tee -a /etc/sysctl.conf
|
||||
sudo sysctl -p
|
||||
```
|
||||
|
||||
## 部署到生产环境
|
||||
|
||||
### 1. 安全加固
|
||||
|
||||
```nginx
|
||||
# 隐藏Nginx版本
|
||||
server_tokens off;
|
||||
|
||||
# 限制请求大小
|
||||
client_max_body_size 10M;
|
||||
|
||||
# 添加安全头部
|
||||
add_header X-Frame-Options DENY;
|
||||
add_header X-Content-Type-Options nosniff;
|
||||
add_header X-XSS-Protection "1; mode=block";
|
||||
```
|
||||
|
||||
### 2. SSL配置
|
||||
|
||||
```nginx
|
||||
# HTTPS配置示例
|
||||
server {
|
||||
listen 443 ssl http2;
|
||||
ssl_certificate /path/to/cert.pem;
|
||||
ssl_certificate_key /path/to/key.pem;
|
||||
|
||||
# SSL优化配置
|
||||
ssl_protocols TLSv1.2 TLSv1.3;
|
||||
ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512;
|
||||
}
|
||||
```
|
||||
|
||||
### 3. 监控集成
|
||||
|
||||
```bash
|
||||
# 集成Prometheus监控
|
||||
sudo apt install nginx-module-prometheus
|
||||
|
||||
# 或使用日志分析工具
|
||||
sudo apt install goaccess
|
||||
goaccess /var/log/nginx/client-a-access.log -o report.html --log-format=COMBINED
|
||||
```
|
||||
|
||||
## 总结
|
||||
|
||||
通过以上配置，你可以在Ubuntu环境中成功测试Nginx多客户端反向代理功能。关键点包括：
|
||||
|
||||
1. **客户端标识传递**：通过 `X-Client-ID` 头部
|
||||
2. **端口映射**：5174-5177映射到不同客户端
|
||||
3. **配置动态切换**：应用根据客户端ID选择对应配置
|
||||
4. **日志分离**：每个客户端独立的访问和错误日志
|
||||
5. **健康检查**：每个端口提供独立的健康检查端点
|
||||
|
||||
这个方案为生产环境的多客户端部署提供了完整的测试基础。
|
||||
Reference in New Issue
Block a user