Notify when rss feeds are updated | RSS 更新通知

INK RSS

• 介绍

• 特点

• 项目背景

• TODO

• 注意事项

• 部署

• 额外附赠

• 使用建议

• 调查

• 贡献

• 作者

• 协议

介绍

特点

项目背景

TODO

关键词过滤

翻译功能

多语言支持

注意事项

对于所有项目都可以使用网页进行订阅

使用 telegram 不仅可以使用网页，还包含借助 telegraph 提供的即时预览功能（instant view）以及一个提供增删查功能的机器人。部署后访问

https://api.telegram.org/bot<your token>/setwebhook?url=https://example.com/secret_path

即可开始使用 bot 进行订阅，注意替换 token 以及 url

连续更新 15 次失败后将会收到错误通知，并将暂时关闭此订阅源更新，如确认订阅源无误，可自行在网页中开启更新。如无法确保订阅源的高可用性，也可在配置中调高此数值。

由于 workers 的限制，无法自行解析 xml，需要配置 PARSE_URL 用于提供解析功能，可以点击以下按钮自行部署，或者适量使用我已部署的 https://inkrssparse.vercel.app

1. 需要配置 SECRET_PATH,网页将部署在https://inkrss.example.workers.dev/secret_path 请仅使用大小写字母和数字进行编写。

部署

• 前期准备

在官网注册 cloudflare 账号，验证邮箱后找到 workers 界面，选择一个子域如 inkrss.workers.dev 即可。

畅通无阻的网络。

安装 wrangler
推荐根据官方文档进行安装，以避免不确定的问题。
在nodejs 官网安装 nodejs（选择长期支持版即可）安装后运行

npm i @cloudflare/wrangler -g

如果在命令行输入以下命令成功输出版本号，即安装成功。

wrangler -V

wrangler 登录

wrangler login

在一般情况下，会打开浏览器申请授权，授权后即成功登陆，可以跳转到下一步。但有些情况 wrangler 会收不到返回的 token，此时应使用另一种方式登陆.
在api tokens 界面 找到创建令牌，选择编辑 cloudflare workers 模版，账户资源选择所有账户，区域资源选择所有区域其他默认即可点击确定并复制 api token。

wrangler config

• 开始部署

克隆本项目并解压，复制 wrangler.example.toml 内容建立新配置文件 wrangler.toml
在文件夹目录打开命令行（windows 用户可直接在资源管理器输入 cmd 并回车）

wrangler kv:namespace create "KV"

根据提示将输出的内容粘贴在 wrangler.toml 文件中 kv_namespaces 位置。

配置
在 cloudflare 网页找到自己的 account id,粘贴在 wrangler.toml 的对应位置。



选择你的通知方式，出于覆盖性考虑目前支持以下方式，将支持 Slack，Discord，钉钉等其他通知方式。
• telegram（包括即时预览和机器人订阅，功能丰富，受限于网络）
• bark（部署最便捷，受限于平台）
• wechat（部署较麻烦，仅支持纯文本，适用性广）
定义 wrangler.toml 中环境变量 [vars]，其中必须定义的有：
• NOTIFIER 为想要的通知方式
• SECRET_PATH 为 UI 页面路径
• PARSE_URL 为 Feed Parser
然后根据所选通知方式，根据 config 文件夹的指定文件夹中 readme 配置其他相应变量，如BARK_URL。

发布

wrangler publish



wrangler 会自动安装相应的依赖，进行打包和上传，并返回一个部署好的 url,之后就可以立即在https://ink-rss.xxx.workers.dev/secret_path 访问到前端进行订阅.但由于cloudflare的一些延迟，定时计划可能在半小时后才会开始运行

多环境（Workers）
可以在 wrangler.toml 中定义多个环境，并通过命令行发布，如若去掉 wrangler.example.toml 中的注释，并如下配置：

# Environments / Multiple Workers
[env.production]
name = "inkrss-prod"

kv_namespaces = [
 { binding = "KV", id = "" }
]

[env.production.vars]
NOTIFIER = "telegram" # bark, telegram or wechat

PARSE_URL = "https://inkrssparse.vercel.app"
SECRET_PATH = "subscriptions"

# Telegram notification
TELEGRAPH_TOKEN = ""
TG_TOKEN = ""

TG_SENDID = "@channel_name"
TG_USERID = 12345678

即可使用以下命令行来部署新的 Worker

$ wrangler publish -e production

具体 wrangler.toml 多环境配置请参考：
• https://developers.cloudflare.com/workers/platform/environments
• https://developers.cloudflare.com/workers/cli-wrangler/configuration

额外附赠

IOS 桌面小插件



默认部署后的 url 很长，使用此小部件可以一键跳转，并展示基本信息。

功能丰富的telegram bot（还没有做完）
cloudflare workers开发机器人只能使用过时的框架并且开发体验较差。目前仅支持四个命令/list /sub /unsub /unsuball
具有完整功能以及行内键盘支持的机器人将部署在其他无服务器平台

使用建议

• 由于对 cpu 时间的限制，cloudflare worker 会分批进行监测，如果订阅数过多，或者希望多渠道接收消息，只需要在 wrangler.toml 中修改名称重新部署即可部署多个 worker。

• 频繁的通知提醒会打扰到正常的生活，建议适量订阅。

• 建议和阅读器结合使用。

调查

贡献

作者

协议