如何在腾讯云Ubuntu服务器上部署Node.js项目

最近弄了一个Node.js项目，包含前端用户前台，管理后台和服务端API服务三个项目，本地搭建好了，于是在腾讯云上新建了个Ubuntu 24.04服务器，想要将本地的Node.js项目部署上去，包括环境配置和数据库搭建。

本文主要讲解如何部署Node.js项目，通常需要以下步骤：

现在，开始第一步，服务器初始设置。我们需要创建新用户、配置SSH密钥、更新系统包，并设置防火墙。

第1步：服务器初始设置（安全与基础配置）

1.1 登录服务器

• 使用SSH登录到你的腾讯云服务器（替换your_username和your_server_ip）：ssh root@your_server_ip

  📌 如果是首次登录，腾讯云可能要求你通过Web控制台重置root密码或使用SSH密钥。

1.2 创建新用户（避免使用root）

# 创建新用户（例如命名为deploy）
sudo adduser deploy

# 赋予sudo权限
sudo usermod -aG sudo deploy

# 切换到新用户
su – deploy

1.3 配置SSH密钥登录（提高安全性）

• 本地机器操作：生成SSH密钥（如果已有可跳过）：ssh-keygen -t ed25519
• 将公钥上传到服务器（替换your_server_ip）：ssh-copy-id deploy@your_server_ip
• 禁用密码登录（可选但推荐）：sudo nano /etc/ssh/sshd_config
  找到并修改：PasswordAuthentication no
  重启SSH服务：sudo systemctl restart sshd

1.4 更新系统

sudo apt update && sudo apt upgrade -y

1.5 配置防火墙（UFW）

sudo ufw allow OpenSSH # 允许SSH
sudo ufw allow 80 # HTTP端口（后续Web服务）
sudo ufw allow 443 # HTTPS端口
sudo ufw enable # 启用防火墙
sudo ufw status # 检查规则

第2步：安装Node.js环境

2.1 安装Node.js（推荐使用LTS版本）

Ubuntu 24.04 默认仓库中的Node.js可能不是最新版本，建议通过NodeSource安装指定版本（以Node.js 18.x为例）：

# 下载并运行NodeSource安装脚本
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash –

# 安装Node.js和npm
sudo apt install -y nodejs

# 验证安装
node -v # 应输出 v18.x.x
npm -v # 应输出对应版本

📌 如果需要其他版本（如20.x），替换脚本中的setup_18.x为setup_20.x，详见 NodeSource文档。

2.2 安装PM2（进程管理工具）

PM2 用于守护Node.js进程，确保应用崩溃或重启后自动运行：

sudo npm install -g pm2

# 验证安装
pm2 –version

2.3 配置项目依赖（可选，后续步骤会详细操作）

如果已有项目的package.json，可提前安装依赖：

# 假设项目目录为/home/deploy/app
cd /home/deploy/app
npm install –production

好的！接下来是 第3步：部署代码到服务器。这一步需要将本地的Node.js项目代码上传到服务器的 /home/lifire 目录。以下是具体操作：

第3步：部署代码到服务器

3.1 将本地代码传输到服务器

有两种常用方法：SCP（直接复制文件）或 Git（从仓库拉取）。选择其中一种方式操作。

方法1：使用SCP传输文件（推荐简单项目）

• 本地机器操作（替换/your/local/path为本地项目路径，your_server_ip为服务器IP）：# 传输整个项目目录到服务器的 /home/lifire
  scp -r /your/local/project/path deploy@your_server_ip:/home/lifire/

  # 示例：
  # scp -r ./my-node-app deploy@123.45.67.89:/home/lifire/

  📌 输入服务器用户 deploy 的密码（如果配置了SSH密钥则无需密码）。

方法2：使用Git克隆仓库（推荐已有Git管理的项目）

• 服务器操作（确保已安装Git）：# 安装Git
  sudo apt install git -y

  # 进入项目目录
  cd /home/lifire

  # 克隆你的Git仓库（替换为你的仓库URL）
  git clone https://github.com/yourusername/your-repo.git .

  # 如果是私有仓库，配置SSH密钥：
  # 1. 在服务器生成SSH密钥（一路回车）：
  # ssh-keygen -t ed25519
  # 2. 将公钥 `cat ~/.ssh/id_ed25519.pub` 添加到GitHub/GitLab的SSH Keys设置中

3.2 安装项目依赖

• 服务器操作：# 进入项目目录
  cd /home/lifire

  # 安装依赖（根据项目实际情况选择）
  npm install # 安装所有依赖（开发+生产）
  # 或
  npm install –production # 仅安装生产依赖

3.3 配置环境变量（如有需要）

如果项目使用了环境变量（如数据库密码、API密钥），需在服务器配置：

# 创建.env文件（示例）
nano .env

# 填写你的环境变量，例如：
# DB_HOST=localhost
# DB_USER=root
# DB_PASSWORD=your_password

按 Ctrl+O 保存，Ctrl+X 退出。

3.4 启动项目（使用PM2守护进程）

# 进入项目目录
cd /home/lifire

# 启动项目（假设入口文件为app.js）
pm2 start app.js –name "my-node-app"

# 设置PM2开机自启动
pm2 save
pm2 startup
# 执行最后一行输出的命令（例如 `sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u deploy –hp /home/deploy`）

3.5 验证服务是否运行

# 查看PM2进程列表
pm2 list

# 检查应用日志
pm2 logs my-node-app

如果看到应用正常启动且无报错，说明部署成功。

3.6 开放应用端口（如3000、8080等）

如果项目监听的是非80/443端口（例如3000），需开放防火墙：

sudo ufw allow 3000
sudo ufw reload

第4步：配置MySQL数据库

4.1 安装MySQL Server

# 更新软件包列表
sudo apt update

# 安装MySQL Server
sudo apt install mysql-server -y

# 验证安装
sudo systemctl status mysql

• 如果状态显示 active (running)，说明安装成功。

4.2 运行安全配置脚本

sudo mysql_secure_installation

按提示操作：

4.3 登录MySQL并创建专用数据库和用户

# 以root身份登录MySQL（使用刚设置的密码）
sudo mysql -u root -p

在MySQL命令行中执行以下操作（替换 your_db_name、your_db_user 和 your_db_password）：

— 创建数据库
CREATE DATABASE your_db_name;

— 创建专用用户并设置密码（推荐强密码）
CREATE USER 'your_db_user'@'localhost' IDENTIFIED BY 'your_db_password';

— 授予用户对数据库的完全权限
GRANT ALL PRIVILEGES ON your_db_name.* TO 'your_db_user'@'localhost';

— 刷新权限
FLUSH PRIVILEGES;

— 退出MySQL
EXIT;

4.4 配置MySQL允许远程访问（可选）

如果Node.js应用与MySQL不在同一服务器，需开放远程访问（注意：仅限内网环境或配置IP白名单）：

# 修改MySQL配置文件
sudo nano /etc/mysql/mysql.conf.d/mysqld.cnf

找到 bind-address 并修改为：

bind-address = 0.0.0.0

重启MySQL服务：

sudo systemctl restart mysql

然后开放防火墙端口：

sudo ufw allow 3306

4.5 在Node.js项目中配置数据库连接

在项目的 .env 文件中添加数据库信息：

DB_HOST=localhost
DB_PORT=3306
DB_USER=your_db_user
DB_PASSWORD=your_db_password
DB_NAME=your_db_name

4.6 测试数据库连接

在Node.js代码中，使用 mysql2 或 sequelize 等库测试连接：

const mysql = require('mysql2/promise');

async function testConnection() {
const connection = await mysql.createConnection({
host: process.env.DB_HOST,
user: process.env.DB_USER,
password: process.env.DB_PASSWORD,
database: process.env.DB_NAME
});
console.log('数据库连接成功！');
await connection.end();
}

testConnection().catch(console.error);

运行测试：

node test-db.js

如果输出 数据库连接成功！，说明配置正确。

关键注意事项

第5步：配置Nginx反向代理

5.1 安装Nginx

sudo apt install nginx -y
sudo systemctl start nginx
sudo systemctl enable nginx # 设置开机自启

5.2 配置反向代理

5.3 启用配置并测试

# 创建符号链接到sites-enabled目录
sudo ln -s /etc/nginx/sites-available/your_domain.conf /etc/nginx/sites-enabled/

# 测试Nginx配置语法
sudo nginx -t # 应显示 "test is successful"

# 重启Nginx
sudo systemctl restart nginx

5.4 配置防火墙（如果未开放80/443端口）

sudo ufw allow 'Nginx Full' # 允许HTTP（80）和HTTPS（443）
sudo ufw reload

5.5 验证反向代理

访问 http://your_domain.com 或 http://服务器IP，应显示Node.js应用页面。

可选：配置HTTPS（Let’s Encrypt免费证书）

5.6 安装Certbot

sudo apt install certbot python3-certbot-nginx -y

5.7 获取SSL证书

sudo certbot –nginx -d your_domain.com -d www.your_domain.com

按提示操作（输入邮箱、同意条款等），Certbot会自动修改Nginx配置并启用HTTPS。

5.8 验证证书自动续签

sudo certbot renew –dry-run # 模拟续签测试

关键检查点

第6步：部署后的优化与监控

6.1 启用PM2集群模式（提升性能）

如果你的应用支持多进程，使用PM2集群模式充分利用多核CPU：

# 停止现有应用
pm2 delete blog-server-v2

# 启动集群模式（假设使用4个进程）
pm2 start app.js -i 4 –name "blog-server-v2"

# 保存配置
pm2 save

6.2 配置日志轮转（防止日志占满磁盘）

6.3 设置基础监控

6.4 配置自动化备份

6.5 安全加固

6.6 配置健康检查端点（可选）

在Node.js应用中添加一个健康检查路由：

app.get('/health', (req, res) => {
res.status(200).json({ status: 'ok', timestamp: Date.now() });
});

然后通过Nginx或外部监控服务定期访问 http://your_domain.com/health 确认应用存活。

后续建议

至此，你的Node.js应用已完成完整部署！