Telegram 转发器是一个消息转发工具，只需要你的账号加入频道/群聊即可以将指定聊天中的消息转发到其他聊天，不需要bot也加入。可用于信息流整合过滤，消息提醒，内容收藏等多种场景。
- 🔄 多源转发：支持从多个来源转发到指定目标
- 🔍 关键词过滤：支持白名单和黑名单模式
- 📝 正则匹配：支持正则表达式匹配目标文本
- 📋 内容修改：支持多种方式修改消息内容
- 🤖 AI 处理：支持使用 AI 处理消息内容
- 🔗 联动同步：支持与通用论坛屏蔽插件联动同步，实现三端屏蔽
-
获取 Telegram API 凭据：
- 访问 https://my.telegram.org/apps
- 创建一个应用获取
API_ID和API_HASH
-
获取机器人 Token：
- 与 @BotFather 对话创建机器人
- 获取机器人的
BOT_TOKEN
-
获取用户 ID：
- 与 @userinfobot 对话获取你的
USER_ID
- 与 @userinfobot 对话获取你的
新建文件夹
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），不填或0表示无限制
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
# 默认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首次运行（需要验证）：
docker-compose run -it telegram-forwarderCTRL+C 退出容器
修改 docker-compose.yml 文件，修改 stdin_open: false 和 tty: false
后台运行：
docker-compose up -d假设订阅了频道 "TG 新闻" (https://t.me/tgnews) 和 "TG 阅读" (https://t.me/tgread) ，但想过滤掉一些不感兴趣的内容：
-
创建一个 Telegram 群组/频道（例如："My TG Filter"）
-
将机器人添加到群组/频道，并设置为管理员
-
在新创建的群组/频道中发送命令：
/bind https://t.me/tgnews 或者 /bind "TG 新闻" /bind https://t.me/tgread 或者 /bind "TG 阅读"
-
设置消息处理模式：
/settings
选择要操作的对应频道的规则，根据喜好设置
特别说明：
- 如果对消息需要进行二次中转处理，可以开启
删除原消息 - 预览模式：开启后，会对消息第一条链接进行预览
- 如果对消息需要进行二次中转处理，可以开启
-
添加屏蔽关键词：
/add 广告 推广 '这是 广告' -
如果发现转发的消息格式有问题（比如有多余的符号），可以使用正则表达式处理：
/replace \*\*这会删除消息中的所有
**符号
注意：以上增删改查操作，只对第一个绑定的规则生效，示例里是TG 新闻。若想对TG 阅读进行操作，需要先使用
/settings(/s)，选择TG 阅读，再点击"应用当前规则"，就可以对此进行增删改查操作了。也可以使用/add_all(/aa)，/replace_all(/ra)等指令同时对两条规则生效
这样，你就能收到经过过滤和格式化的频道消息了
项目提供了AI处理接口,可以对消息进行智能化处理。配合提示词可以应用多种场景例如：
- 翻译
- 总结
- 自动对内容打标签
- 智能去除广告
- ............
在settings中点击AI设置即可进入设置菜单。每条转发规则都可以独立配置AI处理。
需要在.env文件中配置AI相关参数, 如API_KEY, API_BASE(API_BASE为可选项目, 默认使用官方接口)等
主要设置项说明:
- AI处理: 开启后将匹配规则的消息发送到AI模型进行处理
- AI模型:
- 点击切换使用的AI模型
- 默认使用
.env中配置的模型 - 可在
config/ai_models.txt中自定义可选模型列表
- AI提示词:
- 点击修改处理消息的提示词
- 默认使用
.env中的提示词 - 开启AI处理后按提示词处理消息
- AI总结:
- 开启后在指定时间总结24小时内的消息
- 将总结结果发送到目标聊天
- 注意:此功能消耗较多API token
- 总结时间:
- 可在
config/summary_time.txt中设置列表,格式为HH:MM，如07:00表示每天早上7点总结 - 可在
.env中设置默认时间和时区
- 可在
- AI总结提示词:
- 点击修改总结的提示词
- 默认使用
.env中的提示词
TG频道的部分消息由于文字嵌入链接，点击会让你确认再跳转，例如nodeseek的官方通知频道
频道的原始消息格式
[**贴子标题**](https://www.nodeseek.com/post-xxxx-1)
可以对通知频道的转发规则依次使用以下指令
/replace \*\*
/replace \[(?:\[([^\]]+)\])?([^\]]+)\]\(([^)]+)\) [\1]\2\n(\3)
/replace \[\]\s*
最后所有转发过来的消息都会变成以下格式，这样直接点击链接就无需确认跳转了
贴子标题
(https://www.nodeseek.com/post-xxxx-1)
转发模式分为两种:
-
用户模式
- 消息转发最完整，保留原始格式
- 需要频道/群聊没有限制转发
- 由于是自身发送消息，无法收到通知提醒
- 可以使用另一个 Telegram 账号来登录我们的程序，这样主账号就能收到通知
-
机器人模式
- 不需要机器人进入相关的频道/群聊，只需要机器人在你新建的频道/群聊即可
- 自定义程度最高，可灵活设置转发规则
- 部分复杂消息可能需要用
/replace命令调整格式 - 可以正常接收消息通知
建议根据实际需求选择合适的模式。如果注重消息完整性，选择用户模式；如果需要更多自定义功能和通知提醒，选择机器人模式。
确保.env文件中已配置相关参数，在已经绑定好的聊天窗口中使用/ufb_bind <论坛域名>，即可实现三端联动屏蔽，使用/ufb_item_change切换要同步当前域名的主页关键字/主页用户名/内容页关键字/内容页用户名
命令列表
基础命令
/start - 开始使用
/help(/h) - 显示此帮助信息
绑定和设置
/bind(/b) - 绑定源聊天
/settings(/s) - 管理转发规则
/switch(/sw) - 切换当前需要设置的聊天规则
关键字管理
/add(/a) <关键字> - 添加普通关键字
/add_regex(/ar) <正则表达式> - 添加正则表达式
/add_all(/aa) <关键字> - 添加普通关键字到所有规则
/add_regex_all(/ara) <正则表达式> - 添加正则表达式到所有规则
/list_keyword(/lk) - 列出所有关键字
/remove_keyword(/rk) <序号> - 删除关键字
/clear_all_keywords(/cak) - 清除当前规则的所有关键字
/clear_all_keywords_regex(/cakr) - 清除当前规则的所有正则关键字
/copy_keywords(/ck) <规则ID> - 复制指定规则的关键字到当前规则
/copy_keywords_regex(/ckr) <规则ID> - 复制指定规则的正则关键字到当前规则
替换规则管理
/replace(/r) <模式> [替换内容] - 添加替换规则
/replace_all(/ra) <模式> [替换内容] - 添加替换规则到所有规则
/list_replace(/lr) - 列出所有替换规则
/remove_replace(/rr) <序号> - 删除替换规则
/clear_all_replace(/car) - 清除当前规则的所有替换规则
/copy_replace(/cr) <规则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同步配置类型
提示
• 括号内为命令的简写形式
• 尖括号 <> 表示必填参数
• 方括号 [] 表示可选参数
• 导入命令需要同时发送文件如果你觉得这个项目对你有帮助，欢迎通过以下方式请我喝杯咖啡：
