stainless403/mdcx-builtin-gui-base mdcx-builtin-gui-base ,然后根据提示输入几个参数即可完成部署。
使用curl:
bashbash -c "$(curl -fsSL [***]"
使用wget:
bashbash -c "$(wget [***] -O -)"
以下的步骤是手动部署的详细说明,即使使用了脚本部署,也请务必阅读一下了解更多细节,如安全、更新等。
stainless403/mdcx-builtin-gui-base镜像已内置编译好的MDCx。如果想使用本地MDCx源码版的,请使用stainless403/mdcx-src-gui-base镜像(🔗 查看部署说明)。
下载 示例项目,解压到合适的位置后,进入项目目录。如无特别说明,之后的操作都是在该目录(假设名为mdcx-docker)内进行。
整个项目的结构大致如下:
mdcx-docker |-- data ------容器系统数据 ... |-- mdcx-config --------应用配置文件目录 |-- config.ini |-- MDCx.config |-- logs --------应用日志目录 |-- 2023-02-04-01-15-00.txt |-- .env ------环境变量文件 |-- .env.sample ------环境变量示例文件 |-- .env.versions ------应用版本文件 |-- gui-base-src.sample.yml |-- gui-base-builtin.sample.yml -------容器部署配置示例 |-- docker-compose.yml -------容器部署配置
编辑.env文件,按需修改。
文件里每个参数都有具体的说明,.env.sample文件里可以查看原始的数值。
一般需要修改的参数:VNC_PASSWORD, WEB_PORT, VNC_PORT, USER_ID, GROUP_ID
| 参数名称 | 说明 | 默认值 | 必填 |
|---|---|---|---|
| VNC_PASSWORD | 访问密码,如不需要,留空。如果有在公网远程访问的需求,建议设置 | 无 | 否 |
| WEB_PORT | 网页访问端口 | 5800 | 是 |
| VNC_PORT | VNC监听端口 | 5900 | 是 |
| USER_ID | 运行应用的用户ID,通过id -u命令可以查看当前用户ID,id -u user1则可以查看用户user1的用户ID | 0 | 是 |
| GROUP_ID | 运行应用的用户组ID,通过id -g命令可以查看当前用户组ID,id -g user1则可以查看用户user1的用户组ID | 0 | 是 |
| DISPLAY_WIDTH | 应用窗口宽度 | 1200 | 否 |
| DISPLAY_HEIGHT | 应用窗口高度 | 750 | 否 |
ymlversion: '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.ini) - ./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
bashdocker-compose up -d # 查看容器日志,容器名称请根据实际情况修改 # docker logs -f mdcx_gui # 或者 # docker-compose logs -f
假设服务器IP为192.168.1.100,使用默认端口5800,则访问地址为:[***]
/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.ini" > mdcx-config/MDCx.config # 确保有config.ini文件 touch mdcx-config/config.ini 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
bashcd /path/to/mdcx-docker docker-compose pull docker-compose up -d
注意,只有使用docker-compose方式部署的才能用该方式更新镜像。 另外其实使用docker-compose方式部署的,也可以使用下面说的
watchtower进行更新。
推荐使用watchtower工具更新。
bashdocker run --rm \ -v /var/run/docker.sock:/var/run/docker.sock \ containrrr/watchtower \ --run-once \ 容器名称
个人不太建议自动更新,请自行斟酌。
示例:每天的凌晨2点进行更新
bashdocker 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
取消定时更新:
bashdocker rm -f watchtower-mdcx


探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像服务
在 Docker Desktop 配置镜像
Docker Compose 项目配置
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
在宝塔面板一键配置镜像
Synology 群晖 NAS 配置
飞牛 fnOS 系统配置镜像
极空间 NAS 系统配置服务
爱快 iKuai 路由系统配置
绿联 NAS 系统配置镜像
QNAP 威联通 NAS 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
免费版仅支持 Docker Hub 访问,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等;免费版仅支持 docker.io。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
来自真实用户的反馈,见证轩辕镜像的优质服务