JavaScript应用分为前端静态应用和Node.js后端服务两类，不同类型的部署方式存在明显差异，下面分别介绍具体的部署步骤和注意事项。
前端JavaScript静态应用部署
前端应用通常是Vue、React、原生JS等开发完成后打包生成的静态文件，部署核心是选择合适的静态资源服务器。
1. 打包构建
首先执行打包命令生成可部署的静态文件，以React应用为例：
# 进入项目根目录 cd my-react-app # 执行打包命令，生成build目录 npm run build
2. 选择部署方式
常见的静态部署方式有以下几种：
- 使用Nginx托管：将build目录下的所有文件上传到服务器指定目录，配置Nginx指向该目录即可
- 使用对象存储服务：将静态文件上传到云厂商的对象存储桶，开启静态网站托管功能
- 使用Serverless静态托管：部分云厂商提供免服务器的静态托管服务，直接上传文件即可访问
3. Nginx配置示例
如果使用Nginx部署，配置文件可以参考以下内容：
server {
listen 80;
server_name your_domain.com;
# 静态文件存放目录
root /usr/share/nginx/html/your_app;
index index.html index.htm;
# 处理前端路由刷新404问题
location / {
try_files $uri $uri/ /index.html;
}
# 静态资源缓存配置
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
expires 7d;
add_header Cache-Control "public, max-age=604800";
}
}Node.js后端服务部署
Node.js应用是运行在服务端的JavaScript程序，部署需要保证服务持续运行，同时做好进程管理和环境配置。
1. 环境准备
首先在服务器上安装对应版本的Node.js和包管理工具，推荐使用nvm管理Node.js版本：
# 安装nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash # 安装指定版本Node.js nvm install 18 # 验证安装 node -v npm -v
2. 上传项目与安装依赖
将项目代码上传到服务器后，安装生产环境依赖，注意不要安装开发依赖：
# 进入项目目录 cd /path/to/your/node_app # 安装生产依赖 npm install --production
3. 进程管理
直接使用node命令启动服务会在终端关闭后停止，需要使用进程管理工具保证服务持续运行，推荐使用pm2：
# 全局安装pm2 npm install -g pm2 # 启动Node.js服务，app.js为入口文件 pm2 start app.js --name your_app_name # 查看运行状态 pm2 list # 设置开机自启 pm2 startup pm2 save
4. 反向代理配置
通常Node.js服务运行在非80/443端口，需要配置Nginx做反向代理，示例配置如下：
server {
listen 80;
server_name api.your_domain.com;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}自动化部署（CI/CD）
手动部署效率低且容易出错，可以通过CI/CD工具实现代码推送后自动部署，常见的工具包括GitHub Actions、GitLab CI等。
以GitHub Actions为例，在项目根目录创建.github/workflows/deploy.yml文件，示例配置如下：
name: Deploy JavaScript App
on:
push:
branches: [ main ]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v4
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: 18
- name: Install dependencies
run: npm install
- name: Build project
run: npm run build
- name: Deploy to server
uses: appleboy/ssh-action@v1.0.0
with:
host: ${{ secrets.SERVER_HOST }}
username: ${{ secrets.SERVER_USER }}
key: ${{ secrets.SSH_KEY }}
script: |
cd /path/to/your/app
git pull
npm install --production
pm2 restart your_app_name配置完成后，每次推送代码到main分支，就会自动执行构建和部署流程，无需手动操作。
部署常见注意事项
- 环境变量不要硬编码在代码中，使用
.env文件配合dotenv库管理，部署时配置服务器环境变量 - 前端应用部署前要检查资源路径是否正确，避免静态资源404
- Node.js服务要做好错误捕获和日志收集，方便排查线上问题
- 部署前在测试环境验证功能，确认无误后再部署到生产环境
JavaScript应用部署Node.js前端部署CI_CD修改时间：2026-05-29 23:36:05