奋斗
努力

如何在一台阿里云ECS实例上部署前端和后端应用?

云计算

单台 ECS 部署前后端,比较稳的做法是:

Nginx 负责 80/443 入口,托管前端静态文件,并把 /api 反向X_X到本机后端服务;后端服务只监听 127.0.0.1,不要直接暴露到公网。

整体结构类似这样:

用户浏览器
   ↓
域名 /  ECS 公网 IP
   ↓
Nginx :80 / :443
   ├─ /            → 前端 dist 静态资源
   └─ /api/        → http://127.0.0.1:3000
                         ↓
                    后端 API 服务
                         ↓
                MySQL / PostgreSQL / Redis
              本机部署或阿里云 RDS / Redis 内网地址

下面按实际部署流程说。


1. ECS 准备

假设 ECS 系统为 Ubuntu 22.04。如果用 Alibaba Cloud Linux、CentOS,把 apt 换成 dnf/yum 即可,Nginx、systemd 的配置思路一致。

安全组

在阿里云 ECS 控制台配置安全组:

建议只开放:

22/SSH    仅允许自己的办公 IP
80/HTTP   0.0.0.0/0
443/HTTPS 0.0.0.0/0

不要开放:

3000、8080 等后端端口
3306 MySQL
6379 Redis
27017 MongoDB

数据库和后端接口不需要直接暴露到公网。

如果 ECS 在内地地域,域名通过 80/443 对外提供 Web 服务,通常需要完成 ICP 备案。域名备案通过后,再做 A 记录解析到 ECS 的弹性公网 IP。


2. 安装基础环境

登录 ECS 后先更新系统:

sudo apt update
sudo apt upgrade -y

安装常用组件:

sudo apt install -y nginx git curl build-essential

安装 Node.js,版本按项目要求来。Vue、React、NestJS、Express 这类项目常用 Node 18 或 20 LTS:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
node -v
npm -v

安装 PM2,用来守护 Node 后端进程:

sudo npm install -g pm2

创建部署目录和用户:

sudo adduser deploy
sudo usermod -aG sudo deploy

sudo mkdir -p /var/www/myapp
sudo mkdir -p /srv/myapp
sudo chown -R deploy:deploy /var/www/myapp /srv/myapp

3. 部署前端

前端一般不要直接在服务器上边改代码边构建,比较推荐在本地或 CI 里打包好,然后上传 dist 产物。

本地构建

以前端项目是 Vue/React 为例:

npm ci
npm run build

生成目录一般是:

dist/

上传到 ECS:

scp -r dist/* deploy@你的ECS公网IP:/var/www/myapp/

服务器上确认权限:

sudo chown -R www-data:www-data /var/www/myapp
sudo find /var/www/myapp -type d -exec chmod 755 {} ;
sudo find /var/www/myapp -type f -exec chmod 644 {} ;

如果你的前端是 History 路由,例如 Vue Router 的 history 模式、React Router 的 BrowserRouter,Nginx 必须配置 fallback,否则刷新页面会 404。


4. 部署后端

后端部署方式取决于技术栈。下面以 Node 后端为例,假设服务监听 3000 端口。

上传后端代码

sudo -u deploy git clone 你的仓库地址 /srv/myapp/api
cd /srv/myapp/api

安装依赖:

npm ci --omit=dev

配置环境变量:

sudo -u deploy nano /srv/myapp/api/.env

示例:

NODE_ENV=production
PORT=3000
DATABASE_URL=mysql://app_user:your_password@127.0.0.1:3306/app_db
JWT_SECRET=replace_with_a_strong_secret

权限收紧一下:

chmod 600 /srv/myapp/api/.env

如果你的后端需要数据库迁移,先执行迁移脚本,例如:

npm run migrate

或者:

npx prisma migrate deploy

后端监听地址

后端建议只监听本机:

app.listen(process.env.PORT || 3000, '127.0.0.1');

如果后端是 Java、Go、Python,也同理:对公网只暴露 Nginx,后端服务让 Nginx 在本机转发即可。

用 PM2 启动 Node 服务

新建 ecosystem.config.js:

module.exports = {
  apps: [
    {
      name: 'myapp-api',
      script: 'dist/main.js',
      instances: 1,
      exec_mode: 'fork',
      env: {
        NODE_ENV: 'production',
        PORT: 3000
      }
    }
  ]
};

启动:

cd /srv/myapp/api
pm2 start ecosystem.config.js
pm2 save
pm2 startup

pm2 startup 会输出一条命令,按提示复制执行,用来配置开机自启。

确认后端已经在本机跑起来:

curl http://127.0.0.1:3000/health

如果你的接口没有 /health,换成实际接口路径即可。


5. 配置 Nginx

新建配置:

sudo nano /etc/nginx/sites-available/myapp

写入:

server {
    listen 80;
    server_name example.com www.example.com;

    root /var/www/myapp;
    index index.html;

    gzip on;
    gzip_comp_level 5;
    gzip_types text/plain text/css application/json application/javascript application/xml image/svg+xml;

    client_max_body_size 20m;

    location = /index.html {
        add_header Cache-Control "no-cache, no-store, must-revalidate";
    }

    location ~* .(js|css|png|jpg|jpeg|gif|ico|svg|webp|woff|woff2|ttf|eot)$ {
        expires 30d;
        add_header Cache-Control "public, immutable";
        try_files $uri =404;
    }

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /api/ {
        proxy_pass http://127.0.0.1:3000/;
        proxy_http_version 1.1;

        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_connect_timeout 10s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
    }
}

启用配置:

sudo ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/myapp
sudo nginx -t
sudo systemctl reload nginx

这里有个容易踩坑的点:

location /api/ {
    proxy_pass http://127.0.0.1:3000/;
}

末尾这个 / 会把 /api/users 转成后端的 /users。

如果你的后端接口本身路径就是 /api/users,那应该写成:

location /api/ {
    proxy_pass http://127.0.0.1:3000;
}

也就是不带末尾 /,保留 /api 前缀。

前端请求地址建议直接用相对路径:

axios.create({
  baseURL: '/api'
});

不要写死:

http://localhost:3000/api

用户浏览器里的 localhost 指的是用户自己的电脑,不是 ECS。


6. 配置 HTTPS

如果域名已经备案并解析到了 ECS,可以用 certbot 配 Let’s Encrypt 证书:

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d example.com -d www.example.com

证书会自动续期,可以检查:

sudo systemctl list-timers | grep certbot

如果你用的是阿里云 SSL 证书,下载 Nginx 格式证书后,放到:

/etc/nginx/ssl/

然后在 Nginx 里配置:

server {
    listen 443 ssl http2;
    server_name example.com www.example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;

    root /var/www/myapp;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /api/ {
        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;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

改完后一定要:

sudo nginx -t
sudo systemctl reload nginx

7. 数据库怎么放

如果只是测试、内部系统、小流量项目,可以直接在 ECS 上装 MySQL 或 PostgreSQL。

例如 MySQL:

sudo apt install -y mysql-server
sudo mysql_secure_installation

创建库和账号:

CREATE DATABASE app_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'app_user'@'127.0.0.1' IDENTIFIED BY '强密码';
GRANT ALL PRIVILEGES ON app_db.* TO 'app_user'@'127.0.0.1';
FLUSH PRIVILEGES;

Redis:

sudo apt install -y redis-server
sudo systemctl enable --now redis-server

确认 Redis 只监听本机:

sudo nano /etc/redis/redis.conf

检查:

bind 127.0.0.1 -::1
protected-mode yes

不过如果是正式业务,我更建议直接用阿里云 RDS MySQL/PostgreSQL 和云数据库 Redis:

  • 数据可靠性更好;
  • 备份、恢复、监控省事;
  • ECS 通过内网访问,延迟低;
  • 不需要自己处理数据库端口暴露、备份、主从切换这些杂活。

用 RDS 时注意把 ECS 的私网 IP 加到 RDS 白名单里,后端连接地址用 RDS 的内网地址。


8. 发布和回滚

前端建议用版本目录加软链接,回滚会舒服很多。

目录结构:

/var/www/myapp/
  releases/
    20250101/
    20250105/
  current -> releases/20250105

发布:

scp -r dist deploy@ECS_IP:/var/www/myapp/releases/20250105
sudo ln -nfs /var/www/myapp/releases/20250105 /var/www/myapp/current

Nginx 配置里 root 用:

root /var/www/myapp/current;

回滚只需要切软链:

sudo ln -nfs /var/www/myapp/releases/20250101 /var/www/myapp/current
sudo nginx -s reload

后端也可以按版本目录部署,但要注意数据库迁移不一定能简单回滚。发布脚本可以写成:

#!/usr/bin/env bash
set -e

cd /srv/myapp/api

git fetch --all
git reset --hard origin/main

npm ci --omit=dev
npm run migrate

pm2 reload ecosystem.config.js || pm2 start ecosystem.config.js
pm2 save

9. 常见排查点

部署完访问不了,通常就这些原因。

1. ECS 安全组没放行端口

检查:

80、443 是否开放
22 是否只允许自己的 IP
3000、8080、3306、6379 是否误开公网

2. 后端端口没在本机监听

sudo ss -lntp | grep -E ':80|:443|:3000|:8080'

正常应该看到 Nginx 监听 80/443,后端监听 3000 或 8080。

3. Nginx 配置错误

sudo nginx -t
tail -f /var/log/nginx/error.log
tail -f /var/log/nginx/access.log

4. 后端服务没起来

Node + PM2:

pm2 list
pm2 logs myapp-api

systemd 服务:

systemctl status myapp-api
journalctl -u myapp-api -f

5. 前端刷新页面 404

History 路由需要:

location / {
    try_files $uri $uri/ /index.html;
}

6. HTTPS 后接口被浏览器拦截

页面是 HTTPS,但接口走 HTTP,会出现 Mixed Content。前端接口统一用:

baseURL: '/api'

或者完整的 HTTPS 域名。

7. 静态资源缓存太久

带 hash 的 JS/CSS 可以长缓存:

app.8d3f9a.js

没有 hash 的文件不要设置 immutable 长缓存,否则发布后用户可能继续拿旧文件。


10. 生产环境建议

单台 ECS 跑前端、后端、数据库,适合测试环境、小型系统、内部工具。如果业务有一定流量,建议至少做这些拆分:

  • 数据库用 RDS,不要和 Web 服务抢资源;
  • 静态资源可以放 OSS + CDN;
  • 多台 ECS 前面挂 SLB/ALB;
  • ECS 开启快照和云监控告警;
  • 日志接入阿里云日志服务或其他日志系统;
  • .env、私钥、证书不要提交到代码仓库;
  • 定期升级系统补丁;
  • 为数据库和重要文件做备份。

如果机器配置是 1 核 2G,同时跑 Java 后端、MySQL、Redis、Nginx 会比较紧。Java 项目建议至少 2 核 4G 起步,或者使用 RDS 把数据库压力分出去。

对于大多数场景,单台 ECS 的核心部署模型就是:

Nginx 管入口
前端放 dist
后端只监听本机
PM2/systemd 守护进程
数据库尽量用内网或 RDS
安全组只放必要端口

按这个思路搭,后面无论是加 HTTPS、接 CI/CD,还是迁移到多台 ECS + 负载均衡,都不会推倒重来。

未经允许不得转载:云服务器 » 如何在一台阿里云ECS实例上部署前端和后端应用?