https://github.com/northsea4/mdcx-docker
在Docker容器中运行 MDCX，并通过Web界面或远程桌面进行控制。Run MDCX in a Docker container, accessible and controllable via a web interface or remote desktop.
https://github.com/northsea4/mdcx-docker
docker mdcx rdp webtop
Last synced: about 1 year ago
JSON representation
在Docker容器中运行 MDCX，并通过Web界面或远程桌面进行控制。Run MDCX in a Docker container, accessible and controllable via a web interface or remote desktop.
- Host: GitHub
- URL: https://github.com/northsea4/mdcx-docker
- Owner: northsea4
- License: gpl-3.0
- Created: 2023-01-29T08:09:17.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-15T08:46:32.000Z (over 1 year ago)
- Last Synced: 2025-04-14T15:56:54.983Z (about 1 year ago)
- Topics: docker, mdcx, rdp, webtop
- Language: Shell
- Homepage:
- Size: 402 KB
- Stars: 720
- Watchers: 6
- Forks: 86
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://GitHub.com/northsea4/mdcx-docker) [](https://github.com/northsea4/mdcx-docker/releases/tag/latest)
# MDCx Docker
📢 上游源码项目已更改为 [sqzw-x/mdcx](https://github.com/sqzw-x/mdcx)。
👉🏻 如果您当前使用的是`20231014`或之前的版本，请阅读 [更改新源码后的更新说明](https://github.com/northsea4/mdcx-docker/blob/dev/docs/about-new-src.md)。
---
## 镜像
> 「builtin」表示内置已编译的应用，不需要额外下载安装包。
> 「src」表示使用应用的python源码运行，需要额外下载源码。
> 「gui」是最简单的版本，通过Web访问，且只能看到应用窗口。
> 「webtop」有比较完整的桌面环境，可以通过Web访问或RDP访问。
| 镜像 | 部署说明 | 网页查看 | 远程桌面 | 文件管理 | 浏览器 |
| --- | --- | --- | --- | --- | --- |
| [mdcx-builtin-gui-base](https://hub.docker.com/r/stainless403/mdcx-builtin-gui-base/tags) | [查看](https://github.com/northsea4/mdcx-docker/blob/main/gui-base/mdcx-builtin.md) | ✅ | | | |
| [mdcx-builtin-webtop-base](https://hub.docker.com/r/stainless403/mdcx-builtin-webtop-base/tags) | [查看](https://github.com/northsea4/mdcx-docker/blob/main/webtop-base/mdcx-builtin.md) | ✅ | ✅ | ✅ | ✅ |
| [mdcx-src-gui-base](https://hub.docker.com/r/stainless403/mdcx-src-gui-base/tags) | [查看](https://github.com/northsea4/mdcx-docker/blob/main/gui-base/mdcx-src.md) | ✅ | | | |
| [mdcx-src-webtop-base](https://hub.docker.com/r/stainless403/mdcx-src-webtop-base/tags) | [查看](https://github.com/northsea4/mdcx-docker/blob/main/webtop-base/mdcx-src.md) | ✅ | ✅ | ✅ | ✅ |
## 使用脚本部署
复制以下命令到终端运行，根据提示输入几个参数即可完成部署。
使用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 -)"
```
## 手动部署
### mdcx-builtin-gui-base示例
⚠️ 这里只给出一个简单的运行示例，建议查看 [部署说明](https://github.com/northsea4/mdcx-docker/blob/main/gui-base/mdcx-builtin.md) 了解更多细节。
```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
```
浏览器访问 http://192.168.1.100:5800 使用。
### mdcx-builtin-webtop-base示例
⚠️ 这里只给出一个简单的运行示例，建议查看 [部署说明](https://github.com/northsea4/mdcx-docker/blob/main/webtop-base/mdcx-builtin.md) 了解更多细节。
```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 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 /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-builtin-webtop-base:latest
```
- 使用`Windows远程桌面`或`Microsoft Remote Desktop`连接 `192.168.1.100:3389` 使用，账号密码`abc/abc`。
- 浏览器访问 http://192.168.1.100:3000 使用。
## 公网访问
如果有公网访问的需求，请自行设置好访问密码（不要使用默认密码）。
| 镜像 | 默认 | 方式1 |
| --- | --- | --- |
| [mdcx-builtin-gui-base](https://hub.docker.com/r/stainless403/mdcx-builtin-gui-base/tags)
[mdcx-src-gui-base](https://hub.docker.com/r/stainless403/mdcx-src-gui-base/tags) | 空 | 设置环境变量`VNC_PASSWORD` |
| [mdcx-builtin-webtop-base](https://hub.docker.com/r/stainless403/mdcx-builtin-webtop-base/tags)
[mdcx-src-webtop-base](https://hub.docker.com/r/stainless403/mdcx-src-webtop-base/tags) | abc/abc | `docker exec -it 容器名称 passwd abc`
或进入桌面使用命令行工具执行`passwd abc` |
## 申明
当你查阅、下载了本项目源代码或二进制程序，即代表你接受了以下条款：
- 本项目和项目成果仅供技术，学术交流和docker测试使用
- 本项目贡献者编写该项目旨在学习docker和python应用在linux平台上的打包处理
- 用户在使用本项目和项目成果前，请用户了解并遵守当地法律法规，如果本项目及项目成果使用过程中存在违反当地法律法规的行为，请勿使用该项目及项目成果
- 法律后果及使用后果由使用者承担
- [GPL LICENSE](https://github.com/northsea4/mdcx-docker/blob/main/LICENSE.md)
- 若用户不同意上述条款任意一条，请勿使用本项目和项目成果
## 更新日志
请查看 [更新日志](https://github.com/northsea4/mdcx-docker/blob/main/CHANGELOG.md)
## FAQ
请查看 [FAQ](https://github.com/northsea4/mdcx-docker/blob/main/FAQ.md)
## 授权许可
本插件项目在 GPLv3 许可授权下发行。此外，如果使用本项目表明还额外接受以下条款：
- 本项目仅供学习以及技术交流使用
- 请勿在公共社交平台上宣传此项目
- 使用本软件时请遵守当地法律法规
- 法律及使用后果由使用者自己承担
- 禁止将本软件用于任何的商业用途