Flowerssr bot的简单介绍
RSS基于XML标准,在互联网上被广泛采用的内容包装和投递协议。
在博客、杂志等等的地方有广泛的应用,而Flowerssr bot就是一个支持应用内即时预览的 Telegram RSS Bot。
安装教程
准备安装前请先安装Docker,安装命令
1 2 3 4 5 6 7 8 9 10 11 |
#CentOS 6系统 rpm -iUvh http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm yum update -y yum -y install docker-io service docker start chkconfig docker on #CentOS 7、Debian、Ubuntu系统 curl -sSL https://get.docker.com/ | sh systemctl start docker systemctl enable docker |
使用Putty或是Xshell等软件进入你的系列,执行以下命令
1 2 3 4 |
mkdir ~/flowerss &&\ wget -O ~/flowerss/config.yml \ https://raw.githubusercontent.com/indes/flowerss-bot/master/config.yml.sample |
然后我们需要编辑一下config.yml文件,具体用WinSCP或是宝塔文件管理(docker也可以在宝塔面板里安装)都可以。
新手不建议使用vim命令直接编辑。
文件所在目录:/root/flowerss/config.yml
打开之后参考下面的配置,这里还有一个小坑,bot_token: xxxxx:xxxxxxxxxxxxxxxxxxxx 这个冒号后面是有一个空格的。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 |
bot_token: xxxxx:xxxxxxxxxxxxxxxxxxxx #Telegram机器人的密钥 telegraph_token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx #telegraph的密钥 #多个telegraph_token可采用数组格式: # telegraph_token: # - token_1 # - token_2 telegraph_account: kxcepinger telegraph_author_name: kxcepinger telegraph_author_url: https://www.771633.com socks5: #用于无法正常 Telegram API 的环境,正常情况下忽略 update_interval: 10 #更新时间 user_agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36 # mysql: # host: # port: # user: # password: # database: # telegram: # endpoint: log: level: release db_log: false # 打印数据库日志,false则只会打印数据库错误日志 # file: ./flowerss.log sqlite: path: /root/.flowerss/data.db allowed_users: - xxxxxxxxxx #输入telegram ID |
各个参数的含义
配置项 | 含义 | 是否必填 |
---|---|---|
bot_token | Telegram Bot Token | 必填 |
telegraph_token | Telegraph Token, 用于转存原文到 Telegraph | 可忽略(不转存原文到 Telegraph ) |
preview_text | 纯文字预览字数(不借助Telegraph) | 可忽略(默认0, 0为禁用) |
user_agent | User Agent | 可忽略 |
disable_web_page_preview | 是否禁用 web 页面预览 | 可忽略(默认 false, true 为禁用) |
update_interval | RSS 源扫描间隔(分钟) | 可忽略(默认 10) |
error_threshold | 源最大出错次数 | 可忽略(默认 100) |
socks5 | 用于无法正常 Telegram API 的环境 | 可忽略(能正常连接上 Telegram API 服务器) |
mysql | MySQL 数据库配置 | 可忽略(使用 SQLite ) |
sqlite | SQLite 配置 | 可忽略(已配置mysql时,该项失效) |
telegram.endpoint | 自定义telegram bot api url | 可忽略(使用默认api url) |
allowed_users | 允许使用bot的用户telegram id, | 可忽略,为空时所有用户都能使用bot |
我们这里需要修改的还是比较少的,下面是我们要用到的。
1、获取telegram bot的token
1 |
telegram中搜索@BotFather,然后输入/newbot,填写相关信息,即可自动生成bot token。 |
2、获取telegraph的token
1 2 3 4 5 6 |
打开浏览器,输入以下内容: https://api.telegra.ph/createAccount?short_name=xxxxxx&author_name=xxxxx&author_url=https://xxxxxxxxxxxxxxxx 其中xxxxxx就是你将要填写的内容,分别是“简称”、“作者名”、“作者网站”,我的是kxcepinger和https://www.771633.com 具体例子:https://api.telegra.ph/createAccount?short_name=kxcepinger&author_name=kxcepinger&author_url=https://www.771633.com |
3、获取telegram ID
1 |
telegram中搜索@getmyid_bot,点击“开始”,即可获得用户ID。 |
4、把mysql那里都注释掉,前面加#就可以。
运行部署我们直接执行下面的命令
1 2 |
docker run -d -v ~/flowerss:/root/.flowerss indes/flowerss-bot |
我的机器人是@kxcepinger_bot
使用方法
主要分为个人订阅和频道订阅
个人订阅
1 2 3 4 5 6 7 8 9 10 11 12 13 |
/sub [url] 订阅(url 为可选) /unsub [url] 取消订阅(url 为可选) /list 查看当前订阅 /set 设置订阅 /check 检查当前订阅 /setfeedtag [sub id] [tag1] [tag2] 设置订阅标签(最多设置三个Tag,以空格分隔) /setinterval [interval] [sub id] 设置订阅刷新频率(可设置多个sub id,以空格分隔) /activeall 开启所有订阅 /pauseall 暂停所有订阅 /import 导入 OPML 文件 /export 导出 OPML 文件 /unsuball 取消所有订阅 /help 帮助 |
就其中的
/sub
指令举个例子,我的RSS订阅为https://www.771633.com/feed,
则写成/sub https://www.771633.com/feed
频道订阅
1 2 3 4 5 6 7 8 9 10 |
/sub @ChannelID [url] 订阅 /unsub @ChannelID [url] 取消订阅 /list @ChannelID 查看当前订阅 /check @ChannelID 检查当前订阅 /unsuball @ChannelID 取消所有订阅 /activeall @ChannelID 开启所有订阅 /setfeedtag @ChannelID [sub id] [tag1] [tag2] 设置订阅标签(最多设置三个Tag,以空格分隔) /import 导入 OPML 文件 /export @ChannelID 导出 OPML 文件 /pauseall @ChannelID 暂停所有订阅 |
同样的,举个例子,我的频道是@kxceping,
则写成/sub @kxceping https://www.771633.com/feed