vue3 history模式配置及nginx服务器配置

vue的路由方式有hash模式和history模式，history模式路由看起来有好些，路由路径里没有#号，而hash模式默认是有#号的。

vue3开始默认新建的项目都是history模式，不过history模式打包后想要使用正常访问的话，需要后端服务器进行配置才可以，否则可能会出现刷新后404的问题。一般情况下，服务器端使用nginx服务器进行配置。

一、vue3 history模式配置：

vue3前端history模式配置如下，这里给一个路由route/index.js里配置的例子：

import { createRouter, createWebHistory } from 'vue-router'
import HomeView from '../views/HomeView.vue'

const router = createRouter({
  // history模式（hash模式的话，这里是createWebHashHistory）
  history: createWebHistory(import.meta.env.BASE_URL),
  routes: [
    {
      path: '/',
      name: 'home',
      component: HomeView
    },
    {
      path: '/wap/',
      name: 'wap',
      // route level code-splitting
      // this generates a separate chunk (About.[hash].js) for this route
      // which is lazy-loaded when the route is visited.
      component: () => import('../views/MobileView.vue')
    }
  ]
})

export default router

vite.config.js里的路径配置，这里给一个例子：

import { fileURLToPath, URL } from 'node:url'

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

// https://vitejs.dev/config/
export default defineConfig({
  //这里也可以设置为/路径
  base: '/calculator',
  publicDir: "public",
  assets: "src/assets",
  plugins: [vue()],
  resolve: {
    alias: {
      '@': fileURLToPath(new URL('./src', import.meta.url))
    }
  },
  build: {
    assetsDir: "assets",
  },
})

以上例子中vite.config.js的配置，打包后访问的路径为https://xxx.com/calculator/。

配置好后，我们在开发完项目后，运行npm run build就可以打包history模式的项目了。

二、nginx服务器配置：

这里用的linux系统的nginx服务器。这里给出会用到的nginx命令：

1、判断服务器是否安装nginx，查看nginx状态；

ps -ef | grep nginx

如果出现如下图类似的运行进程，证明nginx已安装并正在运行。

2、服务器安装nginx；

如果我们的linux服务器没有安装nginx服务，可以通过以下命令安装nginx服务。

（1）安装依赖包

//一键安装上面四个依赖
yum -y install gcc zlib zlib-devel pcre-devel openssl openssl-devel

（2）下载并解压安装包

//创建一个文件夹
cd /usr/local
mkdir nginx
cd nginx
//下载tar包
wget http://nginx.org/download/nginx-1.13.7.tar.gz
tar -xvf nginx-1.13.7.tar.gz

（3）安装nginx

//进入nginx目录
cd /usr/local/nginx
//进入目录
cd nginx-1.13.7
//执行命令 考虑到后续安装ssl证书 添加两个模块
./configure --with-http_stub_status_module --with-http_ssl_module
//执行make命令
make
//执行make install命令
make install

（4）启动nginx

/usr/local/nginx/sbin/nginx -c /usr/local/nginx/conf/nginx.conf
//或者
nginx -c /usr/local/nginx/conf/nginx.conf 

3、查看nginx版本号；

//直接使用nginx命令时，是已经切换到nginx/sbin/nginx目录
nginx -v
//或者
/usr/local/nginx/sbin/nginx -v

4、nignx配置；

# 打开配置文件
vi /usr/local/nginx/conf/nginx.conf
//或者用ftp下载nginx.conf下来后进行编辑

这里给一个简单的监听一个域名端口的nginx.conf配置文件：

server
{
    listen 80;
    listen 443 ssl http2;
    server_name abc.xxx.com;
    index index.php index.html index.htm default.php default.htm default.html;
    root /www/wwwroot/abc.xxx.com;
    
    #SSL-START SSL相关配置，请勿删除或修改下一行带注释的404规则
    #error_page 404/404.html;
    ssl_certificate    /etc/letsencrypt/live/abc.xxx.com/fullchain.pem;
    ssl_certificate_key    /etc/letsencrypt/live/abc.xxx.com/privkey.pem;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    error_page 497  https://$host$request_uri;

    #SSL-END
    
    #ERROR-PAGE-START  错误页配置，可以注释、删除或修改
    error_page 404 /404.html;
    error_page 502 /502.html;
    #ERROR-PAGE-END
    
    #PHP-INFO-START  PHP引用配置，可以注释或修改
    include enable-php-00.conf;
    #PHP-INFO-END
    
    #REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效
    include /www/server/panel/vhost/rewrite/abc.xxx.com.conf;
    #REWRITE-END
    
    #禁止访问的文件或目录
    location ~ ^/(\.user.ini|\.htaccess|\.git|\.svn|\.project|LICENSE|README.md)
    {
        return 404;
    }
    
    #一键申请SSL证书验证目录相关设置
    location ~ \.well-known{
        allow all;
    }
    
    location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
    {
        expires      30d;
        error_log off;
        access_log off;
    }
    
    location ~ .*\.(js|css)?$
    {
        expires      12h;
        error_log off;
        access_log off; 
    }

    #vue3 history模式站点目录配置

    location /calculator {
      try_files $uri $uri/ /calculator/index.html;
    }

    access_log  /www/wwwlogs/abc.xxx.com.log;
    error_log  /www/wwwlogs/abc.xxx.com.error.log;
}

5、检测nignx配置是否正确；

./nginx -t
//或者
nginx -t

出现如上图所示test is successful表示配置文件正确。

6、重启nginx服务。
配置文件编写或者更改后，需要重启nginx服务才能生效。

nginx -s reload

这样，我们通过访问https://abc.xxx.com/calculator/或者https://abc.xxx.com/calculator/wap/这个路径就可以正常使用了，刷新也不会出现404问题。

三、宝塔nginx配置文件路径

如果我们是通过宝塔系统建站配置的，那么更加的方便，都是可视化操作配置。

宝塔面板站点Nginx配置文件nginx.conf路径位置放在：/www/server/panel/vhost/nginx/xxx.com.info.conf下。