写在前面

• Rin 是什么
  一款基于 Cloudflare Pages + Workers + D1 + R2 全家桶的博客
  说人话：前端纯静态页面，后端提供API给前端拉取文章和配置信息，一切都在 Cloudflare 上完成

• 为什么应该选择它
  无需服务器无需备案，只需要一个解析到 Cloudflare 的域名，且在一定的用量内完全免费（对于小型个人博客绰绰有余）

它适合哪些人

• 不想架设服务器、维护动态博客的人
• 追求轻量化的人
• 喜欢云原生的人
• 希望一切皆可白嫖的人

它可能不适合的人

• 追求高大全的人
• 既要又要事多的人
• 已有较多博客文章需要迁移的人
  目前 Rin 仅支持从 Wordpress 批量导入文章，其他博客的数据迁移可能会较为繁琐

注意

目前 Rin 属于刚起步阶段，功能还是稳定性上都稍不尽人意，请在部署前做好心理准备
如果在使用中遇到问题，先去 Issues 看看有没有人已经提出过

Cloudflare 需要绑定支付方式才可启用 R2 功能，你可以绑定 Paypal 或银行卡来激活 （料卡也不是不行，它不验卡的）

本文所使用的 Rin 为 官方版本，而本站所使用的为 个人修改版，由于 99% 的代码都来自 ChatGPT 而且实现方式都是依托答辩， 不会考虑将自己的版本提交官方。如果有需要可以自行部署
如果使用我的修改版遇到了问题，请先行联系我而不是官方仓库以免造成困扰

准备工作

你需要先准备以下内容

• 一个 GitHub 账号
• 一个 Cloudflare 账号，同时已经解析自己的域名
• 带上脑子和手还有耐心

正式部署

首先打开 Rin 项目地址，点击 Fork 按钮

前端

打开 Cloudflare 控制台，进入侧边栏的 Workers 和 Pages，然后点击 创建

构建命令：bun b
构建输出目录：client/dist

没有提到的项目保持默认值
填写之后点开环境变量（高级），添加以下变量（注意不要有多余的空格）

NAME=Xeu # 昵称，显示在左上角
DESCRIPTION=杂食动物 # 个人描述，显示在左上角昵称下方
AVATAR=https://avatars.githubusercontent.com/u/36541432 # 头像地址，显示在左上角
API_URL=https://rin.xeu.life # 服务端域名，可以先使用默认值查看效果，后续部署服务端后再修改
PAGE_SIZE=5 # 默认分页大小，推荐 5
SKIP_DEPENDENCY_INSTALL=true
UNSTABLE_PRE_BUILD=asdf install bun latest && asdf global bun latest && bun i

最后两行环境变量 SKIP_DEPENDENCY_INSTALL 和 UNSTABLE_PRE_BUILD 不要修改，按原样添加即可

后端

这里并不需要自行去 Cloudflare Workers 新建项目，后端采用 GitHub Actions 部署，你只需要配置好 GitHub 这边就行

配置 Cloudflare R2 存储桶

新建存储桶

进入 Cloudflare 控制台，转到侧边栏的 R2，点击 新建存储桶

存储桶配置

进入存储桶，点击设置，复制 S3 API

[
  {
    "AllowedOrigins": [
      "https://blog.obdo.cc"
    ],
    "AllowedMethods": [
      "GET",
      "DELETE",
      "HEAD",
      "POST",
      "PUT"
    ],
    "AllowedHeaders": [
      "Content-Type"
    ]
  }
]

回到 概述，点击 管理 R2 API 令牌

前往 Cloudflare 获取 账户 ID 和 API 令牌

进入 Cloudflare 控制台，随意进入一个域名，记录下方的 账户 ID

进入右上角的 我的个人资料

接入 GitHub OAuth

Rin 的登录系统采用的是 GitHub 授权，因此你需要先去申请一个 GitHub OAuth App

进入 GitHub OAuth Apps，点击 New OAuth App
按照以下参数进行填写
Homepage URL 填写上面的前端地址
Authorization callback URL 填写 https://<你的后端地址>/user/github/callback
这里的后端地址即后面你的 Cloudflare Workers 需要绑定的域名，我这里以 https://rin.obdo.cc/user/github/callback 为例

配置 GitHub Actions

打开自己 Fork 的 GitHub 仓库，依次转到 Settings、Secrets and variables、Actions、Variables

FRONTEND_URL=前端地址，填写上文前端所绑定的域名，如 https://blog.obdo.cc
S3_BUCKET=R2 存储桶名称，如上文示例中的 rin-storage
S3_REGION=auto
S3_ENDPOINT=R2 的 S3 API，去掉域名后面的路径，如 https://1234567890abcdef1234567890abcd.r2.cloudflarestorage.com
S3_ACCESS_HOST=R2 公开访问域名，如上文示例中的 https://rin-storage.obdo.cc

添加好之后应该是这样的

CLOUDFLARE_ACCOUNT_ID=Cloudflare 的 账户ID
CLOUDFLARE_API_TOKEN=Cloudflare 的 用户API令牌 值
RIN_GITHUB_CLIENT_ID=上文生成的 Github Client ID
RIN_GITHUB_CLIENT_SECRET=上文生成的 Github Client Secret
JWT_SECRET=加密用的密钥，你可以使用密码生成器随机生成一个
S3_ACCESS_KEY_ID=存储桶API的 访问密钥ID
S3_SECRET_ACCESS_KEY=存储桶API的 机密访问密钥

添加好之后应该是这样的
由于是 Secrets 所以不会显示值，添加时务必确认添加正确

对接前后端

首先，提前祝贺下自己，你已经完成了前端与后端的部署，接下来只差最后一步，就是对接前后端了
进入 Cloudflare 控制台，转到侧边栏的 Workers 和 Pages
如果前面部署的一切顺利，这里你应该会看到一个名为 rin-server 的 Worker
进入 rin-server 的设置，转到 触发器
点击 添加自定义域，绑定自己的后端域名
点击 添加路由，依次加入 前端域名/sub/* 前端域名/seo/*
如下图所示