请注意，本文编写于 520 天前，最后修改于 520 天前，其中某些信息可能已经过时。
0. 为什么要使用 Transmission
- 开源免费，无广告；
- 全平台支持，适合 NAS 系统；
- 没有内容审查，无法下载等情况；
- 迅雷下载故意降速，很多资源无速度或只能下载到 99%；
1. 安装
1.1 添加源
打开【套件中心】选择【套件来源】新增一个非群晖官方的套件安装源。
名称 ：synocommunity 位置 ：http://packages.synocommunity.com
1.2 开启信任层级
由于非群晖官方套件，如果不开启信任，会提示安装失败。
1.3 安装 Transmission
添加之后，刷新或重新打开套件中心找到社群并找到 Transmission 点击安装。
2. 配置目录
2.1 设置文件夹路径
安装成功后会弹出配置界面，我们暂时先不要配置，先打开 File Station 创建下载文件夹
- dowload 文件下载完成后再会出现再该目录，所以可以直接关联该目录为媒体库；
- incomplete 临时文件，正在下载但是未下载完成的文件；
- watch 这个目录一旦放入 torrent 文件，会自动创建任务并下载，适合做批量和自动下载。
按照示例分别创建 download incomplete watch 文件夹
- 上述路径，都需要授权 sc-download 用户读写权限，否则将 tr 将无法下载或自动添加种子。
- 后面两个路径如果不写，默认禁用相应的功能
根据自己实际需求填写文件夹地址
填写对应文件夹地址到安装界面，点击 下一步 ，填写 后台管理用户名和密码（一定要记住） ，继续下一步完成后会启动。
2.2 设置文件夹权限
在开始使用之前，我们还需要设置目标 下载文件夹读写权限，否则会出现无权限读取和写入。
设置读写权限，需要设置好 sc-download 用户完全读写权限：
设置，打开 http://你的IP 地址:9091 或者通过已安装套件中点击启动会自动跳转到该管理控制台，输入安装过程中我们设置的用户名和密码，进入管理控制台。
3. 下载文件与控制
3.1 控制台页面介绍
3.2 GUI 客户端控制
除了网页之外，我们还可以通过电脑上安装 Transmission 客户端软件进行下载任务的控制。打开 transgui 选择对应平台软件下载并安装。
4. 安装增强汉化版 WebUI
4.1 项目地址：
https://github.com/ronggang/transmission-web-control
4.2 如何安装（SSH 方式）
安装之前
- 请确认系统已安装 Transmission；
- 请确认你是否有 root 用户权限；
4.3 获取最新的安装脚本
- 使用终端以
root用户登录到你的系统，以下脚本假设你已经使用root用户；（方法自行搜索） - 记住当前路径（如 /volume1/ ），以后用到，因为 wget 下载的文件会保存到当前目录；
- 获取最新的安装脚本：
wget https://github.com/ronggang/transmission-web-control/raw/master/release/install-tr-control-cn.sh- 请留意执行结果，如果出现
install-tr-control-cn.sh.1之类的提示，表示文件已存在，请使用rm install-tr-control-cn.sh*删除之前的脚本再重新执行上面的命令； - 如果提示
https获取失败，请使用以下命令获取安装脚本：
wget https://github.com/ronggang/transmission-web-control/raw/master/release/install-tr-control-cn.sh --no-check-certificate- 如果提示文件已存在，可以通过
rm install-tr-control-cn.sh进行删除后再执行下载；或者在wget后面添加-N参数，如：
wget -N https://github.com/ronggang/transmission-web-control/raw/master/release/install-tr-control-cn.sh --no-check-certificate4.4 执行安装脚本
- 执行安装脚本（如果系统不支持
bash命令，请尝试将bash改为sh）：
bash install-tr-control-cn.sh- 如果出现
Permission denied之类的提示，表示没有权限，可尝试添加执行权限：
chmod +x install-tr-control-cn.sh- 如果命令成功执行，将出现以下界面：
- 按照提示，输入相应的数字，按回车即可；
- 如果无法正常显示中文，请尝试设置 SSH 客户端编码为
UTF-8，如依然不能显示中文，请下载并使用英文安装脚本install-tr-control.sh
wget https://github.com/ronggang/transmission-web-control/raw/master/release/install-tr-control.sh --no-check-certificate- 安装完成后，用浏览器访问 Transmission Web Interface（如：http://192.168.1.1:9091/ ）即可看到新的界面；如果无法看到新界面，可能是浏览器缓存了，请按
Ctrl + F5强制刷新页面或 [清空缓存]后再重新打开； - 如果在知道自己的 Transmission Web 所在目录，也可以在安装脚本后面直接加路径，以避免搜索，如：
bash install-tr-control-cn.sh /var/packages/transmission/target/share/transmission- 注意，路径最后 不要 加
web；
5. 关于下载速度
- 带宽的大小决定了下载速度的上限；
- 资源的热度也可以决定下载速度快慢，一般冷门资源速度较慢；
- 一开始速度较慢可以稍等，比如到了晚上可能速度就会边快，理论上越多人下载，速度越快；
- 如果速度特别甚至为 0 ，可以考虑更换其它同内容磁力链接。
6. 备份恢复做种列表
6.1 明确 Transmission 安装位置
我的安装位置：所在磁盘的 /volume3/@appstore/transmission/
6.2. 备份文件夹
备份安装路径 resume 和 torrents 文件夹，如果没有暂定任务，resume 文件夹内无内容。
/volume3/@appstore/transmission/var/torrents
/volume3/@appstore/transmission/var/resume
可以创建群辉定时任务，这样群辉可以定期备份做种列表和种子，任务内容如下，需要根据自己的情况修改
# 按日期新建备份文件夹
mkdir -p /var/services/homes/admin/PTools/transmission/resume/`date +%y%m%d`
mkdir -p /var/services/homes/admin/PTools/transmission/torrents/`date +%y%m%d`
# 备份至新建的文件夹
cp -rf /volume2/@appstore/transmission/var/resume/* /var/services/homes/admin/PTools/transmission/resume/`date +%y%m%d`
cp -rf /volume2/@appstore/transmission/var/torrents/* /var/services/homes/admin/PTools/transmission/torrents/`date +%y%m%d`6. 3. 重装 tr 后恢复做种列表
将备份的文件夹覆盖新的安装路径对应位置，然后修改种子文件和 resume 文件的权限、所有者、所有组。
chmod 600 *
chown sc-transmission *
chgrp transmission *
ll修改完成之后，重启 Tr 即可看到亲切的做种列表。
PS：install-tr-control.sh 代码备份
#!/bin/bash
# 获取第一个参数
ARG1="$1"
ROOT_FOLDER=""
SCRIPT_NAME="$0"
SCRIPT_VERSION="1.2.2-beta2"
VERSION=""
WEB_FOLDER=""
ORG_INDEX_FILE="index.original.html"
INDEX_FILE="index.html"
TMP_FOLDER="/tmp/tr-web-control"
PACK_NAME="master.tar.gz"
WEB_HOST="https://github.com/ronggang/transmission-web-control/archive/"
DOWNLOAD_URL="$WEB_HOST$PACK_NAME"
# 安装类型
# 1 安装至当前 Transmission Web 所在目录
# 2 安装至 TRANSMISSION_WEB_HOME 环境变量指定的目录，参考：https://github.com/transmission/transmission/wiki/Environment-Variables#transmission-specific-variables
# 使用环境变量时，如果 transmission 不是当前用户运行的，则需要将 TRANSMISSION_WEB_HOME 添加至 /etc/profile 文件，以达到“永久”的目的
# 3 用户指定参数做为目录，如 sh install-tr-control.sh /usr/local/transmission/share/transmission
INSTALL_TYPE=-1
SKIP_SEARCH=0
AUTOINSTALL=0
if which whoami 2>/dev/null; then
USER=`whoami`
fi
#==========================================================
MSG_TR_WORK_FOLDER="当前 Transmission Web 目录为: "
MSG_SPECIFIED_VERSION="您正在使用指定版本安装，版本："
MSG_SEARCHING_TR_FOLDER="正在搜索 Transmission Web 目录..."
MSG_THE_SPECIFIED_DIRECTORY_DOES_NOT_EXIST="指定的目录不存在，准备进行搜索，请稍候..."
MSG_USE_WEB_HOME="使用 TRANSMISSION_WEB_HOME 变量: $TRANSMISSION_WEB_HOME"
MSG_AVAILABLE="可用"
MSG_TRY_SPECIFIED_VERSION="正在尝试指定版本"
MSG_PACK_COPYING="正在复制安装包..."
MSG_WEB_PATH_IS_MISSING="错误 : Transmisson WEB 目录不存在，请确认是否已安装 Transmisson 。"
MSG_PACK_IS_EXIST=" 已存在，是否重新下载？（y/n）"
MSG_SIKP_DOWNLOAD="\n跳过下载，正在准备安装"
MSG_DOWNLOADING="正在下载 Transmission Web Control..."
MSG_DOWNLOAD_COMPLETE="下载完成，正在准备安装..."
MSG_DOWNLOAD_FAILED="安装包下载失败，请重试或尝试其他版本。"
MSG_INSTALL_COMPLETE="Transmission Web Control 安装完成!"
MSG_PACK_EXTRACTING="正在解压安装包..."
MSG_PACK_CLEANING_UP="正在清理安装包..."
MSG_DONE="安装脚本执行完成。如遇到问题请查看：https://github.com/ronggang/transmission-web-control/wiki "
MSG_SETTING_PERMISSIONS="正在设置权限，大约需要一分钟 ..."
MSG_BEGIN="开始"
MSG_END="结束"
MSG_MAIN_MENU="
欢迎使用 Transmission Web Control 中文安装脚本。
官方帮助文档：https://github.com/ronggang/transmission-web-control/wiki
安装脚本版本：$SCRIPT_VERSION
1. 安装最新的发布版本（release）；
2. 安装指定版本，可用于降级；
3. 恢复到官方UI；
4. 重新下载安装脚本（$SCRIPT_NAME）；
5. 检测 Transmission 是否已启动；
6. 指定安装目录；
9. 安装最新代码库中的内容（master）；
===================
0. 退出安装；
请输入对应的数字："
MSG_INPUT_VERSION="请输入版本号（如：1.5.1）："
MSG_INPUT_TR_FOLDER="请输入 Transmission Web 所在的目录（不包含web，如：/usr/share/transmission）："
MSG_SPECIFIED_FOLDER="安装目录已指定为："
MSG_INVALID_PATH="输入的路径无效。"
MSG_MASTER_INSTALL_CONFIRM="最新代码可能包含未知错误，是否确认安装？ (y/n): "
MSG_FIND_WEB_FOLDER_FROM_PROCESS="正在尝试从进程中识别 Transmission Web 目录..."
MSG_FIND_WEB_FOLDER_FROM_PROCESS_FAILED=" × 识别失败，请确认 Transmission 已启动。"
MSG_CHECK_TR_DAEMON="正在检测 Transmission 进程..."
MSG_CHECK_TR_DAEMON_FAILED="在系统进程中没有找到 Transmission ，请确认是否已启动。"
MSG_TRY_START_TR="是否尝试启动 Transmission ？（y/n）"
MSG_TR_DAEMON_IS_STARTED="Transmission 已启动。"
MSG_REVERTING_ORIGINAL_UI="正在恢复官方UI..."
MSG_REVERT_COMPLETE="恢复完成，在浏览器中重新访问 http://ip:9091/ 或刷新即可查看官方UI。"
MSG_ORIGINAL_UI_IS_MISSING="官方UI不存在。"
MSG_DOWNLOADING_INSTALL_SCRIPT="正在重新下载安装脚本..."
MSG_INSTALL_SCRIPT_DOWNLOAD_COMPLETE="下载完成，请重新运行安装脚本。"
MSG_INSTALL_SCRIPT_DOWNLOAD_FAILED="安装脚本下载失败！"
MSG_NON_ROOT_USER="无法确认当前是否为 root 用户，可能无法进行安装操作。是否继续？（y/n）"
#==========================================================
# 是否自动安装
if [ "$ARG1" = "auto" ]; then
AUTOINSTALL=1
else
ROOT_FOLDER=$ARG1
fi
initValues() {
# 判断临时目录是否存在，不存在则创建
if [ ! -d "$TMP_FOLDER" ]; then
mkdir -p "$TMP_FOLDER"
fi
# 获取 Transmission 目录
getTransmissionPath
# 判断 ROOT_FOLDER 是否为一个有效的目录，如果是则表明传递了一个有效路径
if [ -d "$ROOT_FOLDER" ]; then
showLog "$MSG_TR_WORK_FOLDER $ROOT_FOLDER/web"
INSTALL_TYPE=3
WEB_FOLDER="$ROOT_FOLDER/web"
SKIP_SEARCH=1
fi
# 判断是否指定了版本
if [ "$VERSION" != "" ]; then
# master 或 hash
if [ "$VERSION" = "master" -o ${#VERSION} = 40 ]; then
PACK_NAME="$VERSION.tar.gz"
# 是否指定了 v
elif [ ${VERSION:0:1} = "v" ]; then
PACK_NAME="$VERSION.tar.gz"
VERSION=${VERSION:1}
else
PACK_NAME="v$VERSION.tar.gz"
fi
showLog "$MSG_SPECIFIED_VERSION $VERSION"
DOWNLOAD_URL="https://github.com/ronggang/transmission-web-control/archive/$PACK_NAME"
fi
if [ $SKIP_SEARCH = 0 ]; then
# 查找目录
findWebFolder
fi
}
# 开始
main() {
begin
# 初始化值
initValues
# 安装
install
# 清理
clear
}
# 查找Web目录
findWebFolder() {
# 找出web ui 目录
showLog "$MSG_SEARCHING_TR_FOLDER"
# 判断 TRANSMISSION_WEB_HOME 环境变量是否被定义，如果是，直接用这个变量的值
if [ $TRANSMISSION_WEB_HOME ]; then
showLog "$MSG_USE_WEB_HOME"
# 判断目录是否存在，如果不存在则创建 https://github.com/ronggang/transmission-web-control/issues/167
if [ ! -d "$TRANSMISSION_WEB_HOME" ]; then
mkdir -p "$TRANSMISSION_WEB_HOME"
fi
INSTALL_TYPE=2
else
if [ -d "$ROOT_FOLDER" -a -d "$ROOT_FOLDER/web" ]; then
WEB_FOLDER="$ROOT_FOLDER/web"
INSTALL_TYPE=1
showLog "$ROOT_FOLDER/web $MSG_AVAILABLE."
else
showLog "$MSG_THE_SPECIFIED_DIRECTORY_DOES_NOT_EXIST"
ROOT_FOLDER=`find / -name 'web' -type d 2>/dev/null| grep 'transmission/web' | sed 's/\/web$//g'`
if [ -d "$ROOT_FOLDER/web" ]; then
WEB_FOLDER="$ROOT_FOLDER/web"
INSTALL_TYPE=1
fi
fi
fi
}
# 安装
install() {
# 是否指定版本
if [ "$VERSION" != "" ]; then
showLog "$MSG_TRY_SPECIFIED_VERSION $VERSION"
# 下载安装包
download
# 解压安装包
unpack
showLog "$MSG_PACK_COPYING"
# 复制文件到
cp -r "$TMP_FOLDER/transmission-web-control-$VERSION/src/." "$WEB_FOLDER/"
# 设置权限
setPermissions "$WEB_FOLDER"
# 安装完成
installed
# 如果目录存在，则进行下载和更新动作
elif [ $INSTALL_TYPE = 1 -o $INSTALL_TYPE = 3 ]; then
# 下载安装包
download
# 创建web文件夹，从 20171014 之后，打包文件不包含web目录，直接打包为src下所有文件
mkdir web
# 解压缩包
unpack "web"
showLog "$MSG_PACK_COPYING"
# 复制文件到
cp -r web "$ROOT_FOLDER"
# 设置权限
setPermissions "$ROOT_FOLDER"
# 安装完成
installed
elif [ $INSTALL_TYPE = 2 ]; then
# 下载安装包
download
# 解压缩包
unpack "$TRANSMISSION_WEB_HOME"
# 设置权限
setPermissions "$TRANSMISSION_WEB_HOME"
# 安装完成
installed
else
echo "##############################################"
echo "#"
echo "# $MSG_WEB_PATH_IS_MISSING"
echo "#"
echo "##############################################"
fi
}
# 下载安装包
download() {
# 切换到临时目录
cd "$TMP_FOLDER"
# 判断安装包文件是否已存在
if [ -f "$PACK_NAME" ]; then
if [ $AUTOINSTALL = 0 ]; then
echo -n "\n$PACK_NAME $MSG_PACK_IS_EXIST"
read flag
else
flag="y"
fi
if [ "$flag" = "y" -o "$flag" = "Y" ] ; then
rm "$PACK_NAME"
else
showLog "$MSG_SIKP_DOWNLOAD"
return 0
fi
fi
showLog "$MSG_DOWNLOADING"
echo ""
wget "$DOWNLOAD_URL" --no-check-certificate
# 判断是否下载成功
if [ $? -eq 0 ]; then
showLog "$MSG_DOWNLOAD_COMPLETE"
return 0
else
showLog "$MSG_DOWNLOAD_FAILED"
end
exit 1
fi
}
# 安装完成
installed() {
showLog "$MSG_INSTALL_COMPLETE"
}
# 输出日志
showLog() {
TIME=`date "+%Y-%m-%d %H:%M:%S"`
case $2 in
"n")
echo -n "<< $TIME >> $1" ;;
*)
echo "<< $TIME >> $1" ;;
esac
}
# 解压安装包
unpack() {
showLog "$MSG_PACK_EXTRACTING"
if [ "$1" != "" ]; then
tar -xzf "$PACK_NAME" -C "$1"
else
tar -xzf "$PACK_NAME"
fi
# 如果之前没有安装过，则先将原系统的文件改为
if [ ! -f "$WEB_FOLDER/$ORG_INDEX_FILE" -a -f "$WEB_FOLDER/$INDEX_FILE" ]; then
mv "$WEB_FOLDER/$INDEX_FILE" "$WEB_FOLDER/$ORG_INDEX_FILE"
fi
# 清除原来的内容
if [ -d "$WEB_FOLDER/tr-web-control" ]; then
rm -rf "$WEB_FOLDER/tr-web-control"
fi
}
# 清除工作
clear() {
showLog "$MSG_PACK_CLEANING_UP"
if [ -f "$PACK_NAME" ]; then
# 删除安装包
rm "$PACK_NAME"
fi
if [ -d "$TMP_FOLDER" ]; then
# 删除临时目录
rm -rf "$TMP_FOLDER"
fi
showLog "$MSG_DONE"
end
}
# 设置权限
setPermissions() {
folder="$1"
showLog "$MSG_SETTING_PERMISSIONS"
# 设置权限
find "$folder" -type d -exec chmod o+rx {} \;
find "$folder" -type f -exec chmod o+r {} \;
}
# 开始
begin() {
echo ""
showLog "== $MSG_BEGIN =="
showLog ""
}
# 结束
end() {
showLog "== $MSG_END =="
echo ""
}
# 显示主菜单
showMainMenu() {
echo -n "$MSG_MAIN_MENU"
read flag
echo ""
case $flag in
1)
getLatestReleases
main
;;
2)
echo -n "$MSG_INPUT_VERSION"
read VERSION
main
;;
3)
revertOriginalUI
;;
4)
downloadInstallScript
;;
5)
checkTransmissionDaemon
;;
6)
echo -n "$MSG_INPUT_TR_FOLDER"
read input
if [ -d "$input/web" ]; then
ROOT_FOLDER="$input"
showLog "$MSG_SPECIFIED_FOLDER $input/web"
else
showLog "$MSG_INVALID_PATH"
fi
sleep 2
showMainMenu
;;
# 下载最新的代码
9)
echo -n "$MSG_MASTER_INSTALL_CONFIRM"
read input
if [ "$input" = "y" -o "$input" = "Y" ]; then
VERSION="master"
main
else
showMainMenu
fi
;;
*)
showLog "$MSG_END"
;;
esac
}
# 获取Tr所在的目录
getTransmissionPath() {
# 指定一次当前系统的默认目录
# 用户如知道自己的 Transmission Web 所在的目录，直接修改这个值，以避免搜索所有目录
# ROOT_FOLDER="/usr/local/transmission/share/transmission"
# Fedora 或 Debian 发行版的默认 ROOT_FOLDER 目录
if [ -f "/etc/fedora-release" ] || [ -f "/etc/debian_version" ]; then
ROOT_FOLDER="/usr/share/transmission"
fi
if [ ! -d "$ROOT_FOLDER" ]; then
showLog "$MSG_FIND_WEB_FOLDER_FROM_PROCESS" "n"
infos=`ps -ef | awk '/[t]ransmission-da/{print $8}'`
if [ "$infos" != "" ]; then
echo " √"
search="bin/transmission-daemon"
replace="share/transmission"
path=${infos//$search/$replace}
if [ -d "$path" ]; then
ROOT_FOLDER=$path
fi
else
echo "$MSG_FIND_WEB_FOLDER_FROM_PROCESS_FAILED"
fi
fi
}
# 获取最后的发布版本号
# 因在源码库里提交二进制文件不便于管理，以后将使用这种方式获取最新发布的版本
getLatestReleases() {
VERSION=`wget -O - https://api.github.com/repos/ronggang/transmission-web-control/releases/latest | grep tag_name | head -n 1 | cut -d '"' -f 4`
}
# 检测 Transmission 进程是否存在
checkTransmissionDaemon() {
showLog "$MSG_CHECK_TR_DAEMON"
ps -C transmission-daemon
if [ $? -ne 0 ]; then
showLog "$MSG_CHECK_TR_DAEMON_FAILED"
echo -n "$MSG_TRY_START_TR"
read input
if [ "$input" = "y" -o "$input" = "Y" ] ; then
service transmission-daemon start
fi
else
showLog "$MSG_TR_DAEMON_IS_STARTED"
fi
sleep 2
showMainMenu
}
# 恢复官方UI
revertOriginalUI() {
initValues
# 判断是否有官方的UI存在
if [ -f "$WEB_FOLDER/$ORG_INDEX_FILE" ]; then
showLog "$MSG_REVERTING_ORIGINAL_UI"
# 清除原来的内容
if [ -d "$WEB_FOLDER/tr-web-control" ]; then
rm -rf "$WEB_FOLDER/tr-web-control"
rm "$WEB_FOLDER/favicon.ico"
rm "$WEB_FOLDER/index.html"
rm "$WEB_FOLDER/index.mobile.html"
mv "$WEB_FOLDER/$ORG_INDEX_FILE" "$WEB_FOLDER/$INDEX_FILE"
showLog "$MSG_REVERT_COMPLETE"
else
showLog "$MSG_WEB_PATH_IS_MISSING"
sleep 2
showMainMenu
fi
else
showLog "$MSG_ORIGINAL_UI_IS_MISSING"
sleep 2
showMainMenu
fi
}
# 重新下载安装脚本
downloadInstallScript() {
if [ -f "$SCRIPT_NAME" ]; then
rm "$SCRIPT_NAME"
fi
showLog "$MSG_DOWNLOADING_INSTALL_SCRIPT"
wget "https://github.com/ronggang/transmission-web-control/raw/master/release/$SCRIPT_NAME" --no-check-certificate
# 判断是否下载成功
if [ $? -eq 0 ]; then
showLog "$MSG_INSTALL_SCRIPT_DOWNLOAD_COMPLETE"
else
showLog "$MSG_INSTALL_SCRIPT_DOWNLOAD_FAILED"
sleep 2
showMainMenu
fi
}
if [ "$USER" != 'root' ]; then
showLog "$MSG_NON_ROOT_USER" "n"
read input
if [ "$input" = "n" -o "$input" = "N" ]; then
exit -1
fi
fi
if [ $AUTOINSTALL = 1 ]; then
getLatestReleases
main
else
# 执行
showMainMenu
fi