transmission web界面无法访问时,需依次检查:一、服务是否运行;二、配置是否允许远程访问;三、防火墙是否放行9091端口;四、反向代理设置是否正确;五、selinux是否限制绑定。

如果您尝试通过浏览器访问Transmission的Web界面,但页面无法加载或提示连接被拒绝,则可能是由于服务未运行、端口未开放或配置文件限制了远程访问。以下是解决此问题的步骤:
一、检查Transmission守护进程是否正在运行
Transmission Web UI依赖后台守护进程(transmission-daemon)提供HTTP服务。若该进程未启动,Web界面将完全不可访问。
1、在Linux终端中执行命令 sudo systemctl status transmission-daemon 查看服务状态。
2、若显示“inactive (dead)”,则执行 sudo systemctl start transmission-daemon 启动服务。
3、执行 sudo systemctl enable transmission-daemon 设置开机自启,避免重启后失效。
二、验证Web UI绑定地址与端口配置
Transmission默认仅绑定到本地回环地址(127.0.0.1),这会阻止局域网或外网设备访问。需修改配置使其监听所有接口或指定IP。
1、停止transmission-daemon:执行 sudo systemctl stop transmission-daemon。
2、编辑配置文件:使用命令 sudo nano /var/lib/transmission-daemon/.config/transmission-daemon/settings.json 打开设置。
3、查找 "rpc-bind-address" 字段,将其值改为 "0.0.0.0" 或目标监听IP(如 "192.168.1.100")。
4、确认 "rpc-port" 值(默认为9091),并确保该端口未被其他程序占用。
5、将 "rpc-authentication-required" 设为 true 或 false,根据是否需要密码登录决定;若设为true,还需同步设置 "rpc-username" 和 "rpc-password"。
6、保存文件后,执行 sudo systemctl start transmission-daemon 重启服务。
三、检查防火墙是否放行RPC端口
系统防火墙可能拦截Transmission的RPC端口(默认9091),导致连接超时或被拒绝。
1、对于UFW防火墙,执行 sudo ufw status 查看当前规则。
2、若9091端口未列出,执行 sudo ufw allow 9091 开放该端口。
3、对于firewalld(CentOS/RHEL),运行 sudo firewall-cmd --permanent --add-port=9091/tcp,再执行 sudo firewall-cmd --reload 生效。
四、确认反向代理或Nginx配置未覆盖原始路径
若Transmission Web UI部署在Nginx或Apache后方,错误的location块或proxy_pass设置可能导致静态资源404或API请求失败。
1、检查Nginx配置中是否存在类似 location /transmission/ { proxy_pass http://127.0.0.1:9091/; } 的语句。
2、确保 proxy_set_header Host $host; 和 proxy_set_header X-Real-IP $remote_addr; 已添加。
3、确认Transmission配置中的 "rpc-url" 字段(若存在)与反向代理路径一致,例如设为 "/transmission/rpc"。
4、重启Nginx:执行 sudo systemctl restart nginx。
五、验证SELinux是否阻止网络绑定(仅限RHEL/CentOS/Fedora)
SELinux处于enforcing模式时,可能禁止transmission-daemon绑定非标准端口或监听外部地址。
1、运行 sudo sestatus 查看SELinux当前状态。
2、若为enforcing,临时切换至permissive模式测试:执行 sudo setenforce 0。
3、再次尝试访问Web UI。若此时可访问,说明SELinux策略限制生效。
4、恢复强制模式:执行 sudo setenforce 1,随后运行 sudo ausearch -m avc -ts recent | grep transmission 查找拒绝日志。
5、根据日志输出,用 audit2allow 生成并安装自定义策略模块。










