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

Nginx 部署前端 Vue 项目步骤

Nginx 的基本概念及其作为 HTTP 服务器的优势,详细讲解了在 Windows 和 Linux 环境下安装 Nginx 的步骤。重点阐述了如何打包 Vue 项目,并提供了 Nginx 配置文件的具体示例,包括解决 Vue Router History 模式刷新 404 问题的关键配置(try_files 和 rewrite),最后说明了如何重载配置并验证部署结果。

接口猎人发布于 2026/4/5更新于 2026/9/364 浏览
Nginx 部署前端 Vue 项目步骤

一、什么是 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 服务和 Windows 环境上使用 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;
    }
    # 对应上面的 @router,主要原因是路由的路径资源并不是一个真实的路径,所以无法找到具体的文件
    # 因此需要 rewrite 到 index.html 中,然后交给路由在处理请求资源
    location @router {
        rewrite ^.*$/index.html last;
    }
    # .......其他部分省略
}

完成 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

更多推荐文章

查看全部
  • Git LFS 跨平台安装与配置实战指南
  • Visual C++运行库管理指南:诊断、修复与维护
  • NVIDIA 发布开放模型和数据,加速语言、生物与机器人 AI 创新
  • 华为交换机首次配置步骤(Console + Web 管理)
  • HDFS 核心机制:文件分块与分布式存储原理
  • Android 求职面试指南:核心知识点与准备策略
  • .NET 集成 GoView 低代码可视化大屏实战指南
  • Stable Diffusion:AI 图像生成技术解析
  • C++ STL 标准库常用算法详解
  • lwIP 实战解析:基于 CGI 与 SSI 的嵌入式 WebServer 开发
  • Cursor、Claude Code 与 Copilot:三款 AI 编程工具深度对比
  • 详解 Python 多线程与多进程
  • OpenClaw QQ 机器人接入指南
  • OpenClaw 多 Agent 协作模式:构建 AI 助手团队
  • .NET 集成 GoView 低代码可视化大屏实战指南
  • Vivado IP核DDS核配置详解
  • Unity+AI 使用自然语言制作小游戏:飞翔的牛马
  • .net Core Web 保姆级教学 逐文件讲解 从0搭建一个 ASP.NET Core Razor Pages
  • 微分的本质:从变化率到线性映射的飞跃 —— 可视化 Python 教程
  • 豆包 Seedream 4.0 多图融合评测:主体一致性与 4K 生成能力解析

相关免费在线工具

  • 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