MDCX Docker 项目部署与使用指南
项目地址: https://gitcode.com/gh_mirrors/md/mdcx-docker MDCX Docker 是一个开源项目，旨在通过 Docker 容器简化 MDCX 的部署过程。该项目允许用户在 Docker 容器中运行 MDCX，并通过 Web 界面或远程桌面进行控制。
项目简介
MDCX Docker 提供了两种主要的镜像版本：
- mdcx-builtin-gui-base：基于 jlesage/baseimage-gui 构建的轻量级版本，只能通过网页查看应用窗口
- mdcx-builtin-webtop-base：基于 linuxserver/webtop 构建的完整桌面环境版本，支持网页访问和 RDP 远程桌面
镜像选择指南
| 镜像类型 | 访问方式 | 文件管理 | 浏览器 | 特点 |
|---|---|---|---|---|
| gui-base | 网页访问(5800端口) | ❌ | ❌ | 轻量级，资源占用少 |
| webtop-base | 网页访问(3000端口) + RDP(3389端口) | ✅ | ✅ | 完整桌面环境，功能丰富 |
快速部署方法
使用脚本部署（推荐）
复制以下命令到终端运行，根据提示选择镜像类型和配置参数：
# 使用 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 版本部署
# 创建项目目录
MDCX_DOCKER_DIR=/path/to/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 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 版本部署
# 创建项目目录
MDCX_DOCKER_DIR=/path/to/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 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
配置文件说明
项目目录结构示例：
mdcx-docker
|-- data # 容器系统数据
|-- mdcx-config # 应用配置文件目录
| |-- config.ini
| |-- MDCx.config
|-- logs # 应用日志目录
|-- .env # 环境变量文件
|-- docker-compose.yml
访问方式
GUI 版本访问
- 浏览器访问：http://服务器IP:5800
Webtop 版本访问
- 浏览器访问：http://服务器IP:3000
- 远程桌面访问：使用 RDP 客户端连接 服务器IP:3389
- 默认账号：abc
- 默认密码：abc
重要安全提示
公网访问时务必修改默认密码！
修改 webtop 版本密码的方法：
docker exec -it 容器名称 passwd abc
或者进入桌面后打开 Konsole 执行：
passwd abc
常见问题解决
选择目录对话框卡顿
进入「设置 - 高级」，找到「选择对话框」，勾选「使用 QT 选择对话框」后保存。
重新部署后黑屏
如果重新部署后无法进入桌面，可以尝试：
cd /path/to/mdcx-docker
docker-compose stop
mv data data-backup
mkdir data
docker-compose up -d
关闭自动锁屏（Webtop版本）
进入桌面后打开 Konsole 执行：
kwriteconfig5 --file $HOME/.config/kscreenlockerrc --group Daemon --key Autolock false
然后重启容器。
更新方法
Docker Compose 方式更新
cd /path/to/mdcx-docker
docker-compose pull
docker-compose up -d
使用 Watchtower 更新
docker run --rm \
-v /var/run/docker.sock:/var/run/docker.sock \
containrrr/watchtower \
--run-once \
容器名称
注意事项
- 上游项目 MDCx 已删库，可部署的最新版镜像为 20231014
- 配置文件和数据目录必须正确挂载以确保数据持久化
- 公网访问时务必设置访问密码
- 建议定期备份重要数据
通过遵循本指南，您可以顺利部署和使用 MDCX Docker 项目，享受容器化带来的便利性。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
