一、服务器环境准备
1. 安装 Node.js 和 NPM
bash
# Ubuntu/Debian curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs # CentOS/RHEL curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash - sudo yum install -y nodejs # 验证安装 node -v npm -v
2. 安装 PM2
bash
sudo npm install -g pm2
3. 安装 Nginx
bash
# Ubuntu/Debian sudo apt update sudo apt install -y nginx # CentOS/RHEL sudo yum install -y nginx # 启动 Nginx sudo systemctl start nginx sudo systemctl enable nginx
二、部署 Nuxt 应用
1. 上传文件到服务器
确保 /www/root/test 目录包含以下结构：
text
/www/root/test/ ├── .output/ │ ├── server/ │ │ └── index.mjs │ └── public/ │ └── _nuxt/ └── package.json
2. 安装生产依赖
bash
cd /www/root/test npm install --production
三、配置 PM2 启动 Nuxt
1. 创建 PM2 配置文件 ecosystem.config.js
javascript
module.exports = {
apps: [{
name: 'nuxt-app',
script: '.output/server/index.mjs',
instances: 'max', // 使用所有CPU核心
exec_mode: 'cluster',
autorestart: true,
watch: false,
max_memory_restart: '1G',
env: {
NODE_ENV: 'production',
PORT: 3000,
HOST: '0.0.0.0'
}
}]
}
2. 启动应用
bash
cd /www/root/test # 使用配置文件启动 pm2 start ecosystem.config.js # 或直接启动 pm2 start .output/server/index.mjs --name nuxt-app --watch --time # 设置开机自启 pm2 startup # 按照提示执行生成的命令 pm2 save
3. 管理 PM2 进程
bash
# 查看所有应用 pm2 list # 查看日志 pm2 logs nuxt-app pm2 logs nuxt-app --lines 100 # 监控 pm2 monit # 重启应用 pm2 restart nuxt-app # 停止应用 pm2 stop nuxt-app # 删除应用 pm2 delete nuxt-app # 保存当前进程列表 pm2 save
四、配置 Nginx 反向代理
1. 创建 Nginx 配置文件
bash
sudo nano /etc/nginx/sites-available/nuxt-app
2. 配置内容如下：
nginx
server {
listen 80;
server_name your-domain.com www.your-domain.com; # 修改为你的域名
root /www/root/test;
# 设置日志
access_log /var/log/nginx/nuxt-app-access.log;
error_log /var/log/nginx/nuxt-app-error.log;
# 反向代理到 Nuxt
location / {
proxy_pass http://127.0.0.1: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 /_nuxt/ {
alias /www/root/test/.output/public/_nuxt/;
expires 365d;
add_header Cache-Control "public, immutable";
access_log off;
}
# 阻止访问敏感文件
location ~ /\. {
deny all;
}
# 压缩配置
gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_types text/plain text/css text/xml text/javascript application/javascript application/xml+rss application/json;
}
3. 启用站点配置
bash
# 创建软链接 sudo ln -s /etc/nginx/sites-available/nuxt-app /etc/nginx/sites-enabled/ # 测试配置 sudo nginx -t # 重新加载 Nginx sudo systemctl reload nginx
五、防火墙配置
bash
# 开放 80 端口（HTTP） sudo ufw allow 80/tcp # 如果使用 SSL，开放 443 端口 sudo ufw allow 443/tcp # 启用防火墙 sudo ufw enable
六、SSL 证书配置（可选，推荐）
1. 安装 Certbot
bash
# Ubuntu/Debian sudo apt install -y certbot python3-certbot-nginx # CentOS/RHEL sudo yum install -y certbot python3-certbot-nginx
2. 获取 SSL 证书
bash
sudo certbot --nginx -d your-domain.com -d www.your-domain.com
3. 自动续期测试
bash
sudo certbot renew --dry-run
七、部署脚本
创建 deploy.sh 脚本：
bash
#!/bin/bash set -e # 遇到错误立即退出 echo "=== 开始部署 Nuxt 应用 ===" # 进入项目目录 cd /www/root/test echo "1. 停止当前应用..." pm2 stop nuxt-app || true echo "2. 安装依赖..." npm ci --production echo "3. 重启应用..." pm2 restart nuxt-app || pm2 start .output/server/index.mjs --name nuxt-app --time echo "4. 等待应用启动..." sleep 5 echo "5. 检查应用状态..." pm2 list echo "6. 查看应用日志..." pm2 logs nuxt-app --lines 10 echo "=== 部署完成 ===" # 测试访问 echo "测试访问..." curl -f http://localhost:3000 || echo "应用启动失败，请检查日志"
给脚本执行权限：
bash
chmod +x deploy.sh ./deploy.sh
八、常用维护命令
bash
# 查看 PM2 状态 pm2 status # 查看实时日志 pm2 logs nuxt-app --lines 100 # 查看 CPU/内存使用 pm2 monit # 重启所有应用 pm2 restart all # 重新加载 Nginx sudo systemctl reload nginx # 查看 Nginx 错误日志 sudo tail -f /var/log/nginx/nuxt-app-error.log
九、故障排除
1. 如果应用无法启动
bash
# 查看详细错误 cd /www/root/test node .output/server/index.mjs # 检查端口占用 netstat -tlnp | grep :3000 # 使用不同端口 PORT=3001 pm2 start ecosystem.config.js
2. 如果 Nginx 返回 502 错误
bash
# 检查 PM2 是否运行 pm2 list # 检查应用是否监听端口 curl http://localhost:3000 # 查看 PM2 日志 pm2 logs nuxt-app
3. 更新 Nginx 配置后
bash
# 测试配置 sudo nginx -t # 重新加载 sudo systemctl reload nginx # 重启 sudo systemctl restart nginx
这样就完成了使用 PM2 + Nginx 的完整部署流程。应用将通过 Nginx 在 80 端口提供服务，PM2 负责管理 Node.js 进程。