FreeBili 自由哔站：高性能影视聚合搜索与播放工具（支持并行检索、SSE 低延迟、Docker 一键部署）

FreeBili 自由哔站简介

FreeBili 自由哔站是一款聚合式影视搜索与播放工具，采用 Python FastAPI + Vue.js 架构。特点在于多源并行搜索与SSE（Server-Sent Events）流式返回，查询结果可即时抵达，交互顺滑。示例地址：freebili.xplayground.asia。

FreeBili 自由哔站核心功能

• 多源并行搜索：对接多个资源站点并行检索，缩短等待。
• SSE 流式接口：以流式方式推送结果，先返回先到达的内容，显著降低首屏等待。
• 极简部署：提供 Docker 镜像，单条命令即可启动。

技术架构

• 后端：FastAPI 提供高性能异步接口与流式响应。
• 前端：Vue.js 构建交互式页面与播放体验。
• 通信：SSE 持续推送查询结果，减少轮询消耗与延迟。

部署与使用

Docker 部署（推荐）

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

开发启动

本项目使用 uv 管理 Python 依赖

uv sync
uv run fastapi dev main.py

配置文件

访问 http://<服务器IP>/docs，在 POST /config 接口上传 config.json 完成配置。

适用场景

• 需要快速聚合检索多站点影视资源的个人或小团队
• 追求低延迟、流式首屏反馈的检索与播放体验
• 希望以 Docker 快速落地的技术实践环境

FreeBili 自由哔站体验地址

体验地址：https://freebili.xplayground.asia/

GitHub地址：https://github.com/rango886/FreeBili