BT 客户端

Transmission 配置指南

轻量级 BT 客户端的完整部署方案

Transmission 是轻量级、稳定的 BT 客户端，特别适合服务器环境部署

📖 概述

Transmission 是一款轻量级、高效的开源 BT 客户端，特别适合在服务器环境中部署。支持 Web 界面远程管理，是 Seedbox 和 NAS 的热门选择。

为什么选择 Transmission？

🪶 极其轻量：资源占用极低，适合长期运行
🌐 Web 管理：内置 Web 界面，支持远程控制
🐧 跨平台：支持 Linux、macOS、Windows 等平台
🔧 易于配置：配置文件简单，API 完善
📦 Docker 友好：容器化部署简单可靠

🚀 安装部署

生产环境建议使用 Docker 部署，版本控制和维护更加便利

Docker 部署（推荐）

Docker 部署提供了最佳的环境隔离和版本管理体验

version: '3.8'
services:
  transmission:
    image: linuxserver/transmission:latest
    container_name: transmission
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - TRANSMISSION_WEB_HOME=/transmission-web-control/
    volumes:
      - ./config:/config
      - ./downloads:/downloads
      - ./watch:/watch
    ports:
      - 9091:9091
      - 51413:51413
      - 51413:51413/udp
    restart: unless-stopped

# 创建目录
mkdir -p transmission/{config,downloads,watch}

# 启动容器
docker-compose up -d

# 查看日志
docker-compose logs -f transmission

Linux 原生安装

# 安装 Transmission
sudo apt update
sudo apt install transmission-daemon transmission-cli

# 启动服务
sudo systemctl enable transmission-daemon
sudo systemctl start transmission-daemon

# 安装 EPEL 仓库
sudo yum install epel-release

# 安装 Transmission
sudo yum install transmission-daemon transmission-cli

# 启动服务
sudo systemctl enable transmission-daemon
sudo systemctl start transmission-daemon

macOS 安装

# 安装桌面版
brew install transmission

# 或安装命令行版
brew install transmission-cli

# 访问官网下载 macOS 版本
# https://transmissionbt.com/download/

⚙️ 核心配置

重要：修改配置前必须停止 Transmission 服务，否则配置将被覆盖

配置文件位置

系统	配置文件路径
Linux	`/var/lib/transmission-daemon/.config/transmission-daemon/settings.json`
macOS	`~/Library/Application Support/Transmission/settings.json`
Windows	`%LOCALAPPDATA%\transmission\settings.json`
Docker	`/config/settings.json`

🚀 基础配置流程

停止服务

sudo systemctl stop transmission-daemon

编辑配置文件

sudo nano /var/lib/transmission-daemon/.config/transmission-daemon/settings.json

启动服务

sudo systemctl start transmission-daemon

关键配置项说明

{
    "bind-address-ipv4": "0.0.0.0",
    "bind-address-ipv6": "::",
    "peer-port": 51413,
    "peer-port-random-on-start": false,
    "port-forwarding-enabled": true,
    "utp-enabled": true
}

{
    "download-dir": "/downloads/completed",
    "incomplete-dir": "/downloads/incomplete", 
    "incomplete-dir-enabled": true,
    "watch-dir": "/downloads/watch",
    "watch-dir-enabled": true,
    "preallocation": 1,
    "rename-partial-files": true
}

{
    "speed-limit-down": 0,
    "speed-limit-down-enabled": false,
    "speed-limit-up": 0,
    "speed-limit-up-enabled": false,
    "alt-speed-down": 1000,
    "alt-speed-up": 500,
    "alt-speed-enabled": false
}

{
    "peer-limit-global": 200,
    "peer-limit-per-torrent": 50,
    "upload-slots-per-torrent": 8,
    "queue-stalled-minutes": 30,
    "download-queue-size": 10,
    "seed-queue-size": 20
}

🌍 Web UI 访问配置

Web UI 是 Transmission 的核心管理界面

{
    "rpc-enabled": true,
    "rpc-bind-address": "0.0.0.0",
    "rpc-port": 9091,
    "rpc-url": "/transmission/",
    "rpc-authentication-required": true,
    "rpc-username": "admin",
    "rpc-password": "your_password_here",
    "rpc-whitelist-enabled": false,
    "rpc-host-whitelist-enabled": false
}

安全提示：生产环境务必启用身份验证并设置强密码

🎨 界面增强

Transmission Web Control 提供了更美观、功能更丰富的管理界面

📦 安装 Transmission Web Control

下载最新版本

cd /tmp
wget https://github.com/ronggang/transmission-web-control/raw/master/release/transmission-control-full.tar.gz

解压并安装

tar -xzf transmission-control-full.tar.gz
sudo cp -r transmission-control-full/* /usr/share/transmission/web/

重启服务生效

sudo systemctl restart transmission-daemon

🌟 增强功能特性

🎨 现代化界面：Material Design 风格，视觉体验更佳
📊 详细统计：实时流量、历史数据、种子状态分析
🔍 智能搜索：支持多条件筛选和快速定位
📱 移动适配：完美支持手机和平板设备
🌈 多主题：内置多种主题，支持暗色模式
🔧 批量操作：支持批量暂停、删除、分类管理

🚨 故障诊断

遇到问题时，请按照以下步骤逐一排查

📋 常见问题速查表

问题现象	可能原因	解决方案
Web UI 无法访问	防火墙阻挡	检查防火墙规则和端口开放
下载速度极慢	端口未转发	配置路由器端口转发或启用 UPnP
配置不生效	服务未重启	修改配置后务必重启服务
权限错误	用户权限不足	检查 transmission 用户的目录权限

🔧 诊断命令工具

# 查看服务运行状态
systemctl status transmission-daemon

# 查看服务是否自启动
systemctl is-enabled transmission-daemon

# 查看实时日志
journalctl -u transmission-daemon -f

# 查看最近的错误日志
journalctl -u transmission-daemon --since "1 hour ago" -p err

# 测试端口连通性
telnet your-server-ip 51413

# 检查端口监听情况
netstat -tlnp | grep :51413

# 验证配置文件语法
transmission-daemon --dump-settings

# 检查配置文件权限
ls -la /var/lib/transmission-daemon/.config/transmission-daemon/

🔗 相关工具

qBittorrent 配置 - 功能更丰富的 BT 客户端
MoviePilot 配置 - 自动化影视资源管理
Jellyfin 部署 - 开源媒体服务器
Plex 配置 - 专业媒体服务器
Emby 设置 - 功能丰富的媒体服务器

🎉 部署完成！

Transmission 现在已经配置完毕，您可以通过 Web 界面远程管理所有种子任务。

下一步建议：

🔐 修改默认密码确保安全
📁 配置合适的下载目录结构
🔄 设置自动启动和监控
🌐 考虑配置反向代理和 HTTPS

qBittorrent 配置指南

功能强大的开源 BT 客户端完整配置方案

MoviePilot 配置指南

全自动影视资源管理系统部署与配置完整指南