FreeBili 部署與使用指南：透過Docker 快速建置高效能影視聚合搜尋系統

FreeBili 自由嗶站：高效率的影視聚合搜尋工具

FreeBili 是一款基於 Python FastAPI 與 Vue.js 建構的聚合式影視搜尋與播放平台。它通過 多源並行檢索 與 SSE（Server-Sent Events）串流 技術，解決了傳統搜尋在多網站查詢時常見的載入緩慢問題，讓搜尋結果能夠即時、流暢地呈現在使用者面前。

核心功能與技術優勢

FreeBili 的設計核心在於「低延遲」與「高效率」，具體體現在以下三個維度：

• 平行檢索機制：同時向多個資源站點發起請求，無需順序等待，極大縮短了整體查詢耗時。
• SSE 串流回饋：採用串流介面推送數據，檢索到的結果將即時抵達前端，無需等待所有站點全部返回，顯著降低首屏等待時間。
• 輕量化部署：原生支援Docker 映像，實現分鐘級快速啟動。

技術架構分析

• 後端(Backend)：利用FastAPI 的非同步特性，高效處理並發請求並實現串流回應。
• 前端(Frontend)：基於Vue.js 開發，提供響應式互動介面與流暢的播放體驗。
• 通訊協定：透過SSE 持續推送結果，有效避免了傳統輪詢帶來的資源浪費與回應延遲。

部署指南

根據您的需求，可以選擇快速部署或開發模式啟動：

方法一：Docker 一鍵部署（建議）

1. 執行下列命令啟動容器：

   docker run -d -p 8000:8000 silvery886/freebili:1.13

2. 設定係統：存取 http://< 服务器 IP>/docs，透過 POST /config 介面上傳 config.json 設定檔即可完成初始化。

方法二：開發環境啟動

本項目使用 uv 進行依賴管理，請依序執行：

1. 同步依賴：

   uv sync

2. 啟動服務：

   uv run fastapi dev  main.py

適用場景

• 資源聚合需求：需要快速在多個影視網站中檢索特定資源的個人使用者或小型團隊。
• 極致體驗追求：無法忍受傳統搜尋載入圈，希望獲得串流即時回饋的體驗。
• 科技快速實踐：希望透過Docker 快速建置一套高效能非同步搜尋服務的開發者。

相關資源

線上體驗： https://freebili.xplayground.asia/

開源倉庫： https://github.com/rango886/FreeBili