大家好，我是 Mliaomcx。平时我们在折腾各类 VPS、搭建测试环境，或者进行全栈开发（比如部署 Vue3 项目环境）时，往往需要注册大量第三方服务和测试账号。拥有一个以自己域名结尾的专属邮箱（如 hi@yourdomain.com）不仅是个人品牌的象征，更是完美隔离数据、保护主力邮箱隐私的“注册神器”。

传统的域名邮箱要么需要高昂的订阅费，要么得在自己的服务器上费时费力地配置环境。今天，我将分享一套完全免费、零服务器成本、免维护的 Serverless 域名邮箱搭建方案。借助网络大善人 Cloudflare 和开源项目 Cloud Mail，我们不仅能实现无限前缀收信，还能结合 Resend 实现无缝发信，把多域名全部整合进一个漂亮的后台统一管理！

💡 为什么选择这套方案？

• 完全免费：充分利用 Cloudflare 的 Serverless 计算和存储资源，零服务器月租。
• 无限前缀 (Catch-all)：任意前缀的邮件都能收到，临时注册毫无压力。
• 自带精美 UI 面板：无缝收发、多域名管理，操作体验媲美专业企业邮。
• 极高安全性：无需担心服务器宕机或遭遇黑客攻击，省钱又省心。

---

🛠️ 前置准备工作

在正式动手之前，请确保你已经准备好以下资源：

1. 专属域名：必须已托管至 Cloudflare。
   • (注意：如果该域名之前绑定过第三方邮箱平台，请务必先进入 Cloudflare 的 DNS 记录中，将旧的 MX 等相关记录彻底删除。)
2. GitHub 账号：用于拉取开源项目代码。
3. Resend 账号：用于后续提供发信 API。

---

🚀 第一阶段：部署 Cloud Mail 核心后台

我们将使用 Cloud Mail，这是一个功能极其强大的开源邮件客户端项目，直接运行在 Cloudflare Workers 上。

1. Fork 官方项目代码

首先，打开浏览器登录 GitHub，访问 Cloud Mail 的官方开源仓库： 👉 https://github.com/maillab/cloud-mail 点击右上角的 Fork，将项目代码复制到你自己的 GitHub 账号下。

2. 创建并部署 Worker

回到 Cloudflare 后台（不要选中任何域名），在左侧菜单点击 Workers 和 Pages -> 创建应用程序 -> 创建 Worker。

• 点击 Continue with GitHub（继续使用 GitHub）。
• 授权登录后，选择你刚才 Fork 的 cloud-mail 仓库。
• ⚠️ 关键设置：下拉找到“高级设置”，必须将「路径」修改为 mail-worker，其余保持默认。点击部署，稍等几分钟等待代码拉取完成。

3. 绑定自定义域名

由于 Cloudflare 默认提供的 workers.dev 域名在国内访问受限，我们需要绑定自己的域名。

• 在 Worker 设置页面，点击 触发器 -> 添加自定义域。
• 输入如 mail.你的域名.com，点击添加。这将是你未来登录邮箱后台的网址。

4. 设置环境变量

在 Worker 的 设置 -> 变量和机密 中，添加以下三个变量：

• domain (类型选 JSON)：填入你的域名，格式必须为 ["你的域名.com"]（注意英文双引号和中括号）。
• admin (类型选 文本)：设置一个你的管理员邮箱，例如 admin@你的域名.com。
• JWT_SECRET (类型选 文本)：后台的防伪密钥，随便输入一段较长的英文字母或数字（不要带特殊符号）。

---

🗄️ 第二阶段：配置 Serverless 数据库

Cloud Mail 巧妙地利用了 CF 的免费数据库资源：D1 SQL 数据库负责登记邮件头信息，KV 命名空间则充当存储邮件正文的大仓库。

1. 创建数据库

• 在 Cloudflare 左侧菜单找到 存储和数据库。
• 创建一个 D1 SQL 数据库，命名为 cloud-mail-db。
• 创建一个 Workers KV 命名空间，命名为 cloud-mail-kv。

2. 将数据库绑定到 Worker

回到刚才部署的 Cloud Mail Worker，进入 设置 -> 绑定：

• 添加 KV 命名空间绑定：变量名称必须填小写 kv，然后选择刚建的 KV 空间。
• 添加 D1 数据库绑定：变量名称必须填小写 db，然后选择刚建的 D1 数据库。

---

📬 第三阶段：设置电子邮件路由 (收信)

1. 回到 Cloudflare 主页，点击进入你的主域名。
2. 在左侧菜单点击 电子邮件 -> 电子邮件路由，点击启用。系统会自动为你补全接信所需的 DNS 记录。
3. 设置 Catch-all 规则：在规则编辑中，操作选择 发送到 Worker，目标选择你刚才建好的 Cloud Mail Worker，并确保状态处于“开启”。
   • 完成这一步，发给该域名的所有邮件就已经可以被你的系统接收了！

---

🌐 第四阶段：初始化系统与账号注册

1. 执行初始化：在浏览器地址栏输入以下链接进行数据库初始化： https://mail.你的域名.com/api/setup/你的JWT_SECRET (将最后一部分替换为你之前设置的 JWT_SECRET)。页面显示 success 即代表成功。
2. 注册管理员：删掉地址栏后缀，直接访问 https://mail.你的域名.com。使用你配置的 admin 邮箱注册账号并设置密码。登录后，你就可以看到极简美观的收件箱了。

---

📤 第五阶段：接入 Resend 突破发信限制

Cloudflare 原生只负责“收”，要回复邮件或往外发信，我们需要配置第三方代发服务 Resend。

1. 配置 Resend 域名

• 前往 Resend 官网 免费注册账号。
• 在左侧 Domains 菜单中添加你的域名，强烈建议选择 Auto config (自动配置)，授权它自动向你的 Cloudflare 写入发信 DNS 记录。
• 状态变为绿色的 Verified 即代表验证成功。

2. 生成 API Key 并配置 Webhooks

• 在左侧 API keys 里生成一把全新的 Key，请立刻复制保存（关掉后将无法再次查看）。
• 在左侧 Webhooks 添加端点，URL 填写： https://mail.你的域名.com/api/webhooks
• 事件类别勾选：Bounced、Complained、Delivered、Delivery delayed、Failed。 (⚠️ 避坑警告：千万不要勾选 Clicked 和 Opened，否则很容易被大厂的安全系统判定为垃圾邮件。)

3. 在后台激活发信

• 回到你的 Cloud Mail 网页后台。
• 进入 System Settings -> Email，在 Resend 选项处点击加号，填入刚刚复制的 API Key 并保存。
• 大功告成！现在你已经可以自由回复和发送邮件了。

---

💡 进阶使用建议 (SEO 优化 Tips)

搭建完成后，为了系统的长期稳定和安全，建议你做以下调整：

• 关闭公共注册：如果是个人私用，强烈建议在后台的 System Settings 中关闭 Sign up 开关。如果需要给朋友开账号，可以使用下方的 Invite code 生成邀请码。
• 额度说明：Resend 免费版每天提供 100 封发信额度；Cloudflare KV 免费版提供 1GB 存储，存放几万封普通验证码邮件绰绰有余。
• 支持大附件：如果后期你用它来接发大容量附件导致 KV 空间不足，可以在设置中无缝切换至 Cloudflare R2 对象存储（每月 10GB 免费空间），满足更高阶的需求。

希望这篇保姆级教程能帮你顺利拿下属于自己的顶级域名邮箱！如果在实操过程中遇到任何卡壳的地方，欢迎在下方评论区留言讨论。

---

文章分类：效率工具 / Web 部署教程 核心标签：域名邮箱, Cloudflare Workers, Serverless, Resend, Cloud Mail, 零成本建站, 隐私保护

最近在 AI 圈子和我们折腾 VPS 的极客群体中，带“自我进化”能力的 AI 智能体框架 Hermes Agent（很多朋友戏称它为“爱马仕”智能体）彻底火了。它是老牌项目 OpenClaw（龙虾）的进化版，最大的杀手锏在于：它拥有长期记忆，并且能根据你的需求，自己编写并固化专属的工具链（技能）。

今天，我们将抛弃繁琐的本地环境配置，使用国人最顺手的 FinalShell 连入云端 VPS 进行部署。更激动人心的是，我们将把它的底层大脑，替换为目前地表最强的 DeepSeek V4。

一、 为什么选择接入 DeepSeek V4？（V4 有多强？）

在动手之前，必须先吹爆我们今天的主角——DeepSeek V4 API。作为最新一代的国产大模型之光，它在作为 Agent “大脑”时有着无可匹敌的优势：

1. 断层领先的逻辑与推理跃升：V4 采用了全新一代的混合专家（MoE）架构，在复杂任务拆解和长程逻辑推理上的表现极度惊艳。Hermes Agent 需要多步思考来自己造工具，V4 强大的逻辑链能确保它在构建工作流时绝对“不翻车”。
2. 原生 Tool-Calling（工具调用）霸主：在代码编写（特别是 Python 脚本）和 API 调用准确率上，DeepSeek V4 甚至能在很多基准测试中压倒顶级大模型的对手。它能极速响应 Hermes 的系统指令，并且错误率极低。
3. 碾压级的价格优势（核心杀手锏）：智能体在后台 7×24 小时不断反思、总结和整理记忆，绝对是个“Token 吞金兽”。但 DeepSeek V4 真正恐怖的地方在于：它的性能已经无限接近 Claude Opus 4.6 这个级别的顶配模型，关键是价格低得离谱！ 跑同样的工作流，它的 API 成本比 GPT 便宜了快 10 倍。用白菜价享受最顶尖的云端 AI 助理，完全不用心疼账单。

deepseek的跑分如下

1.综合跑分对比表

模型	MMLU (5-shot)	HumanEval (pass@1)	MATH (CoT)	LongBench (avg)	上下文窗口
DeepSeek V4 (Preview)	89.2	90.8	78.5	72.1	128K
DeepSeek V3	85.7	85.2	68.3	61.4	128K
GPT-5	90.1	92.4	80.2	69.8	128K
Claude Opus 4.6	88.6	91.5	76.8	73.5	200K
GLM 5	83.4	82.1	65.7	58.9	128K
Qwen 3 旗舰	87.1	87.3	72.4	66.2	128K

2. 各维度排名速览

排名	MMLU	HumanEval	MATH	LongBench
🥇 1	GPT-5 (90.1)	GPT-5 (92.4)	GPT-5 (80.2)	Claude Opus 4.6 (73.5)
🥈 2	DeepSeek V4 (89.2)	Claude Opus 4.6 (91.5)	DeepSeek V4 (78.5)	DeepSeek V4 (72.1)
🥉 3	Claude Opus 4.6 (88.6)	DeepSeek V4 (90.8)	Claude Opus 4.6 (76.8)	GPT-5 (69.8)
4	Qwen 3 (87.1)	Qwen 3 (87.3)	Qwen 3 (72.4)	Qwen 3 (66.2)
5	DeepSeek V3 (85.7)	DeepSeek V3 (85.2)	DeepSeek V3 (68.3)	DeepSeek V3 (61.4)
6	GLM 5 (83.4)	GLM 5 (82.1)	GLM 5 (65.7)	GLM 5 (58.9)

3.第一梯队详解：MATH 子类别对比

MATH 子类别	DeepSeek V4	DeepSeek V3	GPT-5	提升幅度 (V4 vs V3)
代数	85.2	76.1	87.3	+9.1
数论	74.8	62.5	76.2	+12.3
几何	71.3	58.7	73.1	+12.6
概率统计	80.1	70.4	82.5	+9.7
微积分	78.6	66.2	80.8	+12.4

4.长文本任务：超长文档 QA 准确率对比

文档长度	DeepSeek V4	DeepSeek V3	GPT-5	Claude Opus 4.6
16K tokens	85.3	79.1	83.7	86.2
32K tokens	80.1	71.5	78.4	82.8
64K tokens	73.6	58.2	68.9	76.1
100K+ tokens	65.4	42.7	59.3	70.5

二、 课前准备物料

1. 一台高性能 VPS 云服务器： 由于 Hermes Agent 需要频繁进行后台任务处理，推荐 2GB 内存及以上的机器。本次演示我使用的是莱卡云 (LcaYun)。他们家的机器拥有优质的 BGP 三网直连线路，海外节点访问 DeepSeek API 非常稳定且延迟极低。目前他们针对新用户有非常给力的活动（如 19.9 元/月起的特惠机型），性价比极高。
   • 推荐购买链接：莱卡云官方特惠入口
2. FinalShell：极其好用的 SSH 远程连接和服务器状态管理工具。
3. DeepSeek API Key：前往 DeepSeek 开放平台，生成你的专属 API 密钥。
4. Telegram 账号：用于后续搭建随身访问的移动端助理界面。

三、 阶段一：使用 FinalShell 丝滑连入 VPS

1. 打开 FinalShell，点击左上角的“文件夹”图标，选择第一项“SSH 连接”。
2. 在弹出的设置框中填写基本信息：
   • 名称：随便起（如：爱马仕 Agent 服务器）
   • 主机：填入你 VPS 的公网 IP
   • 端口：保持默认的 22
   • 认证方法：选择“密码”
   • 用户名：输入 root
   • 密码：填入你的服务器密码
3. 点击“确定”保存后，双击这个连接。接受安全警告后，当你在软件底部看到 CPU、内存和网络的实时监控仪表盘开始跳动，说明已经成功进入你的服务器底层！

四、 阶段二：使用科技lion一键脚本傻瓜式安装

纯手动配 Python 环境容易踩坑，这里我们直接调用圈内大名鼎鼎的“科技lion一键管理脚本”，全中文面板，对新手极其友好。

1. 在 FinalShell 下方的终端黑框里，复制粘贴下面这行命令，然后按回车：

curl -sS -O https://raw.githubusercontent.com/kejilion/sh/main/kejilion.sh && chmod +x kejilion.sh && ./kejilion.sh

1. (注：如果提示没有 curl，可以先运行 apt install curl -y 再执行上述命令)
2. 脚本运行后，输入 Y 回车进入全屏的中文主面板。
3. 找到 Hermes Agent 的安装选项，根据屏幕提示，输入数字 1（使用官方命令安装），然后按回车。
4. 接下来喝口水，脚本会自动在后台帮你拉取代码并配置好所需的底层依赖。

五、 阶段三：配置 DeepSeek V4 (核心大脑注入)

安装完成后，系统会自动跳出 Hermes 的初始化引导（Setup 界面）。目前大部分框架还没把所有模型列全，但我们可以通过自定义 URL 完美兼容。

跟着键盘方向键和回车键，按以下步骤选择：

1. 选择模式：选择 Quick Mode（快速模式）。
2. 选择对接平台：在列表中下拉找到 More（更多），然后选择 Custom URL（自定义 URL）。
3. 填入 Base URL（关键）：务必填入 DeepSeek V4 的官方标准兼容端点：https://api.deepseek.com （回车确认）。
4. 填入 API Key：复制你的 DeepSeek 密钥，在 FinalShell 的终端区域右键点击“粘贴”（注意：Linux 终端输入密码默认不显示字符，粘贴后直接回车即可）。

！！！：一般来说，你输入api key，显示模型名称，说明正常，如果没有显示具体模型名称，检查一下你的URL和API Key是否正确

1. 指定模型名称：手动输入 deepseek-v4-flash或deepseek-v4-pro。
2. 设置上下文长度时，直接按回车，让系统自动探测最大长度。
3. 备注模型名称，大家随意填写

六、 阶段四：灵魂注入，无缝对接 Telegram

出于安全和极客纯粹性考虑，Hermes 目前是没有自带 WebUI 的。为了避免每次都要打开电脑连 SSH 打字，我们要把它接入 Telegram，变成你的随身微信助理。

1. 获取 Bot Token：打开 Telegram，搜索 @BotFather，发送 /newbot 跟着提示创建一个新机器人。完成后，复制系统发给你的一长串 API Token。
2. 获取你的用户 ID：在 TG 搜索 @userinfobot，点击 Start，拿到你个人的专属数字 ID（为了防止别人白嫖你的 API，必须告诉 Agent 你的专属白名单 ID）。
3. 让 AI 自己写代码对接：此时回到 FinalShell，你已经处在 Hermes 的初始终端聊天界面里了。不要自己找配置文件，直接像使唤员工一样对它输入：“请帮我对接 Telegram 机器人。这是我的 Bot Token: [你的Token]，我的用户 ID 是: [你的ID]。”

接下来就是见证奇迹的时刻：Hermes Agent 会自动开始调用自身的工具链，分析你的要求，自己写 Python 脚本配置对接代码，处理依赖报错，并最终自动重启服务完成挂载！

七、 总结

当终端提示完成后，打开 Telegram，点开你刚刚创建的机器人，发一句“你好”。

恭喜你！一个由目前性价比与智商双绝的 DeepSeek V4 驱动、能自己写代码造工具、具备长程记忆、且完全由你自己掌控的云端专属 AI 助理，已经 24 小时待命了！赶紧去试试让它帮你搜集资讯或者跑个自动化脚本吧！

拥有一个属于自己的域名邮箱，不仅能提升个人或品牌的专业形象，更相当于拥有了无限个邮箱账号前缀！无论是为了保护主力邮箱的隐私，还是注册特定平台获取多次福利，域名邮箱都极其好用。

传统部署方式要么需要复杂的身份验证，要么需要花钱购买服务器。今天，我们将教你如何借助 Cloudflare（赛博菩萨）和开源项目 Cloud Mail，零服务器成本搭建一套能收能发、支持多域名管理、完美免维护的专属域名邮箱。

为什么选择 Cloud Mail？

这套架构具有三大核心亮点：

1. 完全免费、免服务器：借助 Cloudflare 的计算与存储资源，无需担心宕机或黑客攻击。
2. 无缝对接发信服务：Cloudflare 原生只能收信，但该项目整合了第三方 Resend 服务，实现了无缝发信。
3. 极强大的集中管理：同一个后台可收发同一域名下的无数个前缀邮箱，甚至能管理多个不同的域名。

---

准备工作

在开始之前，你需要准备一个属于自己的域名。如果没有，可以通过服务商（如 Spaceship）购买，并将域名 DNS 解析托管至 Cloudflare 平台。

---

详细实操部署步骤

1. 清理旧 DNS 记录

如果你之前曾使用过其他平台绑定过该域名邮箱，请先进入 Cloudflare 的 DNS 记录中，将相关的旧记录彻底删除，打扫干净“战场”。

2. Fork 开源项目与部署 Worker

1. 打开 Cloud Mail 项目的 GitHub 仓库，点击右上角的 Fork，将源代码克隆到你自己的 GitHub 账号下。
2. 登录 Cloudflare 控制台，点击左侧的“计算 (Workers & Pages)” -> “创建应用程序”。
3. 默认创建 Worker，点击 Continue with GitHub，授权并选择你刚 Fork 的 cloud_mail 仓库。
4. 【关键配置】：点击高级设置，在“路径”中必须输入 mail-worker，其他保持不变，点击部署并等待克隆完成。

3. 自定义后台域名与配置环境变量

为了方便记忆和访问，你需要绑定一个属于自己的登录地址，并设置系统变量：

1. 点击“设置” -> “触发器” -> “添加自定义域”，例如输入 mail.yourdomain.com。
2. 找到“变量和机密”，点击添加以下 3 个环境变量：
   • domain：类型必须选 JSON，值为 ["你的主域名"]（注意：必须包含英文双引号和中括号）。
   • admin：类型文本，输入你想要的管理员邮箱账号（如 admin@yourdomain.com）。
   • JWT_SECRET：类型文本，这是后台防伪钥匙，随意输入一段复杂的英数字符串即可（切勿带特殊符号）。

4. 创建并绑定 D1 与 KV 数据库

在这个系统中，D1 数据库相当于前台（登记基础信息），KV 数据库相当于仓库（存储长篇邮件正文）。

1. 在左侧菜单点击“存储和数据库”，分别创建一个 D1 SQL 数据库 和一个 Workers KV 命名空间（名字可随意，如 cloud_mail）。
2. 回到你的 Worker 设置中，找到“绑定”并点击添加：
   • 添加 KV 绑定：变量名称必须输入小写的 kv，选择刚建的 KV 空间。
   • 添加 D1 绑定：变量名称必须输入小写的 db，选择刚建的 D1 数据库。

5. 开启 Cloudflare 电子邮件路由

1. 回到账户主页，点击进入你的主域名。
2. 选择左侧“电子邮件” -> “电子邮件路由” -> 开始使用并启用。
3. 自动添加 DNS 记录后，进入路由规则配置，编辑 Catch-all (全部接收) 规则。
4. 将操作设为“发送到 Worker”，目标选择你刚才配置好的 Cloud Mail Worker，并确保状态开关开启。

6. 初始化系统与接收邮件测试

1. 在浏览器地址栏输入：你设置的登录域名/api/init/你的JWT_SECRET（例如 mail.xxx.com/api/init/testtesttest）。当页面显示 success 时，代表数据库初始化成功。
2. 删掉 URL 后缀访问后台，使用你在环境变量中设置的 admin 邮箱注册一个密码。
3. 此时，利用任何外部邮箱给你域名下的任意前缀发送邮件，只要点击后台的刷新按钮，即可完美收信。

7. 接入 Resend 开启发送功能

Cloudflare 原生不支持发信，我们需要配置代发平台 Resend。

1. 访问 Resend 官网，免费注册账号并验证。进入 Domains 菜单添加你的主域名，选择 Auto config 让系统全自动给 Cloudflare 加上验证记录。
2. 点击 API Keys，创建一个新的密钥。切记：密钥生成后只显示一次，务必立刻复制保存下来！
3. 设置 Webhooks：在 URL 处填入 你的后台域名/api/webhooks，事件类别勾选 Bounce, Complained, Delivered, Delivery delayed 和 Failed。（高亮提醒：千万别勾选 Clicked 和 Opened，以免触发大厂的反垃圾邮件系统导致拒收）。
4. 回到你搭建的 Cloud Mail 网页后台，进入 System Settings -> Email，将 API Key 粘贴进去并保存，至此系统发信能力激活！

---

高阶运营建议

• 账号安全与注册控制：如果是个人私有，建议在 System Settings 中关闭 Sign up 注册开关；如果想分给亲友使用，可以开启邀请码 Invite code 功能，只允许凭码注册。
• 使用配额：Resend 免费账户每天可发 100 封邮件，足够普通用户日常沟通和验证码接收使用。
• 附件存储扩容：系统默认使用 KV 数据库（1GB 免费空间），应付日常邮件绰绰有余。如果你需要频繁接收大附件，日后可随时无缝切换到 Cloudflare R2 存储（每月 10GB 免费空间，但需要绑卡认证）。

---

结语： 虽然第一次配置略带繁琐，但跟着步骤操作，你就能以“零月租”拥有一个高度可定制、隐私安全的专业级域名邮箱系统！赶快动手打造专属于你个人品牌的强悍邮箱吧！

随着云端折腾经验的不断丰富以及长线运营计划的推进，建立一个长期、可扩展的底层基础设施来承载内容与软件工具矩阵，变得尤为重要。传统的 VPS 建站虽然自由度高，但往往伴随着繁琐的服务器维护、环境配置以及续费焦虑。

今天这篇文章，我们将彻底转换思路，利用 Serverless 架构的优势，依托 Cloudflare 的强大生态，手把手教你零成本、高可用地部署个人内容大本营——Rin 博客系统，以及一个用于集中管理各类云端服务的专属导航网站。这套方案免去了底层运维的烦恼，并自带全球边缘节点的极速 CDN 加速。

---

一、 核心底座：部署 Rin 博客系统

Rin 是一款极其轻量且专为 Cloudflare 生态打造的现代博客系统。它依赖 Cloudflare Workers 提供后端计算，利用 D1 承担数据库，并使用 R2 作为对象存储（图床）。

1. 准备源码与获取 CF 授权

首先，需要获取源码并赋予 GitHub Actions 自动化部署到 Cloudflare 的权限。

• Fork 仓库：前往 GitHub，访问 openRin/Rin 仓库，点击右上角的 Fork 将代码复制到你的个人账号下。
• 获取 Account ID：登录 Cloudflare 控制台，在主页随便点击进入一个你托管的自定义域名，在页面右下方找到 账户 ID (Account ID) 并复制备用。
• 创建高定权限的 API Token：
  1. 点击右上角头像进入 我的个人资料 (My Profile) -> API 令牌 (API Tokens) -> 创建令牌 (Create Token)。
  2. 选择 编辑 Cloudflare Workers 模板。
  3. 划重点：修改默认权限！
     • 删除不需要的权限（如 KV 存储、路由、账户设置等）。
     • 保留以下三项权限：Workers 脚本 (Edit)、R2 存储桶 (Edit)、Cloudflare Pages 项目及其配置 (Edit)。
     • 手动新增一项：点击 添加更多，搜索并添加 D1 (Edit) 权限。
  4. 在底部“账户资源”区域，选择 包括 -> 所有账户。
  5. 设定好令牌到期时间（例如一个月或更长），点击创建并妥善保存这串 API Token。

2. 配置 GitHub 机密环境变量 (Secrets)

为了让 GitHub Actions 能够顺利建库和部署，必须将凭证安全地存入仓库。

进入你 Fork 的 Rin 仓库，点击 Settings -> Secrets and variables -> Actions，在 Secrets 标签页下点击 New repository secret，依次添加以下变量：

Secret 名称	填入的值	说明
CLOUDFLARE_ACCOUNT_ID	你的 Cloudflare 账户 ID	刚获取的 CF 账户标识
CLOUDFLARE_API_TOKEN	修改过权限（包含 D1）的 API Token	赋予部署权限
JWT_SECRET	任意长度的随机英文字符串	用于系统鉴权的密钥
ADMIN_USERNAME	自定义用户名	博客后台的首个管理员账号
ADMIN_PASSWORD	自定义密码	博客后台的首个管理员密码

3. 配置站点信息与图床 (Variables)

Rin 博客的站点名称、描述以及图床依赖，推荐通过 GitHub Variables 进行固化配置，避免重新部署时设置丢失。

• 创建 R2 存储桶：在 Cloudflare 面板左侧找到 R2 对象存储，创建一个新的存储桶（例如命名为 rin-images，名字不与其他用户冲突即可），复制该存储桶的名称。
• 添加 Variables：回到 GitHub 仓库的 Settings -> Secrets and variables -> Actions，切换到 Variables 标签页，点击 New repository variable 依次添加：
  • NAME: 你的博客站点名称（例如：mliaomcx）
  • DESCRIPTION: 你的站点描述
  • R2_BUCKET_NAME: 刚刚在 CF 创建的 R2 存储桶名称（填入后即可在后台正常上传图片到图床）

4. 进阶选项：配置 GitHub OAuth 快捷登录（可选）

如果你希望后续能直接用 GitHub 账号登录后台，可以配置 OAuth App（注意：首次必须用账号密码登录以获取管理员权限）：

1. 在 GitHub 右上角头像菜单进入 Settings -> 最底部的 Developer settings -> OAuth Apps -> New OAuth App。
2. 填写名称，Homepage URL 填入你的博客域名（如 https://blog.yourdomain.com）。
3. Authorization callback URL 填入：https://你的域名/api/auth/callback。
4. 注册后，复制 Client ID，并生成一个 Client Secret 复制下来。
5. 回到 Rin 仓库的 Secrets 设置中，新增两个 Secret：GH_CLIENT_ID 和 GH_CLIENT_SECRET，分别填入对应的值。

5. 触发自动化部署 (Build) & 绑定域名

• 进入 Rin 仓库的 Actions 选项卡。
• 如果是第一次进入，点击绿色按钮启用工作流。如果在左侧找不到 build，请先回到代码主页点击 Sync fork 同步拉取最新代码。
• 在左侧工作流列表中选择 build，点击右侧的 Run workflow 手动触发构建。
• 等待 3-5 分钟绿灯亮起，代码编译完成。此时 Cloudflare 需要 1-2 分钟同步全网节点。
• 同步完成后，在 Cloudflare 左侧菜单的 Workers 和 Pages 中，找到新部署的 Rin 服务，进入其 设置 -> 触发器 -> 自定义域，添加你的专属域名（如 blog.yourdomain.com），等待 SSL 证书自动签发即可访问并开始创作！

---

二、 效率枢纽：部署“拾光集”导航站

当探针、路由面板、内网穿透入口越来越多时，我们需要一个集中的导航页。这里强烈推荐部署“拾光集” (wangwangit/nav) 的 V2 版本。它基于 Workers + D1 + KV 构建，不仅自带边缘缓存，还大幅升级了后台安全机制（支持会话登录）。

整个部署过程分为四步，请严格按照下方的顺序和名称配置。

1. 准备基础资源：创建数据库与存储

• 创建 D1 数据库：
  • 登录 Cloudflare，选择 存储和数据库 -> D1 SQL 数据库，点击创建。名称建议填 book（位置选亚太地区）。
  • 初始化数据表：进入该数据库的 控制台 (Console)。

CREATE TABLE sites (
id INTEGER PRIMARY KEY AUTOINCREMENT,
name TEXT NOT NULL,
url TEXT NOT NULL,
logo TEXT,
“desc” TEXT,
catelog TEXT NOT NULL,
status TEXT,
sort_order INTEGER NOT NULL DEFAULT 9999,
create_time DATETIME DEFAULT CURRENT_TIMESTAMP,
update_time DATETIME DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE pending_sites (
id INTEGER PRIMARY KEY AUTOINCREMENT,
name TEXT NOT NULL,
url TEXT NOT NULL,
logo TEXT,
“desc” TEXT,
catelog TEXT NOT NULL,
status TEXT,
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE category_orders (
catelog TEXT PRIMARY KEY,
sort_order INTEGER NOT NULL DEFAULT 9999
);

• 创建 KV 命名空间（配置后台账密）：
  • 在左侧菜单找到 存储和数据库 -> KV，点击创建，名称建议填 NAV_AUTH。
  • 进入该 KV 空间，在 KV 条目 (KV Entries) 中依次添加两条数据作为你的后台凭证：
    • 第一条：键填入 admin_username，值填入你的自定义账号。
    • 第二条：键填入 admin_password，值填入你的自定义密码。(注：键名必须全小写，一字不差)

2. 部署导航站核心代码

• 在 Cloudflare 左侧菜单选择 Workers 和 Pages，点击 创建 -> 创建 Worker，给程序起个名字（如 my-nav），点击部署。
• 部署后点击 编辑代码，清空左侧的默认代码。
• 回到 拾光集 GitHub 源码库，找到 work_v2.js 文件。复制里面的所有代码，粘贴到 Cloudflare 的编辑器中，点击右上角的 部署，然后返回上一级 Worker 面板。

3. 核心绑定（⚠️ 最容易踩坑的一步）

现在代码跑起来了，但我们需要把步骤 1 创建的资源“绑定”给代码。

**避坑必读：**在 Cloudflare 体系中，“你在后台创建的资源名”和“代码读取的变量名”是两码事。代码里硬编码了特定的变量名，填错会导致站点直接崩溃报 undefined！

在当前 Worker 面板，进入 设置 -> 变量和机密 -> 绑定 (Bindings)，严格按照下表添加：

绑定类型	变量名称 (代码里的暗号，必须严格大写)	右侧资源选择
D1 数据库	NAV_DB	选择你的 D1 数据库 ( book)
KV 命名空间	NAV_AUTH	选择你的 KV 空间 ( NAV_AUTH)

(进阶设置：如果你想关闭前台访客提交链接的入口，可在“环境变量”中新增变量 ENABLE_PUBLIC_SUBMISSION，值填 false。)

4. 绑定域名与后台管理

• 配置自定义域名：在 Worker 面板进入 设置 -> 触发器 -> 自定义域，添加专属域名（例如 nav.yourdomain.com）。
• 登录后台：浏览器访问 你的域名/admin，输入你在 KV 中配置的账号密码。
• 开始使用：进入后台后，尽情添加你的 iStoreOS 面板、服务器探针和其他云端服务入口吧！设置好分类和排序后，前台主页会实时极速响应。

---

结语

至此，一套轻量化、免维护且零服务器支出的个人内容基建就彻底打通了。这种将底层架构全面交给 Serverless 与边缘计算的方案，极大地降低了我们日常运维的心智负担，让我们能够将更多时间专注投入到高价值的“内容沉淀”和矩阵运营本身。