Ubuntu上Node.js项目如何迁移

Ubuntu上Node.js项目迁移详细步骤

在开始迁移前，务必备份项目的所有关键数据，避免数据丢失。

备份代码：使用tar命令将项目目录打包为压缩文件，例如：
tar -czvf project-backup.tar.gz /path/to/your/nodejs/project
备份数据库（若项目使用数据库）：
- MySQL：mysqldump -u [username] -p [database_name] > database_backup.sql
- PostgreSQL：pg_dump -U [username] -d [database_name] > database_backup.sql
备份配置文件：如.env（环境变量）、Nginx配置文件（若有反向代理）、PM2配置文件（若有进程管理）等。

确保新服务器（Ubuntu系统）已安装Node.js、npm及必要依赖。

更新系统包：
sudo apt update && sudo apt upgrade -y
安装Node.js（以Node.js 16.x为例，可根据项目需求调整版本）：
```
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt install -y nodejs
```
安装完成后，验证版本：node -v（应输出v16.x.x）、npm -v（应输出对应版本）。

将本地/旧服务器的项目代码传输到新服务器。

使用SCP传输（适用于小型项目）：
scp -r project-backup.tar.gz [username]@[new_server_ip]:/path/to/new/location
解压代码：
在新服务器上进入目标目录，执行：
tar -xzvf project-backup.tar.gz -C /path/to/new/location

或使用Git克隆（若项目托管在Git仓库）：

cd /path/to/new/location
git clone https://github.com/your-username/your-repo.git
cd your-repo

进入项目目录，通过package.json安装所有依赖。

cd /path/to/new/location/your-project
npm install

可选：若项目使用yarn，可先删除yarn.lock文件，再运行npm install生成package-lock.json（确保依赖版本一致）。

将旧服务器的数据库备份恢复到新服务器。

恢复MySQL数据库：
mysql -u [username] -p [database_name] < /path/to/database_backup.sql
恢复PostgreSQL数据库：
psql -U [username] -d [database_name] < /path/to/database_backup.sql
验证数据库连接：检查项目中的数据库配置（如.env文件中的DATABASE_URL）是否与新服务器的数据库信息一致。

确保新服务器的环境变量与旧服务器一致，避免因配置差异导致应用异常。

创建/复制.env文件：将旧服务器的.env文件复制到新项目目录，或手动创建并填写必要变量（如NODE_ENV=production、DATABASE_URL等）。
检查启动脚本：若项目使用PM2管理进程，需更新PM2配置文件（如ecosystem.config.js）中的项目路径、环境变量等信息。

使用进程管理工具（如PM2）启动项目，确保其在后台稳定运行。

安装PM2（若未安装）：
sudo npm install -g pm2
启动项目：
pm2 start app.js --name "your-project-name"（app.js替换为项目的入口文件，如index.js、server.js）。
验证状态：
pm2 status（应显示项目为“online”状态）。
设置开机自启动（可选但推荐）：
pm2 startup（按提示执行生成的命令，确保服务器重启后项目自动启动）。

测试应用功能：通过浏览器或curl访问项目URL（如http://your-server-ip），检查页面加载、接口响应是否正常。
查看日志：若出现问题，通过pm2 logs your-project-name查看实时日志，定位错误原因。
清理备份文件：确认迁移成功后，删除旧备份文件以释放空间：
rm project-backup.tar.gz、rm /path/to/database_backup.sql。

最新问答