refactor(docs): 简化README结构，更新技术栈和项目结构描述
This commit is contained in:
992
docs/部署运维文档.md
Normal file
992
docs/部署运维文档.md
Normal file
@@ -0,0 +1,992 @@
|
||||
# 活牛采购智能数字化系统 - 部署运维文档
|
||||
|
||||
## 概述
|
||||
|
||||
本文档详细描述了活牛采购智能数字化系统的部署流程、运维管理、监控告警和故障处理等内容，为系统的稳定运行提供完整的运维指南。
|
||||
|
||||
## 环境要求
|
||||
|
||||
### 硬件要求
|
||||
|
||||
#### 最小配置
|
||||
- **CPU**: 2核心
|
||||
- **内存**: 4GB RAM
|
||||
- **存储**: 50GB SSD
|
||||
- **网络**: 10Mbps带宽
|
||||
|
||||
#### 推荐配置
|
||||
- **CPU**: 4核心以上
|
||||
- **内存**: 8GB RAM以上
|
||||
- **存储**: 100GB SSD以上
|
||||
- **网络**: 100Mbps带宽以上
|
||||
|
||||
#### 生产环境配置
|
||||
- **CPU**: 8核心以上
|
||||
- **内存**: 16GB RAM以上
|
||||
- **存储**: 500GB SSD以上
|
||||
- **网络**: 1Gbps带宽以上
|
||||
|
||||
### 软件要求
|
||||
|
||||
#### 操作系统
|
||||
- **Linux**: Ubuntu 20.04+ / CentOS 8+ / RHEL 8+
|
||||
- **macOS**: 10.15+ (仅开发环境)
|
||||
- **Windows**: Windows 10+ (仅开发环境)
|
||||
|
||||
#### 运行环境
|
||||
- **Node.js**: 18.x LTS
|
||||
- **npm**: 8.x+
|
||||
- **MySQL**: 8.0+
|
||||
- **Redis**: 6.x+ (可选)
|
||||
- **Nginx**: 1.18+ (生产环境)
|
||||
|
||||
#### 容器环境
|
||||
- **Docker**: 20.10+
|
||||
- **Docker Compose**: 2.0+
|
||||
|
||||
## 部署架构
|
||||
|
||||
### 单机部署架构
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 服务器 (单机) │
|
||||
├─────────────────────────────────────────┤
|
||||
│ Nginx (反向代理 + 静态文件服务) │
|
||||
├─────────────────────────────────────────┤
|
||||
│ Node.js 应用 (PM2管理) │
|
||||
├─────────────────────────────────────────┤
|
||||
│ MySQL 数据库 │
|
||||
├─────────────────────────────────────────┤
|
||||
│ Redis 缓存 (可选) │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 集群部署架构
|
||||
```
|
||||
┌─────────────┐ ┌─────────────────────────────────┐ ┌─────────────┐
|
||||
│ 负载均衡器 │ │ 应用服务器集群 │ │ 数据库集群 │
|
||||
│ (Nginx) │◄──►│ ┌─────────┐ ┌─────────┐ │◄──►│ (MySQL) │
|
||||
│ │ │ │ Node.js │ │ Node.js │ │ │ │
|
||||
│ │ │ │ App1 │ │ App2 │ │ │ 主从复制 │
|
||||
└─────────────┘ │ └─────────┘ └─────────┘ │ │ │
|
||||
│ ┌─────────┐ ┌─────────┐ │ └─────────────┘
|
||||
│ │ Redis │ │ 文件存储 │ │
|
||||
│ │ 缓存 │ │ (NFS) │ │
|
||||
│ └─────────┘ └─────────┘ │
|
||||
└─────────────────────────────────┘
|
||||
```
|
||||
|
||||
## 部署流程
|
||||
|
||||
### 1. 环境准备
|
||||
|
||||
#### 1.1 系统更新
|
||||
```bash
|
||||
# Ubuntu/Debian
|
||||
sudo apt update && sudo apt upgrade -y
|
||||
|
||||
# CentOS/RHEL
|
||||
sudo yum update -y
|
||||
```
|
||||
|
||||
#### 1.2 安装Node.js
|
||||
```bash
|
||||
# 使用NodeSource仓库安装
|
||||
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
|
||||
sudo apt-get install -y nodejs
|
||||
|
||||
# 验证安装
|
||||
node --version
|
||||
npm --version
|
||||
```
|
||||
|
||||
#### 1.3 安装MySQL
|
||||
```bash
|
||||
# Ubuntu/Debian
|
||||
sudo apt install mysql-server -y
|
||||
|
||||
# 启动并设置开机自启
|
||||
sudo systemctl start mysql
|
||||
sudo systemctl enable mysql
|
||||
|
||||
# 安全配置
|
||||
sudo mysql_secure_installation
|
||||
```
|
||||
|
||||
#### 1.4 安装Nginx
|
||||
```bash
|
||||
# Ubuntu/Debian
|
||||
sudo apt install nginx -y
|
||||
|
||||
# 启动并设置开机自启
|
||||
sudo systemctl start nginx
|
||||
sudo systemctl enable nginx
|
||||
```
|
||||
|
||||
#### 1.5 安装PM2
|
||||
```bash
|
||||
# 全局安装PM2
|
||||
sudo npm install -g pm2
|
||||
|
||||
# 设置PM2开机自启
|
||||
pm2 startup
|
||||
sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u $USER --hp $HOME
|
||||
```
|
||||
|
||||
### 2. 代码部署
|
||||
|
||||
#### 2.1 创建部署目录
|
||||
```bash
|
||||
sudo mkdir -p /var/www/niumall
|
||||
sudo chown $USER:$USER /var/www/niumall
|
||||
cd /var/www/niumall
|
||||
```
|
||||
|
||||
#### 2.2 克隆代码
|
||||
```bash
|
||||
# 从Git仓库克隆
|
||||
git clone https://github.com/your-org/niumall.git .
|
||||
|
||||
# 或者上传代码包
|
||||
# scp -r ./niumall user@server:/var/www/
|
||||
```
|
||||
|
||||
#### 2.3 安装依赖
|
||||
```bash
|
||||
# 后端依赖
|
||||
cd backend
|
||||
npm install --production
|
||||
|
||||
# 前端构建
|
||||
cd ../frontend
|
||||
npm install
|
||||
npm run build
|
||||
```
|
||||
|
||||
### 3. 数据库配置
|
||||
|
||||
#### 3.1 创建数据库
|
||||
```sql
|
||||
-- 登录MySQL
|
||||
mysql -u root -p
|
||||
|
||||
-- 创建数据库
|
||||
CREATE DATABASE niumall CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
||||
|
||||
-- 创建用户
|
||||
CREATE USER 'niumall'@'localhost' IDENTIFIED BY 'your_password';
|
||||
GRANT ALL PRIVILEGES ON niumall.* TO 'niumall'@'localhost';
|
||||
FLUSH PRIVILEGES;
|
||||
```
|
||||
|
||||
#### 3.2 配置环境变量
|
||||
```bash
|
||||
# 创建环境配置文件
|
||||
cd /var/www/niumall/backend
|
||||
cp .env.example .env
|
||||
|
||||
# 编辑配置文件
|
||||
nano .env
|
||||
```
|
||||
|
||||
```env
|
||||
# 数据库配置
|
||||
DB_HOST=localhost
|
||||
DB_PORT=3306
|
||||
DB_USERNAME=niumall
|
||||
DB_PASSWORD=your_password
|
||||
DB_NAME=niumall
|
||||
|
||||
# JWT配置
|
||||
JWT_SECRET=your_jwt_secret_key
|
||||
JWT_EXPIRES_IN=24h
|
||||
|
||||
# 应用配置
|
||||
NODE_ENV=production
|
||||
PORT=3000
|
||||
```
|
||||
|
||||
#### 3.3 初始化数据库
|
||||
```bash
|
||||
# 运行数据库迁移
|
||||
cd /var/www/niumall/backend
|
||||
npm run migrate
|
||||
|
||||
# 创建管理员用户
|
||||
node create_admin.js
|
||||
```
|
||||
|
||||
### 4. Nginx配置
|
||||
|
||||
#### 4.1 创建站点配置
|
||||
```bash
|
||||
sudo nano /etc/nginx/sites-available/niumall
|
||||
```
|
||||
|
||||
```nginx
|
||||
server {
|
||||
listen 80;
|
||||
server_name your-domain.com;
|
||||
|
||||
# 前端静态文件
|
||||
location / {
|
||||
root /var/www/niumall/frontend/dist;
|
||||
try_files $uri $uri/ /index.html;
|
||||
|
||||
# 缓存静态资源
|
||||
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
|
||||
expires 1y;
|
||||
add_header Cache-Control "public, immutable";
|
||||
}
|
||||
}
|
||||
|
||||
# API代理
|
||||
location /api/ {
|
||||
proxy_pass http://localhost:3000;
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Upgrade $http_upgrade;
|
||||
proxy_set_header Connection 'upgrade';
|
||||
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;
|
||||
|
||||
# 超时设置
|
||||
proxy_connect_timeout 60s;
|
||||
proxy_send_timeout 60s;
|
||||
proxy_read_timeout 60s;
|
||||
}
|
||||
|
||||
# 文件上传大小限制
|
||||
client_max_body_size 10M;
|
||||
|
||||
# 安全头
|
||||
add_header X-Frame-Options "SAMEORIGIN" always;
|
||||
add_header X-XSS-Protection "1; mode=block" always;
|
||||
add_header X-Content-Type-Options "nosniff" always;
|
||||
add_header Referrer-Policy "no-referrer-when-downgrade" always;
|
||||
add_header Content-Security-Policy "default-src 'self' http: https: data: blob: 'unsafe-inline'" always;
|
||||
}
|
||||
```
|
||||
|
||||
#### 4.2 启用站点
|
||||
```bash
|
||||
# 创建软链接
|
||||
sudo ln -s /etc/nginx/sites-available/niumall /etc/nginx/sites-enabled/
|
||||
|
||||
# 测试配置
|
||||
sudo nginx -t
|
||||
|
||||
# 重载配置
|
||||
sudo systemctl reload nginx
|
||||
```
|
||||
|
||||
### 5. SSL证书配置
|
||||
|
||||
#### 5.1 安装Certbot
|
||||
```bash
|
||||
# Ubuntu/Debian
|
||||
sudo apt install certbot python3-certbot-nginx -y
|
||||
```
|
||||
|
||||
#### 5.2 获取SSL证书
|
||||
```bash
|
||||
# 自动配置SSL
|
||||
sudo certbot --nginx -d your-domain.com
|
||||
|
||||
# 设置自动续期
|
||||
sudo crontab -e
|
||||
# 添加以下行
|
||||
0 12 * * * /usr/bin/certbot renew --quiet
|
||||
```
|
||||
|
||||
### 6. 应用启动
|
||||
|
||||
#### 6.1 PM2配置文件
|
||||
```bash
|
||||
cd /var/www/niumall/backend
|
||||
nano ecosystem.config.js
|
||||
```
|
||||
|
||||
```javascript
|
||||
module.exports = {
|
||||
apps: [{
|
||||
name: 'niumall-api',
|
||||
script: 'src/main.js',
|
||||
instances: 'max',
|
||||
exec_mode: 'cluster',
|
||||
env: {
|
||||
NODE_ENV: 'production',
|
||||
PORT: 3000
|
||||
},
|
||||
error_file: '/var/log/niumall/error.log',
|
||||
out_file: '/var/log/niumall/out.log',
|
||||
log_file: '/var/log/niumall/combined.log',
|
||||
time: true,
|
||||
max_memory_restart: '1G',
|
||||
node_args: '--max_old_space_size=1024'
|
||||
}]
|
||||
};
|
||||
```
|
||||
|
||||
#### 6.2 启动应用
|
||||
```bash
|
||||
# 创建日志目录
|
||||
sudo mkdir -p /var/log/niumall
|
||||
sudo chown $USER:$USER /var/log/niumall
|
||||
|
||||
# 启动应用
|
||||
pm2 start ecosystem.config.js
|
||||
|
||||
# 保存PM2配置
|
||||
pm2 save
|
||||
```
|
||||
|
||||
## 容器化部署
|
||||
|
||||
### 1. Docker部署
|
||||
|
||||
#### 1.1 Dockerfile配置
|
||||
|
||||
**后端Dockerfile**
|
||||
```dockerfile
|
||||
# backend/Dockerfile
|
||||
FROM node:18-alpine
|
||||
|
||||
WORKDIR /app
|
||||
|
||||
# 复制package文件
|
||||
COPY package*.json ./
|
||||
|
||||
# 安装依赖
|
||||
RUN npm ci --only=production
|
||||
|
||||
# 复制源代码
|
||||
COPY . .
|
||||
|
||||
# 暴露端口
|
||||
EXPOSE 3000
|
||||
|
||||
# 启动应用
|
||||
CMD ["npm", "start"]
|
||||
```
|
||||
|
||||
**前端Dockerfile**
|
||||
```dockerfile
|
||||
# frontend/Dockerfile
|
||||
FROM node:18-alpine as builder
|
||||
|
||||
WORKDIR /app
|
||||
COPY package*.json ./
|
||||
RUN npm ci
|
||||
COPY . .
|
||||
RUN npm run build
|
||||
|
||||
FROM nginx:alpine
|
||||
COPY --from=builder /app/dist /usr/share/nginx/html
|
||||
COPY nginx.conf /etc/nginx/nginx.conf
|
||||
EXPOSE 80
|
||||
CMD ["nginx", "-g", "daemon off;"]
|
||||
```
|
||||
|
||||
#### 1.2 Docker Compose配置
|
||||
```yaml
|
||||
# docker-compose.yml
|
||||
version: '3.8'
|
||||
|
||||
services:
|
||||
frontend:
|
||||
build: ./frontend
|
||||
ports:
|
||||
- "80:80"
|
||||
depends_on:
|
||||
- backend
|
||||
networks:
|
||||
- niumall-network
|
||||
|
||||
backend:
|
||||
build: ./backend
|
||||
ports:
|
||||
- "3000:3000"
|
||||
environment:
|
||||
- NODE_ENV=production
|
||||
- DB_HOST=database
|
||||
- DB_PORT=3306
|
||||
- DB_USERNAME=niumall
|
||||
- DB_PASSWORD=password
|
||||
- DB_NAME=niumall
|
||||
- JWT_SECRET=your_jwt_secret
|
||||
depends_on:
|
||||
- database
|
||||
networks:
|
||||
- niumall-network
|
||||
volumes:
|
||||
- ./logs:/app/logs
|
||||
|
||||
database:
|
||||
image: mysql:8.0
|
||||
environment:
|
||||
- MYSQL_ROOT_PASSWORD=rootpassword
|
||||
- MYSQL_DATABASE=niumall
|
||||
- MYSQL_USER=niumall
|
||||
- MYSQL_PASSWORD=password
|
||||
ports:
|
||||
- "3306:3306"
|
||||
volumes:
|
||||
- mysql_data:/var/lib/mysql
|
||||
- ./init.sql:/docker-entrypoint-initdb.d/init.sql
|
||||
networks:
|
||||
- niumall-network
|
||||
|
||||
redis:
|
||||
image: redis:6-alpine
|
||||
ports:
|
||||
- "6379:6379"
|
||||
networks:
|
||||
- niumall-network
|
||||
|
||||
volumes:
|
||||
mysql_data:
|
||||
|
||||
networks:
|
||||
niumall-network:
|
||||
driver: bridge
|
||||
```
|
||||
|
||||
#### 1.3 部署命令
|
||||
```bash
|
||||
# 构建并启动服务
|
||||
docker-compose up -d
|
||||
|
||||
# 查看服务状态
|
||||
docker-compose ps
|
||||
|
||||
# 查看日志
|
||||
docker-compose logs -f backend
|
||||
```
|
||||
|
||||
### 2. Kubernetes部署
|
||||
|
||||
#### 2.1 命名空间
|
||||
```yaml
|
||||
# k8s/namespace.yaml
|
||||
apiVersion: v1
|
||||
kind: Namespace
|
||||
metadata:
|
||||
name: niumall
|
||||
```
|
||||
|
||||
#### 2.2 配置映射
|
||||
```yaml
|
||||
# k8s/configmap.yaml
|
||||
apiVersion: v1
|
||||
kind: ConfigMap
|
||||
metadata:
|
||||
name: niumall-config
|
||||
namespace: niumall
|
||||
data:
|
||||
NODE_ENV: "production"
|
||||
DB_HOST: "mysql-service"
|
||||
DB_PORT: "3306"
|
||||
DB_NAME: "niumall"
|
||||
```
|
||||
|
||||
#### 2.3 密钥
|
||||
```yaml
|
||||
# k8s/secret.yaml
|
||||
apiVersion: v1
|
||||
kind: Secret
|
||||
metadata:
|
||||
name: niumall-secret
|
||||
namespace: niumall
|
||||
type: Opaque
|
||||
data:
|
||||
DB_PASSWORD: <base64-encoded-password>
|
||||
JWT_SECRET: <base64-encoded-jwt-secret>
|
||||
```
|
||||
|
||||
#### 2.4 部署配置
|
||||
```yaml
|
||||
# k8s/deployment.yaml
|
||||
apiVersion: apps/v1
|
||||
kind: Deployment
|
||||
metadata:
|
||||
name: niumall-backend
|
||||
namespace: niumall
|
||||
spec:
|
||||
replicas: 3
|
||||
selector:
|
||||
matchLabels:
|
||||
app: niumall-backend
|
||||
template:
|
||||
metadata:
|
||||
labels:
|
||||
app: niumall-backend
|
||||
spec:
|
||||
containers:
|
||||
- name: backend
|
||||
image: niumall/backend:latest
|
||||
ports:
|
||||
- containerPort: 3000
|
||||
envFrom:
|
||||
- configMapRef:
|
||||
name: niumall-config
|
||||
- secretRef:
|
||||
name: niumall-secret
|
||||
resources:
|
||||
requests:
|
||||
memory: "256Mi"
|
||||
cpu: "250m"
|
||||
limits:
|
||||
memory: "512Mi"
|
||||
cpu: "500m"
|
||||
```
|
||||
|
||||
## 监控和日志
|
||||
|
||||
### 1. 应用监控
|
||||
|
||||
#### 1.1 PM2监控
|
||||
```bash
|
||||
# 查看应用状态
|
||||
pm2 status
|
||||
|
||||
# 查看详细信息
|
||||
pm2 show niumall-api
|
||||
|
||||
# 查看日志
|
||||
pm2 logs niumall-api
|
||||
|
||||
# 重启应用
|
||||
pm2 restart niumall-api
|
||||
|
||||
# 重载应用（零停机）
|
||||
pm2 reload niumall-api
|
||||
```
|
||||
|
||||
#### 1.2 系统监控
|
||||
```bash
|
||||
# 安装htop
|
||||
sudo apt install htop -y
|
||||
|
||||
# 查看系统资源
|
||||
htop
|
||||
|
||||
# 查看磁盘使用
|
||||
df -h
|
||||
|
||||
# 查看内存使用
|
||||
free -h
|
||||
|
||||
# 查看网络连接
|
||||
netstat -tulpn
|
||||
```
|
||||
|
||||
### 2. 日志管理
|
||||
|
||||
#### 2.1 日志轮转配置
|
||||
```bash
|
||||
# 创建logrotate配置
|
||||
sudo nano /etc/logrotate.d/niumall
|
||||
```
|
||||
|
||||
```
|
||||
/var/log/niumall/*.log {
|
||||
daily
|
||||
missingok
|
||||
rotate 30
|
||||
compress
|
||||
delaycompress
|
||||
notifempty
|
||||
create 644 $USER $USER
|
||||
postrotate
|
||||
pm2 reloadLogs
|
||||
endscript
|
||||
}
|
||||
```
|
||||
|
||||
#### 2.2 日志分析
|
||||
```bash
|
||||
# 查看错误日志
|
||||
tail -f /var/log/niumall/error.log
|
||||
|
||||
# 分析访问日志
|
||||
tail -f /var/log/nginx/access.log
|
||||
|
||||
# 统计API调用
|
||||
grep "POST /api" /var/log/nginx/access.log | wc -l
|
||||
```
|
||||
|
||||
### 3. 性能监控
|
||||
|
||||
#### 3.1 安装监控工具
|
||||
```bash
|
||||
# 安装Node.js性能监控
|
||||
npm install -g clinic
|
||||
|
||||
# 使用clinic监控
|
||||
clinic doctor -- node src/main.js
|
||||
```
|
||||
|
||||
#### 3.2 数据库监控
|
||||
```sql
|
||||
-- 查看慢查询
|
||||
SHOW VARIABLES LIKE 'slow_query_log';
|
||||
SET GLOBAL slow_query_log = 'ON';
|
||||
SET GLOBAL long_query_time = 2;
|
||||
|
||||
-- 查看连接数
|
||||
SHOW STATUS LIKE 'Threads_connected';
|
||||
|
||||
-- 查看查询缓存
|
||||
SHOW STATUS LIKE 'Qcache%';
|
||||
```
|
||||
|
||||
## 备份和恢复
|
||||
|
||||
### 1. 数据库备份
|
||||
|
||||
#### 1.1 自动备份脚本
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# backup.sh
|
||||
|
||||
# 配置变量
|
||||
DB_NAME="niumall"
|
||||
DB_USER="niumall"
|
||||
DB_PASS="password"
|
||||
BACKUP_DIR="/var/backups/mysql"
|
||||
DATE=$(date +%Y%m%d_%H%M%S)
|
||||
|
||||
# 创建备份目录
|
||||
mkdir -p $BACKUP_DIR
|
||||
|
||||
# 执行备份
|
||||
mysqldump -u$DB_USER -p$DB_PASS $DB_NAME > $BACKUP_DIR/niumall_$DATE.sql
|
||||
|
||||
# 压缩备份文件
|
||||
gzip $BACKUP_DIR/niumall_$DATE.sql
|
||||
|
||||
# 删除7天前的备份
|
||||
find $BACKUP_DIR -name "*.sql.gz" -mtime +7 -delete
|
||||
|
||||
echo "Backup completed: niumall_$DATE.sql.gz"
|
||||
```
|
||||
|
||||
#### 1.2 设置定时备份
|
||||
```bash
|
||||
# 添加执行权限
|
||||
chmod +x backup.sh
|
||||
|
||||
# 设置定时任务
|
||||
crontab -e
|
||||
# 每天凌晨2点执行备份
|
||||
0 2 * * * /path/to/backup.sh
|
||||
```
|
||||
|
||||
### 2. 文件备份
|
||||
|
||||
#### 2.1 代码备份
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# backup_code.sh
|
||||
|
||||
APP_DIR="/var/www/niumall"
|
||||
BACKUP_DIR="/var/backups/code"
|
||||
DATE=$(date +%Y%m%d_%H%M%S)
|
||||
|
||||
mkdir -p $BACKUP_DIR
|
||||
|
||||
# 打包代码
|
||||
tar -czf $BACKUP_DIR/niumall_code_$DATE.tar.gz -C $APP_DIR .
|
||||
|
||||
# 删除30天前的备份
|
||||
find $BACKUP_DIR -name "*.tar.gz" -mtime +30 -delete
|
||||
```
|
||||
|
||||
### 3. 数据恢复
|
||||
|
||||
#### 3.1 数据库恢复
|
||||
```bash
|
||||
# 解压备份文件
|
||||
gunzip niumall_20240101_020000.sql.gz
|
||||
|
||||
# 恢复数据库
|
||||
mysql -u niumall -p niumall < niumall_20240101_020000.sql
|
||||
```
|
||||
|
||||
#### 3.2 代码恢复
|
||||
```bash
|
||||
# 停止应用
|
||||
pm2 stop niumall-api
|
||||
|
||||
# 备份当前代码
|
||||
mv /var/www/niumall /var/www/niumall.bak
|
||||
|
||||
# 解压备份代码
|
||||
mkdir /var/www/niumall
|
||||
tar -xzf niumall_code_20240101_020000.tar.gz -C /var/www/niumall
|
||||
|
||||
# 重启应用
|
||||
pm2 start niumall-api
|
||||
```
|
||||
|
||||
## 安全配置
|
||||
|
||||
### 1. 防火墙配置
|
||||
|
||||
#### 1.1 UFW配置
|
||||
```bash
|
||||
# 启用UFW
|
||||
sudo ufw enable
|
||||
|
||||
# 允许SSH
|
||||
sudo ufw allow ssh
|
||||
|
||||
# 允许HTTP和HTTPS
|
||||
sudo ufw allow 80
|
||||
sudo ufw allow 443
|
||||
|
||||
# 查看状态
|
||||
sudo ufw status
|
||||
```
|
||||
|
||||
#### 1.2 iptables配置
|
||||
```bash
|
||||
# 基本规则
|
||||
sudo iptables -A INPUT -i lo -j ACCEPT
|
||||
sudo iptables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT
|
||||
sudo iptables -A INPUT -p tcp --dport 22 -j ACCEPT
|
||||
sudo iptables -A INPUT -p tcp --dport 80 -j ACCEPT
|
||||
sudo iptables -A INPUT -p tcp --dport 443 -j ACCEPT
|
||||
sudo iptables -A INPUT -j DROP
|
||||
|
||||
# 保存规则
|
||||
sudo iptables-save > /etc/iptables/rules.v4
|
||||
```
|
||||
|
||||
### 2. 系统安全
|
||||
|
||||
#### 2.1 SSH安全配置
|
||||
```bash
|
||||
# 编辑SSH配置
|
||||
sudo nano /etc/ssh/sshd_config
|
||||
|
||||
# 禁用root登录
|
||||
PermitRootLogin no
|
||||
|
||||
# 修改默认端口
|
||||
Port 2222
|
||||
|
||||
# 禁用密码认证（使用密钥认证）
|
||||
PasswordAuthentication no
|
||||
|
||||
# 重启SSH服务
|
||||
sudo systemctl restart sshd
|
||||
```
|
||||
|
||||
#### 2.2 系统更新
|
||||
```bash
|
||||
# 设置自动安全更新
|
||||
sudo apt install unattended-upgrades -y
|
||||
sudo dpkg-reconfigure -plow unattended-upgrades
|
||||
```
|
||||
|
||||
### 3. 应用安全
|
||||
|
||||
#### 3.1 文件权限
|
||||
```bash
|
||||
# 设置应用目录权限
|
||||
sudo chown -R www-data:www-data /var/www/niumall
|
||||
sudo chmod -R 755 /var/www/niumall
|
||||
|
||||
# 保护配置文件
|
||||
sudo chmod 600 /var/www/niumall/backend/.env
|
||||
```
|
||||
|
||||
#### 3.2 Nginx安全配置
|
||||
```nginx
|
||||
# 隐藏Nginx版本
|
||||
server_tokens off;
|
||||
|
||||
# 限制请求大小
|
||||
client_max_body_size 10M;
|
||||
|
||||
# 限制请求频率
|
||||
limit_req_zone $binary_remote_addr zone=api:10m rate=10r/s;
|
||||
limit_req zone=api burst=20 nodelay;
|
||||
|
||||
# 安全头
|
||||
add_header X-Frame-Options "SAMEORIGIN" always;
|
||||
add_header X-XSS-Protection "1; mode=block" always;
|
||||
add_header X-Content-Type-Options "nosniff" always;
|
||||
```
|
||||
|
||||
## 故障处理
|
||||
|
||||
### 1. 常见问题
|
||||
|
||||
#### 1.1 应用无法启动
|
||||
```bash
|
||||
# 检查端口占用
|
||||
sudo netstat -tulpn | grep :3000
|
||||
|
||||
# 检查PM2状态
|
||||
pm2 status
|
||||
|
||||
# 查看错误日志
|
||||
pm2 logs niumall-api --err
|
||||
|
||||
# 检查环境变量
|
||||
pm2 env 0
|
||||
```
|
||||
|
||||
#### 1.2 数据库连接失败
|
||||
```bash
|
||||
# 检查MySQL状态
|
||||
sudo systemctl status mysql
|
||||
|
||||
# 测试数据库连接
|
||||
mysql -u niumall -p -h localhost
|
||||
|
||||
# 检查数据库配置
|
||||
cat /var/www/niumall/backend/.env
|
||||
```
|
||||
|
||||
#### 1.3 Nginx配置错误
|
||||
```bash
|
||||
# 测试Nginx配置
|
||||
sudo nginx -t
|
||||
|
||||
# 查看Nginx错误日志
|
||||
sudo tail -f /var/log/nginx/error.log
|
||||
|
||||
# 重载Nginx配置
|
||||
sudo systemctl reload nginx
|
||||
```
|
||||
|
||||
### 2. 性能问题
|
||||
|
||||
#### 2.1 内存不足
|
||||
```bash
|
||||
# 查看内存使用
|
||||
free -h
|
||||
|
||||
# 查看进程内存使用
|
||||
ps aux --sort=-%mem | head
|
||||
|
||||
# 重启应用释放内存
|
||||
pm2 restart niumall-api
|
||||
```
|
||||
|
||||
#### 2.2 磁盘空间不足
|
||||
```bash
|
||||
# 查看磁盘使用
|
||||
df -h
|
||||
|
||||
# 清理日志文件
|
||||
sudo journalctl --vacuum-time=7d
|
||||
|
||||
# 清理临时文件
|
||||
sudo apt autoremove -y
|
||||
sudo apt autoclean
|
||||
```
|
||||
|
||||
### 3. 应急处理
|
||||
|
||||
#### 3.1 服务降级
|
||||
```bash
|
||||
# 停止非关键服务
|
||||
pm2 stop non-critical-service
|
||||
|
||||
# 启用维护模式
|
||||
sudo cp maintenance.html /var/www/html/index.html
|
||||
```
|
||||
|
||||
#### 3.2 快速回滚
|
||||
```bash
|
||||
# 回滚到上一个版本
|
||||
pm2 stop niumall-api
|
||||
git checkout HEAD~1
|
||||
npm install
|
||||
pm2 start niumall-api
|
||||
```
|
||||
|
||||
## 运维脚本
|
||||
|
||||
### 1. 健康检查脚本
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# health_check.sh
|
||||
|
||||
# 检查应用状态
|
||||
if ! pm2 describe niumall-api > /dev/null 2>&1; then
|
||||
echo "Application is down, restarting..."
|
||||
pm2 restart niumall-api
|
||||
fi
|
||||
|
||||
# 检查数据库连接
|
||||
if ! mysqladmin ping -h localhost --silent; then
|
||||
echo "Database is down, please check MySQL service"
|
||||
sudo systemctl restart mysql
|
||||
fi
|
||||
|
||||
# 检查磁盘空间
|
||||
DISK_USAGE=$(df / | grep -vE '^Filesystem' | awk '{print $5}' | sed 's/%//g')
|
||||
if [ $DISK_USAGE -gt 80 ]; then
|
||||
echo "Disk usage is above 80%: ${DISK_USAGE}%"
|
||||
fi
|
||||
```
|
||||
|
||||
### 2. 部署脚本
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# deploy.sh
|
||||
|
||||
set -e
|
||||
|
||||
APP_DIR="/var/www/niumall"
|
||||
BACKUP_DIR="/var/backups/deployments"
|
||||
DATE=$(date +%Y%m%d_%H%M%S)
|
||||
|
||||
echo "Starting deployment..."
|
||||
|
||||
# 创建备份
|
||||
mkdir -p $BACKUP_DIR
|
||||
tar -czf $BACKUP_DIR/niumall_$DATE.tar.gz -C $APP_DIR .
|
||||
|
||||
# 拉取最新代码
|
||||
cd $APP_DIR
|
||||
git pull origin main
|
||||
|
||||
# 安装依赖
|
||||
cd backend
|
||||
npm install --production
|
||||
|
||||
# 运行数据库迁移
|
||||
npm run migrate
|
||||
|
||||
# 构建前端
|
||||
cd ../frontend
|
||||
npm install
|
||||
npm run build
|
||||
|
||||
# 重启应用
|
||||
pm2 reload niumall-api
|
||||
|
||||
echo "Deployment completed successfully!"
|
||||
```
|
||||
|
||||
## 总结
|
||||
|
||||
本文档提供了活牛采购智能数字化系统的完整部署和运维指南，包括环境准备、代码部署、监控告警、备份恢复、安全配置和故障处理等各个方面。通过遵循本文档的指导，可以确保系统的稳定运行和高效维护。
|
||||
|
||||
在实际运维过程中，建议：
|
||||
1. 定期检查系统状态和性能指标
|
||||
2. 及时更新系统和应用补丁
|
||||
3. 定期测试备份和恢复流程
|
||||
4. 建立完善的监控告警机制
|
||||
5. 制定详细的应急响应预案
|
||||
|
||||
通过持续的运维优化和改进，可以不断提升系统的可靠性和性能表现。
|
||||
Reference in New Issue
Block a user