我是基于ChatGPT-turbo-3.5实现的AI助手,在此网站上负责整理和概括文章

本文介绍了如何使用Hexo+ShokaX主题搭建个人博客,并将其部署到Vercel或Github Pages平台上。通过详细的步骤和指导,读者可以轻松地创建自己的博客网站,并实现部署和发布。文章涵盖了Hexo和ShokaX主题的安装配置,以及如何在Vercel或Github Pages上进行部署。读者可以根据自己的需求和喜好选择合适的部署方式,并利用Hexo和ShokaX主题打造个性化的博客页面。整体而言,本文为读者提供了一种简单而高效的方式来搭建个人博客,并分享自己的知识和经验。

当你看到这里时,你应该已经成功在本地搭建了你的 hexo 博客,并且装上了 shokax

如果没有的话请戳这里1️⃣主题安装

下面我将默认你看完了第一部分内容,Let' go.

# 介绍

下面推荐两种部署方式

Github Pages

  • 优点:稳定性强,部署简单,使用方便,还支持自定义域名,最重要的是 完!全!免!费!
  • 缺点:国内访问速度一般,而且拒绝百度爬虫访问,不支持本主题搭配的评论系统,想使用需要自行替换或使用第三方接入。
  • 总结:适合不太想折腾的,对费用特别敏感的人。

Vercel

  • 优点:国内访问速度比 Github Pages 要快,支持自定义域名和自动部署。
  • 缺点:构建次数和构建时长有限制,每月带宽限制 100G,国内域名被墙,需要搭配域名食用。
  • 总结:速度快,每月资源的限制对个人博客而言完全够用,适合能够接受付费购买域名,对访问速度有要求的人。

# Github Pages 部署

首先,你要有一个 github 账号,这个我默认你已经有了。

来到 github 首页,点击左上角的 new 创建一个新仓库

image-20250224135433941

注意仓库名必须是 你的github用户名.github.io

仓库类型选择公开 (Public)

创建成功之后回到我们的 hexo 根目录,在命令行中安装 git 插件

pnpm add hexo-deployer-git

安装完成之后回 github,复制仓库链接

image-20250224140505681

打开 hexo 根目录的 _config.yml ,找到

deploy: 
  type: ''

修改成

deploy: 
  type: git
  repository: https://github.com/Winter334/Winter334.github.io.git #你刚刚复制的链接
  branch: main

然后命令行执行

hexo clean && hexo g && hexo d

静静等待执行完毕,就可以通过 你的github用户名.github.io 访问你的博客啦

# Vercel 部署

# 项目托管

vercel 部署依赖 github 仓库,首先先创建一个仓库,名字随意,仓库类型随意

然后按照 Github Pages 的教程把博客部署到你的刚刚创建的仓库里

image-20250224145742324

之后登陆 Vercel, 建议使用 github 登陆

登陆之后右上角 Add New... ➡️ Project ,添加新项目

image-20250224150418458

在这里搜索你之前创建的仓库,点击 Import ➡️ Deploy

然后只需要慢慢等待部署成功就可以了

之后我们点进刚刚部署成功的项目,右上角找到 Domains ,点击它,进入域名管理页

image-20250224151249774

这个就是 vercel 为你自动分配的域名,不过现在 vercel 的域名在国内被墙了,不用魔法的话是访问不了的,不过我们可以绑定自己的域名来实现国内访问

# 自定义域名

其实 Github Pages 也支持自定义域名,但是需要自备 SSL 证书,不然会被浏览器提醒危险,而 vercel 会为我们自动配置证书

找一个域名商,我这里以阿里云为例

image-20250224152053215

输入你想要的域名,先查询域名是否被注册

如果被注册了,那就只能换一个了,除非你愿意支付高额的转让费用只恨财力不足 (´Д`) y━・~~

挑好自己满意的域名之后,购买即可,需要实名,一般引导都很详细,跟着照做即可

一切都准备就绪之后,我们打开 vercel 域名管理页点击 Add ,添加你刚刚购买的域名

image-20250224153957167

然后 vercel 会给出这样两条记录

之后我们返回你的云服务商,打开控制台,选择 云解析DNS

image-20250224153411273

点击你购买的域名,选择添加记录

image-20250224154411693

对于规则如下,一一对照把 vercel 上显示的内容添加过来就行了,两条都要添加

  • Type:记录类型
  • Name:主机记录
  • Value:记录值

做完这一切之后,稍微等待一会

image-20250224154846686

vercel 域名控制页显示这样就绑定成功了,现在你就可以使用你的域名访问你的博客啦

# 其他问题

# 检测到仿冒网站弹窗

如果遇到下面这种情况,是因为 shokax 默认开启防镜像站功能

image-20250224141600362

解决办法也很简单,打开 _config.yml , 找到 url 一栏

  • Github Pages 部署:将网址修改成 https://你的github用户名.github.io/
  • Vercel: 将网址修改成 https://你的域名

示例:

#Github Pages
url: https://winter334.github.io/
#Vercel
url: https://你的域名

然后重新部署就可以了

# 图片不显示

关于图片,shokax 自带的 images 链接已经失效,可以使用静态图片代替,具体操作可以参考自定义网站图片,以及图片自定义

不过使用静态图像会拖慢网站的加载速度,也会增加网站的流量负担,建议使用图床代替

如何自建免费图床,可以期待我之后的更新