背景:当前项目首页和登录后的平台在一个项目里,路由采用hash模式,如今要作SEO优化,这时候同构SSR(Server Side Rendering)服务端渲染代价显然太大,影响范围比较广,一样更改当前项目路由为history模式采用预渲染(Prerending)代价也不小。最终决定将首页单独出一个项目采用预渲染,而后用nginx代理来实现两个项目之间的跳转。php
同构SSR服务端渲染这里就很少赘述了,说一下预渲染:css
1、什么状况下用预渲染比较好html
官方文档建议:若是你调研服务器端渲染(SSR)只是用来改善少数营销页面(例如 /
, /about
, /contact
等)的 SEO,那么你可能须要预渲染。无需使用 web 服务器实时动态编译 HTML,而是使用预渲染方式,在构建时(build time)简单地生成针对特定路由的静态 HTML 文件。优势是设置预渲染更简单,并能够将你的前端做为一个彻底静态的站点。前端
2、选用插件vue
官方文档建议:若是你使用 webpack,你可使用 prerender-spa-plugin 轻松地添加预渲染。它已经被 Vue 应用程序普遍测试 - 事实上,做者是 Vue 核心团队的成员。webpack
结合vue-meta-info这一类动态设置meta信息的插件,能够达到更好的效果。nginx
3、插件的使用git
安装github
# Yarn $ yarn add prerender-spa-plugin # or NPM $ npm i prerender-spa-plugin
vue-cli3 webpack配置web
在vue.config.js中:
const PrerenderSPAPlugin = require('prerender-spa-plugin') const Renderer = PrerenderSPAPlugin.PuppeteerRenderer module.exports = { configureWebpack: { module: {}, plugins: process.env.NODE_ENV === 'production' ? [ new PrerenderSPAPlugin({ staticDir: path.join(__dirname, process.env.VUE_APP_OUTPUT_DIR), // 须要进行预渲染的路由路径 routes: ['/', '/about'], // html文件压缩 minify: { minifyCSS: true, // css压缩 removeComments: true // 移除注释 }, renderer: new Renderer({ // Optional - The name of the property to add to the window object with the contents of `inject`. injectProperty: '__PRERENDER_INJECTED', // Optional - Any values you'd like your app to have access to via `window.injectProperty`. inject: {}, // 在 main.js 中 new Vue({ mounted () {document.dispatchEvent(new Event('render-event'))}}),二者的事件名称要对应上。 renderAfterDocumentEvent: 'render-event' }) }) ] : [] } }
这里只在 process.env.NODE_ENV === 'production'的时候进行预渲染,输入目录为 process.env.VUE_APP_OUTPUT_DIR,是在.env .env.prod .env.test等全局环境变量中配置的,能够根据不一样环境打包,如.env.prod的配置为:
NODE_ENV = production VUE_APP_OUTPUT_DIR = 'dist-prod' VUE_APP_PROJECT_URL = '/platform'
这里的VUE_APP_PROJECT_URL稍后再作解释。
以上的new PrerenderSPAPlugin({})配置中删除了
headless: false // Display the browser window when rendering. Useful for debugging.
目的是为了避免打开chromium浏览器。
在main.js中配置:
new Vue({ router, store, render: h => h(App), mounted () { document.dispatchEvent(new Event('render-event')) // 预渲染 } }).$mount("#app")
vue-meta-info安装使用:
安装
# Yarn $ yarn add vue-meta-info # or NPM $ npm install vue-meta-info --save
使用
import Vue from 'vue' import MetaInfo from 'vue-meta-info' Vue.use(MetaInfo) <template> ... </template> <script> export default { metaInfo: { title: 'My Example App', // set a title meta: [{ // set meta name: 'keyWords', content: 'My Example App' }] link: [{ // set link rel: 'asstes', href: 'https://assets-cdn.github.com/' }] } } </script>
若是你的title或者meta是异步加载的,那么你可能须要这样使用
<template> ... </template> <script> export default { name: 'async', metaInfo () { return { title: this.pageName } }, data () { return { pageName: 'loading' } }, mounted () { setTimeout(() => { this.pageName = 'async' }, 2000) } } </script>
3、项目间跳转配置
如今说一下VUE_APP_PROJECT_URL这个变量,这个变量即是两个项目间跳转的关键。在本地开发中,能够经过设置.env中的变量:
VUE_APP_PROJECT_URL = 'http://localhost:8080'
另外一个项目
VUE_APP_PROJECT_URL = 'http://localhost:8081'
而后经过window.location.href的方式进行两个本地项目之间的跳转:
export function toUrl (query) { // 动态更改href window.location.href = process.env.VUE_APP_PROJECT_URL + query }
至于线上怎么进行跳转,能够这么配置.env.prod中的变量:
VUE_APP_PROJECT_URL = '/'
另外一个项目
VUE_APP_PROJECT_URL = '/platform'
而后在nginx中配置:
### 默认进入的项目 ### server { listen 30002; server_name xxx.xx.xxx.xxx; proxy_buffer_size 8k; proxy_buffers 8 32k; set $root /var/www/page-for-seo/dist-prod; root $root; index index.html index.htm index.php; error_log /var/nginx/logs/error.log error; access_log /var/nginx/logs/access.log; #access_log off; ### 客户端请求错误处理 ### error_page 403 404 /404.html; location = /404.html { return 404 'Sorry, File not Found!'; } ### 服务端请求错误处理 ### error_page 500 502 503 504 /50x.html; location = /50x.html { root /usr/share/nginx/html; } ### 静态资源有效期 ### location ~ .*\.(jpeg|png|jpg|gif)$ { expires 1d; } ### 匹配全部请求 ### location / { try_files $uri $uri/ /index.php?$query_string; } ### 匹配 platform/ 而后进行代理 ### location ^~ /platform/ { proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_pass http://xxx.xx.xxx.xxx:30012/; } } ### 要进行跳转的项目 ### server { listen 30012; server_name xxx.xx.xxx.xxx; proxy_buffer_size 8k; proxy_buffers 8 32k; set $root /var/www/platform/dist-prod; root $root; index index.html index.htm index.php; error_log /var/nginx/logs/error.log error; access_log /var/nginx/logs/access.log; #access_log off; ### 客户端请求错误处理 ### error_page 403 404 /404.html; location = /404.html { return 404 'Sorry, File not Found!'; } ### 服务端请求错误处理 ### error_page 500 502 503 504 /50x.html; location = /50x.html { root /usr/share/nginx/html; } ### 静态资源有效期 ### location ~ .*\.(jpeg|png|jpg|gif)$ { expires 1d; } ### 匹配全部请求 ### location / { try_files $uri $uri/ /index.php?$query_string; } }