前端项目部署到阿里云,本质上就是把你的静态资源(HTML/CSS/JS/图片等)放到一个能对外提供 HTTP 服务的服务器上。
虽然阿里云产品很多,但对于纯前端项目,最主流、成本最低且维护最简单的方案只有两种:
- 对象存储 OSS + CDN(推荐,适合纯静态页面,如 Vue/React 打包后的 dist 目录)
- 轻量应用服务器 / ECS + Nginx(适合需要后端XX、或者对服务器有控制权的需求)
下面我按这两个路径,把实操步骤拆解清楚。
方案一:OSS + CDN(最推荐,几乎零运维)
这是目前前端部署的“标准答案”。你只需要把打包好的文件上传到 OSS,然后配个域名走 CDN 提速即可。
第一步:准备工作
- 本地打包:在你的项目中执行构建命令,比如
npm run build或yarn build。你会得到一个dist或build文件夹。 - 配置路由模式:如果你的前端使用了 Vue Router 或 React Router 的
history模式,务必在打包配置中开启publicPath: './'或者确保 Nginx/OSS 支持回退到index.html。注意:OSS 原生不支持 SPA 路由回退,如果直接用 OSS,建议改用hash模式,或者配合 CloudBase(云开发)使用。如果是 history 模式,请看方案二。
第二步:创建 OSS Bucket
- 登录阿里云控制台,搜索“对象存储 OSS”。
- 点击“创建 Bucket”。
- Bucket 名称:全局唯一,随便起个有意义的。
- 地域:选离你用户最近的地方(比如华东1-杭州)。
- 存储类型:标准存储。
- 访问权限:私有(为了安全),不要选公共读,除非你不在乎流量费用。
- 创建完成后,进入 Bucket 详情页,找到“基础设置” -> “网络 endpoint”,记下这个地址。
第三步:上传文件
你有几种方式上传:
- 官方工具 ossutil:命令行工具,适合自动化脚本。
- 第三方客户端:如 Cyberduck、Transmit,图形界面拖拽。
- CI/CD 自动部署:在 GitHub Actions 或 GitLab CI 中集成
ossutil命令,每次 push 代码自动上传。这是最优雅的方式。
手动上传示例(用 ossutil):
# 安装 ossutil (略)
# 配置密钥
./ossutil config
# 上传整个 dist 目录到 bucket 根路径
./ossutil cp -r ./dist oss://your-bucket-name/
第四步:绑定自定义域名 & 开启 CDN
- 在 OSS 控制台,找到“域名管理”,添加你的自定义域名(例如
static.yourdomain.com)。 - 验证域名所有权(添加 TXT 记录)。
- 将 Bucket 设置为“静态网站托管”模式,指定
index.html为主页。 - 关键点:为了让速度快,去阿里云“CDN”控制台,添加提速域名,源站指向你的 OSS 域名。
- 解析 DNS:在你的域名服务商那里,把你项目的域名 CNAME 到你的 CDN 域名。
优点:带宽成本低,全球提速,无需维护服务器,不怕被黑。
缺点:不支持服务端渲染(SSR),不支持动态 API 请求(除非你单独搞后端)。
方案二:轻量应用服务器 + Nginx(适合 SSR 或全栈需求)
如果你用的是 Next.js、Nuxt.js 这种需要 Node.js 服务的项目,或者你需要反向XX后端接口,那就得用服务器。
第一步:购买服务器
- 登录阿里云控制台,搜索“轻量应用服务器”(Lightweight Application Server)。
- 选择镜像:Docker 或者 CentOS/Ubuntu。新手建议直接选 Docker 镜像,省去了装环境的麻烦。
- 规格:前端项目很吃 CPU 和内存吗?不。选最低的就行,比如 2核 2G 或 2核 4G,足够跑一个 Nginx 甚至简单的 Node 服务。
- 购买后,你会得到一台服务器的 IP 地址和管理密码。
第二步:连接服务器并安装环境
通过 SSH 连上去:
ssh root@你的服务器IP
如果你选的是 Docker 镜像:
你可以直接运行 Nginx 容器:
docker run -d --name my-frontend -p 80:80 nginx
然后把你的 dist 文件夹里的内容替换掉 /usr/share/nginx/html 下的内容。
如果你选的是 Linux 系统镜像:
- 安装 Nginx:
# CentOS yum install nginx -y # Ubuntu apt update && apt install nginx -y - 启动 Nginx:
systemctl start nginx systemctl enable nginx
第三步:上传前端代码
你可以用 scp 命令从本地上传:
scp -r ./dist root@你的服务器IP:/var/www/html/
或者直接在服务器上拉取 Git 仓库(更推荐,方便更新):
cd /var/www/html
git clone https://github.com/your-repo.git .
第四步:配置 Nginx(关键)
编辑 Nginx 配置文件。通常在 /etc/nginx/conf.d/default.conf 或 /etc/nginx/nginx.conf。
对于 Vue/React 单页应用,必须配置 fallback,否则刷新页面会 404:
server {
listen 80;
server_name yourdomain.com; # 换成你的域名
root /var/www/html/dist; # 指向你的 dist 目录
index index.html;
location / {
try_files $uri $uri/ /index.html; # 核心配置:所有请求先找文件,找不到就返回 index.html
}
# 如果有后端接口,可以加反向XX
# location /api/ {
# proxy_pass http://localhost:3000;
# }
}
保存后重启 Nginx:
nginx -t # 检查语法
systemctl restart nginx
第五步:域名解析
在你的域名 DNS 解析中,将 A 记录指向你的轻量服务器 IP。
避坑指南 & 最佳实践
-
关于 HTTPS:
现在浏览器强制要求 HTTPS。在阿里云上,申请 SSL 证书非常简单(免费型一年可续)。- OSS 方案:在 CDN 控制台绑定证书,一键开启 HTTPS。
- Nginx 方案:在 Nginx 配置文件中加入
ssl_certificate和ssl_certificate_key路径,并重写 HTTP 到 HTTPS。
-
CI/CD 自动化:
不要手动上传代码!一旦你开始手动传,你就输了。
推荐使用 GitHub Actions 或 GitLab CI。
流程:Push 代码 -> 触发 Action -> npm install & npm run build -> 上传 dist 到 OSS 或 SCP 到服务器。
这样你只管写代码,部署全自动完成。 -
缓存策略:
前端上线后,最怕用户缓存了旧 JS/CSS。- 确保你的构建工具(Webpack/Vite)开启了文件名哈希(如
app.a1b2c3.js)。 - 在 OSS 或 Nginx 中,为 HTML 文件设置短缓存时间(或不缓存),为带 Hash 的资源设置长缓存时间(如 1 年)。
- 确保你的构建工具(Webpack/Vite)开启了文件名哈希(如
-
安全组:
如果使用 ECS/轻量服务器,记得在阿里云控制台的“防火墙”或“安全组”里,只开放 80 (HTTP)、443 (HTTPS) 和 22 (SSH) 端口,其他端口全部关闭,防止被扫描攻击。
总结
- 纯静态页面(Vue/React):无脑选 OSS + CDN。便宜、快、稳、不用管服务器。
- SSR 项目(Next/Nuxt)或需后端XX:选 轻量应用服务器 + Nginx/Docker。
- 无论哪种,务必配置 HTTPS 和 CI/CD 自动化。
这就够了。别想太复杂,前端部署的核心就是“把文件放到能访问的地方,并确保浏览器能正确加载”。
云技术博客