如何配置 Telegram 登錄與 Mini App¶

Stream 站點部署完成後，若要在網站中 使用 Telegram 賬號登錄，或在 Telegram 內 打開 Mini App，還需要在 BotFather 中爲機器人完成兩項配置：

配置項	作用	是否必需
Domain（域名）	授權網站使用 Telegram Login Widget	開通 Telegram 登錄必須
Mini App	在機器人資料頁顯示「打開應用」，在 Telegram 內直接打開你的網站	體驗 Mini App 必須

本教程分兩部分：先配置 Domain，再配置 Mini App。請使用你 已部署完成的網站域名（下文以 https://tgff.ccwu.cc 爲例，請替換爲你自己的地址）。

前置條件

已完成 Stream 站點部署
已擁有可用的 Bot 和 Bot Token（若尚未創建，請先閱讀如何申請 Telegram Bot 並獲取 Token）
網站域名已可正常訪問（建議已啓用 HTTPS）

開始之前，請先準備好¶

準備項	說明
Telegram 賬號	手機 App、桌面版或 Telegram Web 均可
已創建的 Bot	需爲 Bot 所有者，才能進入 BotFather 管理
網站完整 URL	形如 `https://你的域名`，需與 Stream 站點實際訪問地址一致

第一部分：配置 Domain（開通 Telegram 登錄）¶

第一步：進入 Bot 管理並打開 Bot Settings¶

在 Telegram 中打開 @BotFather
發送 /mybots
在列表中選擇你要配置的機器人（示例：@tmk_wj_bot）
點擊 「Bot Settings」

進入 Bot Settings

第二步：進入 Domain 設置¶

在 Settings for @你的機器人 頁面，點擊 「Domain」。

點擊 Domain

第三步：開始綁定域名¶

若尚未配置過 Domain，BotFather 會提示 Web login is currently unavailable，點擊 「Set domain」 繼續。

點擊 Set domain

第四步：發送網站 URL¶

BotFather 會提示：

Link your website with your bot to use the Telegram Login Widget.

請在輸入框發送你的 網站完整 URL（必須帶 https://），例如：

https://tgff.ccwu.cc

請填寫完整 URL

必須包含 https:// 協議頭
域名需與 Stream 站點 實際訪問地址一致
不要使用帶路徑的地址（如 /admin），填寫站點根域名即可

發送網站 URL

第五步：確認 Domain 配置成功¶

發送 URL 後，BotFather 返回 「Success! Domain updated.」 表示綁定成功。

Domain 配置成功

此時你的網站已授權使用該 Bot 進行 Telegram 登錄。點擊 「« Back to Bot」 返回機器人管理頁，繼續第二部分 Mini App 配置。

第六步：返回 Bot Settings（準備配置 Mini App）¶

點擊 「« Back to Bot」 後，會回到機器人管理菜單。再次點擊 「Bot Settings」，進入下一步 Mini App 配置。

返回並再次進入 Bot Settings

如何移除 Domain？

若需更換域名，重新進入 Domain 設置，發送新 URL 即可覆蓋。發送 /empty 可清除已綁定的 Domain。

第二部分：配置 Mini App¶

第七步：進入 Configure Mini App¶

在 Bot Settings 頁面，點擊 「Configure Mini App」。

點擊 Configure Mini App

第八步：啓用 Mini App¶

若 BotFather 提示 Mini App is currently disabled，點擊 「Enable Mini App」 開啓。

啓用 Mini App

第九步：發送 Mini App URL¶

BotFather 會提示：

Send me the Mini App URL that will be opened by tapping the 'Open App' button.

發送你的網站地址（通常與 Domain 相同），例如：

https://tgff.ccwu.cc

Domain 與 Mini App URL 的關係

兩者通常填寫 同一個站點根 URL。Domain 用於登錄授權，Mini App URL 用於 Telegram 內打開網頁。

發送 Mini App URL

第十步：確認 Mini App 配置成功¶

BotFather 返回 「Success! Mini App settings updated.」 表示配置完成。

Mini App 配置成功

第十一步：在 Telegram 中驗證¶

打開你的 機器人資料頁，應出現 「打開應用」 按鈕。點擊後會在 Telegram 內打開你配置的網站，即 Mini App 入口。

機器人資料頁出現打開應用按鈕

服務條款提示

資料頁底部可能出現 Telegram 開發者服務條款說明，屬於正常提示。

配置完成後¶

能力	驗證方式
Telegram 登錄	在網站登錄頁點擊 Telegram 登錄，應能正常授權
Mini App	在機器人資料頁點擊「打開應用」，應能在 Telegram 內打開站點

將 Bot Token 與上述配置一併填入 TG-FF Stream 建站配置中，即可完整使用登錄與 Mini App 能力。

常見問題¶

只配置 Domain，不配置 Mini App 可以嗎？¶

可以。若只需要 網站 Telegram 登錄，配置 Domain 即可。若希望用戶在 Telegram 內通過「打開應用」訪問站點，還需完成 Mini App 配置。

域名填錯了怎麼辦？¶

重新進入 BotFather → /mybots → 選擇 Bot → Bot Settings → Domain，發送正確的 URL 覆蓋即可。

必須使用 HTTPS 嗎？¶

是的。Telegram Login Widget 和 Mini App 都要求使用 HTTPS 站點地址。

一個 Bot 可以綁定多個域名嗎？¶

BotFather 的 Domain 通常 一次只能綁定一個域名。若你有多個站點，建議爲每個站點創建獨立 Bot，或更換 Domain 後重新綁定。

配置後登錄仍然失敗？¶

請逐項檢查：

Domain 中的 URL 是否與瀏覽器訪問地址 完全一致（含 https://）
Stream 站點是否已成功部署並可訪問
TG-FF 中填寫的 Bot Token 是否與當前 Bot 一致
是否使用了正確的 Bot（Domain 綁定在哪個 Bot 上，登錄就用哪個 Bot 的 Token）

如何關閉 Mini App？¶

進入 Configure Mini App，向 BotFather 發送 /empty 即可禁用。

流程回顧¶

flowchart TB
    subgraph domain [第一部分：Domain 登錄]
        A[/mybots 選擇 Bot] --> B[Bot Settings]
        B --> C[Domain → Set domain]
        C --> D[發送 https 網站 URL]
        D --> E[Domain updated 成功]
    end
    subgraph mini [第二部分：Mini App]
        F[Bot Settings] --> G[Configure Mini App]
        G --> H[Enable Mini App]
        H --> I[發送 Mini App URL]
        I --> J[資料頁出現打開應用]
    end
    E --> F

按以上步驟完成配置後，你的 Stream 站點即可支持 Telegram 登錄 與 Mini App 訪問。若尚未創建 Bot，請先閱讀 Bot 申請教程；若尚未部署站點，請從 Stream 建站介紹開始。遇到問題可加入 TG-FF 用戶交流羣交流。