stainless403/mdcx

当前镜像已停止维护

请使用 https://hub.docker.com/repository/docker/stainless403/gui-base_mdcx-builtin 或 https://hub.docker.com/repository/docker/stainless403/webtop-base_mdcx-builtin

0. 必看

0.1 USER_ID和GROUP_ID

bash
# 获取当前用户的ID信息
id
# 获取指定用户的ID信息
id admin

# 获取USER_ID
id -u admin
# 获取GROUP_ID
id -g admin

容器内置用户app的用户ID和分组ID对应部署时指定的USER_ID和GROUP_ID环境变量，默认均为0（即root用户）。app是运行MDCx的用户，其产生的文件（如nfo、海报等）默认归属于该用户。若app用户对相关文件无操作权限，MDCx可能运行异常。

权限问题示例场景：

• 配置目录映射：./config:/mdcx_config，且MDCx配置目录设为/mdcx_config
• ./config目录归属于root且权限为755（非777）
• 使用普通用户的USER_ID和GROUP_ID

此时MDCx因无/mdcx_config目录写入权限，保存配置文件时会报错并退出：

关键日志：PermissionError: [Errno 13] Permission denied

log
mdcx   | [app         ] Traceback (most recent call last):
mdcx   | [app         ]   File "/app/MDCx_Main.py", line 3971, in pushButton_save_new_config_clicked
mdcx   | [app         ]     self.pushButton_save_config_clicked()
mdcx   | [app         ]   File "/app/MDCx_Main.py", line 3958, in pushButton_save_config_clicked
mdcx   | [app         ]     self.save_config_clicked()
mdcx   | [app         ]   File "/app/MDCx_Main.py", line 4939, in save_config_clicked
mdcx   | [app         ]     cf.save_config(json_config)
mdcx   | [app         ]   File "/app/Function/config.py", line 557, in save_config
mdcx   | [app         ]     with open(config_path, "wt", encoding='UTF-8') as code:
mdcx   | [app         ] PermissionError: [Errno 13] Permission denied: '/mdcx_config/config3.ini'
mdcx   | [app         ] Fatal Python error: Aborted
mdcx   | [app         ] Current thread 0x00007fd625215740 (most recent call first):
mdcx   | [app         ]   File "/app/MDCx_Main.py", line 13568 in <module>
mdcx   | [app         ] Aborted (core dumped)
mdcx   | [supervisor  ] service 'app' exited (with status 134).
mdcx   | [supervisor  ] service 'app' exited, shutting down...

2. mdcx示例

https://hub.docker.com/r/stainless403/mdcx%E9%95%9C%E5%83%8F%E5%B7%B2%E5%86%85%E7%BD%AEMDCx%E3%80%82%E8%8B%A5%E9%9C%80%E4%BD%BF%E7%94%A8%E6%9C%AC%E5%9C%B0MDCx%E6%BA%90%E7%A0%81%E7%89%88%EF%BC%8C%E8%AF%B7%E4%BD%BF%E7%94%A8https://hub.docker.com/r/stainless403/mdcx-base%E9%95%9C%E5%83%8F%E3%80%82

🔗 stainless403/mdcx-base示例

2.1 准备项目目录

建议使用 https://github.com/northsea4/mdcx-docker/archive/refs/heads/main.zip 结构，解压后进入项目目录（假设名为mdcx-docker），后续操作均在此目录内进行。

项目结构如下：

mdcx-docker
  |-- config
    |-- config.ini
    |-- config-vip.ini
    |-- config-test.ini
  |-- logs
    |-- 2023-02-04-01-15-00.txt
  |-- .env
  |-- .env.sample
  |-- .env.versions
  |-- docker-compose.mdcx-base.sample.yml
  |-- docker-compose.mdcx.sample.yml
  |-- docker-compose.yml
  |-- update-app.sh

2.2 设置参数

复制docker-compose.mdcx.sample.yml为docker-compose.yml：

bash
cp docker-compose.mdcx.sample.yml docker-compose.yml

2.2.1 目录映射

修改docker-compose.yml的volumes部分添加目录映射。例如影片存放在/volume2，添加映射：/volume2:/volume2，使MDCx内访问路径一致。

2.2.2 环境变量

复制.env.sample为.env：

bash
cp .env.sample .env

修改.env配置参数：

shell
TZ=Asia/Shanghai

# 应用窗口宽度
DISPLAY_WIDTH=1200
# 应用窗口高度
DISPLAY_HEIGHT=750

# 访问密码（公网访问建议设置，无需则留空）
VNC_PASSWORD=

# 网页访问端口
WEB_LISTENING_PORT=5800
# VNC监听端口
VNC_LISTENING_PORT=5900

# 运行应用的用户ID
USER_ID=0
# 运行应用的用户组ID
GROUP_ID=0

# Python软件包加速镜像
# 豆瓣
PYPI_MIRROR=https://pypi.doubanio.com/simple
# 清华
# PYPI_MIRROR=https://pypi.tuna.tsinghua.edu.cn/simple
# 默认
# PYPI_MIRROR=https://pypi.org/simple

# 容器名称
CONTAINER_NAME=mdcx

2.2.3 完整docker-compose.yml示例

yml
version: '3'

services:
  mdcx:
    image: stainless403/mdcx:latest
    container_name: ${CONTAINER_NAME}
    volumes:
      # 配置目录
      - ./config:/mdcx_config

      # 日志目录
      - ./logs:/app/Log
      
      # 影片所在位置  
      - /volume2:/volume2
      - /volume3:/volume3
    environment:
      - TZ=${TZ}
      # 应用窗口宽度
      - DISPLAY_WIDTH=${DISPLAY_WIDTH}
      # 应用窗口高度
      - DISPLAY_HEIGHT=${DISPLAY_HEIGHT}
      # 访问密码
      - VNC_PASSWORD=${VNC_PASSWORD}
      # 运行应用的用户ID
      - USER_ID=${USER_ID}
      # 运行应用的用户分组ID
      - GROUP_ID=${GROUP_ID}
      # Python软件包镜像地址
      - PYPI_MIRROR=${PYPI_MIRROR}
    ports:
      - ${WEB_LISTENING_PORT}:5800
      - ${VNC_LISTENING_PORT}:5900
    restart: unless-stopped
    network_mode: bridge
    stdin_open: true

2.3 运行容器

bash
docker-compose up -d

2.4 使用

假设服务器IP为192.168.1.100，默认端口5800，访问地址：[***]

2.5 docker run运行示例

将/path/to/替换为实际路径：

bash
docker run --name mdcx \
  --restart unless-stopped \
  -p 5800:5800 \
  -p 5900:5900 \
  # 配置目录
  -v /path/to/mdcx-docker/config:/mdcx_config \
  # 日志目录
  -v /path/to/mdcx-docker/logs:/app/Log \
  # 影片目录
  -v /volume2:/volume2 \
  -e TZ=Asia/Shanghai \
  -e DISPLAY_WIDTH=1200 \
  -e DISPLAY_HEIGHT=750 \
  -e VNC_PASSWORD=123456 \
  # 运行应用的用户ID和分组ID（替换为实际ID）
  -e USER_ID=0 \
  -e GROUP_ID=0 \
  stainless403/mdcx

3. 更新

3.0 mdcx-base更新应用

使用stainless403/mdcx-base镜像（无内置MDCx）需手动下载新版应用并解压至app目录；stainless403/mdcx可省略此步骤。

提供一键更新脚本 https://github.com/northsea4/mdcx-docker/blob/dev/update-app.sh%EF%BC%8C%E7%A1%AE%E4%BF%9D%E8%84%9A%E6%9C%AC%E4%BD%8D%E4%BA%8E%60/path/to/mdcx-docker%60%E7%9B%AE%E5%BD%95%EF%BC%9A

bash
cd /path/to/mdcx-docker

# 赋予执行权限（仅需一次）
chmod +x ./update-app.sh

# 查看帮助
./update-app.sh --help

⚠️ 同目录需存在.env和.env.versions文件（.env示例为.env.sample）。脚本也可完成首次源码部署。 手动更新需删除app目录下的.mdcx_initialized文件！

3.1 docker-compose方式更新镜像

bash
cd /path/to/项目目录
docker-compose pull
docker-compose up -d

仅适用于docker-compose部署方式，也可使用watchtower工具更新。

3.2 docker-run方式更新

推荐使用watchtower工具：

一次性更新

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

定时任务方式（不建议自动更新，谨慎使用）

示例：每天凌晨2点更新

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

0 0 2 * * *格式说明（秒 分 时 日 月 星期），参考：https://pkg.go.dev/github.com/robfig/cron@v1.2.0#hdr-CRON_Expression_Format

取消定时更新：

bash
docker rm -f watchtower-mdcx

3. 镜像说明

3.1 已有镜像

• https://hub.docker.com/r/stainless403/mdcx-base

  无内置MDCx，需自行下载源码并准备。对应示例文件：docker-compose.mdcx-base.sample.yml

• https://hub.docker.com/r/stainless403/mdcx

  内置MDCx，使用更方便，但更新进度可能滞后于MDCx官方。对应示例文件：docker-compose.mdcx.sample.yml

• https://hub.docker.com/r/stainless403/gui-base

  MDCx运行基础环境，非开发人员可忽略。

3.2 构建镜像

参考文件：https://github.com/northsea4/mdcx-docker/blob/dev/build-mdcx.sh