从 Hexo 到 Anheyu：安和鱼框架对比、部署、升级与迁移全指南

作为一个用了多年 Hexo + 安知鱼主题的老用户，一直在关注作者「安知鱼」的新动向。最近官方推出了全新的 Anheyu App（也叫 Anheyu Nova）——一个基于 Go + Next.js 的现代化内容管理平台。这篇文章记录我从调研、对比到实际上手的全过程：框架优劣、部署、版本升级、服务器迁移、Hexo 文章迁移，以及 Pro 版的购买与授权机制。

一、先厘清概念：安和鱼到底是什么

很多人（包括一开始的我）以为「安和鱼框架」是和 Hexo 平级的东西，其实不然。它目前有两个形态：

  1. 安知鱼主题（hexo-theme-anzhiyu）：基于 Butterfly 深度修改的 Hexo 主题，本质上是 Hexo 的一件「豪华皮肤」，解决的是 Hexo 不好看、功能要自己搭的问题；
  2. Anheyu App / Nova（anheyu-app）：基于 Go + Next.js 的独立 SSR 应用，需要服务器部署，自带 anheyu-pro 可视化后台。

所以严格来说：「Hexo + 安知鱼主题」vs「Hexo 默认主题」是皮肤对比；真正框架级的对比是 Anheyu App（SSR）vs Hexo（SSG）。

二、Hexo 与 Anheyu App 对比

维度 Anheyu App Hexo
渲染方式 SSR 服务端渲染，数据实时 SSG 静态生成，构建时固定
部署方式 必须有服务器（推荐 Docker） 纯静态文件，GitHub Pages / Cloudflare Pages 免费托管
后台管理 可视化后台，改配置不碰代码 无后台，改 yml 重新构建部署
动态功能 说说、朋友圈、评论实时展示 动态内容停留在构建时快照
生态成熟度 新项目，生态较小 十年老项目，主题插件几百个
维护成本 高：进程、数据库、安全更新 几乎为零

结论：追求省心、免费、长期持有，Hexo + 安知鱼主题依然是首选；想要后台管理、动态内容、内容变现（付费文章、打赏），且不介意维护服务器，可以上 Anheyu App。

三、部署：三个容器就够了

官方推荐 Docker Compose 部署，系统要求很低（512MB 内存 / 1GB 硬盘 / 1 核 CPU）。跑起来只有三个容器：

容器 镜像 网络
anheyu-backend anheyu/anheyu-backend:latest 只暴露 8091
anheyu_redis redis:latest 仅内网
anheyu_postgresql postgres:17 仅内网

Anheyu 只需要暴露 8091 一个端口——Next.js 前台（3000）由 Go 后端内部代理，Redis 和 PostgreSQL 都不要对公网开放。

部署后的初始化三件事：

  1. 浏览器访问 http://服务器IP:8091，走初始化向导创建管理员账号；
  2. 解析域名 + 面板反向代理指向 127.0.0.1:8091，申请 SSL 强制 HTTPS；
  3. 关闭公网 8091（安全组只放行 80/443），后台走域名访问。

四、版本升级（核心章节）

Anheyu 的更新本身很简单（拉镜像重启），但它是带数据库的动态应用，备份是绝对的第一步。

4.1 升级前备份

1
2
3
4
5
6
7
8
9
10
11
# 1. 停应用，保证数据库一致性（数据库保留）
docker compose stop anheyu-backend

# 2. 导出数据库（用户名/库名以 .env 配置为准，默认 anheyu）
docker exec -i anheyu_postgresql pg_dump -U anheyu -d anheyu > anheyu_db_$(date +%F).sql

# 3. 打包本地持久化目录和配置文件
tar -czvf anheyu_files_$(date +%F).tar.gz data themes static backup docker-compose.yml .env

# 4. 给当前镜像打回滚标签（:latest 拉新后旧镜像就没了）
docker tag anheyu/anheyu-backend:latest anheyu/anheyu-backend:rollback

第 4 步是关键技巧：镜像是 :latest 标签时，pull 之后旧镜像会被覆盖丢失。提前打个 rollback 标签，万一新版翻车可以一分钟内退回。

4.2 执行升级

面板操作（宝塔 / 1Panel）：Compose 项目 → 编辑 → 保存 → 重新构建/拉取并启动。

命令行操作：

1
2
3
cd /你的compose目录
docker compose pull      # 只拉取有更新的镜像（一般只有 backend）
docker compose up -d     # 自动重建有变化的容器，数据卷不动

千万不要用 docker compose down -v——-v 会连数据卷一起删掉，数据库直接没了。

4.3 升级后验证

1
2
docker compose ps                      # 三个容器都是 Up，postgresql 显示 healthy
docker compose logs -f anheyu-backend  # 无 ERROR / panic

然后浏览器实操一遍：前台首页 → 登录后台 → 发一篇文章 → 传一张图 → 评论一条 → 搜索一下。Pro 用户顺带确认授权正常（密钥不变，一般不会掉）。

4.4 出问题怎么回滚

1
2
3
4
5
docker compose down
# 编辑 docker-compose.yml，把镜像改回 anheyu/anheyu-backend:rollback
docker compose up -d
# 只有新版动过数据库结构时才需要恢复数据：
docker exec -i anheyu_postgresql psql -U anheyu -d anheyu < anheyu_db_2026-09-28.sql

4.5 特别提醒

  • PostgreSQL 大版本不能顺手升：应用升级只动 backend 镜像，数据库不动；但如果官方 compose 模板把 PG 升到 18+，那是数据库大版本迁移，必须先备份再走官方升级流程；
  • 升级前看一眼 Release 说明，确认没有需要手动改配置的变更项；
  • 挑访问量低的时间段操作，整个流程（含备份）10 分钟内；
  • 升级后强制刷新（Ctrl+Shift+R）清掉 PWA/浏览器缓存的旧前端。

五、服务器迁移（搬家）

Anheyu 的数据分散在本地挂载目录 + Docker 卷，需要备份 6 样东西：

数据 位置
应用数据 本地目录 ./data、./static、./backup
主题 本地目录 ./themes
数据库 Docker 卷 database_postgres
Redis Docker 卷 redis_data（纯缓存，不用备份）
编排文件 docker-compose.yml + .env

旧服务器备份：

1
2
3
4
5
docker compose down
docker compose up -d anheyu_postgresql   # 单独拉起数据库，等 healthy
docker compose exec -T anheyu_postgresql pg_dump -U anheyu -d anheyu > anheyu_db_backup.sql
tar -czvf anheyu_app_files.tar.gz data themes static backup docker-compose.yml .env
docker compose down

新服务器恢复：

1
2
3
4
5
tar -xzvf anheyu_app_files.tar.gz
docker volume create database_postgres
docker compose up -d anheyu_postgresql
cat anheyu_db_backup.sql | docker compose exec -T anheyu_postgresql psql -U anheyu -d anheyu
docker compose up -d

日常备份建议：把 pg_dump 写成 shell 脚本，配面板计划任务每日执行、保留最近 7 天，再定时打包本地目录，双保险。

六、从 Hexo 迁移文章

如果你像我一样有 Hexo 老站，文章迁移有两条路：

  1. Pro 版内置数据迁移：后台自带「从其他博客系统（Hexo、WordPress 等）迁移数据」功能；
  2. 社区开源工具 mdSendToBlog：通过 Anheyu 开放的 REST API 批量导入，能完整解析 Hexo Front Matter（date、tags、categories、abbrlink），保留原始发布时间，批量脚本支持断点续传、失败重试，适合文章多的老站。

七、Pro 版购买

项目 说明
价格 ¥199 永久授权（限时特惠），终身更新，非订阅制
购买 官网 anheyu.com/zh-CN/pricing 在线支付，账号内获得专属授权码
绑定 与域名强绑定、本地认证不联网、每个域名单独添加（根域名和子域名要分别加）、换域名需重新生成密钥
启用 .env 中设置 ANHEYU_LICENSE_KEY，Pro 包从账号授权下载入口获取
额外功能 AI 摘要 / AI 写作 / AI 播客、付费文章、密码文章、说说、多用户共创、多种支付登录方式

建议：先用社区版或官网 Demo 站把功能体验一遍，确认 AI 功能接入方式满足需求再下单；域名先想好再购买，避免后期换域名重新部署授权。

八、总结

  • Hexo + 安知鱼主题：静态、免费、零维护，今天生成的 HTML 十年后照样能打开，长期持有博客的最优解；
  • Anheyu App：动态、有后台、能变现，代价是要维护服务器和数据库，适合折腾党和内容创业者；
  • Anheyu 的升级操作本身不难，真正的门槛在于它是带数据库的动态应用——更新前必备份、日常必须跑自动备份脚本；
  • 如果刚从 Hexo 转过来，建议先在测试环境完整走一遍迁移流程再动生产环境。

我已经把 Anheyu 跑起来了（三个容器，80M 内存占用），后续会分享更多深度使用体验。

参考资料：Anheyu 官方文档 dev.anheyu.com、GitHub 仓库 anzhiyu-c/anheyu-app、作者博客迁移教程。