跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScript大前端

Vue 项目使用 Nginx 部署指南

综述由AI生成Nginx 的基本概念及其作为轻量级 HTTP 服务器的优势,详细阐述了在 Windows 和 Linux 环境下安装 Nginx 的步骤。内容涵盖了 Vue 项目的打包流程(npm run build),以及关键的 Nginx 配置方法,特别是针对单页应用(SPA)路由刷新 404 问题的解决方案,通过 try_files 和 rewrite 指令实现正确跳转。最后提供了配置文件重载及验证部署结果的方法。

栈溢出发布于 2026/4/6更新于 2026/5/2238 浏览
Vue 项目使用 Nginx 部署指南

一、什么是 Nginx?

Nginx 是一款轻量级的 HTTP 服务器,采用事件驱动的异步非阻塞处理方式框架,这让其具有极好的 IO 性能,时常用于服务端的反向代理和负载均衡。

优点:

  • 支持海量高并发:采用 IO 多路复用 epoll。官方测试 Nginx 能够支持 5 万并发链接,实际生产环境中可以支撑 2-4 万并发连接数。
  • 内存消耗少
  • 可商业化
  • 配置文件简单

除了这些优点还有很多,比如反向代理功能,灰度发布,负载均衡功能等。

二、Nginx 部署前端 Vue 项目步骤

2.1 安装 Nginx

2.1.1 Windows 环境安装

到 nginx 官方下载系统相关的 nginx 版本安装。

在这里插入图片描述

启动命令:

cd F:\nginx-1.19.4
start nginx
2.1.2 Linux 环境安装

通常情况下很少使用 windows 来作为 nginx 的服务器,一般使用 linux。对于 linux 安装 nginx 有两种方式,一种是使用官方已经编译好的包来安装,一种是使用源码构建安装。

第一种方式参考官方地址 https://nginx.org/en/linux_packages.html#stable

第二种方式参考官方地址 https://nginx.org/en/docs/install.html 中的 Building from Sources 片段,这种实际上就是下一个 tar.gz 包仍到 linux 服务去自己编译。

在 linux 服务上和 window 环境上使用 nginx 部署 vue 项目并没有太大差异,把构建好的 vue 项目 dist 上传到 linux 服务上,通用修改 nginx 服务器中的 root 来指向 dist 就 ok 了,然后使用

# centos 7
systemctl restart nginx.service
# centos 6
service nginx restart
# 或者是平滑重启
service nginx reload

2.2 打包 Vue 项目

执行命令

npm run build

在这里插入图片描述

2.3 配置 Nginx

修改 nginx 配置文件,配置文件为 conf 下的 nginx.conf,修改 nginx.conf 中的 server 配置片段。

server {
    listen 80; # 默认端口是 80,如果端口没被占用可以不用修改
    server_name localhost;
    root E:/vue_project/my_project/dist; # vue 项目的打包后的 dist

    location / {
        try_files $uri $uri/@router; # 需要指向下面的@router 否则会出现 vue 的路由在 nginx 中刷新出现 404
        index index.html index.htm;
    }

    location @router {
        rewrite ^.*$/index.html last; # 对应上面的@router,主要原因是路由的路径资源并不是一个真实的路径,所以无法找到具体的文件,因此需要 rewrite 到 index.html 中,然后交给路由在处理请求资源
    }
    # .......其他部分省略
}

完成 nginx 配置后重新加载配置文件

nginx -s reload

浏览器中访问:http://localhost 测试是否部署成功

目录

  1. 一、什么是 Nginx?
  2. 二、Nginx 部署前端 Vue 项目步骤
  3. 2.1 安装 Nginx
  4. 2.1.1 Windows 环境安装
  5. 2.1.2 Linux 环境安装
  6. centos 7
  7. centos 6
  8. 或者是平滑重启
  9. 2.2 打包 Vue 项目
  10. 2.3 配置 Nginx
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • MC.JS WEBMC1.8 快速创建方块世界入门教程
  • Vivado FPGA 开发工具安装指南
  • Flutter 底部导航与 TabBar 多页切换实战
  • Dify 与 MySQL 集成实战:基于 MCP 协议的数据交互方案
  • 本地大模型部署的残酷真相:成本、门槛与体验落差
  • 自然语言处理在金融领域的应用与实战
  • 多卡部署 Qwen-VL-32B:vLLM 与 llama.cpp 性能对比分析
  • NDVI 时序数据:从原理到 WebGIS 应用指南
  • 自然语言生成 SQL 查询的技术实践
  • MCP、Agent 与 Skills:AI 时代三大核心概念解析
  • VSCode GitHub Copilot 使用 OpenAI 兼容自定义模型方法
  • 基于 GLM-4.6V-Flash-WEB 解析微信聊天截图关键信息
  • MC.JS WEBMC1.8 入门:10 分钟构建首个方块世界
  • ComfyUI Photoshop 插件配置与 AI 绘画工作流实战
  • LeetCode 热题 100 算法通关指南及代码模板
  • QClaw 接入微信:AI Agent 从聊天迈向执行
  • RAG 实战:利用 Langchain 和 Milvus 构建本地知识库
  • ZeroClaw 本地 AI 管理面板:Gateway + LM Studio + Reflex
  • MC.JS WEBMC1.8 入门教程:快速创建方块世界
  • AI 工具一键去除豆包及即梦图片与视频水印方法

相关免费在线工具

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online

  • JavaScript 压缩与混淆

    Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online