上级 项目
type
status
date
slug
summary
password
子级 项目
tags
category
moments-workers
基于 Cloudflare Workers + Hono + React 的全栈开箱即用项目,完全免费,用于记录和分享美好瞬间 ✨
功能特点
- 📝 支持用户注册、登录、权限管理(管理员/普通用户)
- 📸 图片/文件上传,文件存储于 Cloudflare KV,支持 Telegram 云端备份
- 🗂️ 记录(posts)增删改查,支持分页
- 🔒 RESTful API,基于 Basic Auth 验证
- ⚡ 前后端分离,前端基于 React + antd-mobile,后端基于 Hono 框架
- 🌍 跨域支持,适合多端部署
- 🛠️ 支持 Cloudflare D1 数据库
技术栈
- Cloudflare Workers
- Hono (API 路由)
- React 18 / antd-mobile
- Cloudflare KV / D1 Database
- Vite 构建
- Telegram Bot API(文件备份)
项目预览





部署步骤
- 克隆项目
moments-workers
chengzhnag • Updated Oct 19, 2025

- 创建cloudflareKV和D1数据库
登录cloudflare新创建KV和D1数据库



创建出来之后kv和d1都有对应的ID


- 进入D1数据库新增用户表和记录表
将上面三段代码分别执行

- 修改git仓库配置文件
需要创建Telegram Bot用于存储文件,需要科学上网。
创建 Telegram Bot 并获取 TG_BOT_TOKEN
与 TG_CHAT_ID
🚀 第一步:创建 Telegram Bot
- 打开 Telegram
在手机或电脑上启动 Telegram 应用,并登录你的账号。
- 搜索
@BotFather
在搜索栏中输入
@BotFather
,找到并点击进入 BotFather 的聊天窗口。- 创建新 Bot
在 BotFather 的聊天框中发送以下命令:
BotFather 会提示你输入 Bot 的名称和用户名。
- 设置 Bot 名称
- 名称:输入你希望的 Bot 名称(可自定义)。
- 用户名:输入 Bot 的唯一标识符(必须以
_bot
结尾,例如MyCoolBot_bot
)。
⚠️ 注意:用户名必须唯一且仅包含字母和 _bot,不能包含中文或特殊符号。
- 获取 Bot Token
成功创建后,BotFather 会返回类似以下的 Token:
请保存好这个 Token,后续所有 API 请求都需要它。
🧩 第二步:获取群组的
TG_CHAT_ID
- 将 Bot 添加到群组
- 创建一个 Telegram 群组(或使用现有群组)。
- 在群组中点击右上角的成员列表 → 添加 Bot。
- 确保 Bot 有权限接收消息(无需管理员权限)。
- 在群组中发送消息并 @Bot
- 在群组中发送任意消息,并在消息中 @Bot(例如):
Hello @MyCoolBot_bot
- 获取 Chat ID
- 打开浏览器,访问以下链接(替换
<token>
为你的 Bot Token): - 你会看到一个 JSON 格式的响应,示例如下:
- 找到
chat.id
的值(例如465512321
),这就是群组的TG_CHAT_ID
。
🧾 常见问题解答
1. 如何验证 Bot 是否正常工作?
- 使用以下链接测试 Bot 是否能向群组发送消息:
- 如果收到
ok: true
的响应,说明配置成功!
2. 如何快速获取 Chat ID?
- 使用 Bot
@getuseridbot
: - 将
@getuseridbot
添加到群组。 - 在群组中发送
/start
。 - Bot 会返回群组的 ID。
3. Token 和 Chat ID 需要保密吗?
- Token 是敏感信息,请勿公开分享。
- Chat ID 可以用于内部配置,但需确保安全性。
🛠 示例代码(Python 发送消息)
通过以上步骤,你可以轻松创建 Telegram Bot 并获取所需的
TG_BOT_TOKEN
和 TG_CHAT_ID
其他配置可直接填入保存
- 修改
wrangler.json
,设置你的 Cloudflare KV、D1、Telegram Bot Token 等。
- 主要环境变量:
TG_BOT_TOKEN
:Telegram Bot TokenTG_CHAT_ID
:Telegram 群组/用户IDDOMAIN
:你的域名DB
:Cloudflare D1 数据库绑定IMAGE
:Cloudflare KV 绑定

- 在cloudflare新建workers


等待部署完成即可,后续改动git仓库都会触发自动部署

默认分配的域名需要科学上网才可以访问,建议自定义域名。
- 账号和密码
初始账号:admin 初始密码:admin123
可在第三个数据库初始代码里修改默认的初始账号:
- 作者:团子
- 链接:https://ikun.su/article/moments-workers
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。
相关文章