从Hexo到Astro Firefly：我的博客迁移之旅

朋友们！还在纠结博客框架选择吗？看过来！#

作为一个写了几年博客的技术博主，我最近完成了从 Hexo 到 Astro Firefly 的迁移。今天就来和大家分享一下这次迁移的全过程，包括两个框架的对比、迁移步骤以及部署经验。

为什么要从 Hexo 迁移到 Astro？#

🚀 迁移过程详解#

1
# 检查 Node.js 版本（需 ≥ 22）
2
node -v
3

4
# 安装 pnpm（推荐）
5
npm install -g pnpm
6
pnpm -v

1
# Fork Firefly 仓库地址
2
https://github.com/CuteLeaf/Firefly

1
# 克隆仓库（建议先 Fork 到自己的仓库）
2
git clone https://github.com/你的用户名/Firefly.git
3
cd Firefly
4

5
# 安装依赖
6
pnpm install

1
// 站点基础配置
2
export const SITE_CONFIG = {
3
  name: "你的博客名称",
4
  title: "你的博客标题",
5
  description: "你的博客描述",
6
  lang: "zh_CN",
7
  url: "https://你的域名.com",
8
  // ... 其他配置
9
};

1
---
2
title: 文章标题
3
date: 2024-01-01 12:00:00
4
tags: [标签1, 标签2]
5
category: 分类
6
---

1
---
2
title: 文章标题
3
published: 2024-01-01
4
description: 文章描述
5
image: ./cover.jpg # 或使用 "api" 启用随机封面
6
tags: [标签1, 标签2]
7
category: 分类
8
draft: false
9
pinned: false
10
comment: true
11
---

1
# 复制图片资源
2
cp -r ../hexo-blog/source/images/* public/images/

1
# 启动开发服务器
2
pnpm dev
3

4
# 构建生产版本
5
pnpm build
6

7
# 预览构建结果
8
pnpm preview

🛠️ 部署实战：Vercel + Cloudflare#

1. 登录 Vercel，点击 “New Project”

2. 导入仓库，选择你的 Firefly 仓库 3. 配置项目(默认已配置好，确认即可)：

• Framework Preset: Astro
• Root Directory: ./
• Build Command: pnpm run build
• Output Directory: dist

4. 点击 Deploy，等待部署完成

5. 配置域名（可选）：Vercel 域名在国内访问速度较慢，建议配置自定义域名。这里以 Cloudflare 为例，配置域名后即可访问。

   • 购买域名（如果还没有）
   • 打开刚部署好的 Vercel 项目，点击 “Domains” 选项卡，添加自定义域名。
   • 在 Cloudflare 控制台添加自定义域名
   • 配置 DNS 记录，将域名指向 Vercel 提供的 IP 地址
   • 等待 DNS 记录生效（通常需要 10-30 分分钟）

6. 必应IndexNow（可选）：

   • 去 必应 IndexNow 点击 “Get Started” 按钮
   • 在打开的页面中，下滑到页面底部，有一个Generate API Key 区域，点击 “Generate” 按钮，即可获取 新的API Key，复制该 Key 到剪贴板，
   • 然后到blog根目录/public/文件夹下创建一个apikey.txt文件，将复制的API Key 放入文件中,注意txt文件名也为key的内容。
   • 安装必应 IndexNow 插件,在根目录执行pnpm install astro-indexnow
   • 配置插件,在blog/astro.config.mjs中添加以下内容：

   1
   //  引入 IndexNow 插件
   2
   import indexnow from 'astro-indexnow';
   3
   
   4
   
   5
   // 新增 IndexNow
   6
   indexnow({
   7
   key: '7axxxxxxxxxxxxxxxxxxxb43c1', // 你的Key
   8
   // 可选：指定引擎（默认必应+Yandex）
   9
   keyLocation: '/7axxxxxxxxxxxxxxxxxxxb43c1.txt',
   10
   // 可选：提交引擎（默认 Bing、Yandex）
   11
   engines: ['bing', 'yandex'],
   12
   // engines: ['bing']
   13
   })

   

   • 这么操作完后，每次执行pnpm run build，即可自动提交 IndexNow 插件（本地执行不会推送哦）

🎨 Firefly 主题特色功能#

💡 迁移注意事项#

1. 备份数据：迁移前务必备份 Hexo 博客的所有文件
2. URL 重定向：如果文章 URL 结构变化，需要配置重定向规则
3. 评论迁移：如果使用 Disqus 等评论系统，需要迁移评论数据
4. SEO 保留：确保文章的永久链接不变，或设置 301 重定向
5. 测试验证：迁移后全面测试各项功能是否正常

📝 总结#

从 Hexo 迁移到 Astro Firefly 是一次非常愉快的体验：

1. 开发体验提升：热更新速度极快，TypeScript 支持完善
2. 性能大幅提升：首屏加载时间减少了 60%+
3. 功能更加丰富：Firefly 主题提供了很多开箱即用的功能
4. 部署更加便捷：Vercel 和 Cloudflare 都提供了很好的支持

如果你也在考虑迁移博客，不妨试试 Astro Firefly，相信你会喜欢上它的！

项目地址#

• Firefly 主题：https://github.com/CuteLeaf/Firefly
• 在线预览：https://blog.huhaha.vip/
• 使用文档：https://docs-firefly.cuteleaf.cn/

互动时间#

你现在使用的是什么博客框架？有没有考虑过迁移？欢迎在评论区分享你的想法！

如果你在迁移过程中遇到了什么问题，也可以在评论区留言，我会尽力帮助你！

推荐阅读：

• 不想修改hosts？这个神器更简单！SteamTools 让你一键加速GitHub和Steam，告别网络问题
• 替代Notion的最佳选择！这个开源工具太惊艳了
• 发现宝藏音乐软件！LX Music 让你告别多 app 切换，一个软件听遍所有平台

（注：文章部分信息来源于 Firefly 官方文档和个人迁移经验）