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

处理完之后，所有转发过来的消息都会变成下面这种格式，直接点链接就不用再确认跳转了

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

设置项说明

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

主设置

下面对各个设置项做个说明

媒体设置

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) <规则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