stainless403/mdcx-src-gui-base

stainless403/mdcx-src-gui-base 镜像文档

镜像概述

https://hub.docker.com/r/stainless403/gui-basemdcx-src%E6%98%AF%E5%9F%BA%E4%BA%8Ehttps://hub.docker.com/r/jlesage/baseimage-gui%E6%9E%84%E5%BB%BA%E7%9A%84Docker%E9%95%9C%E5%83%8F%EF%BC%8C%E4%B8%93%E4%B8%BA%E8%BF%90%E8%A1%8Cpython+QT5%E5%BA%94%E7%94%A8%E8%AE%BE%E8%AE%A1%E3%80%82%E5%85%B6%E6%A0%B8%E5%BF%83%E7%89%B9%E7%82%B9%E6%98%AF%E8%BD%BB%E9%87%8F%EF%BC%8C%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87%E7%BD%91%E9%A1%B5%E8%AE%BF%E9%97%AE%E5%BA%94%E7%94%A8%EF%BC%8C%E4%BD%86%E4%B8%8D%E6%8F%90%E4%BE%9B%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E5%8A%9F%E8%83%BD%E3%80%82

注意：该镜像未内置MDCx应用，需用户自行部署源码。若需使用内置MDCx的版本，可选择https://hub.docker.com/r/stainless403/mdcx-builtin-gui-base%E9%95%9C%E5%83%8F%E3%80%82

核心功能与特性

• 轻量级设计：基于轻量基础镜像，资源占用低
• 网页访问支持：通过浏览器即可访问应用界面
• Python+QT5环境：内置适合python+QT5应用运行的环境
• 源码部署灵活：支持用户自行部署和更新应用源码
• 配置持久化：通过挂载卷实现配置文件和数据的持久化存储

使用场景

• 需要在容器中运行python+QT5图形应用的场景
• 希望通过网页远程访问应用界面的需求
• 需自行管理和更新应用源码的开发或使用场景

使用方法

快速部署（脚本方式）

通过以下命令运行部署脚本，选择模板3) mdcx-src-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 -)"

手动部署（docker-compose方式）

1. 准备项目目录

下载https://github.com/northsea4/mdcx-docker/releases/download/latest/template-mdcx-src-gui-base.zip%EF%BC%8C%E8%A7%A3%E5%8E%8B%E5%90%8E%E8%BF%9B%E5%85%A5%E9%A1%B9%E7%9B%AE%E7%9B%AE%E5%BD%95%EF%BC%88%E5%81%87%E8%AE%BE%E5%90%8D%E4%B8%BA%60mdcx-docker%60%EF%BC%89%E3%80%82

2. 准备应用源码

执行以下命令自动下载源码到app目录：

bash
./update-src.sh

项目目录结构如下：

mdcx-docker
  |-- app          # 应用源码目录
  |-- data         # 容器系统数据目录
  |-- mdcx-config  # 应用配置文件目录
  |-- logs         # 应用日志目录
  |-- .env         # 环境变量文件
  |-- .env.sample  # 环境变量示例文件
  |-- docker-compose.yml  # 容器部署配置文件
  |-- update-src.sh       # 源码更新脚本
  ...

3. 设置环境变量

编辑.env文件，主要参数说明如下：

4. docker-compose配置示例

yaml
version: '3'

services:
  mdcx:
    image: stainless403/mdcx-src-gui-base:${MDCX_SRC_IMAGE_TAG}
    container_name: ${MDCX_CONTAINER_NAME}
    env_file:
      - .env
    volumes:
      - ./data:/config                 # 系统数据目录
      - ./app:/app                     # 源码目录
      - ./mdcx-config:/mdcx-config     # 配置文件目录
      - ./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

5. 启动容器

bash
docker-compose up -d

# 查看日志
# docker logs -f mdcx_gui
# 或
# docker-compose logs -f

首次运行时会自动安装依赖，并在app目录和容器内/tmp目录生成.mdcx_initialized标记文件。若依赖安装失败，删除app目录下的.mdcx_initialized文件即可重新安装。

6. 访问应用

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

docker run方式部署示例

bash
# 创建目录
MDCX_DOCKER_DIR=/path/to/mdcx-docker
mkdir -p $MDCX_DOCKER_DIR && cd $MDCX_DOCKER_DIR
mkdir -p app mdcx-config logs data

# 创建配置文件标记
echo "/mdcx-config/config.ini" > mdcx-config/MDCx.config
touch mdcx-config/config.ini

# 下载源码（需先获取update-src.sh脚本）
./update-src.sh

# 启动容器
docker run -d --name mdcx \
  -p 5800:5800 \
  -p 5900:5900 \
  -v $(pwd)/app:/app \
  -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=your_password \  # 访问密码
  -e USER_ID=$(id -u) \
  -e GROUP_ID=$(id -g) \
  --restart unless-stopped \
  stainless403/mdcx-src-gui-base:latest

更新方法

更新应用源码

bash
cd /path/to/mdcx-docker
chmod +x ./update-src.sh  # 确保有执行权限
./update-src.sh --verbose
docker restart mdcx  # 重启容器使更新生效

若手动更新源码，需删除app目录下的.mdcx_initialized文件。

更新镜像（docker-compose方式）

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

更新镜像（docker-run方式）

推荐使用watchtower工具：

1. 一次性更新：

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

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 * * *" mdcx  # 容器名称

取消定时更新：

bash
docker rm -f watchtower-mdcx