Vue 项目开发完成后,要让用户通过域名稳定访问,先得选对部署方式。个人作品、企业展示站这类纯静态页面,通常可以把构建文件放到阿里云 OSS;如果项目还要运行接口、SSR 服务,或需要自行管理系统环境,则可以考虑云服务器 ECS。阿里云 vue 部署不一定要从复杂架构开始,项目需要什么,就先部署什么。
一、先确认项目需要什么运行环境
多数 Vue 项目构建后会生成 HTML、CSS、JavaScript 和图片等静态文件,浏览器读取这些文件就能运行。线上一般不需要持续运行 Vue 开发服务器,也不必在服务器上安装完整的前端开发工具链。
如果项目包含 Node.js 接口、服务端渲染(SSR)或其他后端程序,只上传静态文件就不够了。动手部署前,检查 Vue 版本、构建工具、路由模式、接口地址,以及后端是否需要单独部署。尤其要确认生产环境接口地址,避免页面上线后仍请求 localhost。
二、阿里云常见部署方式
方式一:OSS,适合纯静态站点
将 Vue 构建产物上传到阿里云对象存储 OSS,再按需要配置静态网站托管和自定义域名。需要加快资源访问时,可以进一步接入 CDN。这种方式不需要自己维护操作系统,适合没有服务端渲染的作品集、活动页和企业展示站。
配置时检查存储桶权限、域名绑定和 HTTPS。不要为了省事把整个存储桶设为公开读写;对外提供静态文件访问,也应按实际需求设置权限。
方式二:ECS,适合需要自行管理服务的项目
在云服务器 ECS 上安装 Nginx 等 Web 服务器,把构建文件放进站点目录,再配置域名、HTTPS 和访问规则。若同一台机器还运行 API 服务,可以通过 Nginx 按路径转发请求。ECS 的控制空间更大,但系统更新、进程管理、访问安全和备份也需要自行负责。
三、Vue 项目上线的7个步骤
- 检查项目配置。确认构建命令和输出目录。常见命令是 npm run build,具体以项目的 package.json 为准。Vite 项目通常输出到 dist,其他工具的目录可能不同。
- 设置生产环境接口。确认构建时使用线上 API 地址,而不是 localhost 或开发环境地址。不要把密钥、数据库密码等敏感信息写进前端代码,浏览器可以查看下载到本地的资源。
- 本地预览构建结果。完成构建后检查输出目录,并用本地静态服务预览。逐一确认页面、图片、字体和接口请求正常,别只凭开发服务器中的表现判断上线效果。
- 选定部署目标。没有后端服务的静态项目,可以先评估 OSS;需要运行后端、调整系统配置或统一管理多个服务时,再考虑 ECS。资源规格结合实际访问情况选择,后续可依据监控结果调整。
- 上传文件并配置站点。使用 OSS 时上传构建产物,检查网站入口设置;使用 ECS 时把文件放入 Nginx 站点目录,并配置根路径和域名解析。发布新版本前保留旧版本,出错时更容易回滚。
- 处理路由和 HTTPS。Vue Router 使用 history 模式时,直接访问二级页面或刷新页面,服务器需要将未匹配的页面请求回退到入口 HTML,否则可能出现 404。配置 HTTPS 证书后,也要检查 HTTP 是否按预期跳转到 HTTPS。
- 上线后逐项验证。通过域名检查首页、子页面、静态资源和接口请求,再查看浏览器控制台、服务器日志或云服务监控。确认正常后,再清理浏览器缓存,或按需刷新 CDN。
四、案例:小团队上线 Vue 产品展示站
一个三人团队准备上线产品展示站,页面包括首页、产品介绍和联系表单。前端构建后只生成静态文件,表单由单独的接口服务处理。团队将前端资源放在 OSS,绑定自有域名;接口服务则部署在已有的 ECS 上,通过 HTTPS 域名提供访问。
上线测试时,首页可以正常打开,但直接访问产品详情页会报错。排查后发现,Vue Router 使用 history 模式,静态站点没有把深层路由请求回退到入口文件。调整回退规则后,页面恢复正常。这个问题很容易被忽略:部署不能只检查首页,二级页面的直接访问和刷新也要测试。
五、常见问题与排查方法
- 页面空白:先打开浏览器控制台和网络面板,检查 JavaScript 资源是否返回 404、接口是否报错,以及构建时是否读取了正确的环境变量。
- 刷新子页面出现 404:检查 history 路由的回退配置。如果当前服务器不方便调整,也可以评估改用 hash 路由。
- 图片或资源路径错误:确认构建工具的基础路径与实际访问路径一致。项目部署在域名子目录下时,尤其要检查这项配置。
- 修改后仍显示旧内容:检查浏览器和 CDN 缓存。带版本号的资源可以设置较长缓存,入口 HTML 宜设置较短缓存;发布后按需刷新 CDN。
- 接口跨域或请求失败:核对前端接口地址、后端跨域策略、HTTPS 协议和服务器访问规则。页面使用 HTTPS 时,不要让它请求 HTTP 接口。
六、上线前检查清单
发布前确认线上接口地址正确,前端没有敏感凭据,域名解析已生效,HTTPS 可以正常访问,Vue 路由刷新正常,移动端页面显示正常,并且备份和回滚方式明确。
如果使用 ECS,还要检查系统补丁、登录方式和安全组规则,只开放业务所需端口,并定期查看日志和资源使用情况。纯静态站点可以从 OSS 起步;需要运行服务端程序或更灵活地控制环境时,再选择 ECS。先完成一次范围可控、便于验证的上线,之后再根据访问量、响应速度和运维成本调整架构。