终极MDCX Docker部署指南:3种高效访问方式全解析
MDCX Docker项目是一个开源容器化解决方案,旨在通过Docker容器简化MDCX的部署过程,提供多种访问方式和完整的桌面环境。本指南将详细介绍如何选择适合的镜像版本、配置数据持久化以及确保安全访问。
快速上手:选择最适合你的MDCX Docker镜像版本
MDCX Docker项目提供两种主要镜像版本,用户可根据需求选择最合适的部署方式:
GUI基础版镜像特性
mdcx-builtin-gui-base是基于jlesage/baseimage-gui构建的轻量级Web访问版本。该版本资源占用最低,仅显示应用窗口,不支持文件管理和浏览器功能。通过5800端口直接访问应用界面,适合对资源消耗敏感的用户。
Webtop完整版镜像优势
mdcx-builtin-webtop-base是基于linuxserver/webtop构建的全功能桌面环境版本。支持Web浏览器访问(3000端口)和RDP远程桌面连接(3389端口),内置文件管理和浏览器功能。虽然资源占用相对较高,但提供完整的桌面体验。
关键配置:数据持久化最佳实践
确保配置文件和数据在容器重启后不会丢失是部署成功的关键。正确的目录挂载配置可以完美解决数据持久化问题。
项目目录结构应包含以下核心目录:
- data目录:用于存储容器系统数据
- mdcx-config目录:存放应用配置文件,必须包含MDCx.config标记文件
- logs目录:存储应用运行日志
必须创建配置文件目录标记文件:
echo "/mdcx-config/config.ini" > mdcx-config/MDCx.config
网络配置:端口映射与访问方式
正确的端口映射配置决定了如何访问运行中的MDCX容器。根据选择的镜像版本,配置相应的端口映射规则:
对于GUI基础版:
- Web访问端口:5800:5800
- VNC监听端口:5900:5900
对于Webtop完整版:
- Web访问端口:3000:3000
- RDP远程桌面端口:3389:3389
安全设置:公网访问安全指南
如果需要将MDCX Docker暴露到公网,务必修改默认密码设置以确保系统安全:
GUI基础版通过设置环境变量VNC_PASSWORD来配置访问密码:
-e VNC_PASSWORD=your_secure_password
Webtop完整版默认账号密码为abc/abc,修改密码方式:
docker exec -it 容器名称 passwd abc
或进入桌面后使用命令行工具执行passwd abc命令。
部署方式选择
使用脚本部署(推荐)
复制以下命令到终端运行,根据提示输入参数即可完成部署:
使用curl:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/northsea4/mdcx-docker/main/install.sh)"
使用wget:
bash -c "$(wget https://raw.githubusercontent.com/northsea4/mdcx-docker/main/install.sh -O -)"
手动部署示例
GUI基础版docker run示例:
docker run -d --name mdcx \
-p 5800:5800 \
-p 5900:5900 \
-v $(pwd)/data:/config \
-v $(pwd)/mdcx-config:/mdcx-config \
-v $(pwd)/mdcx-config/MDCx.config:/app/MDCx.config \
-v $(pwd)/logs:/app/Log \
-v /path/to/movies:/movies \
-e TZ=Asia/Shanghai \
-e DISPLAY_WIDTH=1200 \
-e DISPLAY_HEIGHT=750 \
-e VNC_PASSWORD= \
-e USER_ID=$(id -u) \
-e GROUP_ID=$(id -g) \
--restart unless-stopped \
stainless403/mdcx-builtin-gui-base:latest
Webtop完整版docker run示例:
docker run -d --name mdcx \
-p 3000:3000 \
-p 3389:3389 \
-v $(pwd)/data:/config \
-v $(pwd)/mdcx-config:/mdcx-config \
-v $(pwd)/mdcx-config/MDCx.config:/app/MDCx.config \
-v $(pwd)/logs:/app/Log \
-v /path/to/movies:/movies \
-e TZ=Asia/Shanghai \
-e AUTO_LOGIN=false \
-e PUID=$(id -u) \
-e PGID=$(id -g) \
--restart unless-stopped \
stainless403/mdcx-builtin-webtop-base:latest
更新维护
对于使用docker-compose部署的容器,更新镜像命令:
cd /path/to/mdcx-docker
docker-compose pull
docker-compose up -d
对于docker run方式部署的容器,推荐使用watchtower工具进行更新:
docker run --rm \
-v /var/run/docker.sock:/var/run/docker.sock \
containrrr/watchtower \
--run-once \
容器名称
通过本指南,您可以快速掌握MDCX Docker项目的核心部署技巧,选择最适合的使用方式,并确保配置的安全性和稳定性。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



