颜值即正义：使用宝塔面板搭建 Hexo 博客并安装安知鱼主题（二）

如果你已经厌倦了 Hexo 默认的简约风格，想让博客拥有类似“大厂”文档的质感，那么 安知鱼 (Anzhiyu) 绝对是你的首选。它不仅颜值极高，还集成了说说、朋友圈、进度条等众多功能。

本文将教你如何在宝塔面板环境下，快速安装并配置这款精美主题。

相关资源

第一步：下载主题

在宝塔面板中，我们推荐直接通过 终端 (Terminal) 使用 Git 或 npm 安装，这样方便后期更新。

  1. 打开宝塔面板，点击左侧 【终端】。
  2. 进入你的博客根目录（假设是 myblog）：
    1
    cd /www/wwwroot/myblog
  3. 安装方式（二选一）：
    • 推荐方式（Git）： 克隆到 themes 文件夹。 
      1
      git clone -b main https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu
    • 普通方式（npm）： 这种方式升级方便。 
      1
      npm install hexo-theme-anzhiyu --save

宝塔面板搭建 Hexo 博客2（一）

第二步：安装必要插件

安知鱼主题基于 Pug 和 Stylus 渲染，如果你的 Hexo 环境里没有这两个渲染器，页面将无法打开。

在终端执行以下命令：

1
npm install hexo-renderer-pug hexo-renderer-stylus --save

第三步：应用主题

我们需要修改 Hexo 的全局配置文件，告诉它我们要用“安知鱼”。

  1. 进入宝塔 【文件】 管理，找到博客根目录下的 _config.yml。
  2. 找到 theme 这一行，将其改为：
    1
    theme: anzhiyu
  3. 注意： 如果你是通过 npm 安装的，Hexo 5.0 以上版本会自动识别。

宝塔面板搭建 Hexo 博客2（二）

第四步：创建主题配置文件 (推荐)

为了方便以后升级主题而不丢失配置，安知鱼支持“覆盖配置”。

  1. 在博客根目录下新建一个文件，命名为 _config.anzhiyu.yml。
  2. 去安知鱼的 GitHub 仓库 复制全部默认配置粘贴进去，或直接在根目录运行
    1
    cp -rf ./themes/anzhiyu/_config.yml ./_config.anzhiyu.yml
  3. 以后所有的个性化修改（如博主头像、菜单、颜色等）都在这个新文件里进行。

第五步：生成与部署

  1. 在宝塔终端执行：
    1
    2
    hexo clean
    hexo g
  2. 关键步骤（回顾）： 确保在宝塔的 【网站设置】 -> 【网站目录】 中：
    • 运行目录 设置为 /public。
    • 防跨站攻击 已关闭。

宝塔面板搭建 Hexo 博客2（三）

第六步：预览效果

现在，刷新你的域名，你应该能看到一个脱胎换骨的博客界面了！

宝塔面板搭建 Hexo 博客2（四）

常见问题排查

  • 页面显示源码或空白？ 请检查 hexo-renderer-pug 和 hexo-renderer-stylus 两个插件是否安装成功。
  • 修改了配置没生效？ 记得每次修改后执行 hexo clean && hexo g。
  • 403 错误？ 请检查宝塔运行目录是否指向了正确的 public 文件夹。

结语

安知鱼主题的配置项非常丰富，建议大家详细阅读其 官方文档 来解锁“朋友圈”、“说说”以及“音乐球”等高级功能。