在nginx上部署vue项目(history模式)；

最新推荐文章于 2025-05-06 17:32:07 发布
最新推荐文章于 2025-05-06 17:32:07 发布
阅读量2.9k 收藏 2
点赞数 1
文章标签： 前端 vue.js javascript
原文链接：https://www.shuzhiduo.com/A/LPdo8Z6Oz3/
版权

vue-router 默认是hash模式，使用url的hash来模拟一个完整的url，当url改变的时候，页面不会重新加载。但是如果我们不想hash这种以#号结尾的路径时候的话，我们可以使用路由的history的模式。比如如下网址：
使用hash模式的话，那么访问变成 http://localhost:8080/bank/page/count/#/ 这样的访问，如果路由使用 history的话，那么访问的路径变成 如下：
http://localhost:8080/bank/page/count 这样的了；

在路由的配置就是如下：我们还是以 vue-cli项目为例：
在src/router/index.js 代码如下：

 

  1. import Vue from 'vue';
  2. import Router from 'vue-router';
  3. // import HelloWorld from '@/views/HelloWorld';
  5. Vue.use(Router);
  7. const router = new Router({
  8. mode: 'history', // 访问路径不带井号 需要使用 history模式
  9. base: '/bank/page', // 基础路径
  10. routes: [
  11. {
  12. path: '/count',
  13. name: 'count',
  14. component: resolve => require(['@/views/count'], resolve) // 使用懒加载
  15. }
  16. ]
  17. });
 

 

不过history的这种模式需要后台配置支持。比如：
 当我们进行项目的主页的时候，一切正常，可以访问，但是当我们刷新页面或者直接访问路径的时候就会返回404，那是因为在history模式下，只是动态的通过js操作window.history来改变浏览器地址栏里的路径，并没有发起http请求，但是当我直接在浏览器里输入这个地址的时候，就一定要对服务器发起http请求，但是这个目标在服务器上又不存在，所以会返回404，怎么解决呢？我们现在可以把所有请求都转发到 http://localhost:8080/bank/page/index.html上就可以了。
 

一： apache服务器上的配置如下：
 

1. 如果我们现在是使用apache做web服务器的话，我们需要开启 .htaccess支持即可：
 在文件里加上如下，就一切正常了
 

 

  1. <IfModule mod_rewrite.c>
  2. RewriteEngine On
  3. RewriteBase /
  4. RewriteRule ^index\.html$ - [L]
  5. RewriteCond %{REQUEST_FILENAME} !-f
  6. RewriteCond %{REQUEST_FILENAME} !-d
  7. RewriteRule . /bank/page/index.html [L]
  8. </IfModule>
 

上面的apache的作用是：把所有服务器上不存在的请求全部转发到 index.html上去，这样就可以直接通过各种url来访问了。
 

注意：
 1. RewriteRule . /bank/page/index.html [L] 这段代码；前面需要加 /bank/page/这样的，因为我在路由配置base里面
 加了 /bank/page/ 这个路径，否则匹配不到了。
 

 

2. vue-cli 项目中需要修改 config/index.js 中的build下的 assetsPublicPath: '/bank/page/', 如果使用相对路径，
 chunk文件会报错找不到。
 

3. 在apache的 www/bank/page 目录下新建 .htaccess文件，需要修改RewriteRule 为/bank/page/index.html, 否则刷新页面服务端会直接报404错误。
 

4. 修改httpd.conf文件，开启rewrite_module功能。
 

5. LoadModule rewrite_module libexec/apache2/mod_rewrite.so，去掉前面的#
 

6. 然后找到AllowOverride None的那行，把它改成AllowOverride All，来使.htaccess文件生效。
 

二：nginx服务器上的配置如下：
 

vue-cli 执行打包命令：
npm run build
 

如上进行打包，生成dist文件夹，把该文件夹下的文件直接复制到nginx服务器目录下，就可打开项目，但是只有首页可以看到的，刷新一下页面也是404了，原因和上面一样，因此需要在nginx服务器配置对所有的路径或者文件夹进行跳转，重定向到首页 index.html即可：这样就能找到路由了。
nginx服务器配置如下：
 

1. 首先登录服务器。
 2. 进入目录 /etc/usr/local/nginx/conf/下;
 执行命令：
    2-1 cd /etc/ 回车
    2-2 cd /usr/ 回车
    2-3 cd loacl/ 回车
    2-4 cd nginx 回车
    2-5 cd conf 回车
    2-6 vi nginx_v4.conf 进入 nginx文件内 新建一个项目的相关配置如下：
 

 

比如我们现在的域名地址这样访问的：http://aa.xx.com/bank/page/count , 需要如下配置：
 

  1. server {
  2. listen 443; # 监听本机所有ip上的 443 端口
  3. listen 80; # 监听本机所有ip上的 80 端口
  4. server_name aa.xx.com; # 域名地址
  5. access_log /data/www/logs/nginx/aa/access.log main; # 新建日志文件
  6. include nginx_xx.conf;
  7. /* 下面是多个location 用于配置路由地址 */
  8. location / {
  9. proxy_pass http://aa/;
  10. include nginx_proxy.conf;
  11. }
  12. location /bank/page/ {
  13. try_files $uri $uri/ /bank;
  14. },
  15. /* http://aa.xx.com/bank2/page/count 有多个不同的地址 就加一个如下这个配置 */
  16. location /bank2/page/ {
  17. try_files $uri $uri/ /bank2;
  18. }
  19. error_page 500 502 503 504 /502.html;
  20. location = /50x.html {
  21. root html;
  22. }
  23. }
 

try_files 指令：
 

语法：try_files file ... uri 或 try_files file ... = code
 默认值：无
 作用域：server location
 

其作用是按顺序检查文件是否存在，返回第一个找到的文件或文件夹（结尾加斜线表示为文件夹），如果所有的文件或文件夹都找不到，会进行一个内部重定向到最后一个参数。
 

需要注意的是，只有最后一个参数可以引起一个内部重定向，之前的参数只设置内部URI的指向。最后一个参数是回退URI且必须存在，否则会出现内部500错误。命名的location也可以使用在最后一个参数中。与rewrite指令不同，如果回退URI不是命名的location那么$args不会自动保留，如果你想保留$args，则必须明确声明。
 

location指令
 语法：location [=|~|~*|^~|@] /uri/ { … }
 默认值：无
 作用域：server
 

 

location指令是用来为匹配的URI进行配置，URI即语法中的"/uri/"，可以是字符串或正则表达式。但如果要使用正则表达式，则必须指定前缀。 [@] 即是命名location，一般只用于内部重定向请求。
 

3. 设置成功后需要重启：nginx重启命令；在 /etc/usr/local/nginx/conf/ 目录下, cd ../ 然后进入sbin目录下 cd sbin 接着运行命令 ./nginx -s reload 重启后即可生效。
 

4. 在/data/www/logs/nginx/aa/目录下 新建 access.log 文件。
 然后nginx保存和退出命令 :wq
 直接退出的命令是 :q
 

5. mac系统下 自带 apache2服务器，需要对apache2作反向代理；配置如下：
 进入本地mac apache2配置；
 命令：cd /etc/apache2
 命令：sudo vi httpd.conf
 

  1. <VirtualHost *:80>
  2. ServerName aa.xx.com
  3. ProxyRequests off
  4. Header set Access-Control-Allow-Origin *
  5. <Proxy *>
  6. Order deny,allow
  7. Allow from all
  8. </Proxy>
  9. <Location /aa>
  10. ProxyPass http://localhost:8896/
  11. ProxyPassReverse http://localhost:8896/
  12. </Location>
  13. // .... 更多配置省略
  14. </VirtualHost>
 

然后进入 sbin目录下 启动服务 sudo apachectl start
 重启命令如下 sudo apachectl restart
 

6. java服务端的配置如下（如果是vm放到开发那边的话，开发那边需要如下处理下，如果页面vm不放在开发那边的话，下面的配置可以忽略）
 在项目目录下 webapp/web-inf/view/ 新建文件夹 aa 和 include文件
 aa文件下 新建index.vm
 如下代码：
 #parse("include/common.vm")
 #@frame("xx管理",true)
 #css(["${version}/business/aa/aa.css"]) // 打包后的css路径，具体看自己的路径
 <div id="app"></div>
 #js(["${version}/business/aa/aa.js"]) // 打包后的js路径，具体看自己的路径
 #end
 

6-2 java开发需要配置一下：
 1 设置路由： /aa 设置路由到 /aa/index.vm
 2 这个include/common.vm有一个地址配置，是在disconf上配置的，你加一个
 地址配置到 //aa.xx.com/aa/dist 上即可

                

        

    

  



    

      

        

            

              
                
                  zhoumeina99
                
              
            

            

                关注
              
            

        

        

          
      

      










                



	

		

			

				
					
Nginx 部署前端 Vue 项目实战指南

				
			

			

				

					miracle的专栏
				

				

					09-02
					
					2638
					
				

			

		

		

			
				
在执行此命令之前，需要确保路由配置中的模式正确。修改完成后，保存配置文件，并在命令行中执行相应命令重启 Nginx 服务。您可以从 Nginx 官方网站下载安装包，然后按照安装向导进行安装。，回车，即可启动 Nginx 服务。可以在任务管理器的进程中看到启动的 Nginx 服务。从 Nginx 官方网站下载安装包，按照安装向导进行安装。另外，还需要对项目中的一些配置文件进行修改，比如在。要修改 Nginx 的配置文件，例如修改端口，可在。指令，将默认的 80 端口修改为您想要的端口，如。

			
		

	



                

            
              



	

		

			

				
					
vue项目部署到nginx/tomcat服务器的实现

				
			

			

				

					10-16
				

			

		

		

			
				
部署Vue项目到Nginx/Tomcat涉及将构建生成的静态资源文件托管在服务器上，并确保应用能够正确地处理前端路由。  在Vue项目中，默认情况下，路由是通过hash模式来实现的，即URL中会有'#'符号。但为了美观，我们通常...

			
		

	



              


  
              

                


	

		

			

				
					
在nginx上部署vue项目(history模式)的方法

				
			

			

				

					08-28
				

			

		

		

			
				
vue-router 默认是hash模式，使用url的hash来模拟一个完整的url，当url改变的时候，页面不会重新加载。这篇文章主要介绍了在nginx上部署vue项目(history模式),需要的朋友可以参考下

			
		

	





	

		

			

				
					
Vue3路由模式为history，使用nginx部署上线是空白的问题

					
最新发布

				
			

			

				

					一位热爱编程的青年
				

				

					05-06
					
					399
					
				

			

		

		

			
				
将vue使用打包后将dist文件的内容，放入nginx的html中，并在nginx.conf中，设置端口启动nginx，打开发现网页内容为空白。

			
		

	



		

			
		



	

		

			

				
					
Nginx 部署 vue项目 （history模式）

				
			

			

				

					yorcentroll的博客
				

				

					04-09
					
					3434
					
				

			

		

		

			
				
大家都知道，vue router有两种模式：

1，hash模式

hash模式应该是平时大家用的最多的一种模式，它的标志是路由地址都会加上#。

2，history模式

history模式则不会加上#号，这样url看起来比较干净。但是使用history模式，会导致一个问题，就是在某个路由页面上刷新的时候或者直接访问多级路由url的时候会报404.


import Vue from 'vue'...

			
		

	





	

		

			

				
					
nginx配置vue(history模式)

				
			

			

				

					m0_37634363的博客
				

				

					03-12
					
					1678
					
				

			

		

		

			
				
问题的原因：项目本来使用 hash 的路由模式来部署，因为需要关系，现在要改成 history 的模式来部署了（路径上不要有 # 号）
第一步：
修改项目的 router/index.js 的配置
const router = new VueRouter({
  mode: 'history',  // 将 hash 改成 history
  routes: [
    ...pages
  ]
})

修改 config/index.js assetsPublicPath

assetsPublicPat

			
		

	





	

		

			

				
					
nginx 配置 vue History模式

				
			

			

				

					牛奔的博客
				

				

					05-28
					
					614
					
				

			

		

		

			
				
解决
需要加一行 try_files $uri $uri/ /index.html;，其中 /index.html 是你自己的目录中的入口文件
server {
        listen [::]:80 default_server;

        #root /var/www/html;

        # Add index.php to the list if you are u...

			
		

	





	

		

			

				
					
nginx 部署 vue 项目找不到js css文件的解决方法

				
			

			

				

					09-29
				

			

		

		

			
				
在使用nginx部署Vue项目时，有时候会遇到找不到JavaScript和CSS文件的问题。这主要是因为Webpack在构建过程中生成的静态资源引用路径不正确。本文将详细介绍解决这一问题的方法，主要包括vue-cli@3的配置方式和vue-...

			
		

	





	

		

			

				
					
vue路由history模式下的nginx配置

				
			

			

				

					胡西风的博客
				

				

					04-02
					
					4144
					
				

			

		

		

			
				
vue路由 history模式 nginx配置

			
		

	





	

		

			

				
					
Nginx部署vue项目history的路由模式（非根目录）

				
			

			

				

					qq_28016751的博客
				

				

					12-16
					
					4959
					
				

			

		

		

			
				
vue的路由分为两种hash和history，hash路由虽然不需要做太多的配置但是url地址上会有一个很丑的#号。
而history模式的路由不会有这个#号但是带来的问题却是刷新页面之后会404找不到页面，原因是spa单页面是通过js来进行跳转的。浏览器根据路由地址是找不到服务器上相关的文件的，所以这里需要进行相应的服务器配置。
这里我选用的是nginx服务器。

VUE项目(我的vue-cli版本4.x)

1. vue.config.js



2. router.js



3. nginx配置..

			
		

	





	

		

			

				
					
nginx 配置 解决 vue history模式下空白 ，以及SSL证书安装

				
			

			

				

					2401_84006953的博客
				

				

					04-04
					
					1160
					
				

			

		

		

			
				
server {#你的域名root html;#你的网站根目录#网站默认访问文件NULL:!aNULL:!MD5:!ADH:!RC4;uribaiyiuri//baiyilocation ~ .php(.*)$  { #HP必须的配置，否则浏览器访问会直接下载php源码文件.+)$;

			
		

	





	

		

			

				
					
配置nginx以支持vue中history路由模式

				
			

			

				

					Eiwen的技术生涯
				

				

					07-03
					
					287
					
				

			

		

		

			
				
【代码】配置nginx以支持vue中history路由模式。

			
		

	





	

		

			

				
					
在nginx上部署vue项目(history模式)--demo实列；

				
			

			

				

					weixin_30699465的博客
				

				

					06-19
					
					733
					
				

			

		

		

			
				
在很早之前，我写了一篇 关于 在nginx上部署vue项目(history模式)但是讲的都是理论，所以今天做个demo来实战下。有必要让大家更好的理解，我发现搜索这类似的问题还是挺多的，因此在写一篇有关这方面的实战文章。在讲解之前，我们还是和以前一样，一步步来，先看下我们项目的整个架构。

|------- 项目的根目录
|  |--- app
|  | |--- index
|  |...

			
		

	





	

		

			

				
					
在nginx上部署vue2/vue3项目(history模式)

				
			

			

				

					qq_41231694的博客
				

				

					03-27
					
					6898
					
				

			

		

		

			
				
1、vue项目路由history模式配置(vue2和vue3整个配置就这一步不一样)
vue2配置
const router = new Router({
  mode: 'history', // 访问路径不带井号  需要使用 history模式
  base: '/bank/page',  // 基础路径
  routes: [
    {
      path: '/count',
      name: 'count',
      component: resolve => require(

			
		

	





	

		

			

				
					
VUE history模式Nginx配置

					
热门推荐

				
			

			

				

					小东东
				

				

					06-02
					
					2万+
					
				

			

		

		

			
				
Vue项目默认路由模式为hash模式，hash模式下url中会带有#号，子页面URL形式为:/mapp/#/subpage，经大神科普了解到，hash模式下页面跳转，只是刷新页面内容，页面整体并没有重新加载。
微信服务号网页授权访问需配置redirect_url，微信平台会在该URl后拼接?code=XXX&state=XXXX，若redirect_url为hash模式下的URL，微信平台...

			
		

	





	

		

			

				
					
nginx部署vue history

				
			

			

				

					A1570555124的博客
				

				

					12-28
					
					643
					
				

			

		

		

			
				
事情是这样的，一开始本地开发使用hash模式，后来改为history模式，部署到线上一看???, App。vue渲染了，router-view没渲染？什么鬼？

看了下vue-router配置
const router = new VueRouter({
  base:'/haiwai/aa/temp/',
  mode:'history',
  routes,
});

在看下nginx配置
location /haiwai/aa/temp {
	root html/;
	try_files $uri $

			
		

	





	

		

			

				
					
在nginx上部署vue项目(history模式)

				
			

			

				

					08-30
				

			

		

		

			
				
在Nginx上部署Vue项目（使用history模式）需要进行以下步骤：

1. 安装Nginx：首先确保已经在服务器上安装了Nginx，可以使用包管理器（如apt、yum等）进行安装。安装完成后，启动Nginx服务。

2. 构建Vue项目：在本地开发环境中使用Vue CLI构建好的Vue项目，使用以下命令构建：
```
npm run build
```
此命令将生成一个`dist`目录，包含了打包好的静态资源。

3. 配置Nginx：找到Nginx的配置文件，默认路径为`/etc/nginx/nginx.conf`，使用文本编辑器打开进行编辑。

4. 在Nginx的配置文件中找到`location /`的块，并将其替换为以下内容：
```
location / {
    try_files $uri $uri/ /index.html;
}
```
这段配置代码的作用是将所有的URL请求重定向到`index.html`文件，因为Vue项目是一个单页应用，所有的页面都由`index.html`和JavaScript文件来管理。

5. 配置代理（可选）：如果Vue项目需要与后端API进行通信，可以将API请求代理到后端服务器。在Nginx配置文件的`location /`块后面，添加以下内容：
```
location /api/ {
    proxy_pass http://backend-server;
}
```
将`backend-server`替换为实际的后端服务器地址。

6. 保存并退出Nginx配置文件。重新加载Nginx配置，使更改生效：
```
nginx -s reload
```

现在，Vue项目已经成功部署在Nginx上，并且可以通过服务器的IP地址或域名进行访问。使用history模式的Vue路由器可以正常工作，并且URL不会显示`/#/`的哈希标记。

			
		

	



              




          




        



    





    



      

      

        
      

      





	

		评论	
	

	
	




  

    

      添加红包
      
    

    

      

        
        

          
          
        

        
请填写红包祝福语或标题

      

      

        
        

          
          个
        

        
红包个数最小为10个

      

      

        
        

          
          元
        

        
红包金额最低5元

      

      

        
        

          当前余额3.43元
          前往充值 >
        

      

      

        

          需支付：10.00元
        

        
        
      

    

  





  

    
    
  

  

    
    
  








  

    

      

        

          

            
            
成就一亿技术人!

          

          

        

        

          

          

            领取后你会自动成为博主和红包主的粉丝
            规则
          

        

      

      

        

          

            
              
            
            

              
hope_wisdom
 发出的红包
            

          

        

        

          

          

          

        

      

    

    

  



      
      

      
实付元

      
使用余额支付

      

        

          

            
            点击重新获取
          

        

        
扫码支付

      

      

        
          
            
          
          
        
      

      

        
        钱包余额
          0
          

            
            

              

                
抵扣说明：

                
 1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
 2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

              

            

          

      

      余额充值