博客部署

环境要求#

• Node.js >= 22
• pnpm >= 9

1. 克隆仓库#

你可以直接克隆主仓库，但更推荐先 Fork 到自己名下再克隆：

1
git clone https://github.com/jeio258/Firefly.git
2
cd Firefly

2. 安装依赖#

1
npm install -g pnpm   # 如果尚未安装 pnpm
2
pnpm install

3. 创建 GitHub OAuth App（友链审核功能必需）#

前往 GitHub Developer Settings 新建一个 OAuth App：

• Application name：任意填写，如 My Blog Admin
• Homepage URL：你的博客首页地址
• Authorization callback URL：https://你的Worker域名/api/auth/callback

创建完成后，你将获得 Client ID 和 Client Secret。
接着生成一个具有 repo 权限的 Personal Access Token，用于向仓库推送友链数据。

4. 配置 Cloudflare 环境变量#

登录 Cloudflare Dashboard，进入你的 Worker 设置，添加以下加密环境变量：

配置无误后，友链审核后台即可正常工作。

5. 自定义博客配置#

所有可配置项都在 src/config/ 目录下，推荐至少修改以下文件：

• siteConfig.ts：站点名称、语言、域名等基础信息
• profileConfig.ts：个人头像、昵称、社交链接
• navBarConfig.ts：导航菜单
• sidebarConfig.ts：侧边栏布局与小组件

更多细节见 Firefly 使用文档。

6. 启动开发服务器#

1
pnpm dev

浏览器访问 http://localhost:4321 即可实时预览。