Hexo 网站搭建过程备忘记录（一）站点配置

圣儿2025-04-112025-05-27

代理编辑：Black，2025-04-11 发布于圣儿博客

本站选用Hexo+Butterfly 主题+AnZhiYu 魔改的路线搭建。

Frame	Theme	Magic
Hexo v7.3.0	Butterfly v5.3	AnZhiYu v1.6.14

动手时在此记录建站过程，防止 来的时候好好的，回不去了。同时也希望能够帮助到需要的朋友。
内容分成几个不同的块，相对应的分成几篇文章记录：

站内地址

点击查看合辑

网站搭建过程备忘记录

Tips:
《Hexo 网站搭建过程备忘记录（一）站点配置》主要记录站点配置文件 _config.yml的一些变更。
基础步骤不再赘述，可根据文档指导完成：Butterfly主题文档 | Anzhiyu主题文档

站点配置

更改调试端口

默认port是4000，两种方式解决占用冲突（二选一）：

1	$ hexo s -p 5000

// 路径：[boot]/node_modules/hexo-server/index.js/
hexo.config.server = Object.assign({
  port: 5000,
}, hexo.config.server);

文章Url自定义

不推荐使用abbrlink之类的插件，只是把长乱码改为短乱码，abbrlink2有文章编号的功能，但是个人认为意义不大。我的做法是：

1 2	url: http://example.com permalink: posts/:title.html

然后根据汉字题目，找风水师傅Deepseek，起一个文雅而响亮、齐得龙东强的英文Title。Markdown文件用英文命名，Front-matter里还是汉字题目。
如本篇文章：https://blog.shenger.cc/posts/hexo-website-development-process-record-start.html

英文标题带一些主要keywords、单词之间用-连接、文章尾部保留.html，这些小心思，在乎SEO优化的同学可以留意。

Encrypt 加密模块配置

部分文章使用 hexo-blog-encrypt 插件加密，需要在 _config.yml 增加相关内容。如果用到按标签加密，可以在此处直接设好，不用每个文章去Front-matter添加，直接统一设置。只把独立需求的，单独添加，比如更改theme或密码。Front-matter独立添加的加密配置，优先级高于此处。

# Security
# Theme: default\blink\shrink\flip\up\surge\wave\xray
# https://mhexo.github.io/

encrypt: # hexo-blog-encrypt
  abstract: 有东西被加密了, 请输入密码查看.
  message: 请输入密码
  tags: 
  - {name: tag1, password: 1234}
  - {name: tag2, password: 5678}

  theme: flip
  wrong_pass_message: 抱歉, 这个密码看着不太对, 请再试试。
  wrong_hash_message: 抱歉, 这个文章不能被校验, 不过您还是能看看解密后的内容。

这个插件有个小issue，手机端有时无法使用确认键，输入密码后无法打开。
只好加个button了，GitHub有人写好了链接
使用wuqi9277的方案，替换他的hbe.js，密码输对后自动打开，不增加按钮什么的更改了。

SEO

Hexo 没有集成Sitemap和Robots，可以用插件来实现。其实这一步也没有太大必要，哎曾经可是标配啊，时代洪流。。。

Sitemap

使用两个插件hexo-generator-sitemap和hexo-generator-baidu-sitemap，前者生成谷歌通用版本的Sitemap，后者生成百度的。
记得站点配置文件 _config.yml里，url改成自己的域名，不然hexo -g 时路径出问题。
增加如下内容：

# Sitemap Setting
sitemap:
  path: sitemap.xml
  tags: true

baidusitemap:
  path: baidusitemap.xml
  tags: true

hexo g后，在public里，找到生成的sitemap，就可以去各个站长工具里提交了。
同时使用网址也可以查看：https://shenger.cc/sitemap.xml和https://shenger.cc/baidusitemap.xml

Robots

在主题的source文件夹下，新建一个robots.txt，写上送给蜘蛛的话（它听不听就不知道了）：


User-agent: *
Allow: /
Allow: /archives/ 

Disallow: /js/
Disallow: /css/
Disallow: /lib/
Disallow: /fancybox/

Sitemap: https://shenger.cc/sitemap.xml
Sitemap: https://shenger.cc/baidusitemap.xml