Ubuntu系统上部署Node.js项目的完整流程

以下是在Ubuntu系统上部署Node.js项目的完整流程,分为系统初始化、环境配置、项目部署三个部分:


一、系统初始化 & 环境准备

复制代码

bash

bash 复制代码
# 1. 更新系统软件包
sudo apt update && sudo apt upgrade -y

# 2. 安装基础工具
sudo apt install -y build-essential git curl

# 3. 安装Node.js(推荐使用LTS版本)
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

# 验证安装
node -v && npm -v

# 4. 全局安装PM2进程管理工具
sudo npm install -g pm2

# 设置PM2开机自启
pm2 startup systemd
# 根据提示执行生成的命令(例如)
sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u ubuntu --hp /home/ubuntu

二、上传Node.js项目

方式1:通过SCP上传(本地→服务器)
复制代码

bash

复制代码
# 本地终端执行(非服务器)
scp -r /本地/项目路径 ubuntu@服务器IP:/目标路径
方式2:通过Git克隆
复制代码

bash

复制代码
# 服务器操作
git clone https://github.com/你的仓库地址.git
cd 项目目录

三、项目部署流程

复制代码

bash

复制代码
# 1. 进入项目目录
cd /path/to/your/project

# 2. 安装项目依赖
npm install

# 3. 配置环境变量(按需)
# 方式1:直接写入
echo "PORT=3000" > .env
# 方式2:手动创建.env文件并填写配置

# 4. 启动项目(任选其一)
pm2 start app.js              # 直接启动js文件
pm2 start "npm start" --name "my-app"  # 启动npm脚本
pm2 start ecosystem.config.js # 使用配置文件

# 5. 保存PM2进程列表
pm2 save

# 6. 查看运行状态
pm2 list
pm2 logs

四、网络配置(可选)

1. 开放防火墙端口
复制代码

bash

复制代码
sudo ufw allow 22    # SSH端口(已默认开放)
sudo ufw allow 3000  # 应用端口
sudo ufw enable
2. 配置Nginx反向代理(推荐)
复制代码

bash

复制代码
# 安装Nginx
sudo apt install -y nginx

# 创建配置文件
sudo nano /etc/nginx/sites-available/your-domain.conf

配置文件内容示例:

复制代码

nginx

复制代码
server {
    listen 80;
    server_name your-domain.com;

    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_cache_bypass $http_upgrade;
    }
}

启用配置并重启Nginx:

复制代码

bash

复制代码
sudo ln -s /etc/nginx/sites-available/your-domain.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx
3. 配置SSL证书(Let's Encrypt)
复制代码

bash

复制代码
sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d your-domain.com

五、常用维护命令

复制代码

bash

javascript 复制代码
# 查看实时日志
pm2 logs

# 重启应用
pm2 restart app-name

# 停止应用
pm2 stop app-name

# 删除应用
pm2 delete app-name

# 更新项目代码后的操作
git pull
npm install
pm2 restart all

注意事项:​

  1. 确保项目中的监听地址为 0.0.0.0 而非 127.0.0.1
  2. 生产环境建议使用NODE_ENV=production
  3. 敏感信息(如API密钥)务必通过.env文件管理
  4. 建议使用npm ci代替npm install保持依赖一致性

按照以上步骤操作,即可完成从零开始到生产环境部署的完整流程。

相关推荐
东方佑16 分钟前
自动调整PPT文本框内容:防止溢出并智能截断文本
linux·运维·powerpoint
zhougl9961 小时前
html处理Base文件流
linux·前端·html
泥土编程2 小时前
kubekey -实现懒人一键部署K8S集群
linux·运维
wirepuller_king5 小时前
创建Linux虚拟环境并远程连接,finalshell自定义壁纸
linux·运维·服务器
在野靡生.6 小时前
Ansible(1)—— Ansible 概述
linux·运维·ansible
风123456789~6 小时前
【Linux运维】查询指定日期的上月
linux·运维·服务器
我没想到原来他们都是一堆坏人6 小时前
利用vmware快速安装一个可以使用的centos7系统
linux·虚拟机
x-cmd7 小时前
[250331] Paozhu 发布 1.9.0:C++ Web 框架,比肩脚本语言 | DeaDBeeF 播放器发布 1.10.0
android·linux·开发语言·c++·web·音乐播放器·脚本语言
还是鼠鼠7 小时前
Node.js全局生效的中间件
javascript·vscode·中间件·node.js·json·express
weitinting7 小时前
Ali linux 通过yum安装redis
linux·redis