vue项目部署到linux核心三步:npm run build打包、上传dist至nginx服务目录、配置nginx.conf中root路径和location /的try_files规则;其余均为权限、路径、防火墙等衍生问题。

直接上结论:Vue 项目部署到 Linux 的核心就三步——npm run build 打包、上传 dist 到 Nginx 可服务目录、改好 nginx.conf 中的 root 和 location / 重写规则。其他都是围绕这三点的权限、路径、防火墙、SSL 等衍生问题。
怎么确认 Nginx 已安装并知道它的配置路径
别猜,直接查:
-
whereis nginx—— 看是否已安装,输出类似nginx: /usr/sbin/nginx /etc/nginx /usr/share/nginx,重点看/etc/nginx(配置)和/usr/sbin/nginx(二进制) -
nginx -t—— 检查当前配置语法是否合法,错误会明确指出哪行哪列 -
ps aux | grep nginx—— 确认进程是否在跑;如果没启动,用/usr/sbin/nginx或/usr/local/nginx/sbin/nginx启动(路径取决于你装在哪)
常见坑:CentOS 7 用 yum install nginx 装的,配置在 /etc/nginx/nginx.conf;源码编译装的,默认在 /usr/local/nginx/conf/nginx.conf。两者别混用,否则改错文件白忙活。
Vue 打包后 dist 怎么放、放哪、权限怎么设
dist 不是随便扔进去就能访问的。Nginx worker 进程以 nginx 或 www-data 用户身份读取文件,所以:
- 推荐路径:
/var/www/my-vue-app/dist(系统级标准位置,比/root或/home下更安全稳定) - 上传后必须设权限:
sudo chown -R nginx:nginx /var/www/my-vue-app(CentOS)或sudo chown -R www-data:www-data /var/www/my-vue-app(Ubuntu/Debian) - 别漏掉执行权限:
sudo chmod -R 755 /var/www/my-vue-app,尤其dist目录不能是 700 - 验证方式:在服务器上执行
sudo -u nginx ls /var/www/my-vue-app/dist/index.html,能列出就说明 Nginx 进程可读
nginx.conf 里最关键的三处配置
只改 server 块内这几项,其他保持默认即可:
-
listen 80;—— 端口按需改,但别用被占用的(如 8080 可能被 Java 占着) -
server_name your-domain.com;或server_name 192.168.1.100;—— 必须填,哪怕只是 IP,否则匹配不到这个 server 块 -
root /var/www/my-vue-app/dist;—— 注意末尾不加/index.html,这是根路径 -
location / { try_files $uri $uri/ /index.html; }—— Vue Router history 模式必需,缺了它刷新页面就 404
别写 alias,用 root;别把 index.html 写死在 root 后面;try_files 顺序不能调,/index.html 必须放最后。
启动失败或访问 403/404 怎么快速定位
先看日志,再查权限,最后看网络:
-
sudo tail -f /var/log/nginx/error.log—— 出现open() "/var/www/..." failed (13: Permission denied)就是权限问题;出现no routes matched或no such file or directory是路径写错 -
curl -I http://localhost—— 在服务器本地测,绕过防火墙和 DNS,看返回状态码和Server头是不是 nginx -
sudo firewall-cmd --list-ports(CentOS)或sudo ufw status(Ubuntu)—— 确认目标端口已放行 -
netstat -tuln | grep :80—— 确认 nginx 真正在监听,不是假启动
最常被忽略的是:开发时用 vue-router 的 history 模式,但 Nginx 配置里漏了 try_files;或者打包时 vue.config.js 里 publicPath 设成了 /subpath/,但 Nginx 的 root 没对应调整,导致静态资源 404。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











