Ghost-Downloader-3 容器化部署3 个文件跑起多平台下载器【免费下载链接】Ghost-Downloader-3The only downloader you need. 下载器的集大成者。项目地址: https://gitcode.com/GitHub_Trending/gh/Ghost-Downloader-3把 Ghost-Downloader-3 这款多平台下载器装进容器核心就三个文件Dockerfile、compose 文件、加宿主机上一个数据目录。前置条件只有装好 Docker 这一件事。读完后你能让下载器在容器里稳定运行配置和下载数据都留在镜像外。部署前环境与物料确认Docker 24 以上自带 compose v2磁盘余量 2GB 起装完依赖后镜像约 1.5GB宿主机规划一个./data目录配置和下载都放这里把仓库克隆到构建目录Dockerfile 与源码放在同级git clone https://gitcode.com/GitHub_Trending/gh/Ghost-Downloader-3仓库本身不带 Dockerfile下面两个文件是放在克隆出来的源码旁边新建的不会动仓库内容。Dockerfile核心配置# 3.13-slim项目要求 Python 3.13pyproject.tomlslim 版省掉桌面环境 FROM python:3.13-slim # PySide6 是 GUI 库即便 offscreen 渲染也需要 OpenGL、XCB 与字体库 RUN apt-get update apt-get install -y --no-install-recommends \ libgl1 libegl1 libxcb-xinerama0 libxkbcommon0 \ fonts-noto-cjk \ rm -rf /var/lib/apt/lists/* # 依赖由 uv 管理pyproject.toml uv.lock项目里没有 requirements.txt RUN pip install --no-cache-dir uv WORKDIR /app # 先复制依赖清单再安装之后改源码不会让依赖缓存失效 COPY pyproject.toml uv.lock ./ RUN uv sync --frozen --no-dev # features/ 是下载功能包B 站、BT、m3u8 等所在目录启动时从这里加载 COPY Ghost-Downloader-3.py . COPY app/ ./app/ COPY features/ ./features/ # 容器里没有显示器offscreen 让 Qt 无界面渲染不崩不闪退 ENV QT_QPA_PLATFORMoffscreen # HOME 指到固定目录配置路径随之固定方便挂载 ENV HOME/data CMD [.venv/bin/python, Ghost-Downloader-3.py]为什么这样写说三点基础镜像选 slim 而不是 full只为压小体积QT_QPA_PLATFORMoffscreen是无头部署的关键它是 PySide6 GUI 程序没有显示器不这么设启动即退出uv sync --frozen严格按uv.lock锁文件装依赖谁来构建环境都一致。features/目录容易漏功能包就是从那里加载的。最小可运行验证docker build -t ghost-downloader . docker run -d --name gd3-test ghost-downloader docker logs -f gd3-test构建、启动、盯日志。看到Ghost Downloader v4.3.7 launched这行说明进程活了docker stop gd3-test即可收工。这一步不引入 compose保持最轻方便把镜像本身有没有问题和挂载有没有问题分开排查。生产化compose 与数据持久化services: ghost-downloader: build: . container_name: ghost-downloader command: .venv/bin/python Ghost-Downloader-3.py --silence environment: - HOME/data volumes: - ./data:/data restart: unless-stoppeddocker compose up -d docker compose logs -f为什么要挂./data应用把配置写到$HOME/.local/share/GhostDownloader见app/config/paths.py里APP_DATA_DIR的取值逻辑下载默认目录是$HOME/Downloads。把 HOME 指到/data再整体挂载任务记录、配置、已下载文件就都留在容器外镜像重建、容器删了都丢不了。--silence跳过首次启动向导向导在无显示器环境下点不了会卡住启动流程。宿主机目录容器内对应原因./data/data即 HOME配置、任务记录、下载文件都在里面不能丢无/app源码镜像已含源码升级靠重建镜像不单独挂载运行中排错现象容器秒退日志里是could not load the Qt platform plugin xcb。 原因没启用 offscreenQt 找不到显示就直接中止。 改法确认 Dockerfile 里保留ENV QT_QPA_PLATFORMoffscreen别删。现象日志停在launched那一行进程还活着但向导不结束、任务不出现。 原因首次启动弹 OOBE 向导offscreen 下没法操作事件循环一直等。 改法启动参数加--silence上面 compose 文件里已经加了。现象docker ps里显示Restarting (137)。 原因137 是被 OOM 杀掉PySide6 加 libtorrent 常驻内存不小。 改法先放宽或去掉内存限制用docker stats观察真实占用后再设限额。源码在镜像里数据在卷里这就是 Ghost-Downloader-3 多平台下载器容器化的全部镜像随时重建./data不动。【免费下载链接】Ghost-Downloader-3The only downloader you need. 下载器的集大成者。项目地址: https://gitcode.com/GitHub_Trending/gh/Ghost-Downloader-3创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考