MDCX Docker终极部署指南：从零搭建完整容器环境

MDCX Docker终极部署指南：从零搭建完整容器环境

【免费下载链接】mdcx-docker在Docker容器中运行 MDCX，并通过Web界面或远程桌面进行控制。Run MDCX in a Docker container, accessible and controllable via a web interface or remote desktop.项目地址: https://gitcode.com/gh_mirrors/md/mdcx-docker

MDCX是一个功能强大的媒体数据处理工具，通过Docker容器化部署可以实现快速安装、环境隔离和便捷管理。本指南将详细介绍如何从零开始搭建完整的MDCX Docker环境，涵盖镜像选择策略、端口映射最佳实践、数据持久化配置等关键技术要点。

🐳 镜像选择策略与技术差异

MDCX Docker项目提供两种主要镜像类型，每种类型针对不同的使用场景：

GUI-Base镜像（轻量级Web访问）

内置编译版本技术特点：

• 基于jlesage/baseimage-gui构建
• 仅支持Web访问（5800端口）
• 资源占用低，部署简单
• 无文件管理和浏览器功能

Webtop-Base镜像（完整桌面环境）

内置编译版本技术特点：

• 基于linuxserver/webtop构建
• 支持Web访问（3000端口）和RDP远程桌面（3389端口）
• 提供完整桌面环境、文件管理和浏览器
• 资源占用相对较高

镜像功能对比表

🔧 完整部署流程与配置

环境准备与目录结构

创建项目目录：

MDCX_DOCKER_DIR=/opt/mdcx-docker mkdir -p $MDCX_DOCKER_DIR && cd $MDCX_DOCKER_DIR

创建必要的目录结构：

mkdir -p mdcx-config logs data

配置文件标记（必须）：

echo "/mdcx-config/config.ini" > mdcx-config/MDCx.config

Docker Compose部署方案

GUI-Base版本部署

version: '3' services: mdcx: image: stainless403/mdcx-builtin-gui-base:latest container_name: mdcx-gui environment: - TZ=Asia/Shanghai - DISPLAY_WIDTH=1200 - DISPLAY_HEIGHT=750 - VNC_PASSWORD=your_secure_password - USER_ID=1000 - GROUP_ID=1000 volumes: - ./data:/config - ./mdcx-config:/mdcx-config - ./mdcx-config/MDCx.config:/app/MDCx.config - ./logs:/app/Log - /path/to/media:/media ports: - "5800:5800" # Web访问端口 - "5900:5900" # VNC端口 restart: unless-stopped

Webtop-Base版本部署

version: '3' services: mdcx: image: stainless403/mdcx-builtin-webtop-base:latest container_name: mdcx-webtop environment: - TZ=Asia/Shanghai - AUTO_LOGIN=false - PUID=1000 - PGID=1000 volumes: - ./data:/config - ./mdcx-config:/mdcx-config - ./mdcx-config/MDCx.config:/app/MDCx.config - ./logs:/app/Log - /path/to/media:/media ports: - "3000:3000" # Web访问端口 - "3389:3389" # RDP远程桌面端口 restart: unless-stopped

🌐 网络配置与端口映射最佳实践

端口映射配置表

安全配置建议

使用非默认端口增强安全性：

ports: - "8580:5800" # 改用非标准端口 - "9339:3389" # 改用非标准端口

设置访问密码（必须用于公网访问）：

environment: - VNC_PASSWORD=complex_password_123

💾 数据持久化与备份方案

关键数据目录说明

mdcx-docker/ ├── data/ # 容器系统数据（必须持久化） ├── mdcx-config/ # 应用配置文件（必须持久化） │ └── config.ini # 主配置文件 ├── logs/ # 应用日志目录（建议持久化） └── docker-compose.yml

备份脚本示例

#!/bin/bash # mdcx-backup.sh BACKUP_DIR="/backup/mdcx-$(date +%Y%m%d)" mkdir -p $BACKUP_DIR # 备份关键数据 cp -r /opt/mdcx-docker/data $BACKUP_DIR/ cp -r /opt/mdcx-docker/mdcx-config $BACKUP_DIR/ cp -r /opt/mdcx-docker/logs $BACKUP_DIR/ # 备份Docker配置 docker inspect mdcx-webtop > $BACKUP_DIR/container-info.json

🔄 容器更新与维护策略

使用Watchtower自动更新

一次性更新：

docker run --rm \ -v /var/run/docker.sock:/var/run/docker.sock \ containrrr/watchtower \ --run-once \ mdcx-webtop

定时更新（每天凌晨2点）：

docker run -d --name watchtower-mdcx \ --restart unless-stopped \ -v /var/run/docker.sock:/var/run/docker.sock \ containrrr/watchtower \ --schedule "0 0 2 * * *" \ mdcx-webtop

手动更新流程

# 停止旧容器 docker stop mdcx-webtop docker rm mdcx-webtop # 拉取最新镜像 docker pull stainless403/mdcx-builtin-webtop-base:latest # 重新部署 docker-compose up -d # 验证状态 docker logs -f mdcx-webtop

⚡ 性能优化与故障排除

资源限制配置

deploy: resources: limits: memory: 2G cpus: '1.0' reservations: memory: 1G cpus: '0.5'

常见问题解决方案

问题：Web访问一分钟断线

Nginx反代配置：

location / { proxy_pass http://localhost:3000; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_read_timeout 86400; }

问题：桌面环境自动锁屏

禁用自动锁屏：

docker exec -it mdcx-webtop \ kwriteconfig5 --file $HOME/.config/kscreenlockerrc \ --group Daemon --key Autolock false

🚀 高级部署场景

多实例部署

version: '3' services: mdcx-primary: image: stainless403/mdcx-builtin-webtop-base:latest container_name: mdcx-primary ports: - "3001:3000" - "3389:3389" # ...其他配置 mdcx-backup: image: stainless403/mdcx-builtin-webtop-base:latest container_name: mdcx-backup ports: - "3002:3000" - "3390:3389" # ...其他配置

使用外部存储

volumes: - nas-media:/media:ro volumes: nas-media: driver: local driver_opts: type: cifs o: username=user,password=pass,vers=3.0 device: "//nas-ip/media"

通过本指南的详细说明，您应该能够成功部署和管理MDCX Docker环境。记得根据实际需求调整配置参数，并定期备份重要数据以确保系统稳定运行。

【免费下载链接】mdcx-docker在Docker容器中运行 MDCX，并通过Web界面或远程桌面进行控制。Run MDCX in a Docker container, accessible and controllable via a web interface or remote desktop.项目地址: https://gitcode.com/gh_mirrors/md/mdcx-docker