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

Nginx 部署前端 Vue 项目步骤

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

接口猎人发布于 2026/4/5更新于 2026/5/2428 浏览
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
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • Capacitor 跨平台打包工具实战指南
  • 机器人算法、系统与架构十年演进
  • Java Lambda 与匿名内部类为何不能修改外部变量?解析 Final 与等效 Final
  • 轻小说机翻机器人:5 分钟搭建日语小说翻译工具
  • 硬件工程师成长之路——知识汇总
  • VSCode配置 AI agent skills 详细步骤
  • Arduino BLDC 模糊动态任务调度机器人
  • 前端可访问性最佳实践:语义化与无障碍设计
  • 弃用 MobaXterm,改用开源终端 Tabby
  • MySQL 数据库核心操作:创建、修改、备份与连接排查
  • 利用大模型构造数据集并微调模型实战
  • 云开发 Copilot:AI 驱动的低代码开发实践
  • CCF-GESP 2025 年 9 月二级 C++ 优美数字题解
  • RMBG-2.0 背景移除模型 Docker 部署与 Web 服务搭建
  • 云开发 Copilot:AI 赋能的低代码开发
  • Pyenv shell 命令临时切换 Python 版本
  • PyCharm 零基础入门指南:项目创建、配置与高效开发
  • Git 安装教程(Windows 版)
  • Flutter 接入 DeepSeek API 实现鸿蒙端 AI 对话与流式渲染
  • OpenClaw 配置飞书机器人指南

相关免费在线工具

  • 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