Flowerssr bot的简单介绍
RSS基于XML标准,在互联网上被广泛采用的内容包装和投递协议。
在博客、杂志等等的地方有广泛的应用,而Flowerssr bot就是一个支持应用内即时预览的 Telegram RSS Bot。
安装教程
准备安装前请先安装Docker,安装命令
#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等软件进入你的系列,执行以下命令
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 这个冒号后面是有一个空格的。
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.kxceping.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
telegram中搜索@BotFather,然后输入/newbot,填写相关信息,即可自动生成bot token。
2、获取telegraph的token
打开浏览器,输入以下内容:
https://api.telegra.ph/createAccount?short_name=xxxxxx&author_name=xxxxx&author_url=https://xxxxxxxxxxxxxxxx
其中xxxxxx就是你将要填写的内容,分别是“简称”、“作者名”、“作者网站”,我的是kxcepinger和https://www.kxceping.com
具体例子:https://api.telegra.ph/createAccount?short_name=kxcepinger&author_name=kxcepinger&author_url=https://www.kxceping.com
3、获取telegram ID
telegram中搜索@getmyid_bot,点击“开始”,即可获得用户ID。
4、把mysql那里都注释掉,前面加#就可以。
运行部署我们直接执行下面的命令
docker run -d -v ~/flowerss:/root/.flowerss indes/flowerss-bot
我的机器人是@kxcepinger_bot
使用方法
主要分为个人订阅和频道订阅
个人订阅
/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.kxceping.com/feed,
则写成/sub https://www.kxceping.com/feed
频道订阅
/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.kxceping.com/feed