Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Mystery00/telegram-channel-publisher

Publish Telegram Channel Post To Halo Moment
https://github.com/Mystery00/telegram-channel-publisher

Last synced: about 1 month ago
JSON representation

Publish Telegram Channel Post To Halo Moment

Awesome Lists containing this project

README 

        
# telegram-channel-publisher



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



[![Docker Pulls](https://img.shields.io/docker/pulls/mystery0/telegram-channel-publisher)](https://hub.docker.com/r/mystery0/telegram-channel-publisher)

[![Docker Image Size](https://img.shields.io/docker/image-size/mystery0/telegram-channel-publisher/latest)](https://hub.docker.com/r/mystery0/telegram-channel-publisher)



示例：



telegram频道： [Mystery0的随缘日常](https://t.me/Mystery0Channel)



Halo站点： [瞬间 - Mystery0の小站](https://blog.mystery0.vip/moments)



## 使用方法



```shell

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`，如果运行时找不到配置文件，会报错退出。



## 配置文件



```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需要的权限



![权限](img/bot-rights.png)



### 创建Halo的token



![创建token](img/create-halo-token.png)



创建令牌的时候，需要授予的权限如下：



- 附件查看：查询附件的信息以获取图片地址

- 附件管理：上传图片需要这个权限

- 瞬间管理：发布瞬间需要这个权限

- 瞬间查看：瞬间管理会默认授予这个权限



### 获取Halo的图片存储策略



![获取policy](img/get_policy.png)



# TODO

- [x] 支持对bot私聊

- [x] 多张图片合起来发送瞬间

- [x] 支持命令删除瞬间

- [ ] 支持内容中包含emoji表情



# FAQ



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



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



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



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



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



3. 为什么图片这么糊？



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



4. Emoji表情不支持吗？解析错位了



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



5. 遇到了其他的问题？



> 欢迎提issue告诉我