charlocharlie/qbittorrent-port-forward-file

qbittorrent-port-forward-file

镜像概述和主要用途

一个Shell脚本和Docker容器，用于从文本文件自动设置qBittorrent的监听端口。通过读取指定文件中的端口号，该容器可自动配置qBittorrent的监听端口，适用于需要动态获取端口转发信息的场景。

核心功能和特性

• 自动读取指定文本文件中的端口号
• 通过qBittorrent Web UI API设置监听端口
• 支持自定义qBittorrent连接信息（用户名、密码、Web UI地址）
• 可配置端口文件路径和挂载目录
• 轻量级实现，易于集成到现有Docker环境

使用场景和适用范围

主要用于与支持将转发端口写入文件的***工具配合使用，例如：

• docker-*-pia**：当启用端口转发并配置端口持久化时，可将转发端口写入文件
• *******：配置端口转发状态文件后，该容器可读取并应用端口

适用于需要动态更新qBittorrent监听端口的场景，确保端口转发与BT客户端配置保持同步。

详细配置和使用方法

环境变量

卷

Docker Compose配置示例

yaml
services:
  qbittorrent-port-forwarder:
    container_name: qbittorrent-port-forwarder
    image: ghcr.io/claabs/qbittorrent-port-forward-file:latest
    environment:
      - QBT_USERNAME=admin
      - QBT_PASSWORD=adminadmin
      - QBT_ADDR=http://192.168.1.100:8080
      - PORT_FILE=/config/forwarded_port.txt
    volumes:
      - ./config:/config:ro
    restart: unless-stopped

与其他工具配合使用

配合docker-***-pia使用

需在docker-***-pia中配置：

• 环境变量：PORT_FORWARDING=1
• 环境变量：PORT_PERSIST=1
• 环境变量：PORT_FILE=/pia/forwarded_port.txt
• 卷：/my/host/dir:/pia:rw（确保端口文件可被写入）

配合***使用

需在***中配置：

• 环境变量：PRIVATE_INTERNET_ACCESS_VPN_PORT_FORWARDING=on
• 环境变量：PRIVATE_INTERNET_ACCESS_VPN_PORT_FORWARDING_STATUS_FILE=/gluetun/forwarded_port.txt
• 卷：/my/host/dir:/gluetun:rw（确保端口文件可被写入）

开发指南

构建镜像

bash
docker build . -t qbittorrent-port-forwarder

运行容器

bash
docker run --rm -it -e QBT_ADDR=[***] -v $(pwd)/config:/config qbittorrent-port-forwarder:latest