| title | TeleFileDB Plus |
|---|---|
| emoji | 📁 |
| colorFrom | blue |
| colorTo | green |
| sdk | docker |
| app_port | 7860 |
| pinned | false |
您的私人 Telegram 檔案索引與管理工具 / Your Private Telegram File Index & Management Tool
💡 關於本專案 / About This Project
這個專案是我在完全沒有程式基礎的情況下，透過 Gemini CLI 使用自然語言指令與 AI 協作完成的。本專案大部分程式碼由 AI 工具生成。我負責邏輯導向與功能定義，AI 負責技術實現。如有任何授權爭議或建議，請與我聯繫以便更正。
This project was developed by a creator with no prior programming background, using only natural language commands via Gemini CLI. Most of the codebase was generated by AI. I focused on logic and functional requirements, while AI handled the technical implementation. Please contact me regarding any licensing concerns or suggestions for improvement.
-
網頁端操作限制 / Web Interface Limitations: 本專案網頁端（Pyrogram 核心）不建議頻繁處理大檔案。20MB 以上的下載 或 50MB 以上的上傳 若在網頁端執行，極易觸發 Telegram 長達 2000+ 秒的限制 (Flood Wait)，甚至有封號風險。 Avoid frequent large file operations (>20MB download / >50MB upload) on the Web UI. These actions highly likely trigger Telegram's 2000+s Flood Wait or even lead to account termination.
-
強烈建議官方下載 / Official Client Recommended: 對於大檔案，請點擊 「View in Telegram」 按鈕跳轉至官方客戶端進行穩定下載或播放。 For large files, use the "View in Telegram" button to download/stream stably via the official app.
-
2GB 上傳與 4GB 下載限制 (免責說明) / 2GB Upload & 4GB Download (Disclaimer):
- 上傳：單個檔案上限固定為 2GB。
- 下載：實測 4GB 以下亦可順利下載。這屬於 Telegram API 的未知行為，開發者無技術能力突破官方限制。若日後此「福利」消失，純屬正常預期。 - Upload: Fixed at 2GB limit. - Download: Current tests show up to 4GB is possible. This is an unexpected API behavior and not guaranteed.
-
存儲性質 / Storage Nature: 資料庫僅保存索引。雖然轉發到私有頻道能延長檔案存取壽命，但若帳號被封禁，檔案將無法救回。請務必做好重要資料的異地備份。 The database only stores indices. While forwarding to private channels extends access, files cannot be recovered if your account is banned. Always keep external backups of important data.
為了保護帳號安全並獲得最佳體驗，請多善用 run_listener.py 腳本功能：
To ensure account safety and best experience, utilize the run_listener.py background script:
-
自動監聽同步 (免動手) / Auto-Sync via Monitoring:
- 在官方 App 將檔案「發送」或「轉發」到您設定的自動監聽群組。
- 系統會秒速自動將其索引至 TeleFileDB+ 的監聽目錄。 - Forward/Upload files to monitored groups in the official app; they will sync to TeleFileDB+ instantly.
-
手動指令索引 (精準收藏) / Manual Indexing via
/savdb:- 在任何群組或私聊 Bot 時，對檔案回覆
/savdb指令。 - 檔案會添加到您指定的目錄（默認為
root/savdb）。 - 進階：支援自定義目錄路徑與文件名（詳見文檔）。
- Reply to any file with
/savdbto index it to a specific folder. Supports custom paths and filenames.
- 在任何群組或私聊 Bot 時，對檔案回覆
-
自動分卷/切片處理: 針對大於 2GB 的任務，系統會自動進行 ffmpeg 媒體流切片 或 7z 物理分卷壓縮。 Auto-Splitting / Segmentation: Tasks exceeding 2GB are automatically processed via ffmpeg stream segmenting or 7z multi-part volume splitting. Auto-splitting for >2GB uploads using ffmpeg or 7z.
您可以透過以下連結體驗 TeleFileDB+ 的界面與查詢功能：
- Demo URL: https://huggingface.co/spaces/hl001x/TeleFileDB_DEMO
- 帳號 / Account:
admin - 密碼 / Password:
demo ⚠️ 注意：演示環境已關閉上傳功能，測試上傳將會失敗。 Note: Upload functionality is disabled in the demo environment.
| 目標 / Goal | 指令 / Command |
|---|---|
| 重置管理員密碼 / Reset Admin Pwd | docker exec -it telefiledb_app flask create-admin |
| 升級資料庫結構 / Migrate DB | docker exec -it telefiledb_app python migrate_db.py |
| 環境清理(含會話) / Full Cleanup | bash cleanup_for_release.sh |