在社群媒體和通訊軟體中分享 Facebook 連結時，自動產生豐富的預覽資訊（Open Graph / Twitter Card / Telegram）的神奇魔法！✨

部署於 Cloudflare Workers，透過 KV 快取 metadata、Telegram Bot 管理封鎖清單、每次請求即時推送 Telegram log。

• 🔗 連結預覽代理 — 將 Facebook 分享連結轉為帶有 OG meta tags 的頁面，讓各平台正確顯示預覽
• ⚡ KV 快取 — 解析過的 metadata 存入 Cloudflare KV，避免重複抓取（預設 TTL 1 小時）
• 📋 Telegram Log — 每次連結請求自動推送通知至 Telegram（含 URL、訪客 IP、快取狀態、封鎖狀態），支援 Forum thread 模式
• 🚫 連結封鎖機制 — 支援 domain + path glob 模式封鎖，違規連結返回 403 頁面
• 🤖 Telegram Bot 管理 — 透過 Bot 指令管理連結封鎖清單，支援多管理員
• 🛡️ XSS 防護 — 所有動態 metadata 皆經過 HTML 轉義

將 Facebook 分享連結中的 https://www.facebook.com 替換成本服務的 domain 即可。

支援的連結格式：

訪問代理連結後，爬蟲會看到完整的 OG 預覽，一般使用者則在 2 秒後自動跳轉至原始 Facebook 頁面。

• Node.js
• Wrangler CLI
• Cloudflare 帳號
• Telegram Bot（透過 @BotFather 建立）

1. 建立 KV Namespace

npx wrangler kv namespace create METADATA_CACHE
npx wrangler kv namespace create BLOCKLIST

將回傳的 id 填入 wrangler.jsonc 中的 kv_namespaces。

2. 設定環境變數

在 wrangler.jsonc 的 vars 中設定：

3. 設定 Secrets

以下為敏感資訊，透過 wrangler secret put 設定，不會出現在程式碼或設定檔中：

npx wrangler secret put TELEGRAM_BOT_TOKEN
npx wrangler secret put TELEGRAM_CHAT_ID
npx wrangler secret put TELEGRAM_WEBHOOK_SECRET

產生 TELEGRAM_WEBHOOK_SECRET：

使用任何安全的隨機字串產生方式，例如：

# Node.js
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

# PowerShell
-join ((1..32) | ForEach-Object { '{0:x2}' -f (Get-Random -Max 256) })

複製產生的字串，用於 wrangler secret put 和註冊 webhook 時的 secret_token 參數（兩者必須相同）。

4. 部署

npx wrangler deploy

5. 註冊 Telegram Webhook

部署完成後，向 Telegram 註冊 webhook，讓 Bot 指令能被 Worker 接收處理：

curl "https://api.telegram.org/bot<BOT_TOKEN>/setWebhook?url=https://YOUR_DOMAIN/webhook/telegram&secret_token=<WEBHOOK_SECRET>"

<BOT_TOKEN> 替換為你的 Bot token，YOUR_DOMAIN 替換為 Worker 的 domain，<WEBHOOK_SECRET> 必須與步驟 3 設定的 TELEGRAM_WEBHOOK_SECRET 相同。

驗證 webhook 是否設定成功：

curl "https://api.telegram.org/bot<BOT_TOKEN>/getWebhookInfo"

取得 TELEGRAM_THREAD_ID（Forum 群組）：

如果你的 Telegram 群組啟用了 Forum（話題）模式，需要指定 thread ID 才能將訊息發送到正確的話題：

1. 在目標話題中發送一則訊息
2. 呼叫 https://api.telegram.org/bot<BOT_TOKEN>/getUpdates
3. 在回傳的 JSON 中找到該訊息的 message_thread_id 值
4. 將該值填入 wrangler.jsonc 的 TELEGRAM_THREAD_ID

npx wrangler dev

透過 Telegram Bot 管理封鎖清單（需在 TELEGRAM_ADMIN_IDS 中的使用者）：

Request → Route Matching → Blocklist Check (input URL)
                              ↓
                        Fetch Metadata (KV Cache → Facebook)
                              ↓
                        Blocklist Check (resolved og:url)
                              ↓
                        Generate HTML (escaped OG/Twitter/Telegram meta)
                              ↓
                        Response + Telegram Log (async, non-blocking)

MIT License