VideoStream流媒体管理平台
VideoStream 3.0 是一个基于 FastAPI 和 MediaMTX 构建的高性能流媒体管理平台。它提供了一套完整的解决方案，用于管理视频资源、推流任务、轮播频道以及流媒体转发。
核心特性
- 高性能架构: 后端采用 Python FastAPI (异步) + SQLAlchemy (AsyncIO)，前端使用 Bootstrap 5 + jQuery，确保轻量且响应迅速。
- 多协议支持: 原生支持 RTMP, RTSP, HLS, WebRTC, SRT 等多种流媒体协议。
- 轮播频道 (Rotation): 支持创建自定义轮播频道，将多个视频文件按顺序循环推流，并具备自动转码标准化功能，确保推流稳定性。
- 拉流转发 (Pull): 支持从远程源（IPTV, 网络摄像头）拉取流并转发到本地服务或第三方平台。
- 跨平台兼容: 完美支持 Windows 和 Linux 环境，自动处理路径差异和进程管理。
- 稳定可靠: 采用文件重定向日志机制，彻底解决 FFmpeg 缓冲区死锁问题；内置进程守护和僵尸进程自动清理。
程序截图
详细的安装、部署和配置说明，请查阅 docs/index.md。
目录结构
VideoStream3.0/
**── app/ # 核心应用代码
** **── core/ # 核心配置与生命周期管理
** **── db/ # 数据库模型与会话
** **── routers/ # API 路由接口
** **── schemas/ # Pydantic 数据模型
** **── services/ # 业务逻辑服务 (推流, 轮播, 监控等)
** **── main.py # 程序入口
**── bin/ # 外部二进制依赖 (MediaMTX)
**── data/ # 运行时数据存储
** **── videoStream_v3.db # SQLite 数据库
** **── cache/ # 视频处理缓存
**── docs/ # 项目文档
**── logs/ # 系统运行日志
**── static/ # 前端静态资源 (CSS, JS)
**── templates/ # Jinja2 前端模板
文档支持
项目地址：https://gitee.com/laoknas/videostream
博客：https://laokhome.cn/videostream-3
详细的安装、部署和配置说明，请查阅 docs/index.md。
快速开始
前置要求
- Python 3.11
- FFmpeg (可选，系统会自动使用内置 static-ffmpeg)
虚拟化部署
# 拉取项目代码
git clone https://gitee.com/laoknas/videostream.git
cd VideoStream3.0
# 创建并激活虚拟环境
python3.11 -m venv .venv
source .venv/bin/activate # Linux/Mac
# 或
.venv\Scripts\activate # Windows
# 安装依赖
pip install -r requirements.txt
运行服务
python3.11 -m uvicorn app.main:app --host 0.0.0.0 --port 20512 --reload
访问 http://localhost:20512 即可进入管理后台。
默认账号 admin
默认密码 123456laok
测试平台
- 群晖 DS920+ 上成功部署和运行（非docker），python 3.11 环境。
- 飞牛 FNOS 上成功部署和运行（docker），python 3.11 环境。
- 其他 Linux 发行版（未测试）
- 拉流转发功能（未测试），可能存在兼容性问题（暂无直播码测试）。
配置说明
请参考 docs/configuration.md 进行系统配置。
API 文档
启动服务后，访问 http://localhost:20512/docs 查看完整的 Swagger API 文档。
飞牛应用部署
应用下载
版权说明
本项目为私有软件，保留所有权利。未经作者授权，禁止复制、分发或用于商业用途。
作者: Laok
本软件使用了以下开源组件，遵循其各自的许可证：
- FastAPI: MIT License
- MediaMTX: MIT License
- FFmpeg: LGPL/GPL License (通过命令行调用)
