Skip to content

Latest commit

 

History

History
138 lines (102 loc) · 5.62 KB

README.md

File metadata and controls

138 lines (102 loc) · 5.62 KB

telegram-channel-publisher

将Telegram频道的内容发布到其他地方,例如Halo的瞬间

Docker Pulls Docker Image Size

示例:

telegram频道: Mystery0的随缘日常

Halo站点: 瞬间 - Mystery0の小站

使用方法

docker run -d \
    -e CONFIG_HOME=/app/etc \
    -v /path/to/logs:/app/logs \
    -v /path/to/config.yaml:/app/etc/config.yaml \
    mystery0/telegram-channel-publisher:latest

/app/logs 是运行时的日志目录,如果出现无法启动的情况,建议单独挂载出来,方便查看日志。

/app/etc 是配置文件目录,对应环境变量 CONFIG_HOME

环境变量是指定服务使用的配置文件的目录,配置文件的名称必须是config.yaml,如果运行时找不到配置文件,会报错退出。

配置文件

bot:
  # 机器人的token
  token: "XXXXXXXXXXXXXXXXXXXX"
  # 机器人的接入点信息,如果部署的服务器无法访问Telegram,可以使用代理的形式来访问,可以参考以下链接自行搭建
  # https://blog.mystery0.vip/archives/cloudflare_worker_proxy_telegram
  # 填写格式 "https://cfworker.xyz.com"
  endpoint: ""
  media:
    # 媒体消息处理延迟时间,单位为秒,如果不需要延迟,可以设置为0,收到带图片的消息之后会延迟指定时间再处理,目的是为了接收到完整的图片组
    delay: 5
  channel:
    # 是否启用频道消息的处理
    enable: true
    # 指定频道id,如果指定,那么只有对应频道的消息才会被处理,如果不指定,那么所有频道的消息都会被处理
    id: ""
    # 需要过滤的频道消息,这里可以填上对应的标签,例如:["tag1", "tag2"],那么就会过滤任何包含 “#tag1”、“#tag2” 的消息
    filter: [ ]
    reply:
      # 注意:频道消息启用回执需要给机器人对应的发布消息、删除消息的权限,否则无法正常工作,详情见下图
      # 是否启用处理回执,如果启用,那么会在处理完消息之后,会发送一条处理结果
      enable: true
      # 回执自动删除时间,单位为秒,如果不需要自动删除,可以设置为0,如果启用了回执,那么会在指定时间之后自动删除回执
      delay: 10
  private:
    # 是否启用私聊消息的处理
    enable: true
    # 指定用户id,如果指定,那么只有对应用户的消息才会被处理,如果不指定,那么所有用户的消息都会被处理
    sender: ""
    reply:
      # 是否启用处理回执,如果启用,那么会在处理完消息之后,会发送一条处理结果
      enable: true
      # 回执自动删除时间,单位为秒,如果不需要自动删除,可以设置为0,如果启用了回执,那么会在指定时间之后自动删除回执
      delay: 10

log:
  home: "logs"
  file: "publisher.log"
  color: false
  local: false
  # 调试模式,出现问题的时候建议打开,会输出更多的日志信息
  debug: true

publisher:
  # 发布的类型,目前只支持log和halo,log是将内容输出到日志文件,halo是将内容发布到Halo的瞬间
  type: "halo"

halo:
  # Halo的访问域名
  host: "https://blog.mystery0.vip"
  # Halo的token 参考下图进行创建
  token: "pat_XXXXXXXX"
  image:
    # 消息中的图片的分组信息,最好是在管理后台自己创建一个分组专门放瞬间的图片,方便管理,可为空
    group: "attachment-group-XXXXXXXX"
    # 消息中的图片的存储策略,参考后续内容进行获取
    policy: "attachment-policy-XXXXXXXX"

Telegram Bot需要的权限

权限

创建Halo的token

创建token

创建令牌的时候,需要授予的权限如下:

  • 附件查看:查询附件的信息以获取图片地址
  • 附件管理:上传图片需要这个权限
  • 瞬间管理:发布瞬间需要这个权限
  • 瞬间查看:瞬间管理会默认授予这个权限

获取Halo的图片存储策略

获取policy

TODO

  • 支持对bot私聊
  • 多张图片合起来发送瞬间
  • 支持命令删除瞬间
  • 支持内容中包含emoji表情

FAQ

  1. 为什么配置好了之后在频道发送消息没有反应?但是私聊会有反应?

检查一下机器人的权限,需要有读取消息的权限,Telegram的频道中,机器人需要被设置为管理员才能读取到消息

  1. 服务运行一会之后出现 Conflict: can't use getUpdates method while webhook is active; use deleteWebhook to delete the webhook first

请检查服务使用的bot有没有在其他地方使用,例如其他的机器人服务,如果有,请停止其他的服务,或者使用不同的bot

Telegram的bot api有一个限制,同一个bot不能多次设置webhook,否则会报错

  1. 为什么图片这么糊?

目前已经是获取 Telegram 给的最高分辨率的图了,bot api似乎没给原图的接口,如果有,欢迎提issue告诉我

  1. Emoji表情不支持吗?解析错位了

Emoji表情在 Telegram 的预解析中所占长度与 Go 获取的不一致,因此会出现emoji表情后的所有内容都错位的情况,目前还没找到解决方案,如果有,欢迎提issue告诉我

  1. 遇到了其他的问题?

欢迎提issue告诉我