stainless403/mdcx-src-webtop-base

By stainless403

•Updated over 1 year ago

MDCx Docker镜像，支持通过网页或远程桌面使用，需自己部署源码。

Image

10K+

Overview Tags

stainless403/mdcx-src-webtop-base repository overview

⁠0. 关于镜像

stainless403/mdcx-src-webtop-base⁠，是基于 linuxserver/webtop⁠ 构建的适合python+QT5应用运行的镜像。

优点是远程桌面、文件管理和浏览器，缺点是资源占用相对高一些，上手难度也稍高。

⁠1. mdcx-src示例

⁠使用脚本部署

复制以下命令到终端运行，第一步选择模版 4) 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 -)"

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

stainless403/mdcx-src-webtop-base⁠镜像没有内置MDCx，如果想使用内置的，请使用stainless403/mdcx-builtin-webtop-base⁠镜像(🔗 查看部署说明⁠)。

Tips: mdcx-src-webtop-base支持运行已编译的应用，但mdcx-builtin-webtop-base默认情况下不能运行应用源码。

下面主要讲述docker-compose的部署方式。docker-run的方式也有简单的示例。

⁠1.1 准备项目目录

下载示例项目⁠，解压到合适的位置后，进入项目目录，如无特别说明，之后的操作都是在该目录(假设名为mdcx-docker)内进行。

⁠1.2 准备应用源码

执行update-src.sh即可自动下载源码到app目录。

./update-src.sh

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

mdcx-docker
  |-- app   ------应用源码目录
    |-- libs
    |-- resources
    |-- src
    |-- main.py
    |-- requirements.txt
    |-- setup.py
    ...
  |-- data ------容器系统数据
    ...
  |-- mdcx-config --------应用配置文件目录
    |-- config.ini
    |-- MDCx.config
  |-- logs --------应用日志目录
    |-- 2023-02-04-01-15-00.txt
  |-- .env ------环境变量文件
  |-- .env.sample ------环境变量示例文件
  |-- .env.versions ------应用版本文件
  |-- mdcx-builtin.sample.yml
  |-- mdcx-src.sample.yml -------容器部署配置示例
  |-- docker-compose.yml -------容器部署配置
  |-- update-app.sh

⁠1.3 设置参数

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

一般需要修改的参数：RDP_LISTEN_PORT, WEB_PORT, PUID, PGID

参数名称	说明	默认值	必填
RDP_LISTEN_PORT	RDP远程桌面端口	3389	是
WEB_PORT	Web访问端口	3000	是
PUID	运行应用的用户ID，通过`id -u`命令可以查看当前用户ID，`id -u user1`则可以查看用户user1的用户ID	0	是
PGID	运行应用的用户组ID，通过`id -g`命令可以查看当前用户组ID，`id -g user1`则可以查看用户user1的用户组ID	0	是

⁠1.4 完整docker-compose.yml示例

version: '3'

services:
  mdcx:
    image: stainless403/mdcx-src-webtop-base:${MDCX_SRC_IMAGE_TAG}
    container_name: ${MDCX_CONTAINER_NAME}
    env_file:
      - .env
    volumes:
      # 系统数据目录
      - ./data:/config

      # 源码目录
      - ./app:/app

      # 配置文件目录
      - ./mdcx-config:/mdcx-config
      # `配置文件目录`标记文件（纯文本文件，内容为当前使用的配置文件路径，默认/mdcx-config/config.ini）
      - ./mdcx-config/MDCx.config:/app/MDCx.config

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

      # 影片目录
      - /path/to/movies:/movies
    ports:
      - ${WEB_PORT}:3000
      - ${RDP_LISTEN_PORT}:3389
    restart: unless-stopped
    network_mode: bridge
    stdin_open: true

⁠1.5 运行容器

docker-compose up -d

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

首次运行时会自动安装依赖，并在app目录和容器内的/tmp目录生成一个名为.mdcx_initialized的标记文件。当启动脚本检查到这两个文件同时存在时，就认为已安装过依赖。而当重建容器时，由于新容器里没有标记文件，所以会进行一次安装依赖的处理。如果由于网络等原因没有成功安装依赖，但.mdcx_initialized又已生成，删除app目录下的.mdcx_initialized文件即可(容器内的标记文件不需要删除)。

⁠1.6 使用

⚠️ 默认的账号密码是abc/abc。如果需要公网访问，请记得修改密码。

修改密码方式1：docker exec -it mdcx_src_webtop passwd abc

修改密码方式2：进入系统后，打开konsole，然后执行passwd abc

webtop-base重点是支持RDP⁠，也就是常说的远程桌面。默认端口是3389。可以使用支持RDP协议的客户端连接使用。常见的客户端：

Microsoft Remote Desktop / 微软远程桌面，多平台支持
Windows自带的「远程桌面」

另外，也支持网页访问。假设服务器IP为192.168.1.100，使用默认端口3000。则访问地址为：http://192.168.1.100:3000。⁠

进入桌面后，点击桌面上的应用图标即可运行。

⚠️ 初次运行需要安装依赖，请耐心等待30秒到两分钟，不要重复点击！ ⚠️ 初次运行需要安装依赖，请耐心等待30秒到两分钟，不要重复点击！ ⚠️ 初次运行需要安装依赖，请耐心等待30秒到两分钟，不要重复点击！

⁠1.7 docker run运行示例

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

# 选一个合适的目录
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
# 确保有config.ini文件
touch mdcx-config/config.ini

# ！！！下载源码！！！最方便的就是使用`update-src.sh`脚本，自动下载源码文件到`app`目录
./update-src.sh

docker run -d --name mdcx \
  -p 3000:3000 `#Web访问端口` \
  -p 3389:3389 `#RDP访问端口` \
  -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 /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-src-webtop-base:latest

⁠2. 更新

⁠2.1 mdcx-src更新应用

cd /path/to/mdcx-docker

./update-src.sh --verbose

# 完成更新源码之后，重启容器
# docker restart mdcx_src_webtop

⚠️ 如果你选择不使用脚本而是手动进行更新，请记得删除app目录下的.mdcx_initialized文件。

⁠2.2 docker-compose方式更新镜像

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

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

⁠3.2 docker-run方式更新

推荐使用watchtower工具更新。

一次性更新

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

定时任务方式：

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

示例：每天的凌晨2点进行更新

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⁠

取消定时更新：

docker rm -f watchtower-mdcx

Tag summary

Recent tags

Content type

Image

Digest

sha256:b18545ccc…

Size

910.5 MB

Last updated

over 2 years ago

docker pull stainless403/mdcx-src-webtop-base