banner
约 900 字
3 分钟

配置flare

无标签
配置flare

第 0 步:准备账号

你需要:

  1. GitHub 账号

  2. Cloudflare 账号(已绑付款方式,并开通 R2)

  3. 一个域名,已在 Cloudflare 托管,状态为 Active

下文用示例:

  • 博客域名:blog.example.com(换成你的)

  • Worker 名称:flare-blog(可自定,后面要一致)

下面按官方部署流程,从零到能写文章,一步一步做。每一步做完再进入下一步。


第 1 步:Fork 仓库

  1. 打开:https://github.com/du2333/flare-stack-blog

  2. 右上角点 Fork

  3. Owner 选自己,仓库名保持 flare-stack-blog,勾选 Copy the main branch only

  4. 点 Create fork

image.png
image.png

之后都用你自己的:github.com/你的用户名/flare-stack-blog

第 2 步:准备两份变量清单

在电脑上建两个文本文件:

  • 一个叫 构建变量

  • 一个叫 运行时变量

需要在cloudflare中填写

先在「构建变量」里写好(值后面会补全):

  • WORKER_NAME=flare-blog

  • DOMAIN=blog.example.com

  • D1_DATABASE_ID=

  • BUCKET_NAME=

  • QUEUE_NAME=

  • KV_NAMESPACE_ID=

在「运行时变量」里写好:

第 3 步:创建 GitHub OAuth App(用于登录)

  1. 打开:https://github.com/settings/applications/new

  2. 填写:

项

内容

Application name

任意,如 我的博客

Homepage URL

https://blog.example.com

Authorization callback URL

https://blog.example.com/api/auth/callback/github

  1. 点 Register application

  2. 复制 Client ID → 填到运行时清单的 GITHUB_CLIENT_ID

  3. 点 Generate a new client secret,立刻复制 → 填到 GITHUB_CLIENT_SECRET(只显示一次)

第 4 步:在 Cloudflare 创建 4 个资源

登录 Cloudflare 控制台,选托管该域名的账号。

image.png
image.png

4.1 D1 数据库(存文章、用户)

  1. 左侧 Storage & databases → D1

  2. Create Database,名称例如 blog-db,创建

  3. 在列表里复制该库的 UUID / Database ID

  4. 填到构建清单:D1_DATABASE_ID=这里粘贴UUID

4.2 R2 存储桶(存图片)

  1. Storage & databases → R2

  2. Create bucket

  3. 名称必须 全小写 + 数字 + 连字符,例如 blog-media(不要 flare-R2 这种大写)

  4. 填到构建清单:BUCKET_NAME=blog-media

4.3 Queue(异步通知)找不到可以搜索

  1. Compute → Queues

  2. Create Queue,名称例如 blog-queue

  3. 填到构建清单:QUEUE_NAME=blog-queue

4.4 KV(缓存)

  1. Storage & databases → Workers KV

  2. Create,名称例如 blog-cache

  3. 复制列表里的 ID

  4. 填到构建清单:KV_NAMESPACE_ID=这里粘贴ID

此时「构建变量」应六项都有值。

第 5 步:创建 Worker 并部署

  1. Compute → Workers & Pages → Create application

image.png
image.png
  1. 选 Continue with GitHub,授权并选中你 Fork 的 flare-stack-blog

  2. 填写:

设置

填什么

Project name

与 WORKER_NAME 相同,如 flare-blog

Build command

bun run build

Deploy command

bun run deploy

Root directory

/

  1. 展开 高级设置 → 变量,把构建清单 6 个变量逐个添加:

image.png
image.png
  • 变量名称:等号左边(如 D1_DATABASE_ID)

  • 变量值:等号右边

  1. 点 部署,等构建成功(约几分钟)

若失败:

  • D1 报错 → 确认是 UUID,不是库名

  • R2 报错 bucket_name invalid → 桶名必须全小写

修好变量后 重新部署。

第 6 步:添加运行时变量

部署成功后:

  1. 打开该 Worker → 设置 → 运行时变量和密钥

  2. 添加变量,把运行时清单全部加上:

纯文本
BETTER_AUTH_SECRET=你生成的密钥
BETTER_AUTH_URL=你的域名
DOMAIN=blog.example.com
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
ENVIRONMENT=prod
  1. 每一项都勾选 密钥(很重要,否则下次部署会丢)

  2. 保存并部署,等生效

  3. 在 Worker 的 域名 里确认已绑定 blog.example.com(部署命令通常会自动绑)

DNS/证书生效后,浏览器打开:https://blog.example.com

第 7 步:第一个登录 = 管理员

  1. 打开博客首页

  2. 右上角 登录 → GitHub 登录 → 授权

  3. 新数据库里第一个用户会自动成为管理员

  4. 登录后点头像,应能看到 管理后台;或直接访问:
    https://blog.example.com/admin

END