Vue 项目上线后,服务器通常不需要运行开发环境。使用 Vue CLI 或 Vite 构建的单页应用,会生成 HTML、JavaScript 和 CSS 等静态文件,再由 Nginx 或对象存储对外提供访问。部署时要把构建文件、网站目录、域名和访问规则配好;只把代码传上服务器还不够。
本文以阿里云 ECS 和 Nginx 为例,介绍常见静态站点的发布流程。若项目使用 Nuxt 等服务端渲染方案,需要按它的部署模式配置 Node.js 服务,不能直接照搬静态文件的做法。若不想维护服务器,也可以考虑阿里云 OSS 静态网站托管或其他托管服务,但仍要检查路由回源、证书和缓存设置。
确认项目配置并完成本地构建
构建前先在本地启动项目,检查页面和接口是否正常,并确认生产环境使用的 API 地址、环境变量都已配置好。开发环境中的 localhost 不能留在正式配置里:上线后,访问者的浏览器会尝试连接访问者自己的电脑,而不是你的服务器。
进入项目目录安装依赖并执行构建命令。Vite 和 Vue CLI 项目常用 npm run build,实际命令以 package.json 的 scripts 配置为准。构建成功后会生成 dist 目录,这里面才是要发布的静态文件。不要把整个开发项目直接作为网站根目录,也不要让生产环境长期运行 npm run dev。
还要留意部署路径。如果网站地址是 https://example.com/,通常无需调整资源基础路径;如果放在 https://example.com/app/,则需设置构建工具的 base 路径,并让 Vue Router 使用相同的基础路径。两处不一致时,页面有时能打开,但脚本或样式会因路径错误返回 404。
准备阿里云 ECS 和网站目录
在阿里云控制台创建 ECS 实例时,按项目需求选择地域和操作系统。个人展示站或小型业务可以先从较低规格开始,后续结合访问量和资源监控调整。安全组只开放实际需要的入站端口:SSH 管理端口、HTTP 的 80 端口,以及启用 HTTPS 后使用的 443 端口。不要为了省事长期开放所有端口。
通过 SSH 登录服务器后安装 Nginx。不同 Linux 发行版使用的包管理命令和配置文件路径可能不同,操作前先核对对应系统的文档。接着创建网站目录,例如 /var/www/vue-app,将本地 dist 目录里的内容上传到这里。可以使用 SCP、SFTP,也可以通过代码仓库或自动化流水线发布。
配置 Nginx 和前端路由
为站点配置监听端口、域名和网站根目录。Vue 单页应用的页面切换由前端路由处理,用户直接打开或刷新 /about 时,Nginx 默认会去服务器上找名为 about 的文件,找不到就可能返回 404。使用 try_files 将这类请求交给 index.html,前端路由才能继续处理。
server {
listen 80;
server_name example.com www.example.com;
root /var/www/vue-app;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
}
保存配置后,先运行 Nginx 配置检查命令,确认语法无误再重新加载服务。配置文件位置会因系统而异;如果 ECS 上已有其他网站,也要检查是否存在重复监听或配置覆盖。之后用浏览器访问服务器公网 IP 或域名,分别测试首页和前端路由。
绑定域名并配置 HTTPS
使用自有域名时,在域名解析控制台添加指向 ECS 公网 IP 的记录。常见做法是为主域名添加 A 记录,并按需要为 www 子域名添加记录。解析结果受缓存影响,可能不会立刻更新。网页打不开时,依次检查域名解析结果、实例公网 IP、安全组规则和 Nginx 监听状态,比反复修改页面代码更有效。
正式网站建议启用 HTTPS。可以通过阿里云申请或购买 SSL 证书,再按证书服务提供的说明部署到 Nginx,并在安全组中开放 443 端口。配置后检查证书覆盖的域名、证书链和续期安排,再设置 HTTP 跳转到 HTTPS。若页面仍请求 HTTP 接口或第三方资源,浏览器可能拦截这些混合内容,相关地址也要改为 HTTPS。
发布后的验收与维护
例如,团队用 Vue 和 Vite 制作活动报名页,目标地址是 https://event.example.com。他们先配置生产环境 API 地址,构建并检查 dist,再将文件上传到 ECS 网站目录,设置 Nginx 根目录和路由回退规则。域名解析完成后部署 HTTPS 证书。第一次验收时首页正常,但刷新报名详情页会返回 404;检查后发现 Nginx 缺少 try_files。补上规则并重新加载,详情页直达和刷新才恢复正常。
所以,验收不要只看首页是否能打开。至少测试关键页面、复制链接后直接访问的效果,以及登录和业务接口;再通过浏览器开发者工具查看跨域、证书和资源加载错误。移动端页面也应实际检查,避免只在电脑上确认后就结束发布。
- 安排缓存:带内容哈希的 JS、CSS 文件可以设置较长缓存;
index.html应及时更新,避免用户继续拿到旧入口文件并加载失效资源。 - 留好回滚方式:发布前备份现有静态文件,或按版本目录保存构建产物,出问题时可以恢复到上一个版本。
- 收紧服务器访问:及时更新系统和 Nginx,限制 SSH 来源,并确保密钥、配置文件和源码仓库不在网站公开目录中。
Vue 部署到阿里云时,重点核对构建产物是否放在正确目录、Nginx 是否指向该目录、域名是否解析到对应 ECS,以及路由和 HTTPS 是否可用。普通单页应用通常用 ECS 加 Nginx 就能满足基础需求;需要服务端渲染、自动扩缩容或高可用时,再设计 Node.js 服务、负载均衡和发布流程。先完成一套能验证、能回滚的部署,再逐步加入缓存、监控和自动化发布,维护起来更稳妥。