Linux 上安装和配置 Transmission

本文详细记录了在 Ubuntu Linux 系统上安装、配置 Transmission BitTorrent 客户端，更换中文 Web 控制面板，以及通过 FRP 实现内网穿透的全过程。内容包括基础安装、目录配置、权限设置、网络穿透和界面美化，并针对过程中遇到的各种问题提供了解决方案。

完整安装与配置过程

1. 安装 Transmission Daemon

通过包管理器安装 Transmission 的守护进程版本：

sudo apt update
sudo apt install transmission-daemon

2. 配置文件修改

Transmission 的主要配置文件位于 /etc/transmission-daemon/settings.json。修改前需要先停止服务：

sudo systemctl stop transmission-daemon

关键配置项说明：

{
    "download-dir": "/home/mrdio/Storage_DATA/transmission_down",
    "rpc-authentication-required": true,
    "rpc-username": "transmission",
    "rpc-password": "{加密密码}",
    "rpc-port": 9091,
    "rpc-whitelist": "127.0.0.1",
    "rpc-whitelist-enabled": true,
    "cache-size-mb": 64
}

目录权限设置：

创建下载目录并设置正确的权限：

mkdir -p /home/mrdio/Storage_DATA/transmission_down
sudo chown -R debian-transmission:debian-transmission /home/mrdio/Storage_DATA/transmission_down

3. FRP 内网穿透配置

通过 FRP 将 Transmission Web 界面暴露到公网，frpc.toml配置如下：

serverAddr = "39.104.61.219"
serverPort = 7000
auth.token = "2653516164"

[[proxies]]
name = "transmission-tcp"
type = "tcp"
localIP = "127.0.0.1"
localPort = 9091
remotePort = 9092

4. 安装中文 Web 控制面板

使用开源项目 Transmission Web Control 替换官方界面：

sudo bash install-tr-control-cn.sh

选择选项 1安装最新发布版本。

遇到的问题及解决方案

问题 1：配置文件权限问题

​​问题描述：​​

尝试直接修改配置文件时遇到权限不足的问题。

​​解决方案：​​

必须使用 sudo权限编辑配置文件，且修改前需要停止服务：

sudo systemctl stop transmission-daemon
sudo nano /etc/transmission-daemon/settings.json
sudo systemctl start transmission-daemon

问题 2：下载目录权限错误

​​问题描述：​​

Transmission 无法在新建的下载目录中创建文件。

​​错误现象：​​

权限拒绝错误或任务无法开始下载。

​​解决方案：​​

需要将目录所有者更改为 Transmission 服务用户：

# 首先确认 Transmission 的运行用户
ps -ef | grep transmission

# 更改目录所有者（以 debian-transmission 为例）
sudo chown -R debian-transmission:debian-transmission /home/mrdio/Storage_DATA/transmission_down

# 验证更改结果
ls -ld /home/mrdio/Storage_DATA/transmission_down

问题 3：Web 控制面板安装脚本权限不足

​​问题描述：​​

直接运行安装脚本时提示需要 root 权限。

​​用户输入：​​

mrdio@mrdio-YAO-9000II:~/APP_DATA$ ./install-tr-control-cn.sh 
/usr/bin/whoami
<< 2025-08-28 10:19:55 >> 无法确认当前是否为 root 用户，可能无法进行安装操作。是否继续？（y/n）

​​解决方案：​​

使用 sudo权限执行安装脚本：

sudo bash install-tr-control-cn.sh

然后在交互菜单中选择选项 1安装最新发布版本。

问题 4：FRP 穿透后无法访问

​​问题描述：​​

配置 FRP 后通过公网地址无法访问 Web 界面。

​​原因分析：​​

Transmission 默认只允许 127.0.0.1访问，需要修改白名单设置。

​​解决方案：​​

在 settings.json中修改白名单配置：

{
    "rpc-whitelist": "127.0.0.1,39.104.61.219",
    "rpc-whitelist-enabled": true
}

或者为测试暂时禁用白名单（测试后建议重新启用）：

{
    "rpc-whitelist-enabled": false
}

问题 5：缓存大小优化

​​问题描述：​​

默认缓存大小较小，可能导致硬盘频繁读写。

​​解决方案：​​

增加缓存大小到 64MB 或 128MB：

{
    "cache-size-mb": 64
}

最终效果

完成所有配置后：

1. Transmission 服务正常运行，使用指定下载目录

2. 通过本地 http://localhost:9091/transmission/可访问中文 Web 界面

3. 通过公网 http://39.104.61.219:9092/transmission/可远程管理下载任务

4. 拥有功能更丰富、中文支持更好的用户界面

总结

通过本文记录的步骤，可以成功在 Linux 系统上部署功能完整的 Transmission 下载服务，解决常见的权限和配置问题，实现远程访问和界面美化。关键点在于正确的权限设置和服务重启流程，以及针对网络环境的适当配置。

​​相关项目链接：​​

• Transmission: https://transmissionbt.com/

• Transmission Web Control: https://github.com/ronggang/transmission-web-control

• FRP: https://github.com/fatedier/frp

希望这份详细的记录对需要在 Linux 上部署 Transmission 的用户有所帮助！