nanhoo82 / mdcx-docker

在Docker容器中运行 MDCX，并通过Web界面或远程桌面进行控制。Run MDCX in a Docker container, accessible and controllable via a web interface or remote desktop.

👇🏻👇🏻👇🏻👇🏻👇🏻👇🏻👇🏻👇🏻👇🏻👇🏻👇🏻👇🏻👇🏻👇🏻👇🏻👇🏻👇🏻

📢 上游源码项目已更改为sqzw-x/mdcx，请阅读下面的更改新源码后的更新说明。

👆🏻👆🏻👆🏻👆🏻👆🏻👆🏻👆🏻👆🏻👆🏻👆🏻👆🏻👆🏻👆🏻👆🏻👆🏻👆🏻👆🏻

---

更改新源码后的更新说明

由于上游源码变更，本项目也做了相应的调整。如果需要使用20231014之后的版本，请参考以下说明进行更新。

建议的操作

直接部署新容器，然后将旧容器的配置文件等数据复制到新容器目录中。

如果想更新已有的容器，请参考下面的说明。

builtin镜像

即mdcx-builtin-gui-base和mdcx-builtin-webtop-base镜像。

简单来说，拉取新版镜像，然后重新部署即可。

注意.env里的MDCX_BUILTIN_IMAGE_TAG应该是latest或者最新的版本号。

建议先备份配置文件等数据，以免部署失败或未知问题导致数据丢失。

docker-compose方式，适用于mdcx-builtin-gui-base和mdcx-builtin-webtop-base

cd /path/to/mdcx-docker
# 拉取新版镜像
docker-compose pull
# 重新部署
docker-compose up -d

docker-cli方式，适用于mdcx-builtin-gui-base

cd /path/to/mdcx-docker
# 拉取新版镜像
docker pull stainless403/mdcx-builtin-gui-base:latest
# 停止并删除容器，容器名称请根据实际情况修改
docker stop mdcx_builtin_gui
docker rm mdcx_builtin_gui
# 重新部署，此处省略具体命令，请根据部署文档执行相关命令
docker run ...

docker-cli方式，适用于mdcx-builtin-webtop-base

cd /path/to/mdcx-docker
# 拉取新版镜像
docker pull stainless403/mdcx-builtin-webtop-base:latest
# 停止并删除容器，容器名称请根据实际情况修改
docker stop mdcx_builtin_webtop
docker rm mdcx_builtin_webtop
# 重新部署，此处省略具体命令，请根据部署文档执行相关命令
docker run ...

src镜像

即mdcx-src-gui-base和mdcx-src-webtop-base镜像。

简单来说，下载新版源码，拉取新版镜像，然后重新部署即可。

注意.env里的MDCX_SRC_IMAGE_TAG应该是latest或者最新的版本号。

建议先备份配置文件等数据，以免部署失败或未知问题导致数据丢失。

下载新版源码

mdcx-src-gui-base

cd /path/to/mdcx-docker
# 备份旧版源码
mv app app-bak
# 下载新版`下载源码脚本`
mv update-src.sh update-src.sh-bak
curl -fsSL https://github.com/northsea4/mdcx-docker/raw/main/gui-base/update-src.sh -o update-src.sh
# 下载新版源码
bash update-src.sh --verbose

mdcx-src-webtop-base

cd /path/to/mdcx-docker
# 备份旧版源码
mv app app-bak
# 下载新版`下载源码脚本`
mv update-src.sh update-src.sh-bak
curl -fsSL https://github.com/northsea4/mdcx-docker/raw/main/webtop-base/update-src.sh -o update-src.sh
# 下载新版源码
bash update-src.sh --verbose

重新部署

docker-compose方式，适用于mdcx-src-gui-base和mdcx-src-webtop-base

cd /path/to/mdcx-docker
# 拉取新版镜像
docker-compose pull
# 重新部署
docker-compose up -d

docker-cli方式，适用于mdcx-src-gui-base

cd /path/to/mdcx-docker
# 拉取新版镜像
docker pull stainless403/mdcx-src-gui-base:latest
# 停止并删除容器，容器名称请根据实际情况修改
docker stop mdcx_src_gui
docker rm mdcx_src_gui
# 重新部署，此处省略具体命令，请根据部署文档执行相关命令
docker run ...

docker-cli方式，适用于mdcx-src-webtop-base

cd /path/to/mdcx-docker
# 拉取新版镜像
docker pull stainless403/mdcx-src-webtop-base:latest
# 停止并删除容器，容器名称请根据实际情况修改
docker stop mdcx_src_webtop
docker rm mdcx_src_webtop
# 重新部署，此处省略具体命令，请根据部署文档执行相关命令
docker run ...

---

镜像

「builtin」表示内置已编译的应用，不需要额外下载安装包。 「src」表示使用应用的python源码运行，需要额外下载源码。

「gui」是最简单的版本，通过Web访问，且只能看到应用窗口。 「webtop」有比较完整的桌面环境，可以通过Web访问或RDP访问。

镜像	部署说明	网页查看	远程桌面	文件管理	浏览器
mdcx-builtin-gui-base	查看	✅
mdcx-builtin-webtop-base	查看	✅	✅	✅	✅
mdcx-src-gui-base	查看	✅
mdcx-src-webtop-base	查看	✅	✅	✅	✅

使用脚本部署

复制以下命令到终端运行，根据提示输入几个参数即可完成部署。

使用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 -)"

手动部署

mdcx-builtin-gui-base示例

⚠️ 这里只给出一个简单的运行示例，建议查看 部署说明 了解更多细节。

# 选一个合适的目录
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 `#Web访问端口` \
  -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 /volume2:/volume2 `#影片目录` \
  -e TZ=Asia/Shanghai \
  -e DISPLAY_WIDTH=1200 \
  -e DISPLAY_HEIGHT=750 \
  -e VNC_PASSWORD=  `#查看密码` \
  -e USER_ID=$(id -u) `#运行应用的用户ID` \
  -e GROUP_ID=$(id -g) `#运行应用的用户组ID` \
  --restart unless-stopped \
  stainless403/mdcx-builtin-gui-base:latest

浏览器访问 http://192.168.1.100:5800 使用。

mdcx-builtin-webtop-base示例

⚠️ 这里只给出一个简单的运行示例，建议查看 部署说明 了解更多细节。

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 `#Web访问端口` \
  -p 3389:3389 `#RDP访问端口` \
  -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 /volume2:/volume2 `#影片目录` \
  -e TZ=Asia/Shanghai \
  -e AUTO_LOGIN=false `#使用默认密码(abc)，且通过网页访问时，是否自动登录` \
  -e PUID=$(id -u) `#运行应用的用户ID` \
  -e PGID=$(id -g) `#运行应用的用户组ID` \
  --restart unless-stopped \
  stainless403/mdcx-builtin-webtop-base:latest

• 使用Windows远程桌面或Microsoft Remote Desktop连接 192.168.1.100:3389 使用，账号密码abc/abc。
• 浏览器访问 http://192.168.1.100:3000 使用。

公网访问

如果有公网访问的需求，请自行设置好访问密码（不要使用默认密码）。

镜像	默认	方式1
mdcx-builtin-gui-base mdcx-src-gui-base	空	设置环境变量VNC_PASSWORD
mdcx-builtin-webtop-base mdcx-src-webtop-base	abc/abc	docker exec -it 容器名称 passwd abc 或进入桌面使用命令行工具执行passwd abc

申明

当你查阅、下载了本项目源代码或二进制程序，即代表你接受了以下条款：

• 本项目和项目成果仅供技术，学术交流和docker测试使用
• 本项目贡献者编写该项目旨在学习docker和python应用在linux平台上的打包处理
• 用户在使用本项目和项目成果前，请用户了解并遵守当地法律法规，如果本项目及项目成果使用过程中存在违反当地法律法规的行为，请勿使用该项目及项目成果
• 法律后果及使用后果由使用者承担
• GPL LICENSE
• 若用户不同意上述条款任意一条，请勿使用本项目和项目成果

更新日志

请查看 更新日志

FAQ

请查看 FAQ