EcoHub

自托管影视聚合系统

中文 | English

在线演示 · 管理后台 · 部署指南 · 常见问题 · 交流群组

使用须知
EcoHub 不提供、不存储任何影视文件。片源来自使用者自行配置的采集接口。请遵守所在地区的法律法规以及各源站的使用约定，由此产生的风险由使用者自行承担。本项目仅供学习与技术交流。

EcoHub 是一款高性能、现代化的全栈多源影视聚合系统。它不仅提供极致流畅的 Web 观影体验，还集成了强大的自动化采集与管理后台，旨在帮助开发者和影视爱好者快速搭建属于自己的私人影视库。

客户端是独立 App 仓库（本项目以 Git Submodule 形式接入在 app-for-ohos/ 与 app-for-android/）：

• EcoHub for OHOS (鸿蒙客户端): fe-spark/EcoHub-for-OHOS
• EcoHub for Android (安卓客户端): fe-spark/EcoHub-for-Android

只读演示账号：guest / guest。该账号不可保存配置，正式部署请使用自有账号并修改默认密码。

CloudCone 为演示站点所使用的服务商，磁盘 I/O 不受限。部分低价 VPS 对 I/O 设有限制，数据库与采集任务容易因此阻塞。境外主机无需 ICP 备案，开通即可使用，适用于采集任务与本类站点部署，亦可用于自建网络出口。

部署境外主机、访问采集源或调试接口时，通常需要稳定的网络代理。建议使用直连服务 良心云：

• 2 元 / 月 100G，6 元 1000G（1T）
• 直连 AWS 与 Oracle，协议为 VLESS Reality 与 Hysteria2
• 可解锁 Netflix、Disney+、TikTok、ChatGPT；无审计，流量倍率 1 倍
• 覆盖新疆、河南、福建等地区，高峰时段可播放 4K
• 新用户注册即获体验流量

注册良心云

要求 Docker 20+、Compose 2+，建议配置不低于 2 核 2 GB 内存。

curl -fsSL https://raw.githubusercontent.com/fe-spark/EcoHub/main/scripts/install-release.sh | sh
cd ~/ecohub

编辑 .env：将 openssl rand -hex 32 的输出写入 JWT_SECRET，并修改 MySQL / Redis 密码，然后启动：

docker compose up -d

默认账号：admin / admin（读写）、guest / guest（只读）。对外部署前须立即修改默认密码。

安装完成后前台无数据，属预期行为。须在管理后台 采集中心 完成全量采集并发布后，前台才会展示影片。1Panel、外部数据库与反向代理见 部署指南。

Telegram 通知在管理后台 系统设置 → 通知配置 中填写。境内服务器访问 Telegram 时经常出现超时，可在 .env 中设置 TG_PROXY=http://host.docker.internal:7890。详见 server/notify.md。

请先在本地启动 MySQL 8 与 Redis 7。后端与前端需两个终端，均从仓库根目录执行。

API：

cd server
cp .env.example .env
go run ./cmd/server

Web：

cd web
cp .env.example .env.local
npm install
npm run dev

前台 http://127.0.0.1:3000，后台 /manage，API http://127.0.0.1:8080。服务端 · 前端

• Telegram 交流群：https://t.me/+6O6MiUdVSOplNjQ0

MIT · fe-spark/EcoHub · Issues · Telegram Group