Telegram 转发器 - 支持黑/白名单，正则匹配，内容替换。适用于消息过滤，内容提醒等多种场景

Telegram 转发器 | Telegram Forwarder

Github: https://github.com/Heavrnl/TelegramForwarder

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

特性

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

快速开始

1. 准备工作

1. 获取 Telegram API 凭据：

   • 访问 https://my.telegram.org/apps
   • 创建一个应用获取 API_ID 和 API_HASH

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=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
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: false 和 tty: false

后台运行：

docker-compose up -d

4. 更新

注意：docker-compose运行不需要拉取仓库源码，只需要在项目目录执行以下命令即可更新。

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
(\3)
/replace \[\]\s*

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

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

设置说明

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

主设置说明

以下对设置选项进行说明

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

媒体设置说明

设置选项	说明
媒体类型过滤	启用后会过滤掉非选中的媒体类型
选择的媒体类型	选择要屏蔽的媒体类型
媒体大小过滤	启用后会过滤掉超过设置大小的媒体
媒体大小限制	设置媒体大小限制，单位：MB
媒体大小超限时发送提醒	启用后媒体超限会发送提醒消息

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切换要同步当前域名的主页关键字/主页用户名/内容页关键字/内容页用户名

扩展内容

与通用论坛屏蔽插件联动

https://github.com/heavrnl/universalforumblock

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

完整指令, 支持缩写

命令列表

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

绑定和设置
/bind(/b)  - 绑定源聊天
/settings(/s) - 管理转发规则
/changelog(/cl) - 查看更新日志

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

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

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

导入导出
/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