如何在 Telegram 上設定挖礦警報？ （機器人配置）

建立用於挖掘通知的 Telegram 機器人

1. 存取 Telegram 上的 BotFather 帳戶並發送指令/newbot來啟動機器人建立。

2. 提供您的機器人的名稱和使用者名稱；使用者名稱必須以bot結尾，例如Miningalertbot 。
3. 確認後，BotFather 傳回一個 API 令牌——這對於與挖掘軟體或腳本整合至關重要。
4. 安全儲存令牌；它可以完全控制您的機器人的訊息傳遞功能，並且如果遺失則無法再次檢索。
5. 透過向機器人發送類似/start 的訊息來驗證機器人是否處於活動狀態——如果註冊正確，它應該會做出回應。

將機器人連接到您的採礦設備

1. 確定您的挖礦軟體：常見的平台包括PhoenixMiner 、 T-Rex和GMiner ，每個平台都支援自訂通知掛鉤。

2. 找到用於啟動礦工的設定檔（例如， miner.conf或start.bat ）。
3. 新增在特定事件上執行的腳本觸發器 - 例如雜湊率下降到基線的 90% 以下、池斷開連接或 GPU 溫度超過 85°C。
4. 使用cURL或基於 Python 的 HTTP POST 請求將格式化訊息傳送到 Telegram 的 API 端點： https://api.telegram.org/bot{YOUR_TOKEN}/sendMessage 。
5. 在有效負載中包含聊天 ID — 透過向您的機器人發送訊息並檢查https://api.telegram.org/bot{YOUR_TOKEN}/getUpdates來獲取它。

有效地格式化警報訊息

1. 具有清晰標識符的結構警報：包括設備名稱、時間戳記、GPU 型號、當前算力和偏差百分比。

2. 使用 Unicode 符號，例如 ⚠️ 表示警告，📈 表示性能峰值，使用 ❌ 表示失敗，以改善視覺掃描。
3. 將訊息長度限制在 4096 個字元以下 - 更長的有效負載需要拆分或截斷邏輯。
4. 使用 URL 編碼正確編碼特殊字元 — 空格變為%20 ，換行符號變為%0A 。
5. 透過parse_mode=HTML選擇性地套用粗體格式並包裝關鍵值，例如Hashrate: 87.3 MH/s 。

確保機器人通訊和存取的安全

1. 將機器人存取限制為僅授權的聊天 ID — 透過根據白名單驗證傳入的chat_id來忽略來自未知用戶的訊息。

2. 避免將 API 令牌直接嵌入到暴露於系統日誌或版本控制儲存庫的 shell 腳本中。
3. 如果偵測到可疑活動，請使用 BotFather 的/revoke指令定期輪換令牌。
4. 除非明確需要，否則禁用內聯模式和群組權限 - 群組中的機器人可能會被濫用於發送垃圾郵件或網路釣魚。
5. 透過 Telegram 的機器人分析儀表板監控機器人的使用情況，可透過 BotFather 的/stats指令存取。

常見問題解答

Q：我可以在不執行本機腳本的情況下接收警報嗎？答：是的 - 2Miners和F2Pool等一些礦池透過儀表板設定提供原生 Telegram 警報整合。透過連結您的機器人令牌並指定錢包地址來啟用它們。

Q：為什麼我的機器人不回應 /start 但接受 API 訊息？答：除非經過編程，否則 Telegram 機器人不會自動回覆指令。 /start訊息出現在getUpdates輸出中，但需要後端服務來處理和回覆。

Q：在 Docker 容器內公開我的機器人令牌是否安全？答：本質上不是－容器可能會通過日誌或檢查洩漏環境變數。透過 Docker 機密傳遞令牌或將它們掛載為唯讀文件，而不是將它們作為純文字 ENV 變數注入。

Q：我可以透過 Telegram 機器人發送挖礦儀表板的螢幕截圖嗎？答：是的 — 使用scrot或ffmpeg等工具擷取終端輸出或 Web UI，然後透過帶有 multipart/form-data 編碼的sendPhoto端點上傳影像。