PyMKUI 是一个为 ZLMediaKit 设计的现代化 Web 管理界面，基于 Python 插件机制深度集成，提供直观、美观的流媒体服务器管理功能。

⚠️ 项目正处于快速迭代期，数据库结构频繁变动。每次更新代码后请先删除旧数据库：

rm data/pymkui.db

数据库将在下次启动时自动重建。

• 🎬 视频流管理 — 查看、播放、停止流，获取截图
• 📡 拉流代理 — 多备用地址、按需/立即模式、自动故障切换、持久化恢复、在线编辑
• 🔄 转协议预设 — 保存多套转协议参数，拉流时一键加载，支持加载服务器默认值
• 👥 观众列表 — 实时查看每路流的在线观众及连接信息
• 📊 服务器监控 — CPU、内存、磁盘、网络实时图表
• ⚙️ 服务配置 — 在线读写 ZLMediaKit 配置项
• 🌐 在线推流 — 基于 WHIP 协议的浏览器端直播推流
• 🔗 网络连接 — 查看和管理当前所有 TCP/UDP 会话

已集成到 ZLMediaKit Docker 镜像中，无需手动配置：

docker run -id \
  -p 1935:1935 \
  -p 80:80 \
  -p 443:443 \
  -p 554:554 \
  -p 10000:10000 \
  -p 10000:10000/udp \
  -p 8000:8000/udp \
  -p 9000:9000/udp \
  zlmediakit/zlmediakit-pro:feature_all

启动后浏览器访问 http://<服务器IP>/，输入 api.secret 密钥即可登录。

适用于自行编译 ZLMediaKit 并希望使用 PyMKUI 的场景。

pymkui/
├─ frontend/          # 静态前端页面
├─ backend/           # Python 插件与 FastAPI 接口
│  ├─ mk_plugin.py    # ZLMediaKit Python 插件入口
│  ├─ py_http_api.py  # FastAPI HTTP API
│  ├─ database.py     # SQLite 数据库
│  ├─ config.py       # 路径配置
│  ├─ mk_logger.py    # 日志封装
│  └─ shared_loop.py  # asyncio 事件循环共享
├─ data/              # 运行时自动生成
│  └─ pymkui.db       # ⚠️ 升级时请删除
└─ README.md

需要 Python 3.10+

cd pymkui/backend
pip install -r requirements.txt

# conda
conda create -n pymkui python=3.12 && conda activate pymkui
pip install -r requirements.txt

# venv (Linux/Mac)
python -m venv venv && source venv/bin/activate && pip install -r requirements.txt

# venv (Windows)
python -m venv venv && venv\Scripts\activate && pip install -r requirements.txt

# 安装 Python 相关依赖
apt-get update && apt-get install -y python3 python3-dev python3-pip
# cmake时指定开启python相关特性
cmake .. -DENABLE_PYTHON=ON

[python]
plugin=mk_plugin

[http]
rootPath=/path/to/pymkui/frontend

# Linux/Mac
export PYTHONPATH=/path/to/pymkui/backend:$PYTHONPATH

# Windows
set PYTHONPATH=C:\pymkui\backend;%PYTHONPATH%

# 启动 ZLMediaKit
./MediaServer

# 验证前端可访问
curl -sv http://localhost:80/login.html
# 应返回 HTTP/1.1 200 OK

• 🩺 流媒体健康度探针 — 抽样探测拉流/推流链路健康状态，输出异常分析报告
• 🧩 事件处理插件机制 — 提供可扩展的 Python 事件钩子，用户可自定义推流鉴权、录制回调、流上下线通知等逻辑
• 🎞️ Python 转码 — 利用 FFmpeg / PyAV 实现服务端转码、水印叠加、分辨率调整等
• 🤖 AI 推理集成 — 对接 ONNX / TensorRT / OpenCV DNN，实现实时视频分析（目标检测、人脸识别等）
• 📁 录像文件管理 — 录像文件浏览、检索、下载、自动清理

欢迎提交 Issue 和 Pull Request。

MIT License