共计 4310 个字符,预计需要花费 11 分钟才能阅读完成。
简介
我的博客一直是用的 wordpress 做的后台,主题已经换了好几版了,学到 vue 的时候,用 vue 做了一个主题,但是不能 SEO,所以采用 vue 的服务端渲染来做了一版,也是对服务端渲染做一下学习,也就是目前的页面,源码已经放在我的 GitHub 上了,相对于之前的主题配置,这次有点不一样,稍微麻烦一点,这次是属于前后端分离,也就是前端需要单独部署,WordPress 只作为内容发布管理平台,不参与任何渲染工作,渲染工作由 Nuxtjs 完成。
部署
所需环境准备
- php 环境推荐 7.0+
- Nodejs 推荐 14+
源码相关
建议直接 clone 一份源码在本地,修改之后再推到服务器,这样可以在本地先改好,能正常运行跑一下流程
源码地址:https://github.com/D-xuanmo/Nuxtjs-Wordpress
小程序版源码:https://github.com/D-xuanmo/blog-miniprogram-wordpress
所有图标:https://www.xuanmo.xin/iconfont
QQ 群:809825850
如果想要更换主体风格可以编辑 assets/scss/variable.scss 文件中的 $color-theme 变量即可
主题已集成 highlight.js 代码高亮,目前只引入了部分语言,如需要支持其他语言,可自行在此文件替换 文件地址
友链链接管理使用说明:https://www.xuanmo.xin/details/3900
安装 Nodejs 环境,如果 Nodejs 环境已有可以忽略这一步
需要在服务器安装 node 环境,需要大于 14. 文档 node 版本为 16.0.0 推荐的版本,使用 wget 命令下载 Node.js 安装包,目录可以放在 root 目录,具体随意。该安装包是编译好的文件,解压之后,在 bin 文件夹中就已存在 node 和 npm,无需重复编译。
wget https://nodejs.org/dist/v16.0.0/node-v16.0.0-linux-x64.tar.xz
解压文件
tar xvf node-v16.0.0-linux-x64.tar.xz
创建软链接,使 node 和 npm 命令全局有效。通过创建软链接的方法,使得在任意目录下都可以直接使用 node 和 npm 命令。
ln -s /root/node-v16.0.0-linux-x64/bin/node /usr/local/bin/node
ln -s /root/node-v16.0.0-linux-x64/bin/npm /usr/local/bin/npm
到此已经安装完成,使用 node -v 查看 node 版本,使用 npm -v 查看版本号,如果出现正确版本号则安装成功,更多安装文档查看:https://help.aliyun.com/document_detail/50775.html?spm=5176.doc25426.6.655.kn1mB7
使用 npm 安装其他的全局命令
npm i -g yarn pm2 这条命令是全局安装 yarn 和 pm2(如果安装比较慢,可以使用淘宝镜像安装,npm i -g yarn pm2 –registry=https://registry.npmmirror.com,后续的安装都可以加上这个),如果执行了这一步操作,提示 command not found: yarn 或者 command not found: pm2 ,可以使用下边两条命令:
ln -s /root/node-v16.0.0-linux-x64/bin/yarn /usr/local/bin/yarn
ln -s /root/node-v16.0.0-linux-x64/bin/pm2 /usr/local/bin/pm2
运行项目
将源码目录下的 service 放入 WordPress 主题目录 wp-content/theme/ 下,并启用此主题,进入 Nuxtjs 主题设置 ,启用本主题之后,会在外观菜单下加入一个子菜单,将站点前端域名设置为 WordPress 访问地址,确保 http://{domain}/wp-json 能有正确的数据,所有 WordPress 接口都是在这个虚拟目录下; 如果访问报错可以尝试在 后台设置 => 固定链接 设置为数字型;
修改项目的一些配置,改为自己的信息,如下截图,这一步不是必选的,可以安装完成之后在修改:
将源码整个文件夹上传到服务器的网站根目录即可,使用命令行工具进入到此目录,执行 yarn 命令,这一步是安装项目所需要的依赖文件,如果比较慢可以使用这个命令 yarn –registry=https://registry.npmmirror.com;
依赖安装完成之后,执行 yarn dev,如果能出现以下截图代表能够正常运行项目,然后用自己的域名或者 IP 访问 3000 端口,这里需要服务器配置放行 3000 端口,如果能够正常访问按 ctrl+c 退出即可;
使用 yarn pm2 这条命令去运行项目并开启文件更改自动重载项目,pm2 是 Nodejs 的一个守护进程,使用 pm2 logs 可查看日志,至此通过 http://domain:3000 就能正常访问了,更多说明查看 https://segmentfault.com/a/1190000012774650
使用 pm2 save 保存当前的应用列表,使用 pm2 startup 开机自动启动
使用 Nginx 或者 Apache 做反向代理
到现在这一步为止都需要加上一个端口才能访问到项目,这并不是我们需要的,我们需要用 80 或者 443 去访问,所以需要用 nginx 做代理,这一步需要自己了解一下 nginx 配置,以下是我的配置文件:
Tips: 先到数据库找到 WordPress 的表 wp_options ,修改 siteurl 和 home 字段,值改为 http://{你的域名}:3002 端口,因为后续 WordPress 只会作为一个 CMS 管理系统,如果不理解欢迎留言或者联系我的 QQ
使用 nginx 启动一个端口,用于代替之前的 WordPress 访问端口;
# wordpress
server {
listen 3002;
server_name xuanmo.xin;
root /htdocs/blog;
location / {
index index.php index.html index.htm;
try_files $uri $uri/ /index.php?q=$uri&$args;
}
location ~ \.php$ {
try_files $uri =404;
include /etc/nginx/fastcgi.conf; # 一般此文件在 nginx 目录下
fastcgi_pass 127.0.0.1:9000;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
使用 nginx 监听 80 或者 443 端口去代理 Nuxt 服务,如果成功配置就到这里结束了,80 端口配置删除 ssl 证书相关的东西即可
server {
listen 80;
listen 443;
server_name www.xuanmo.xin xuanmo.xin;
# 引入证书文件开始
ssl on;
ssl_certificate /etc/xxx.pem;
ssl_certificate_key /etc/xxx.key;
ssl_session_timeout 5m;
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_prefer_server_ciphers on;
# 引入证书文件结束
location / {
# 这里是每次访问域名将请求转发到 3000 端口
proxy_pass http://127.0.0.1:3000;
}
# 下边两个是代理 wordpress 的一些服务
location /wp-json {proxy_pass http://127.0.0.1:3002/wp-json;}
location /wp-content {proxy_pass http://127.0.0.1:3002/wp-content;}
}
常用命令
node -v 查看 nodejs 版本
npm -v 查看 npm 版本
npm i -g yarn 使用 npm 全局安装 yarn
yarn 安装项目依赖
yarn dev 启动 nuxt 开发模式,关闭终端或者使用 ctrl+c 就会终止,用于查看项目是否能正常启动
pm2 logs 查看实时 pm2 日志,比如 nuxt 目录的文件有更改时,可以查看打包进度
yarn pm2 使用 pm2 启动 nuxt 服务,并监听目录更改重新打包项目,注:每次服务器重启之后需要再次进入到 nuxt 项目目录执行此命令,如果设置了开机启动则不用重新执行
pm2 save 保存当前应用列表
pm2 startup 设置开机自启
主题设置说明
导航栏 logo 比例 120px*40px
首页 banner 大图尺寸比例 710px*320px,小图尺寸比例 180px*100px
文章列表缩略图的比例 260px*145px
站点总导航的菜单名称为 Home,如果不是这个将获取不到菜单,网站底部菜单名字为 SubMenu
菜单前边的图标名字在菜单设置中的 css 类选项,如果没有显示此选项将右上角的显示选项展开,打开 css 类即可
首页友情链接在后台链接管理添加一个分类,命名为首页即可,后续添加的链接只要关联此分类即可在首页看见
说说功能在后台添加即可,如果本条说说需要添加链接,在摘要处填入链接即可,说说访问地址 http://domain/phrase
nuxt 目录说明
static 所有需要在根目录访问的文件可以存放在这里,相当于网站根目录,举个栗子,/static/favicon.ico 会被映射到网站根目录 https://www.ttzdm.cn/favicon.ico
你的工作,由 AI 赋能!🔥
还在为文案、脚本卡壳、做视频、写代码、设计图片灵感枯竭而烦恼吗?🤯
板板 AI,你的工作好帮手!
一键生成 各种文案、脚本、图片、视频、代码、报告,轻松应对各种工作 / 营销需求!
现在注册体验,即可获得:
- 🎁 30 积分基础模型余额
- 🎁 3 积分高级模型余额
- 🎁 3 积分绘画余额
还不快来试试?
点击链接,开启你的 AI 创作之旅!>>>https://www.banbanai.cn
板板 AI,让你的工作效果发挥无限可能! 🚀