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

Nginx 部署前端 Vue 项目指南

Nginx 的基本概念及在 Windows 和 Linux 环境下安装 Nginx 的步骤。详细说明了如何打包 Vue 项目,并配置 Nginx 的 server 块以支持单页应用的路由刷新问题。主要操作包括设置 root 路径指向 dist 目录,使用 try_files 指令配合 @router 重写规则,最后通过 reload 命令生效配置。

随缘发布于 2026/4/5更新于 2026/10/19100 浏览
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 即可。然后使用以下命令重启或重载:

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

2.2 打包 Vue 项目

执行命令:

npm run build

Vue 打包完成

2.3 配置 Nginx

修改 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

更多推荐文章

查看全部
  • VR + 具身智能 + 人形机器人:通往现实世界的智能接口
  • 大语言模型高效参数微调(PEFT)技术详解
  • 前端代码质量保证实践与工具链构建
  • 《Agent Runtime 工程化》第十一章 源码研读方法:11.2 推荐研读顺序
  • AionUi:首个开源运行时生成式 UI 框架,意图驱动界面渲染
  • Ubuntu 25.04 私有化部署 Ollama + DeepSeek + OpenWebUI 实战
  • GitHub Copilot 与 Claude Code 深度对比:如何选择 AI 编程助手
  • SQL Server 错误 18456 用户 sa 登录失败排查与解决
  • OpenClaw 开源 AI 智能体项目精选与部署指南
  • ComfyUI AI 绘画高效工作流:节点思维与模板复用
  • LLM 推理思维链变体:TOT、GOT、AOT、SoT 与 PoT 详解
  • SBUS 协议深度解析:硬件接口与 STM32 代码实现
  • WorkBuddy 安装使用完全指南:腾讯 AI 桌面智能体工作台
  • C++ 输入输出与缺省参数详解
  • OpenClaw「龙虾」本地部署指南:安装、QQ 接入及运维实战
  • 大模型与小模型选型指南:开源闭源及国内外对比
  • Ubuntu 20.04 缺少 WiFi 图标的驱动排查与修复方案
  • Django REST Framework 重构智能合同审查系统实战
  • GraphMindStudio 开源工作流引擎:AI 智能体的高效执行底座
  • 基于 Leaflet 的 WebGIS 省域区县天气可视化实现

相关免费在线工具

  • 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