MediaCMS Docker镜像文档

镜像概述和主要用途

MediaCMS是一个现代化、功能齐全的开源视频和媒体内容管理系统(CMS)。该Docker镜像提供了一种便捷的方式来部署和运行MediaCMS，帮助用户快速搭建中小型视频和媒体门户网站。通过自托管方式，用户可以完全控制自己的媒体数据，无需依赖第三方平台。

核心功能和特性

• 数据完全控制：自托管模式确保数据隐私和控制权
• 多种发布工作流：支持公开、私有、未列出和自定义发布选项
• 现代技术栈：基于Django/Python/Celery后端和React前端，包含REST API
• 多媒体类型支持：视频、音频、图像和PDF文件
• 媒体分类选项：类别、标签和自定义分类
• 媒体分享功能：社交媒体分享、视频嵌入代码生成
• 高级搜索功能：支持实时搜索
• 音视频播放列表：创建、添加和重新排序内容
• 响应式设计：包括明暗两种主题
• 用户管理系统：支持自助注册、邀请制和封闭模式
• 可配置操作：允许下载、评论、点赞、点踩和举报媒体
• 自定义配置：更改logo、字体、样式和添加页面
• 增强型视频播放器：基于video.js的自定义播放器，支持多种分辨率和播放速度
• 多转码配置：针对不同分辨率(240p, 360p, 480p, 720p, 1080p)和编码格式(h264, h265, vp9)的默认配置
• 自适应视频流：通过HLS协议实现
• 字幕/隐藏字幕：支持多语言字幕文件
• 可扩展转码：基于优先级的转码系统，支持远程工作节点(实验性)
• 分块文件上传：支持可暂停/恢复的内容上传
• REST API：通过Swagger文档化

使用场景和适用范围

教育机构

管理员和编辑可以控制发布内容，学生不会受到广告和无关内容的干扰，同时可以选择流式播放或下载内容。

组织敏感内容管理

适用于内容敏感且不能上传到外部站点的场景，确保数据安全。

社区建设

可高度定制的视频门户，帮助构建活跃的媒体社区。

个人媒体门户

按照个人偏好组织、分类和托管媒体内容。

硬件要求

服务器配置

• 小型到中型部署：4GB内存 / 2-4 CPU核心
• 大型部署：需要更多CPU核心和内存，特别是处理大量视频转码任务时

存储空间

建议为预期上传视频大小的3倍分配存储空间，因为系统会保留原始版本、编码版本和HLS流文件。例如，若每天接收1GB视频并长期保存，一年内大约需要1TB存储空间(1GB × 3 × 365天)。

安装与部署

Docker Compose部署(推荐)

1. 克隆MediaCMS仓库:

git clone [***]
cd mediacms

2. 创建环境配置文件:

cp .env.example .env

3. 编辑.env文件设置必要参数，如域名、管理员***等

4. 启动服务:

docker-compose up -d

5. 初始化管理员账户:

docker-compose exec web python manage.py createsuperuser

Docker Run命令示例

docker run -d \
  --name mediacms \
  -p 80:80 \
  -p 443:443 \
  -e MEDIA_DOMAIN=yourdomain.com \
  -e ADMIN_EMAIL=*** \
  -v mediacms_data:/opt/mediacms/media \
  -v mediacms_static:/opt/mediacms/static \
  -v mediacms_db:/var/lib/postgresql \
  -v mediacms_redis:/var/lib/redis \
  mediacms/mediacms

配置说明

MediaCMS提供丰富的配置选项，主要配置文件位于/opt/mediacms/mediacms/settings.py和.env环境文件。关键配置项包括：

基本设置

• SITE_NAME: 网站名称
• MEDIA_DOMAIN: 媒体服务器域名
• ADMIN_EMAIL: 管理员***
• ALLOW_REGISTRATION: 是否允许用户注册(True/False)

媒体设置

• ALLOWED_UPLOAD_FILE_TYPES: 允许上传的文件类型
• MAX_UPLOAD_SIZE: 最大上传文件大小
• TRANSCODING_PROFILES: 转码配置文件

用户管理

• REGISTRATION_TYPE: 注册类型(公开/邀请/关闭)
• USER_CAN_UPLOAD: 用户是否可以上传媒体

详细配置说明请参考***文档: Configuration

使用方法

访问系统

部署完成后，通过浏览器访问您配置的域名，系统默认提供以下功能:

1. 用户功能:

   • 注册/登录账户
   • 上传媒体文件
   • 创建和管理播放列表
   • 搜索和浏览媒体内容

2. 管理员功能:

   • 通过/admin路径访问管理后台
   • 管理用户账户和权限
   • 配置网站外观和功能
   • 监控系统状态和媒体处理任务

技术栈

MediaCMS基于以下技术构建:

• 后端: Python, Django, Django Rest Framework, Celery
• 前端: React, video.js
• 数据库: PostgreSQL, Redis
• 服务器: Nginx, uWSGI
• 媒体处理: FFMPEG, Bento4
• 文件上传: Fine Uploader

已知用户案例

• Cinemata: 非营利媒体、技术和文化组织 - [***]
• Critical Commons: 公共媒体档案和合理使用倡导网络 - [***]

文档与支持

• 用户文档: [***]
• 管理员文档: [***]
• 开发者文档: [***]
• 社区支持: 通过GitHub Issues或邮件联系: ***

版本发布

最新版本和更新日志请访问: Releases Page

联系方式

如需商业支持或定制服务，请联系: ***

截图

!MediaCMS界面 !视频播放页面 !嵌入示例