transmission-remote Docker 镜像下载 - 轩辕镜像

镜像概述与主要用途

transmission-remote Docker镜像是一个容器化的transmission-remote工具，用于远程管理Transmission BitTorrent客户端。无需在本地安装transmission-remote依赖，即可通过命令行与远程Transmission服务（如种子箱、NAS上的Transmission实例）进行交互，执行种子管理、状态查看等操作。

核心功能与特性

• 容器化运行：通过Docker容器提供独立运行环境，避免本地环境依赖冲突
• 认证支持：集成.netrc文件挂载功能，实现远程Transmission服务的安全认证
• 灵活参数传递：支持原生transmission-remote所有命令行参数，满足多样化操作需求
• 临时容器模式：默认使用--rm参数，容器退出后自动清理，减少系统资源占用

使用场景

• 远程管理种子箱或NAS上的Transmission服务
• 需在多设备间统一使用transmission-remote工具的场景
• 希望避免在本地系统安装transmission-remote及其依赖的环境

使用方法与配置说明

基本命令示例（docker run）

直接通过docker run命令执行远程操作：

bash
docker run --rm -v ${HOME}/.netrc:/home/user/.netrc:ro tanel/transmission-remote [***] --netrc /home/user/.netrc -l

• --rm：容器执行完毕后自动删除
• -v ${HOME}/.netrc:/home/user/.netrc:ro：挂载本地.netrc文件（只读）至容器内，用于认证
• [***]：远程Transmission服务的RPC接口地址
• --netrc /home/user/.netrc：指定容器内.netrc文件路径进行认证
• -l：查看当前种子列表（transmission-remote原生参数）

命令行别名配置（.bashrc集成）

为简化日常使用，可在.bashrc或其他shell配置文件中定义函数与别名：

bash
func_transmission_remote() {
  docker run --rm \
             --name transmission-remote \
             -v ${HOME}/.netrc:/home/user/.netrc:ro \
             tanel/transmission-remote \
             [***] \
             --netrc /home/user/.netrc \
             $@
}
alias transmission-remote=func_transmission_remote

配置后可直接通过transmission-remote [参数]调用，例如：

bash
transmission-remote -a [***]  # 添加种子
transmission-remote -t 1 -s                                # 启动ID为1的种子

配置说明

• .netrc文件格式：需包含远程Transmission服务的认证信息，格式如下：

  machine seedbox.tld
  login your_username
  password your_password
  

• 远程地址配置：需替换示例中的[***]为实际Transmission服务的RPC URL（通常以/rpc/结尾）
• 参数说明：支持transmission-remote所有原生参数，完整参数列表可通过docker run --rm tanel/transmission-remote --help查看