stainless403/mdcx-builtin-gui-base

0. 关于镜像

https://hub.docker.com/r/stainless403/mdcx-builtin-gui-base%EF%BC%8C%E6%98%AF%E5%9F%BA%E4%BA%8E https://hub.docker.com/r/jlesage/baseimage-gui 构建的适合python+QT5应用运行的镜像。

优点是轻量，缺点是只支持通过网页查看，且没有文件管理。

1. mdcx-builtin示例

使用脚本部署

复制以下命令到终端运行，第一步选择模版 1) mdcx-builtin-gui-base ，然后根据提示输入几个参数即可完成部署。

使用curl：

bash
bash -c "$(curl -fsSL https://raw.githubusercontent.com/northsea4/mdcx-docker/main/install.sh)"

使用wget：

bash
bash -c "$(wget https://raw.githubusercontent.com/northsea4/mdcx-docker/main/install.sh -O -)"

以下的步骤是手动部署的详细说明，即使使用了脚本部署，也请务必阅读一下了解更多细节，如安全、更新等。

https://hub.docker.com/r/stainless403/mdcx-builtin-gui-base%E9%95%9C%E5%83%8F%E5%B7%B2%E5%86%85%E7%BD%AE%E7%BC%96%E8%AF%91%E5%A5%BD%E7%9A%84MDCx%EF%BC%8C%E7%9B%B4%E6%8E%A5%E9%83%A8%E7%BD%B2%E5%8D%B3%E5%8F%AF%E4%BD%BF%E7%94%A8%E3%80%82

1.1 准备项目目录

下载 https://github.com/northsea4/mdcx-docker/releases/download/latest/template-mdcx-builtin-gui-base.zip%EF%BC%8C%E8%A7%A3%E5%8E%8B%E5%88%B0%E5%90%88%E9%80%82%E7%9A%84%E4%BD%8D%E7%BD%AE%E5%90%8E%EF%BC%8C%E8%BF%9B%E5%85%A5%E9%A1%B9%E7%9B%AE%E7%9B%AE%E5%BD%95%E3%80%82%E5%A6%82%E6%97%A0%E7%89%B9%E5%88%AB%E8%AF%B4%E6%98%8E%EF%BC%8C%E4%B9%8B%E5%90%8E%E7%9A%84%E6%93%8D%E4%BD%9C%E9%83%BD%E6%98%AF%E5%9C%A8%E8%AF%A5%E7%9B%AE%E5%BD%95(%E5%81%87%E8%AE%BE%E5%90%8D%E4%B8%BA%60mdcx-docker%60)%E5%86%85%E8%BF%9B%E8%A1%8C%E3%80%82

整个项目的结构大致如下：

mdcx-docker
  |-- data ------容器系统数据
    ...
  |-- mdcx-config --------应用配置文件目录
    |-- config.v2.json
    |-- MDCx.config
  |-- logs --------应用日志目录
    |-- 2023-02-04-01-15-00.txt
  |-- .env ------环境变量文件
  |-- .env.sample ------环境变量示例文件
  |-- .env.versions ------应用版本文件
  |-- gui-base-builtin.sample.yml -------容器部署配置示例
  |-- docker-compose.yml -------容器部署配置

1.2 设置参数

编辑.env文件，按需修改。 文件里每个参数都有具体的说明，.env.sample文件里可以查看原始的数值。

一般需要修改的参数：VNC_PASSWORD, WEB_PORT, VNC_PORT, USER_ID, GROUP_ID

1.3 完整docker-compose.yml示例

yml
version: '3'

services:
  mdcx:
    image: stainless403/mdcx-builtin-gui-base:${MDCX_BUILTIN_IMAGE_TAG}
    container_name: ${MDCX_CONTAINER_NAME}
    env_file:
      - .env
    volumes:
      # 系统数据目录
      - ./data:/config
          
      # 配置文件目录
      - ./mdcx-config:/mdcx-config
      # `配置文件目录`标记文件（纯文本文件，内容为当前使用的配置文件路径，默认/mdcx-config/config.v2.json）
      - ./mdcx-config/MDCx.config:/app/MDCx.config

      # 日志目录
      - ./logs:/app/Log

      # 影片目录
      - /path/to/movies:/movies
    ports:
      - ${WEB_PORT}:5800
      - ${VNC_PORT}:5900
    restart: unless-stopped
    network_mode: bridge
    stdin_open: true

1.4 运行容器

bash
docker-compose up -d

# 查看容器日志，容器名称请根据实际情况修改
# docker logs -f mdcx_gui
# 或者
# docker-compose logs -f

1.5 使用

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

1.6 docker run运行示例

/path/to/ 替换为你实际的路径。

bash
# 选一个合适的目录
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.v2.json" > 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

2. 更新

2.1 docker-compose方式更新镜像

bash
cd /path/to/mdcx-docker
docker-compose pull
docker-compose up -d

注意，只有使用docker-compose方式部署的才能用该方式更新镜像。 另外其实使用docker-compose方式部署的，也可以使用下面说的watchtower进行更新。

2.2 docker-run方式更新

推荐使用watchtower工具更新。

1. 一次性更新

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once \
  容器名称

2. 定时任务方式：

个人不太建议自动更新，请自行斟酌。

示例：每天的凌晨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 * * *" 容器名称

0 0 2 * * * 6个部分分别为： 秒 分 时 日 月 星期

参考：CRON_Expression_Format

取消定时更新：

bash
docker rm -f watchtower-mdcx