
源码系统概览
文章正文
MediaCMS 是一套基于 Django 加 React 构建的开源媒体内容管理系统源码,用于快速搭建自托管的视频与媒体分享门户。它覆盖媒体上传、智能转码、播放分享、评论管理到用户权限控制的全流程,短时间即可搭建一套可用的中小型视频平台。
平台对外提供 REST API 接口,支持与第三方系统对接,也便于按需二次开发播放器与数据管理模块。
源码简介
本项目为 MediaCMS 的中文增强版源码,根项目来自 GitHub 开源社区 mediacms-io/mediacms,当前版本号 v8.4.0,采用 GNU AGPL-3.0 许可证发布,GitHub 获得约 5125 颗星。源码内置 Django 5.2 后端、React 前端、PostgreSQL 数据库和 Redis 缓存,原生支持视频、音频、图片与 PDF 多格式媒体。
代码附带 Docker Compose 一键部署、部署目录 deploy、中文 README 说明以及 Moodle 与 LTI 学习平台插件,适合作为私有化媒体门户的完整基础。
仓库持续维护并保留完整更新日志,安装脚本与前端构建都已沉淀,社区可反馈问题参与协作。
适用场景
教育机构可用于搭建校内课程视频点播平台,避免商业平台的广告与数据不自主问题。企业知识库、社区媒体门户与个人内容站也能快速落地,支持私有部署、自定义品牌页面与播放器外观。
需要建立互动内容资产的团队,可借助点赞、评论、播放列表与分享嵌入等能力沉淀自有媒体内容。
技术栈与运行环境
压缩包大小: 81M
解压后大小: 108.3M
前端语言: React(JSX 编译)
后端语言: Python(Django 5.2.6)
接口语言: Python(Django REST Framework)
数据库: PostgreSQL,缓存: Redis,媒体处理: FFmpeg 与 Bento4
功能亮点
多格式媒体支持,视频音频图片与 PDF 统一管理
智能转码生成多分辨率,支持 HLS 自适应流媒体
RBAC 角色权限体系与 SAML 单点登录
Whisper 自动生成字幕与翻译,本地运行无需外部 API
内置视频剪辑、播放列表、多语言字幕与 REST API
LTI 1.3 支持与 Moodle 插件,方便教学平台嵌入
点赞评论与收藏等用户互动,支持公开与私有媒体控制
结合对比 MediaCMS 和 PeerTube 这两类开源视频平台的区别,MediaCMS 在权限管理、自动字幕与学习平台集成上更完整,适合企业级私有部署。
| 对比项 | MediaCMS | PeerTube |
|---|
| 后端技术 | Python Django | Node.js |
| 权限控制 | RBAC 加 SAML | 基础账号 |
| 教学集成 | LTI 加 Moodle | 无 |
| 自动字幕 | Whisper 本地 | 需插件 |
技术架构与部署指南
安装与部署提示
官方推荐 Docker Compose 一键部署,克隆仓库后执行 docker compose up -d 即可,启动后访问本地服务并使用默认管理员账号登录,建议上线前立即修改默认口令。
国内环境可先用清华 pip 源加速依赖安装,前端使用 npmmirror 镜像,能显著缩短安装时间。本项目 package.json 记录版本 8.1.3,GitHub 最新发布 v8.4.0,最后更新 2026 年,仓库保持持续更新日志。
代码内的 deploy 目录提供部署增强包,包含国内镜像源的一键安装脚本 install.sh 与 install.ps1,以及部署参考说明,方便快速落地。
对外提供服务时配合 Nginx 反向代理与 HTTPS 证书即可进入生产环境,前后端分离结构便于横向扩展。
截图与演示说明

源码内的 files 管理后台、视频详情页、播放器与编辑器的页面模板都能直接复用,详情参考截图演示。
首页布局与频道浏览对应后台发布流程,视频播放页体现播放器、字幕与评论交互,嵌入分享页展示对外投放能力。

媒体详情页支持生成分享链接与自定义尺寸嵌入代码,可将视频展示到第三方网站。
常见问题
问. MediaCMS 支持哪些媒体格式
支持视频、音频、图片与 PDF 等主流媒体,并可自动转码生成多分辨率版本。
问. 如何快速部署它
最简单方式是用 Docker Compose 一键启动,也支持手动安装依赖并运行。
问. 采用什么许可证
项目采用 GNU AGPL-3.0 开源许可证,二次分发需遵循对应协议。
问. 能否嵌入学习系统
可以,项目提供 LTI 1.3 支持以及配套 Moodle 插件。
问. 支持多语言吗
界面支持多语言切换,媒体字幕也支持上传多语言文件。
安全风险提示
默认管理员账号存在弱口令风险,部署后必须立即修改。公开访问时建议配置 HTTPS 与严格 CORS,容器部署注意限制后台管理页访问来源,并留意上传接口的访问控制。
下载说明
源码包见下方下载区,包含完整后端、前端与部署脚本,解压后按 README 即可安装运行。GitHub项目开源地址 https://github.com/mediacms-io/mediacms
建议在干净服务器或容器环境解压部署,并按实际域名配置站点访问地址。