ai_learn_node/nginx

Nginx 配置说明

配置文件

• nginx.conf - 主配置文件

功能特性

1. 前端静态文件服务 - 服务 React 构建后的静态文件
2. API 代理 - 将 /api 请求代理到后端服务器 (localhost:3001)
3. SPA 路由支持 - 支持 React Router 的客户端路由
4. 静态资源缓存 - 优化静态资源加载性能
5. 健康检查 - /health 端点用于健康检查

部署步骤

1. 构建前端

cd frontend
npm run build

构建输出在 frontend/dist/ 目录

2. 配置 Nginx

编辑 nginx.conf 文件，修改以下配置：

• server_name: 改为您的域名
• root: 改为前端构建文件的绝对路径
• upstream backend: 确保后端服务器地址正确

3. 安装配置文件

# 复制配置文件到 nginx 配置目录
sudo cp nginx/nginx.conf /etc/nginx/sites-available/ai-learning-platform

# 创建符号链接
sudo ln -s /etc/nginx/sites-available/ai-learning-platform /etc/nginx/sites-enabled/

# 测试配置
sudo nginx -t

# 重新加载 nginx
sudo systemctl reload nginx

4. 启动后端服务

确保后端服务在 3001 端口运行：

cd backend
npm run build
npm start

或者使用 PM2 管理：

pm2 start backend/dist/index.js --name ai-learning-backend

配置说明

前端路径

默认配置假设前端构建文件在：

/var/www/ai-learning-platform/frontend/dist

请根据实际部署路径修改 root 指令。

后端代理

API 请求会被代理到：

http://localhost:3001

如果需要修改，编辑 upstream backend 部分。

静态资源缓存

静态资源（JS、CSS、图片等）会缓存 1 年，提高性能。

SPA 路由支持

try_files $uri $uri/ /index.html; 确保所有路由都返回 index.html，支持 React Router。

HTTPS 配置（可选）

如果需要 HTTPS，取消注释配置文件中的 HTTPS 部分，并：

1. 获取 SSL 证书（Let's Encrypt 免费证书）
2. 修改证书路径
3. 重新加载 nginx

使用 Let's Encrypt

# 安装 certbot
sudo apt-get install certbot python3-certbot-nginx

# 获取证书
sudo certbot --nginx -d yourdomain.com

性能优化

Gzip 压缩

在 nginx 主配置文件中添加：

gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_types text/plain text/css text/xml text/javascript application/x-javascript application/xml+rss application/json;

缓存优化

静态资源已配置长期缓存，生产环境建议使用 CDN。

监控和日志

• 访问日志：/var/log/nginx/ai-learning-access.log
• 错误日志：/var/log/nginx/ai-learning-error.log

故障排查

检查 nginx 状态

sudo systemctl status nginx

查看错误日志

sudo tail -f /var/log/nginx/ai-learning-error.log

测试配置

sudo nginx -t

重新加载配置

sudo systemctl reload nginx

Docker 部署（可选）

如果使用 Docker，可以创建 Dockerfile.nginx：

FROM nginx:alpine
COPY nginx/nginx.conf /etc/nginx/conf.d/default.conf
COPY frontend/dist /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]