Vue项目上传云服务器,传的是npm run build生成的dist目录,不是整个源码仓库;服务器上用Nginx指向这个目录,再补上try_files回退规则,项目才算真正跑起来。
很多新手第一次做这件事,容易把整个项目文件夹拖到服务器上,然后在服务器里执行npm install、npm run dev,这样做既慢又不安全,线上环境也不该跑开发服务器,正确的思路是把Vue当成一组静态文件来处理,本地完成构建,服务器只负责托管。
上传之前,先把构建产物和服务器环境理顺
本地打包到底生成了什么
在项目根目录执行:
npm run build
构建完成后会出现dist目录,里面通常是index.html、assets下的JS和CSS、图片字体等静态资源,需要检查两个地方:
vue.config.js或vite.config.js里的publicPath/base,如果项目要部署到子目录,必须改成对应路径,否则资源会404。- 路由模式,
history模式需要服务端支持,hash模式对服务端几乎无要求,生产环境多数项目用history,这也是后面404问题的根源。
打包完成后,本地可以先用npx serve dist快速预览,确认页面和接口请求正常,再往服务器传。
服务器上要提前准备的三样东西
- 一个能登录的Linux用户,建议普通用户加
sudo,不要长期用root直接操作网站目录。 - 安装Nginx,以Ubuntu为例:
sudo apt install nginx;CentOS系用sudo yum install nginx。 - 放行端口,云厂商控制台的安全组要开80和443,服务器本机防火墙也要放行,
firewall-cmd --add-port=80/tcp --permanent之后记得reload,只开安全组不开本机防火墙,或者反过来,都会出现“服务器上能curl通、外网打不开”的情况。
目录建议统一放在/var/www/下,
sudo mkdir -p /var/www/vue-app sudo chown -R $USER:$USER /var/www/vue-app
后面上传的文件都进这个目录,权限清晰,排查也方便。
vue项目打包后怎么部署到简米云服务器:三条上传路径怎么选
scp或rsync命令行上传
适合熟悉终端、项目更新频繁的人,最直接的一条命令:
scp -r dist/ root@服务器公网IP:/var/www/vue-app/
如果每次都要覆盖旧文件,rsync更省事,它只传差异部分,还能删掉服务器上多余的旧资源:
rsync -avz --delete dist/ root@服务器公网IP:/var/www/vue-app/
--delete要谨慎,目录写错会误删,建议先--dry-run跑一遍看清单。
宝塔面板上传,Vue项目上传云服务器用宝塔面板还是命令行
这是被问得很多的一组对比,宝塔的优势是可视化:添加站点、设置根目录、上传压缩包、在线解压、点几下配置伪静态,对不熟悉Linux的人友好,命令行的优势是快、可脚本化、可接入自动化,出问题也更容易定位。
| 对比项 | 宝塔面板 | scp/rsync命令行 |
|---|---|---|
| 上手门槛 | 低,图形界面 | 需要记命令 |
| 上传速度 | 受面板和网络影响 | 直连,通常更快 |
| 更新效率 | 手动上传解压 | 一条命令或脚本完成 |
| 排错能力 | 看日志入口分散 | 终端直接看Nginx和系统日志 |
| 适合场景 | 单机、少量站点、新手 | 多环境、频繁发布、团队协作 |
选哪个没有标准答案,个人项目、一台服务器、几个月更新一次,宝塔足够;如果每周都要发版,命令行加脚本会明显省时间。
Git拉取或CI自动构建
服务器上装Git,把构建产物放到独立分支,服务器git pull,更规范的做法是本地推送后由CI流水线构建并同步到服务器,常见组合是GitHub Actions加rsync,这条路线前期配置多一点,但发布动作会变成“推代码”,人为失误少,小项目不必一上来就上CI,先把手动流程跑通更重要。
Nginx配置,决定项目能不能正常访问
一个能用的基础配置
在/etc/nginx/conf.d/下新建vue-app.conf:
server {
listen 80;
server_name 你的域名或服务器IP;
root /var/www/vue-app;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
location /api/ {
proxy_pass http://127.0.0.1:3000/;
}
}
保存后执行sudo nginx -t检查语法,没问题再sudo systemctl reload nginx。root必须指向dist所在层,不要多一层也不要少一层,这是新手最常见的路径错误。
vue项目上传到云服务器后刷新404怎么解决
首页能打开,点进子路由再刷新就404,几乎都是history模式缺服务端回退,浏览器请求的是/user/123这种真实路径,Nginx在磁盘上找不到对应文件,自然返回404,上面配置里的try_files $uri $uri/ /index.html;就是让找不到的路径统一回到index.html,再由前端路由接管,行业共识认为,使用history模式就必须在服务端做这项fallback,没有例外。
如果配了try_files还404,按顺序查:root路径是否指对、index.html是否真的在目录里、浏览器是否命中了旧缓存、CDN是否缓存了404响应,清缓存后强刷再测。
资源路径和缓存的两个细节
- 打包时用了绝对路径
/assets/...,项目却部署在/app/子目录下,会出现白屏,改base为/app/重新构建即可。 index.html不建议长缓存,带hash的JS和CSS可以长缓存,可以在Nginx里对index.html单独设置Cache-Control: no-cache,避免发版后用户还拿到旧入口文件。
域名、HTTPS和成本,上线前顺手处理掉
域名解析与备案
据工信部规定,使用中国大陆服务器绑定域名提供网站服务,需要完成ICP备案,解析上,在域名服务商处添加A记录指向服务器公网IP,生效后用ping或curl -I验证,没备案先用IP访问测试,功能没问题再走备案流程。
HTTPS
免费证书足够个人项目使用,Let’s Encrypt配合certbot可以自动续期,宝塔面板里也有申请入口,启用HTTPS后记得把HTTP请求301到HTTPS,避免混合内容告警。
vue项目部署到云服务器一年多少钱
成本不只是一台服务器,入门级轻量应用服务器年付通常在几百元区间,具体看厂商活动和配置;域名一年几十元;SSL证书用免费的;带宽按固定带宽或流量计费,访问量小的项目固定小带宽就够,需要注意的是,低价套餐往往带宽和流量有限,图片多、接口重的项目要提前估算,据统计,多数个人和小团队项目的首年支出集中在一台轻量服务器加一个域名,属于可控范围。
上线后的自检清单
- 用无痕窗口访问首页和二级路由,各刷新一次。
- 打开开发者工具Network面板,确认JS、CSS、图片没有404。
- 检查接口请求是否跨域,生产环境优先用Nginx反向代理同域访问。
- 确认服务器目录权限,Nginx用户对静态文件有读权限即可,不要图省事给777。
- 发版后对比文件hash,确认用户拿到的是新资源。
关于vue项目怎么上传到云服务器6的常见疑问
Q1:上传时必须用root账号吗?
不建议,创建一个普通用户,加入sudo组,网站目录归属该用户或Nginx运行用户,root登录风险高,一旦密钥泄露影响整台机器,上传时用普通用户加sudo提权,权限边界更清楚。
Q2:文件传上去了,页面空白但控制台没明显报错,先查什么?
先看Network里assets下的请求状态码,大量404通常是base路径配错或root指错层级;请求200但页面空白,检查是否有路由守卫拦截或接口失败导致渲染中断,再用curl -I http://你的地址/assets/具体文件名在服务器本机验证文件是否真的存在,业内专家指出,静态部署的问题八成出在“构建路径”和“服务器目录”没对齐,而不是Vue代码本身。
Q3:Vue项目一定要用Nginx吗,能不能用Node直接托管?
dist本质是静态文件,Nginx在并发、缓存、压缩和反向代理上更成熟,生产环境更适合,用Express的express.static也能跑,但等于多起一个Node进程管静态资源,收益不高,SSR项目才需要Node常驻,普通SPA用Nginx托管静态文件加反向代理接口即可。
把构建产物放对位置、Nginx指向正确、回退规则配好,Vue项目上云这件事就闭环了,剩下的域名、证书、自动化,都是在这个闭环上做加法。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/806191.html


