返回资讯中心
外部精选
软件工程
#开发者实时流

青椒味发布可在Cloudflare免费层自托管的小组后端

来源标题:A self-hosted small-group back end on a Cloudflare free tier

青椒味(QJW)推出面向教会小组的自托管后端,会议、讲道、考勤等数据全部存于用户自己 Cloudflare 账户的 SQLite 数据库,且完全运行在免费层。成员可通过官方下载页或网页端使用客户端,后端只负责提供小组数据和二维码。部署需通过部署按钮新建仓库以初始化 D1,不能手动导入源码仓库。

Hacker News 最新davidliuus6662026/11/3 · 14 天前15 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

给小组负责人:请先读 START-HERE.md。不需要技术背景。 教会技术志愿者?请读 FOR-CHURCH-TECH.md——你要承担什么、要花多少钱,以及它做不到什么。 还在犹豫是否要自托管?请读这篇文章——小组实际存储了什么,自己拥有这些数据要付出什么代价。 给维护者:发布检查清单见 DEPLOY_BUTTON.md。 要绑定自己的域名:请读 DOMAIN.md。 中文说明见 README.zh-CN.md。

QJW 是青椒味的英文名,这是一款用于教会聚会、讲道和课程的小组应用。这是面向希望自己掌控数据的小组的自托管后端:聚会、讲道系列、公告、测验、作业、签到和代祷请求,全部存放在你自己 Cloudflare 账户里的一个 SQLite 数据库中。它完全运行在 Cloudflare 的免费套餐上:

成员从哪里获取应用:客户端发布在官方下载页面,不由这个后端发布。成员也可以直接使用 Web 应用,无需安装任何东西。这个后端只负责提供你们小组的数据和二维码。

不要使用 Workers & Pages → Create → Import a repository。连接 GitHub 之后,让按钮创建一个新仓库。只有这样才会创建 D1。手动导入源码仓库会跳过 D1,并在部署步骤失败。

成员使用手机应用或 Web 应用。这个仓库是它们所通信的后端。

一个 Cloudflare 账户(免费,用邮箱注册) 一个你自行设定的一次性设置码,至少 8 个字符(仅在你首次打开管理后台时使用) 若要一键部署:一个 GitHub 账户(按钮会把代码复制到你自己的仓库)

一键部署(新手路径) 点击上方的 Deploy to Cloudflare。 登录 GitHub 和 Cloudflare。GitHub 连接完成后,让 Cloudflare 创建一个新仓库。不要使用 Workers & Pages → Create → Import a repository;那条路径不会创建 D1,会在部署时失败。如果名字已被占用,Cloudflare 会加上一个数字,比如 qingjiaowei-selfhost2,这是正常的。 取一个名字,输入你自行设定的设置码(至少 8 个字符),然后点击部署。把设置码记下来;它不是你的 GitHub 或 Cloudflare 密码。 等待 2–3 分钟。在 Worker 页面上,打开 Settings → Domains & Routes。如果 workers.dev 显示为 Disabled,点击 Enable。如果页面显示 No URLs enabled,也是同一个页面。地址形如 https://<worker-name>.<your-subdomain>.workers.dev。 在该地址后面加上 /admin 打开。输入同一个设置码、一个小组名称和一个管理员密码(至少 8 个字符)。然后生成一个二维码。 把官方下载页面和 Web 应用发给成员;他们先安装应用(或打开 Web 应用),再进行扫码。 如果 /admin 提示“SETUP_CODE is still the example value”,请前往 Settings → Variables and Secrets,把 SETUP_CODE 替换成你自己的设置码,保存,然后在 /admin 输入这个新设置码。示例值会被故意拒绝。

优先使用上面的按钮。它已经过真实 Cloudflare 部署验证。如果它不起作用,以下手动步骤仍可作为备选方案。 npm install npx wrangler login

创建一个 D1 数据库,然后把打印出的 database_id 填入 wrangler.jsonc

npx wrangler d1 create qingjiaowei-selfhost

部署

npm run deploy

设置一次性设置码(至少 8 个字符;不要保留示例值)

npx wrangler secret put SETUP_CODE 部署完成后,打开: https://<your-worker-name>.<your-workers-subdomain>.workers.dev/admin 如果 Worker 页面显示 No URLs enabled 或 workers.dev 为 Disabled,请先打开 Settings → Domains & Routes → workers.dev → Enable。确切地址会显示在那里。 之后,打开 Access,生成一个二维码,并分享给小组。成员通过在应用中扫码加入。

SETUP_CODE 在自托管版本中是必需的,至少 8 个字符,且不能是示例值。否则首次设置会被拒绝,这样公开的 URL 就不会被陌生人抢先占用。 如果 /admin 提示设置码仍是示例值,请在 Settings → Variables and Secrets 下替换 SETUP_CODE,保存,然后输入新的设置码。

支持。把域名放在同一个 Cloudflare 账户下,然后在 Worker 上打开 Settings → Domains & Routes → Add → Custom Domain,输入 qjw.example.com。Cloudflare 会自动创建 DNS 记录和证书;无需修改代码。 Deploy to Cloudflare 按钮无法完成这一步:域名注册和名称服务器变更都在 Cloudflare 之外进行。完整步骤见 DOMAIN.md,其中也包含 DNSHE 免费域名方案。

cp .dev.vars.example .dev.vars

把 .dev.vars 中的示例 SETUP_CODE 替换成你自己的

npm run dev 打开 http://localhost:8789/admin。本地开发也走同样的首次设置流程。

媒体库和上传按钮会被隐藏,图片字段只接受 URL。请粘贴公开的直接链接: 文件上传 / 媒体库(需要完整的 R2 版本) 一键按钮自动绑定自定义域名(域名和名称服务器属于你自己;部署后按 DOMAIN.md 手动绑定) 自动升级(重新部署即可更新) 多租户或计费

安全提示 切勿提交 .dev.vars、管理员密码或 Cloudflare API token。 设置码只能使用一次,设置管理员密码后即失效。 忘记管理员密码目前需要重新部署或修改数据库。重置流程已在计划中。

界面语言 设置页、登录页、管理后台和课堂页面都支持中文和英文。 语言默认跟随浏览器。用右上角的开关切换;选择会记住在这个浏览器中。 你自己输入的文本(小组名称、标题、通知等)不会自动翻译。 手机应用支持中文和英文。它默认跟随手机语言;你可以在 Settings → Interface language 中更改。

如果这个项目对你有用 点一颗星,能帮下一位小组负责人找到它。这就是全部所求。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →