開源 · MIT 授權 · 即時防護

Your Telegram
Spam Firewall

不是 Bot,直接以你的身份登入。私訊封鎖、群組踢除、圖片 OCR、自動學習 —
一個指令,全面守護你的 Telegram。

teleshield — listen
$ python3 teleshield.py --listen
[Hermes Agent] 即時監聽啟動完成
保護範圍:私訊 + 3 個群組
廣告模式:22 條內建 + OCR 啟用
⚡ 封鎖 85.217.140.37 — 投資詐騙模式命中
⚡ 群組踢除 192.227.184.120 — 廣告推廣
等待新訊息...
🧠
20+
內建廣告偵測模式
🔄
3 層
防禦架構
iptables + fail2ban + TeleShield
💰
$0
營運成本
自有伺服器 · 零 API 費用
✦ 已攔截 36+ 廣告帳號 · 純本地運行 · 資料絕不外傳 ✦

全方位的防護能力

從私訊到群組、從文字到圖片,TeleShield 守護你 Telegram 的每一個角落。

🔍

私訊掃描封鎖

掃描所有非聯絡人對話,即時比對 20+ 中英文廣告模式,一秒封鎖。

👥

群組自動踢除

管理員身份的群組中自動監測,廣告出現即刻踢除 + 封鎖,不再復返。

📸

圖片 OCR 辨識

純圖片廣告無所遁形。Tesseract 本地 OCR 辨識文字,資料絕不外傳。

🧠

自動學習模式

遇到新模式廣告?手動標記一次,自動提取關鍵詞、生成正則,舉一反三。

📊

封鎖報告

每日 / 每週封鎖摘要,含類型統計、來源分析、趨勢圖表。

白名單 / 黑名單

精準控制。白名單永不封鎖,黑名單見一個封一個。支援私訊與群組。

簡潔而強大

所有功能濃縮在幾個直觀的指令中,學習成本趨近於零。

--listen即時監聽模式
--scan掃描並封鎖
--group-scan群組掃描踢除
--report封鎖摘要報告
--learn手動標記學習
--status系統狀態一覽
--whitelist白名單管理
--blacklist黑名單管理
--setup首次設定

兩分鐘搞定

只需要 Python 3.9+ 和 Telegram API 憑證,一行指令部署。

# 1. 克隆倉庫
git clone https://github.com/c92d58/TeleShield.git
cd TeleShield
pip install telethon

# 2. 安裝 OCR(選用)
apt install tesseract-ocr tesseract-ocr-chi-sim
pip install pytesseract Pillow

# 3. 首次設定
python teleshield.py --setup

# 4. 啟動防護
python teleshield.py --listen
1

取得 API 憑證

前往 my.telegram.org/apps 申請 API ID 和 API Hash

2

首次登入

執行 --setup 輸入憑證,Telegram 會發送驗證碼到你的手機

3

開始保護

執行 --listen 即時監聽,TeleShield 會在後台默默守護你

開放原始碼,自由使用

MIT 授權 · 可直接下載原始碼部署

當前版本 v1.0 · 最後更新 2026-07-14 · 共 4 個檔案 · 14KB