单台 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 + 负载均衡,都不会推倒重来。
云服务器