mobilistics/pyload

PyLoad Docker镜像文档

镜像概述和主要用途

pyLoad是一款快速、轻量级且功能全面的下载管理器，支持多种一键主机（One-Click-Hoster）、DLC等容器格式、视频网站链接以及普通http/ftp链接。其设计目标是低硬件需求和平台独立性，可运行于各类系统（如桌面PC、上网本、NAS、路由器等）。尽管硬件要求严格，pyLoad仍具备丰富功能，包括Web界面、验证码识别、解压缩等。pyLoad分为核心和客户端两部分，便于远程访问，目前提供Web界面、命令行界面和Qt编写的GUI客户端。

官方pyLoad项目

核心功能和特性

• 多链接支持：兼容一键主机、DLC容器格式、视频网站及http/ftp链接
• 轻量级设计：低硬件资源占用，适合资源有限的设备
• 跨平台运行：可在桌面PC、NAS、路由器等多种系统上部署
• 丰富功能集：包含Web管理界面、自动验证码识别、解压缩等功能
• 远程访问：支持Web界面、命令行和Qt GUI多种客户端
• 配置持久化：支持将配置文件和下载目录挂载到宿主机，实现数据持久化
• 权限控制：可通过环境变量指定下载文件的UID和GID，避免权限问题

使用场景和适用范围

• 个人用户在家庭网络中搭建下载服务器
• NAS设备上部署以管理下载任务
• 资源有限的嵌入式设备（如路由器）中运行轻量级下载服务
• 需要远程管理下载任务的场景（通过Web界面）
• 批量下载各类网络资源（视频、文件等）

安装方法

拉取镜像命令如下：

sh
docker pull mobilistics/pyload:latest

注意：如果pyload无法更新插件，尝试使用latest标签

使用方法

基本运行

sh
docker run -d -P mobilistics/pyload:latest

配置说明

挂载下载目录

将宿主机目录与容器内下载目录关联，实现下载文件持久化：

sh
docker run -d -v <宿主机目录>:/opt/pyload/Downloads -P mobilistics/pyload:latest

示例：若需将下载文件存储在宿主机/tmp/Downloads目录：

sh
docker run -d -v /tmp/Downloads:/opt/pyload/Downloads -P mobilistics/pyload:latest

挂载配置目录

将配置目录挂载到宿主机，实现配置持久化：

sh
docker run -d -v <宿主机目录>:/opt/pyload/pyload-config -P mobilistics/pyload:latest

设置文件权限（UID/GID）

默认情况下，pyload以root用户运行，下载文件的UID和GID为0。可通过环境变量UID和GID指定下载文件的用户和组ID：

完整Docker运行命令

sh
docker \
    run \
    -d \
    -v <宿主机下载目录>:/opt/pyload/Downloads \
    -v <宿主机配置目录>:/opt/pyload/pyload-config \
    -e UID=<用户ID> \
    -e GID=<组ID> \
    -P \
    mobilistics/pyload:latest

Docker Compose配置示例

yaml
version: "2"
services:
    pyload:
      image: mobilistics/pyload:latest
      container_name: pyload
      ports:
        - 8000:8000
      environment:
        - UID=1000
        - GID=1000
      volumes:
        - /path/to/config:/opt/pyload/pyload-config  # 宿主机配置目录
        - /path/to/data:/opt/pyload/Downloads        # 宿主机下载目录

访问与登录

容器创建后，可通过Web界面访问pyLoad，地址为：<宿主机IP>:8000

默认登录凭据：

• 用户名：pyload
• 密码：pyload