create-dp-koa 1.0.0

package/template/docs/DEPLOYMENT_GUIDE.md

@@ -0,0 +1,1062 @@
+# 部署指南
+
+本指南提供 DP-Koa Framework 在不同环境下的详细部署方案，包括开发环境、测试环境和生产环境。
+
+## 📋 目录
+
+- [部署概览](#部署概览)
+- [环境准备](#环境准备)
+- [Docker 部署](#docker-部署)
+- [Docker Compose 部署](#docker-compose-部署)
+- [Kubernetes 部署](#kubernetes-部署)
+- [传统服务器部署](#传统服务器部署)
+- [CI/CD 流水线](#cicd-流水线)
+- [监控配置](#监控配置)
+- [安全配置](#安全配置)
+- [性能优化](#性能优化)
+- [故障排除](#故障排除)
+
+## 🚀 部署概览
+
+### 部署架构
+
+```
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│   Load Balancer │────│   Application   │────│    Database     │
+│   (Nginx)       │    │   (Node.js)     │    │   (MySQL)      │
+└─────────────────┘    └─────────────────┘    └─────────────────┘
+         │                       │                       │
+         │                       │                       │
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│   SSL/TLS       │    │   Cache Layer   │    │   Backup        │
+│   Certificate   │    │   (Redis)       │    │   System        │
+└─────────────────┘    └─────────────────┘    └─────────────────┘
+```
+
+### 部署选项
+
+| 部署方式 | 适用场景 | 复杂度 | 可扩展性 | 维护成本 |
+|----------|----------|--------|----------|----------|
+| Docker | 单机部署 | 低 | 中 | 低 |
+| Docker Compose | 多服务部署 | 中 | 中 | 中 |
+| Kubernetes | 大规模部署 | 高 | 高 | 高 |
+| 传统服务器 | 简单部署 | 低 | 低 | 中 |
+
+## 🔧 环境准备
+
+### 1. 服务器要求
+
+#### 最低配置
+
+- **CPU**: 2 核心
+- **内存**: 4GB RAM
+- **存储**: 20GB SSD
+- **网络**: 100Mbps
+
+#### 推荐配置
+
+- **CPU**: 4 核心
+- **内存**: 8GB RAM
+- **存储**: 50GB SSD
+- **网络**: 1Gbps
+
+### 2. 系统要求
+
+#### 操作系统
+
+- **Ubuntu**: 20.04 LTS 或更高版本
+- **CentOS**: 8 或更高版本
+- **RHEL**: 8 或更高版本
+- **Debian**: 11 或更高版本
+
+#### 必需软件
+
+```bash
+# Ubuntu/Debian
+sudo apt update
+sudo apt install -y curl wget git nginx
+
+# CentOS/RHEL
+sudo yum update -y
+sudo yum install -y curl wget git nginx
+```
+
+## 🐳 Docker 部署
+
+### 1. 构建镜像
+
+```bash
+# 构建生产镜像
+docker build -t dp-koa-framework:latest .
+
+# 查看镜像
+docker images dp-koa-framework
+```
+
+### 2. 运行容器
+
+```bash
+# 基本运行
+docker run -d \
+  --name dp-koa-app \
+  -p 3000:3000 \
+  -e NODE_ENV=production \
+  dp-koa-framework:latest
+
+# 带环境变量运行
+docker run -d \
+  --name dp-koa-app \
+  -p 3000:3000 \
+  -e NODE_ENV=production \
+  -e DB_HOST=mysql-server \
+  -e DB_PASSWORD=your_password \
+  -v /app/logs:/app/logs \
+  dp-koa-framework:latest
+```
+
+### 3. 容器管理
+
+```bash
+# 查看容器状态
+docker ps
+
+# 查看容器日志
+docker logs dp-koa-app
+
+# 进入容器
+docker exec -it dp-koa-app sh
+
+# 停止容器
+docker stop dp-koa-app
+
+# 删除容器
+docker rm dp-koa-app
+```
+
+## 🐙 Docker Compose 部署
+
+### 1. 基础部署
+
+使用项目提供的 `docker-compose.yml`：
+
+```bash
+# 启动所有服务
+docker-compose up -d
+
+# 查看服务状态
+docker-compose ps
+
+# 查看日志
+docker-compose logs -f
+
+# 停止服务
+docker-compose down
+```
+
+### 2. 自定义配置
+
+创建 `docker-compose.override.yml`：
+
+```yaml
+version: '3.8'
+
+services:
+  app:
+    environment:
+      - NODE_ENV=production
+      - DB_HOST=mysql
+      - DB_PASSWORD=your_secure_password
+      - REDIS_PASSWORD=your_redis_password
+    volumes:
+      - ./logs:/app/logs
+      - ./uploads:/app/uploads
+    restart: unless-stopped
+
+  mysql:
+    environment:
+      - MYSQL_ROOT_PASSWORD=root_secure_password
+      - MYSQL_PASSWORD=your_secure_password
+    volumes:
+      - mysql_data:/var/lib/mysql
+      - ./backup:/backup
+
+  redis:
+    command: redis-server --requirepass your_redis_password
+    volumes:
+      - redis_data:/data
+
+volumes:
+  mysql_data:
+  redis_data:
+```
+
+### 3. 生产环境配置
+
+创建 `docker-compose.prod.yml`：
+
+```yaml
+version: '3.8'
+
+services:
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile.prod
+    environment:
+      - NODE_ENV=production
+      - PORT=3000
+      - DB_HOST=mysql
+      - DB_USERNAME=app_user
+      - DB_PASSWORD=${DB_PASSWORD}
+      - REDIS_HOST=redis
+      - REDIS_PASSWORD=${REDIS_PASSWORD}
+    depends_on:
+      mysql:
+        condition: service_healthy
+      redis:
+        condition: service_started
+    restart: unless-stopped
+    networks:
+      - app-network
+    deploy:
+      resources:
+        limits:
+          memory: 1G
+          cpus: '0.5'
+        reservations:
+          memory: 512M
+          cpus: '0.25'
+
+  mysql:
+    image: mysql:8.0
+    environment:
+      - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD}
+      - MYSQL_DATABASE=app_db
+      - MYSQL_USER=app_user
+      - MYSQL_PASSWORD=${DB_PASSWORD}
+    volumes:
+      - mysql_data:/var/lib/mysql
+      - ./docker/mysql/init:/docker-entrypoint-initdb.d
+    restart: unless-stopped
+    networks:
+      - app-network
+    healthcheck:
+      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    deploy:
+      resources:
+        limits:
+          memory: 2G
+          cpus: '1.0'
+
+  redis:
+    image: redis:7-alpine
+    command: redis-server --appendonly yes --requirepass ${REDIS_PASSWORD}
+    volumes:
+      - redis_data:/data
+    restart: unless-stopped
+    networks:
+      - app-network
+    deploy:
+      resources:
+        limits:
+          memory: 512M
+          cpus: '0.25'
+
+  nginx:
+    image: nginx:alpine
+    ports:
+      - "80:80"
+      - "443:443"
+    volumes:
+      - ./docker/nginx/nginx.conf:/etc/nginx/nginx.conf
+      - ./docker/nginx/ssl:/etc/nginx/ssl
+      - ./logs/nginx:/var/log/nginx
+    depends_on:
+      - app
+    restart: unless-stopped
+    networks:
+      - app-network
+
+volumes:
+  mysql_data:
+  redis_data:
+
+networks:
+  app-network:
+    driver: bridge
+```
+
+### 4. 环境变量配置
+
+创建 `.env.prod`：
+
+```bash
+# 数据库配置
+DB_PASSWORD=your_secure_database_password
+MYSQL_ROOT_PASSWORD=your_secure_root_password
+
+# Redis配置
+REDIS_PASSWORD=your_secure_redis_password
+
+# JWT配置
+JWT_SECRET=your_super_secure_jwt_secret_key
+
+# 其他配置
+NODE_ENV=production
+LOG_LEVEL=info
+```
+
+### 5. 启动生产环境
+
+```bash
+# 使用生产配置启动
+docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d
+
+# 查看服务状态
+docker-compose ps
+
+# 查看应用日志
+docker-compose logs -f app
+```
+
+## ☸️ Kubernetes 部署
+
+### 1. 创建命名空间
+
+```yaml
+# namespace.yaml
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: dp-koa-framework
+```
+
+### 2. 配置 ConfigMap
+
+```yaml
+# configmap.yaml
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: dp-koa-config
+  namespace: dp-koa-framework
+data:
+  NODE_ENV: "production"
+  PORT: "3000"
+  LOG_LEVEL: "info"
+  DB_HOST: "mysql-service"
+  DB_PORT: "3306"
+  DB_DATABASE: "app_db"
+  REDIS_HOST: "redis-service"
+  REDIS_PORT: "6379"
+```
+
+### 3. 配置 Secret
+
+```yaml
+# secret.yaml
+apiVersion: v1
+kind: Secret
+metadata:
+  name: dp-koa-secrets
+  namespace: dp-koa-framework
+type: Opaque
+data:
+  DB_PASSWORD: <base64-encoded-password>
+  REDIS_PASSWORD: <base64-encoded-redis-password>
+  JWT_SECRET: <base64-encoded-jwt-secret>
+```
+
+### 4. 部署应用
+
+```yaml
+# deployment.yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: dp-koa-app
+  namespace: dp-koa-framework
+spec:
+  replicas: 3
+  selector:
+    matchLabels:
+      app: dp-koa-app
+  template:
+    metadata:
+      labels:
+        app: dp-koa-app
+    spec:
+      containers:
+      - name: app
+        image: dp-koa-framework:latest
+        ports:
+        - containerPort: 3000
+        envFrom:
+        - configMapRef:
+            name: dp-koa-config
+        - secretRef:
+            name: dp-koa-secrets
+        resources:
+          requests:
+            memory: "512Mi"
+            cpu: "250m"
+          limits:
+            memory: "1Gi"
+            cpu: "500m"
+        livenessProbe:
+          httpGet:
+            path: /live
+            port: 3000
+          initialDelaySeconds: 30
+          periodSeconds: 10
+        readinessProbe:
+          httpGet:
+            path: /ready
+            port: 3000
+          initialDelaySeconds: 5
+          periodSeconds: 5
+        volumeMounts:
+        - name: logs
+          mountPath: /app/logs
+      volumes:
+      - name: logs
+        emptyDir: {}
+```
+
+### 5. 创建服务
+
+```yaml
+# service.yaml
+apiVersion: v1
+kind: Service
+metadata:
+  name: dp-koa-service
+  namespace: dp-koa-framework
+spec:
+  selector:
+    app: dp-koa-app
+  ports:
+  - port: 80
+    targetPort: 3000
+  type: ClusterIP
+```
+
+### 6. 配置 Ingress
+
+```yaml
+# ingress.yaml
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: dp-koa-ingress
+  namespace: dp-koa-framework
+  annotations:
+    nginx.ingress.kubernetes.io/rewrite-target: /
+    nginx.ingress.kubernetes.io/ssl-redirect: "true"
+spec:
+  tls:
+  - hosts:
+    - api.yourdomain.com
+    secretName: tls-secret
+  rules:
+  - host: api.yourdomain.com
+    http:
+      paths:
+      - path: /
+        pathType: Prefix
+        backend:
+          service:
+            name: dp-koa-service
+            port:
+              number: 80
+```
+
+### 7. 部署到 Kubernetes
+
+```bash
+# 应用所有配置
+kubectl apply -f namespace.yaml
+kubectl apply -f configmap.yaml
+kubectl apply -f secret.yaml
+kubectl apply -f deployment.yaml
+kubectl apply -f service.yaml
+kubectl apply -f ingress.yaml
+
+# 查看部署状态
+kubectl get pods -n dp-koa-framework
+kubectl get services -n dp-koa-framework
+kubectl get ingress -n dp-koa-framework
+```
+
+## 🖥️ 传统服务器部署
+
+### 1. 安装 Node.js
+
+```bash
+# 使用 NodeSource 仓库安装 Node.js 20
+curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+sudo apt-get install -y nodejs
+
+# 验证安装
+node --version
+npm --version
+```
+
+### 2. 安装 PM2
+
+```bash
+# 全局安装 PM2
+npm install -g pm2
+
+# 验证安装
+pm2 --version
+```
+
+### 3. 部署应用
+
+```bash
+# 克隆项目
+git clone <repository-url>
+cd dp-koa-framework
+
+# 安装依赖
+npm install --production
+
+# 构建应用
+npm run build
+
+# 使用 PM2 启动
+pm2 start dist/main.js --name "dp-koa-app"
+
+# 保存 PM2 配置
+pm2 save
+pm2 startup
+```
+
+### 4. 配置 Nginx
+
+创建 `/etc/nginx/sites-available/dp-koa-framework`：
+
+```nginx
+server {
+    listen 80;
+    server_name your-domain.com;
+
+    # 重定向到 HTTPS
+    return 301 https://$server_name$request_uri;
+}
+
+server {
+    listen 443 ssl http2;
+    server_name your-domain.com;
+
+    # SSL 配置
+    ssl_certificate /path/to/your/certificate.crt;
+    ssl_certificate_key /path/to/your/private.key;
+    ssl_protocols TLSv1.2 TLSv1.3;
+    ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512;
+    ssl_prefer_server_ciphers off;
+
+    # 日志配置
+    access_log /var/log/nginx/dp-koa-access.log;
+    error_log /var/log/nginx/dp-koa-error.log;
+
+    # 反向代理配置
+    location / {
+        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;
+    }
+
+    # 静态文件缓存
+    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+    }
+
+    # 健康检查
+    location /health {
+        proxy_pass http://localhost:3000/health;
+        access_log off;
+    }
+}
+```
+
+启用站点：
+
+```bash
+# 启用站点
+sudo ln -s /etc/nginx/sites-available/dp-koa-framework /etc/nginx/sites-enabled/
+
+# 测试配置
+sudo nginx -t
+
+# 重启 Nginx
+sudo systemctl restart nginx
+```
+
+## 🔄 CI/CD 流水线
+
+### 1. GitHub Actions
+
+创建 `.github/workflows/deploy.yml`：
+
+```yaml
+name: Deploy to Production
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Setup Node.js
+      uses: actions/setup-node@v3
+      with:
+        node-version: '20'
+        cache: 'npm'
+    
+    - name: Install dependencies
+      run: npm ci
+    
+    - name: Run tests
+      run: npm test
+    
+    - name: Run linting
+      run: npm run lint
+    
+    - name: Type check
+      run: npm run type-check
+
+  build:
+    needs: test
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Setup Node.js
+      uses: actions/setup-node@v3
+      with:
+        node-version: '20'
+        cache: 'npm'
+    
+    - name: Install dependencies
+      run: npm ci
+    
+    - name: Build application
+      run: npm run build
+    
+    - name: Build Docker image
+      run: docker build -t dp-koa-framework:${{ github.sha }} .
+    
+    - name: Push to registry
+      run: |
+        echo ${{ secrets.DOCKER_PASSWORD }} | docker login -u ${{ secrets.DOCKER_USERNAME }} --password-stdin
+        docker push dp-koa-framework:${{ github.sha }}
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+    
+    steps:
+    - name: Deploy to production
+      run: |
+        # 部署脚本
+        echo "Deploying to production..."
+```
+
+### 2. GitLab CI
+
+创建 `.gitlab-ci.yml`：
+
+```yaml
+stages:
+  - test
+  - build
+  - deploy
+
+variables:
+  DOCKER_IMAGE: $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA
+
+test:
+  stage: test
+  image: node:20-alpine
+  script:
+    - npm ci
+    - npm test
+    - npm run lint
+    - npm run type-check
+  only:
+    - merge_requests
+    - main
+
+build:
+  stage: build
+  image: docker:latest
+  services:
+    - docker:dind
+  script:
+    - docker build -t $DOCKER_IMAGE .
+    - docker push $DOCKER_IMAGE
+  only:
+    - main
+
+deploy:
+  stage: deploy
+  image: alpine:latest
+  script:
+    - apk add --no-cache curl
+    - curl -X POST "$DEPLOY_WEBHOOK_URL" -H "Content-Type: application/json" -d '{"image": "'$DOCKER_IMAGE'"}'
+  only:
+    - main
+  when: manual
+```
+
+## 📊 监控配置
+
+### 1. Prometheus 配置
+
+创建 `docker/prometheus/prometheus.yml`：
+
+```yaml
+global:
+  scrape_interval: 15s
+  evaluation_interval: 15s
+
+rule_files:
+  - "rules/*.yml"
+
+scrape_configs:
+  - job_name: 'dp-koa-framework'
+    static_configs:
+      - targets: ['app:3000']
+    metrics_path: '/metrics'
+    scrape_interval: 5s
+    scrape_timeout: 5s
+
+  - job_name: 'mysql'
+    static_configs:
+      - targets: ['mysql-exporter:9104']
+
+  - job_name: 'redis'
+    static_configs:
+      - targets: ['redis-exporter:9121']
+
+  - job_name: 'nginx'
+    static_configs:
+      - targets: ['nginx-exporter:9113']
+```
+
+### 2. Grafana 仪表板
+
+创建 `docker/grafana/provisioning/dashboards/dashboard.yml`：
+
+```yaml
+apiVersion: 1
+
+providers:
+  - name: 'dp-koa-framework'
+    orgId: 1
+    folder: ''
+    type: file
+    disableDeletion: false
+    updateIntervalSeconds: 10
+    allowUiUpdates: true
+    options:
+      path: /etc/grafana/provisioning/dashboards
+```
+
+### 3. 告警规则
+
+创建 `docker/prometheus/rules/app-alerts.yml`：
+
+```yaml
+groups:
+  - name: dp-koa-framework
+    rules:
+      - alert: HighErrorRate
+        expr: rate(http_requests_total{status=~"5.."}[5m]) > 0.1
+        for: 5m
+        labels:
+          severity: warning
+        annotations:
+          summary: "High error rate detected"
+          description: "Error rate is {{ $value }} errors per second"
+
+      - alert: HighResponseTime
+        expr: histogram_quantile(0.95, rate(http_request_duration_seconds_bucket[5m])) > 1
+        for: 5m
+        labels:
+          severity: warning
+        annotations:
+          summary: "High response time detected"
+          description: "95th percentile response time is {{ $value }} seconds"
+
+      - alert: DatabaseConnectionDown
+        expr: up{job="mysql"} == 0
+        for: 1m
+        labels:
+          severity: critical
+        annotations:
+          summary: "Database connection down"
+          description: "MySQL database is not responding"
+```
+
+## 🔒 安全配置
+
+### 1. SSL/TLS 配置
+
+#### 使用 Let's Encrypt
+
+```bash
+# 安装 Certbot
+sudo apt install certbot python3-certbot-nginx
+
+# 获取证书
+sudo certbot --nginx -d your-domain.com
+
+# 自动续期
+sudo crontab -e
+# 添加以下行
+0 12 * * * /usr/bin/certbot renew --quiet
+```
+
+#### 手动配置 SSL
+
+```nginx
+server {
+    listen 443 ssl http2;
+    server_name your-domain.com;
+
+    ssl_certificate /etc/ssl/certs/your-domain.crt;
+    ssl_certificate_key /etc/ssl/private/your-domain.key;
+    
+    # 安全配置
+    ssl_protocols TLSv1.2 TLSv1.3;
+    ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384;
+    ssl_prefer_server_ciphers off;
+    ssl_session_cache shared:SSL:10m;
+    ssl_session_timeout 10m;
+    
+    # HSTS
+    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
+    
+    # 其他安全头
+    add_header X-Frame-Options DENY;
+    add_header X-Content-Type-Options nosniff;
+    add_header X-XSS-Protection "1; mode=block";
+    add_header Referrer-Policy "strict-origin-when-cross-origin";
+}
+```
+
+### 2. 防火墙配置
+
+```bash
+# UFW 配置
+sudo ufw default deny incoming
+sudo ufw default allow outgoing
+sudo ufw allow ssh
+sudo ufw allow 80/tcp
+sudo ufw allow 443/tcp
+sudo ufw enable
+
+# iptables 配置
+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
+```
+
+### 3. 应用安全配置
+
+```bash
+# 环境变量安全配置
+export NODE_ENV=production
+export JWT_SECRET=$(openssl rand -base64 64)
+export DB_PASSWORD=$(openssl rand -base64 32)
+export REDIS_PASSWORD=$(openssl rand -base64 32)
+
+# 文件权限
+chmod 600 .env
+chmod 700 logs/
+chown -R app:app /app
+```
+
+## ⚡ 性能优化
+
+### 1. 应用优化
+
+```bash
+# PM2 集群模式
+pm2 start dist/main.js -i max --name "dp-koa-app"
+
+# 内存优化
+export NODE_OPTIONS="--max-old-space-size=2048"
+
+# 启用压缩
+export COMPRESSION_ENABLED=true
+```
+
+### 2. 数据库优化
+
+```sql
+-- MySQL 配置优化
+SET GLOBAL innodb_buffer_pool_size = 1G;
+SET GLOBAL innodb_log_file_size = 256M;
+SET GLOBAL max_connections = 200;
+SET GLOBAL query_cache_size = 64M;
+```
+
+### 3. 缓存优化
+
+```bash
+# Redis 配置优化
+redis-cli CONFIG SET maxmemory 1gb
+redis-cli CONFIG SET maxmemory-policy allkeys-lru
+redis-cli CONFIG SET save "900 1 300 10 60 10000"
+```
+
+### 4. Nginx 优化
+
+```nginx
+# 启用 gzip 压缩
+gzip on;
+gzip_vary on;
+gzip_min_length 1024;
+gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
+
+# 连接优化
+worker_processes auto;
+worker_connections 1024;
+
+# 缓存配置
+proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=app_cache:10m max_size=1g inactive=60m;
+```
+
+## 🚨 故障排除
+
+### 1. 常见问题
+
+#### 应用无法启动
+
+```bash
+# 检查日志
+pm2 logs dp-koa-app
+docker logs dp-koa-app
+
+# 检查端口占用
+netstat -tulpn | grep :3000
+
+# 检查环境变量
+env | grep NODE_ENV
+```
+
+#### 数据库连接失败
+
+```bash
+# 检查数据库状态
+systemctl status mysql
+docker ps | grep mysql
+
+# 测试连接
+mysql -h localhost -u app_user -p app_db
+
+# 检查防火墙
+sudo ufw status
+```
+
+#### 内存不足
+
+```bash
+# 检查内存使用
+free -h
+top -p $(pgrep node)
+
+# 增加 swap
+sudo fallocate -l 2G /swapfile
+sudo chmod 600 /swapfile
+sudo mkswap /swapfile
+sudo swapon /swapfile
+```
+
+### 2. 监控和告警
+
+```bash
+# 设置监控脚本
+#!/bin/bash
+# monitor.sh
+
+# 检查应用状态
+if ! curl -f http://localhost:3000/health > /dev/null 2>&1; then
+    echo "Application is down!" | mail -s "Alert" admin@example.com
+fi
+
+# 检查磁盘空间
+if [ $(df / | awk 'NR==2 {print $5}' | sed 's/%//') -gt 80 ]; then
+    echo "Disk space is low!" | mail -s "Alert" admin@example.com
+fi
+```
+
+### 3. 备份策略
+
+```bash
+# 数据库备份脚本
+#!/bin/bash
+# backup.sh
+
+DATE=$(date +%Y%m%d_%H%M%S)
+BACKUP_DIR="/backup"
+DB_NAME="app_db"
+
+# 创建备份目录
+mkdir -p $BACKUP_DIR
+
+# 备份数据库
+mysqldump -u root -p$MYSQL_ROOT_PASSWORD $DB_NAME > $BACKUP_DIR/db_backup_$DATE.sql
+
+# 压缩备份
+gzip $BACKUP_DIR/db_backup_$DATE.sql
+
+# 删除7天前的备份
+find $BACKUP_DIR -name "db_backup_*.sql.gz" -mtime +7 -delete
+```
+
+## 📚 相关文档
+
+- [安装配置指南](INSTALLATION_GUIDE.md) - 详细安装步骤
+- [开发指南](DEVELOPMENT_GUIDE.md) - 开发规范和最佳实践
+- [API 文档](API_DOCUMENTATION.md) - API 参考
+- [故障排除指南](TROUBLESHOOTING.md) - 常见问题解决
+
+---
+
+**相关链接**:
+- [Docker 官方文档](https://docs.docker.com/) - Docker 使用指南
+- [Kubernetes 官方文档](https://kubernetes.io/docs/) - K8s 部署指南
+- [Nginx 配置指南](https://nginx.org/en/docs/) - Nginx 配置参考
+- [Prometheus 文档](https://prometheus.io/docs/) - 监控系统配置
+
+