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