努力
加油

如何将前端项目部署到阿里云上?

前端项目部署到阿里云,本质上就是把你的静态资源(HTML/CSS/JS/图片等)放到一个能对外提供 HTTP 服务的服务器上。

虽然阿里云产品很多,但对于纯前端项目,最主流、成本最低且维护最简单的方案只有两种:

  1. 对象存储 OSS + CDN(推荐,适合纯静态页面,如 Vue/React 打包后的 dist 目录)
  2. 轻量应用服务器 / ECS + Nginx(适合需要后端XX、或者对服务器有控制权的需求)

下面我按这两个路径,把实操步骤拆解清楚。


方案一:OSS + CDN(最推荐,几乎零运维)

这是目前前端部署的“标准答案”。你只需要把打包好的文件上传到 OSS,然后配个域名走 CDN 提速即可。

第一步:准备工作

  1. 本地打包:在你的项目中执行构建命令,比如 npm run build 或 yarn build。你会得到一个 dist 或 build 文件夹。
  2. 配置路由模式:如果你的前端使用了 Vue Router 或 React Router 的 history 模式,务必在打包配置中开启 publicPath: './' 或者确保 Nginx/OSS 支持回退到 index.html。注意:OSS 原生不支持 SPA 路由回退,如果直接用 OSS,建议改用 hash 模式,或者配合 CloudBase(云开发)使用。如果是 history 模式,请看方案二。

第二步:创建 OSS Bucket

  1. 登录阿里云控制台,搜索“对象存储 OSS”。
  2. 点击“创建 Bucket”。
    • Bucket 名称:全局唯一,随便起个有意义的。
    • 地域:选离你用户最近的地方(比如华东1-杭州)。
    • 存储类型:标准存储。
    • 访问权限:私有(为了安全),不要选公共读,除非你不在乎流量费用。
  3. 创建完成后,进入 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

  1. 在 OSS 控制台,找到“域名管理”,添加你的自定义域名(例如 static.yourdomain.com)。
  2. 验证域名所有权(添加 TXT 记录)。
  3. 将 Bucket 设置为“静态网站托管”模式,指定 index.html 为主页。
  4. 关键点:为了让速度快,去阿里云“CDN”控制台,添加提速域名,源站指向你的 OSS 域名。
  5. 解析 DNS:在你的域名服务商那里,把你项目的域名 CNAME 到你的 CDN 域名。

优点:带宽成本低,全球提速,无需维护服务器,不怕被黑。
缺点:不支持服务端渲染(SSR),不支持动态 API 请求(除非你单独搞后端)。


方案二:轻量应用服务器 + Nginx(适合 SSR 或全栈需求)

如果你用的是 Next.js、Nuxt.js 这种需要 Node.js 服务的项目,或者你需要反向XX后端接口,那就得用服务器。

第一步:购买服务器

  1. 登录阿里云控制台,搜索“轻量应用服务器”(Lightweight Application Server)。
  2. 选择镜像:Docker 或者 CentOS/Ubuntu。新手建议直接选 Docker 镜像,省去了装环境的麻烦。
  3. 规格:前端项目很吃 CPU 和内存吗?不。选最低的就行,比如 2核 2G 或 2核 4G,足够跑一个 Nginx 甚至简单的 Node 服务。
  4. 购买后,你会得到一台服务器的 IP 地址和管理密码。

第二步:连接服务器并安装环境

通过 SSH 连上去:

ssh root@你的服务器IP

如果你选的是 Docker 镜像:
你可以直接运行 Nginx 容器:

docker run -d --name my-frontend -p 80:80 nginx

然后把你的 dist 文件夹里的内容替换掉 /usr/share/nginx/html 下的内容。

如果你选的是 Linux 系统镜像:

  1. 安装 Nginx:
    # CentOS
    yum install nginx -y
    # Ubuntu
    apt update && apt install nginx -y
  2. 启动 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。


避坑指南 & 最佳实践

  1. 关于 HTTPS:
    现在浏览器强制要求 HTTPS。在阿里云上,申请 SSL 证书非常简单(免费型一年可续)。

    • OSS 方案:在 CDN 控制台绑定证书,一键开启 HTTPS。
    • Nginx 方案:在 Nginx 配置文件中加入 ssl_certificate 和 ssl_certificate_key 路径,并重写 HTTP 到 HTTPS。
  2. CI/CD 自动化:
    不要手动上传代码!一旦你开始手动传,你就输了。
    推荐使用 GitHub Actions 或 GitLab CI。
    流程:Push 代码 -> 触发 Action -> npm install & npm run build -> 上传 dist 到 OSS 或 SCP 到服务器。
    这样你只管写代码,部署全自动完成。

  3. 缓存策略:
    前端上线后,最怕用户缓存了旧 JS/CSS。

    • 确保你的构建工具(Webpack/Vite)开启了文件名哈希(如 app.a1b2c3.js)。
    • 在 OSS 或 Nginx 中,为 HTML 文件设置短缓存时间(或不缓存),为带 Hash 的资源设置长缓存时间(如 1 年)。
  4. 安全组:
    如果使用 ECS/轻量服务器,记得在阿里云控制台的“防火墙”或“安全组”里,只开放 80 (HTTP)、443 (HTTPS) 和 22 (SSH) 端口,其他端口全部关闭,防止被扫描攻击。

总结

  • 纯静态页面(Vue/React):无脑选 OSS + CDN。便宜、快、稳、不用管服务器。
  • SSR 项目(Next/Nuxt)或需后端XX:选 轻量应用服务器 + Nginx/Docker。
  • 无论哪种,务必配置 HTTPS 和 CI/CD 自动化。

这就够了。别想太复杂,前端部署的核心就是“把文件放到能访问的地方,并确保浏览器能正确加载”。