TelegramForwarder

TelegramForwarder

一个功能强大的 Telegram 消息转发器,支持多源转发、关键词过滤、正则替换、黑白名单,AI处理等功能。

Stars: 75

Visit
 screenshot

Telegram Forwarder is a message forwarding tool that allows you to forward messages from specified chats to other chats without the need for a bot to enter the corresponding channels/groups to listen. It can be used for information stream integration filtering, message reminders, content archiving, and more. The tool supports multiple sources forwarding, keyword filtering in whitelist and blacklist modes, regular expression matching, message content modification, AI processing using major vendors' AI interfaces, media file filtering, and synchronization with a universal forum blocking plugin to achieve three-end blocking.

README:

img

Telegram 转发器 | Telegram Forwarder

Docker License: GPL-3.0

📋 目录

📖 简介

Telegram 转发器是一个消息转发工具,只需要你的账号加入频道/群聊即可以将指定聊天中的消息转发到其他聊天,不需要bot进入对应的频道/群组即可监听。可用于信息流整合过滤消息提醒内容收藏等多种场景。

✨ 特性

  • 🔄 多源转发:支持从多个来源转发到指定目标
  • 🔍 关键词过滤:支持白名单和黑名单模式
  • 📝 正则匹配:支持正则表达式匹配目标文本
  • 📋 内容修改:支持多种方式修改消息内容
  • 🤖 AI 处理:支持使用各大厂商的AI接口
  • 📹 媒体过滤:支持过滤指定类型的媒体文件
  • 🔗 联动同步:支持与通用论坛屏蔽插件联动同步,实现三端屏蔽

🚀 快速开始

1️⃣ 准备工作

  1. 获取 Telegram API 凭据:

  2. 获取机器人 Token:

    • 与 @BotFather 对话创建机器人
    • 获取机器人的 BOT_TOKEN
  3. 获取用户 ID:

    • 与 @userinfobot 对话获取你的 USER_ID

2️⃣ 配置环境

新建文件夹

mkdir ./TelegramForwarder && cd ./TelegramForwarder

新建.env文件,填写参数,或者直接下载仓库的.env.example文件

wget https://raw.githubusercontent.com/Heavrnl/TelegramForwarder/refs/heads/main/.env.example -O .env
# Telegram API 配置 (从 https://my.telegram.org/apps 获取)
API_ID=
API_HASH=

# 用户账号登录用的手机号 (格式如: +8613812345678)
PHONE_NUMBER=

# Bot Token
BOT_TOKEN=

# 用户ID (从 @userinfobot 获取)
USER_ID=

# 默认最大媒体文件大小限制(单位:MB)
DEFAULT_MAX_MEDIA_SIZE=15

# 是否开启调试日志 (true/false)
DEBUG=false

# 数据库配置
DATABASE_URL=sqlite:///./db/forward.db

# UI 布局配置
AI_MODELS_PER_PAGE=10
KEYWORDS_PER_PAGE=10
SUMMARY_TIME_ROWS=10  
SUMMARY_TIME_COLS=6
DELAY_TIME_ROWS=10
DELAY_TIME_COLS=
MEDIA_SIZE_ROWS=10
MEDIA_SIZE_COLS=6


# 默认AI模型
DEFAULT_AI_MODEL=gemini-2.0-flash

# OpenAi API Key
# 留空使用官方接口 https://api.openai.com/v1
OPENAI_API_KEY=your_openai_api_key
OPENAI_API_BASE=  

# Claude API Key
# 默认使用官方接口
CLAUDE_API_KEY=your_claude_api_key

# Gemini API Key
# 默认使用官方接口
GEMINI_API_KEY=your_gemini_api_key

# DeepSeek API Key
# 留空使用官方接口 https://api.deepseek.com/v1
DEEPSEEK_API_KEY=your_deepseek_api_key
DEEPSEEK_API_BASE=  

# Qwen API Key
# 留空使用官方接口 https://dashscope.aliyuncs.com/compatible-mode/v1
QWEN_API_KEY=your_qwen_api_key
QWEN_API_BASE=  

# Grok API Key
# 留空使用官方接口 https://api.x.ai/v1
GROK_API_KEY=your_grok_api_key
GROK_API_BASE=     

# 默认AI提示词
DEFAULT_AI_PROMPT=请尊重原意,保持原有格式不变,用简体中文重写下面的内容:

# 默认AI总结提示词
DEFAULT_SUMMARY_PROMPT=请总结以下频道/群组24小时内的消息。
# 默认总结时间
DEFAULT_SUMMARY_TIME=07:00
# 默认时区
DEFAULT_TIMEZONE=Asia/Shanghai

# AI总结每次爬取消息数量
SUMMARY_BATCH_SIZE=20
# AI总结每次爬取消息间隔时间(秒)
SUMMARY_BATCH_DELAY=2


######### 扩展内容 #########

# 是否开启与通用论坛屏蔽插件服务端的同步服务 (true/false)
UFB_ENABLED=false
# 服务端地址
UFB_SERVER_URL=
# 用户API_KEY
UFB_TOKEN=

新建 docker-compose.yml 文件,内容如下:

services:
  telegram-forwarder:
    image: heavrnl/telegramforwarder:latest
    container_name: telegram-forwarder
    restart: unless-stopped
    volumes:
      - ./db:/app/db
      - ./.env:/app/.env
      - ./sessions:/app/sessions
      - ./temp:/app/temp
      - ./ufb/config:/app/ufb/config
      - ./config:/app/config
    stdin_open: true
    tty: true

3️⃣ 启动服务

首次运行(需要验证):

docker-compose run -it telegram-forwarder

CTRL+C 退出容器

修改 docker-compose.yml 文件,修改 stdin_open: falsetty: false

后台运行:

docker-compose up -d

4️⃣ 更新

注意:docker-compose运行不需要拉取仓库源码,除非你打算自己build,否则只需要在项目目录执行以下命令即可更新。

docker-compose down
docker-compose pull
docker-compose up -d

📚 使用指南

🌟 基础使用示例

假设订阅了频道 "TG 新闻" (https://t.me/tgnews) 和 "TG 阅读" (https://t.me/tgread) ,但想过滤掉一些不感兴趣的内容:

  1. 创建一个 Telegram 群组/频道(例如:"My TG Filter")

  2. 将机器人添加到群组/频道,并设置为管理员

  3. 新创建的群组/频道中发送命令:

    /bind https://t.me/tgnews 或者 /bind "TG 新闻"
    /bind https://t.me/tgread 或者 /bind "TG 阅读"
  4. 设置消息处理模式:

    /settings

    选择要操作的对应频道的规则,根据喜好设置

    详细设置说明请查看 🛠️ 功能详解

  5. 添加屏蔽关键词:

    /add 广告 推广 '这是 广告'
  6. 如果发现转发的消息格式有问题(比如有多余的符号),可以使用正则表达式处理:

    /replace \*\*

    这会删除消息中的所有 ** 符号

注意:以上增删改查操作,只对第一个绑定的规则生效,示例里是TG 新闻。若想对TG 阅读进行操作,需要先使用/settings(/s),选择TG 阅读,再点击"应用当前规则",就可以对此进行增删改查操作了。也可以使用/add_all(/aa)/replace_all(/ra)等指令同时对两条规则生效

这样,你就能收到经过过滤和格式化的频道消息了

🔧 特殊使用场景示例

TG频道的部分消息由于文字嵌入链接,点击会让你确认再跳转,例如nodeseek的官方通知频道

频道的原始消息格式

[**贴子标题**](https://www.nodeseek.com/post-xxxx-1)

可以对通知频道的转发规则依次使用以下指令

/replace \*\*
/replace \[(?:\[([^\]]+)\])?([^\]]+)\]\(([^)]+)\) [\1]\2\n(\3)
/replace \[\]\s*

最后所有转发过来的消息都会变成以下格式,这样直接点击链接就无需确认跳转了

贴子标题
(https://www.nodeseek.com/post-xxxx-1)

🛠️ 功能详解

⚡ 过滤流程

首先要清楚消息过滤顺序,括号里对应设置里的选项:

flowchart TD
    A["延迟处理过滤器(延迟处理)"] --> B["关键字过滤器(对应过滤模式/过滤关键字时是否附带发送者名称和ID)"]
    B --> C["替换过滤器(替换模式)"]
    C --> D["AI处理过滤器(使用AI处理消息)"]
    D --> E["信息过滤器(添加原始链接/发送者/时间)"]
    E --> K["评论区按钮过滤器(添加评论区直达按钮)"]
    K --> F["媒体过滤器(处理媒体内容,对应.env里的MAX_MEDIA_SIZE)"]
    F --> J{"处理模式判断(根据规则配置判断后续处理方式)"}
    J -->|编辑模式| G["编辑过滤器(编辑消息)"]
    J -->|转发模式| H["发送过滤器(发送消息,对应预览模式/消息格式/转发方式)"]
    G --> I["删除原始消息过滤器(删除原始消息)"]
    H --> I

    classDef filter fill:#f5f5f5,stroke:#333,stroke-width:1px;
    class A,B,C,D,E,F,G,H,I,K filter;
    classDef decision fill:#f5f5f5,stroke:#333,stroke-width:1px;
    class J decision;

⚙️ 设置说明

主设置界面 AI设置界面 媒体设置界面
img img img

主设置说明

以下对设置选项进行说明

设置选项 说明
应用当前规则 选择后,关键字指令(/add,/remove_keyword,/list_keyword等)和替换指令(/replace,/list_replace等)的增删改查导入导出将作用于当前规则
是否启用规则 选择后,当前规则将被启用,否则将被禁用
当前关键字添加模式 点击可切换黑/白名单模式,由于黑白名单是分开处理的,需要手动切换
过滤关键字时是否附带发送者名称和ID 启用后,过滤关键字时会包含发送者名称和ID信息(不会添加到实际消息中),可用于针对特定用户进行过滤
处理模式 可切换编辑/转发模式。编辑模式下会直接修改原消息;转发模式下会将处理后的消息转发到目标聊天。注意:编辑模式仅适用于你是管理员的且原消息是频道消息或群组中自己发送的消息
过滤模式 可切换仅黑名单/仅白名单/先黑后白/先白后黑模式。由于黑白名单分开存储,可根据需要选择不同的过滤方式
转发模式 可切换用户/机器人模式。用户模式下使用用户账号转发消息;机器人模式下使用机器人账号发送消息
替换模式 启用后将根据已设置的替换规则对消息进行处理
消息格式 可切换Markdown/HTML格式,在最终发送阶段生效,一般使用默认的Markdown即可
预览模式 可切换开启/关闭/跟随原消息。开启后会预览消息中的第一个链接,默认跟随原消息的预览状态
原始发送者/原始链接/发送时间 启用后会在消息发送时添加这些信息,默认关闭
延时处理 启用后会按设定的延迟时间重新获取原消息内容,再开始处理流程,适用于频繁修改消息的频道/群组,可在 config/delay_time.txt 中添加自定义延迟时间
删除原始消息 启用后会删除原消息,使用前请确认是否有删除权限
评论区直达按钮 启用后在转发后的消息下发添加评论区直达按钮,前提是原消息有评论区

媒体设置说明

设置选项 说明
媒体类型过滤 启用后会过滤掉非选中的媒体类型
选择的媒体类型 选择要屏蔽的媒体类型,注意:Telegram对媒体文件的分类是固定的,主要就是这几种,图片 (photo),文档 (document),视频 (video),音频 (audio),语音 (voice),其中所有不属于图片、视频、音频、语音的文件都会被归类为"文档"类型。比如病毒文件(.exe)、压缩包(.zip)、文本文件(.txt)等,在 Telegram 中都属于"文档"类型。
媒体大小过滤 启用后会过滤掉超过设置大小的媒体
媒体大小限制 设置媒体大小限制,单位:MB,可在 config/media_size.txt 中添加自定义大小
媒体大小超限时发送提醒 启用后媒体超限会发送提醒消息
媒体扩展名过滤 启用后会过滤掉选中的媒体扩展名
媒体扩展名过滤模式 切换黑/白名单模式
选择的媒体扩展名 选择要过滤的的媒体扩展名,可在 config/media_extensions.txt 中添加自定义扩展名

🤖 AI功能

项目内置了各大厂商的AI接口,可以帮你:

  • 自动翻译外语内容
  • 定时总结群组消息
  • 智能过滤广告信息
  • 自动为内容打标签 ....

配置

  1. .env 文件中配置你的 AI 接口:
# OpenAI API
OPENAI_API_KEY=your_key
OPENAI_API_BASE=  # 可选,默认官方接口

# Claude API
CLAUDE_API_KEY=your_key

# 其他支持的接口...

自定义模型

没找到想要的模型名字?在 config/ai_models.txt 中添加即可。

AI 处理

AI处理提示词中可以使用以下格式:

  • {source_message_context:数字} - 获取源聊天窗口最新的指定数量消息
  • {target_message_context:数字} - 获取目标聊天窗口最新的指定数量消息
  • {source_message_time:数字} - 获取源聊天窗口最近指定分钟数的消息
  • {target_message_time:数字} - 获取目标聊天窗口最近指定分钟数的消息

定时总结

开启定时总结后,机器人会在指定时间(默认每天早上 7 点)自动总结过去 24 小时的消息。

  • 可在 config/summary_time.txt 中添加多个总结时间点
  • .env 中设置默认时区
  • 自定义总结的提示词

注意:总结功能会消耗较多的 API 额度,请根据需要开启。

🎯 特殊功能

🔗 链接转发功能

向bot发送消息链接,即可把那条消息转发到当前聊天窗口,无视禁止转发和复制的限制(虽然我们转发器本身的功能就无视该限制...

🔄 与通用论坛屏蔽插件联动

https://github.com/heavrnl/universalforumblock

确保.env文件中已配置相关参数,在已经绑定好的聊天窗口中使用/ufb_bind <论坛域名>,即可实现三端联动屏蔽,使用/ufb_item_change切换要同步当前域名的主页关键字/主页用户名/内容页关键字/内容页用户名

📝 命令列表

命令列表

基础命令
/start - 开始使用
/help(/h) - 显示此帮助信息

绑定和设置
/bind(/b) <聊天窗口链接/聊天窗口名字> - 绑定源聊天
/settings(/s) - 管理转发规则
/changelog(/cl) - 查看更新日志

转发规则管理
/copy_rule(/cr) <规则ID> - 复制指定规则的所有设置到当前规则
/delete_rule(/dr) <规则ID> [规则ID] [规则ID] ... - 删除指定规则
/list_rule(/lr) - 列出所有转发规则

关键字管理
/add(/a) <关键字> - 添加普通关键字
/add_regex(/ar) <正则表达式> - 添加正则表达式
/add_all(/aa) <关键字> - 添加普通关键字到所有规则
/add_regex_all(/ara) <正则表达式> - 添加正则关键字到所有规则
/list_keyword(/lk) - 列出所有关键字
/remove_keyword(/rk) <关键词1> [关键词2] - 删除关键字
/clear_all_keywords(/cak) - 清除当前规则的所有关键字
/clear_all_keywords_regex(/cakr) - 清除当前规则的所有正则关键字
/copy_keywords(/ck) <规则ID> - 复制指定规则的关键字到当前规则
/copy_keywords_regex(/ckr) <规则ID> - 复制指定规则的正则关键字到当前规则
/copy_replace(/crp) <规则ID> - 复制指定规则的替换规则到当前规则
/copy_rule(/cr) <规则ID> - 复制指定规则的所有设置到当前规则(包括关键字、正则、替换规则、媒体设置等)

替换规则管理
/replace(/r) <模式> [替换内容] - 添加替换规则
/replace_all(/ra) <模式> [替换内容] - 添加替换规则到所有规则
/list_replace(/lrp) - 列出所有替换规则
/remove_replace(/rr) <序号> - 删除替换规则
/clear_all_replace(/car) - 清除当前规则的所有替换规则
/copy_replace(/crp) <规则ID> - 复制指定规则的替换规则到当前规则

导入导出
/export_keyword(/ek) - 导出当前规则的关键字
/export_replace(/er) - 导出当前规则的替换规则
/import_keyword(/ik) <同时发送文件> - 导入普通关键字
/import_regex_keyword(/irk) <同时发送文件> - 导入正则关键字
/import_replace(/ir) <同时发送文件> - 导入替换规则

UFB相关
/ufb_bind(/ub) <域名> - 绑定UFB域名
/ufb_unbind(/uu) - 解绑UFB域名
/ufb_item_change(/uic) - 切换UFB同步配置类型

提示
• 括号内为命令的简写形式
• 尖括号 <> 表示必填参数
• 方括号 [] 表示可选参数
• 导入命令需要同时发送文件

☕ 捐赠

如果你觉得这个项目对你有帮助,欢迎通过以下方式请我喝杯咖啡:

ko-fi

📄 开源协议

本项目采用 GPL-3.0 开源协议,详细信息请参阅 LICENSE 文件。

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for TelegramForwarder

Similar Open Source Tools

For similar tasks

For similar jobs