tdeutsch/jdownloader-headless

jdownloader-headless

镜像概述和主要用途

jdownloader-headless是JDownloader 2的Docker镜像，支持无头（无图形界面）运行，可通过MyJDownloader平台远程控制。该镜像解决了原版在Kubernetes环境中的兼容性问题，提供多架构支持，无需VNC即可轻松管理下载任务，适用于家庭媒体服务器、远程下载管理等场景。

核心功能和特性

• 多架构支持：兼容amd64、armv7和arm64架构，包括树莓派等设备（RPI Zero需指定arm32v6标签）
• MyJDownloader集成：通过MyJDownloader平台远程控制，无需VNC会话
• 持久化存储：配置文件、下载目录和日志可通过卷挂载持久化到主机
• 灵活配置：支持通过环境变量或命令行设置MyJDownloader账号、设备名称等参数
• 直接连接模式：支持端口3129的直接连接，提升GUI响应速度和数据更新效率

使用场景和适用范围

• 家庭媒体服务器：后台运行下载任务，通过MyJDownloader远程管理
• 远程下载管理：在无图形界面的服务器或NAS上部署，通过网页或移动设备控制
• 多设备同步：在不同架构设备（如x86服务器、ARM开发板）上统一部署
• Kubernetes环境：解决原版镜像在K8s中的兼容性问题

使用方法和配置说明

镜像标签

• latest：最新稳定版
• 版本标签：如1.0.0（镜像版本，非JDownloader版本）、1.0、1
• weekly：每周自动构建版
• devel：代码提交后自动构建的开发版

安装示例

Docker命令

bash
docker run -d --init --restart=always \
  -v </path/to/downloads>:/opt/JDownloader/Downloads \
  -v </path/to/appdata/config>:/opt/JDownloader/cfg \
  --name jdownloader \
  -u $(id -u) \
  -p 3129:3129 \
  -e MYJD_USER=email@email.com \
  -e MYJD_PASSWORD=bar \
  -e MYJD_DEVICE_NAME=goofy \
  tdeutsch/jdownloader-headless

Docker Compose配置

yaml
services:
  jdownloader:
    image: tdeutsch/jdownloader-headless
    container_name: jdownloader
    restart: always
    user: 1001:100  # 替换为实际的UID:GID
    volumes:
      - </path/to/appdata/config>:/opt/JDownloader/cfg  # 配置文件目录
      - </path/to/downloads>:/opt/JDownloader/Downloads  # 下载目录
      - </path/to/appdata/logs>:/opt/JDownloader/logs  # 日志目录（可选）
      - /etc/localtime:/etc/localtime:ro  # 同步主机时间（可选）
    environment: 
      MYJD_USER: email@email.com  # MyJDownloader账号（可选，见下方说明）
      MYJD_PASSWORD: bar  # MyJDownloader密码（可选，见下方说明）
      MYJD_DEVICE_NAME: goofy  # 设备名称（可选）
      XDG_DOWNLOAD_DIR: /opt/JDownloader/Downloads  # 下载目录（可选，需与卷挂载一致）
      UMASK: "0002"  # 文件权限掩码（可选，八进制格式）
    ports:
      - 3129:3129  # 直接连接模式端口

配置参数说明

卷挂载

环境变量

账号配置

若未通过环境变量设置MYJD_USER和MYJD_PASSWORD，可通过以下命令配置账号：

bash
docker exec jdownloader configure email@email.com password

其他配置可通过MyJDownloader网页端（[***]

附录

直接连接模式

直接连接模式通过端口3129实现客户端与JDownloader的直接通信，替代通过MyJDownloader服务器中转，提升响应速度和数据更新效率。启用方法：

1. 容器启动时暴露3129端口（-p 3129:3129）
2. 在MyJDownloader网页端或客户端中启用直接连接模式
3. 如需从公网访问，需在路由器中端口转发3129端口

DNS绑定警告

部分高级路由器（如Fritz!Box、Asus、OpenWRT等）启用了DNS Rebind保护，会阻止直接连接。需将mydns.jdownloader.org加入白名单：

• Fritz!Box：参考JDownloader官方知识库文章
• Asus Merlin：编辑dnsmasq配置，添加rebind-domain-ok=/mydns.jdownloader.org/
• OpenWRT：网络>DHCP和DNS>常规设置，在“域名白名单”中添加mydns.jdownloader.org
• pfSense：参考https://github.com/jaymoulin/docker-jdownloader/issues/61#issuecomment-607474205

桥接网络中的直接连接配置

1. 暴露3129端口（-p 3129:3129）
2. 进入JDownloader设置>高级设置，搜索“myjdownloader”
3. 在“MyJDownloaderSettings: Custom Device IPs”中输入主机LAN IP，格式如["192.168.1.10"]（多IP用["192.168.1.10","10.10.10.10"]）
4. 设置“MyJDownloaderSettings: Manual Local Port”为3129
5. 设置“MyJDownloaderSettings: Direct Connect Mode”为“Allow lan/wan connections with manual port forwarding”
6. 重启JDownloader使配置生效

调试方法

在下载目录中创建jdownloader-block.txt文件可暂停容器启动，便于通过shell调试：

bash
docker exec -it jdownloader sh

相关链接

• 原始仓库：https://github.com/jaymoulin/docker-jdownloader
• 代码仓库：https://github.com/tuxpeople/docker-jdownloader-headless
• 问题反馈：https://github.com/tuxpeople/docker-jdownloader-headless/issues