mdcx-builtin-webtop-base 镜像文档

0. 关于镜像

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

优点是集成远程桌面、文件管理和浏览器功能，缺点是资源占用相对较高，上手难度稍高。

1. mdcx-builtin示例部署

使用脚本部署

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

使用curl：

bash -c "$(curl -fsSL [***]"

使用wget：

bash -c "$(wget [***] -O -)"

以下为手动部署详细说明，即使使用脚本部署，建议阅读以了解安全、更新等细节。

stainless403/mdcx-builtin-webtop-base 镜像已内置编译好的MDCx。若需使用本地MDCx源码版，可使用 stainless403/mdcx-src-webtop-base 镜像 (🔗 查看部署说明)。

1.1 准备项目目录

下载 示例项目，解压到合适位置后进入项目目录（假设名为mdcx-docker），后续操作均在此目录内进行。

项目结构如下：

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

1.2 设置参数

编辑.env文件，按需修改以下关键参数：

1.3 完整docker-compose.yml示例

version: '3'

services:
  mdcx:
    image: stainless403/mdcx-builtin-webtop-base:${MDCX_BUILTIN_IMAGE_TAG}
    container_name: ${MDCX_CONTAINER_NAME}
    env_file:
      - .env
    volumes:
      # 系统数据目录
      - ./data:/config
          
      # 配置文件目录
      - ./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.4 运行容器

docker-compose up -d

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

1.5 使用说明

⚠️ 安全提示：默认账号密码为abc/abc。若需公网访问，务必修改密码。

• 修改密码方式1：docker exec -it mdcx_webtop passwd abc
• 修改密码方式2：进入系统后打开konsole，执行passwd abc

访问方式

1. 远程桌面（RDP）：默认端口3389，支持RDP协议的客户端（如微软远程桌面、Windows自带远程桌面）连接。
2. 网页访问：假设服务器IP为192.168.1.100，默认端口3000，访问地址：[***]

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

1.6 docker run运行示例

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

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
# 创建配置文件
touch mdcx-config/config.ini

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 /path/to/movies:/movies `#影片目录（替换为实际路径）` \
  -e TZ=Asia/Shanghai \
  -e AUTO_LOGIN=false `#网页访问是否自动登录（true/false）` \
  -e PUID=$(id -u) `#运行应用的用户ID` \
  -e PGID=$(id -g) `#运行应用的用户组ID` \
  --restart unless-stopped \
  stainless403/mdcx-builtin-webtop-base:latest

2. 更新方法

2.1 docker-compose方式更新

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

2.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 * * *" 容器名称

定时任务格式：秒 分 时 日 月 星期（参考 CRON_Expression_Format）

取消定时更新：

docker rm -f watchtower-mdcx