rTorrent

提供: ArchWiki
2022年2月3日 (木) 01:24時点におけるKgx (トーク | 投稿記録)による版 (→‎ヒントとテクニック‎: ユーザーのためのデーモンとしての Systemd サービスを翻訳して追加)
ナビゲーションに移動 検索に移動

rTorrent は迅速に動作する BitTorrent クライアントです。開発面では、libTorrent ライブラリを使用しています (libtorrent-rasterbar とは違います)。rTorrent は C++ を使って書かれており、ncurses プログラミングライブラリを利用したテキストユーザーインターフェイスがあります。ターミナルマルチプレクサ (例: GNU ScreenTmux) と Secure Shell を一緒に使うことで、便利なリモート BitTorrent クライアントとして活用できます。

インストール

公式リポジトリrtorrent パッケージを インストール してください。

非公式パッケージ

設定

ノート: 設定に関する詳細は次の rTorrent wiki の記事を見て下さい: Common Tasks in rTorrent for Dummies

rTorrent を実行する前に、サンプル設定ファイル /usr/share/doc/rtorrent/rtorrent.rc を探して ~/.rtorrent.rc にコピーしましょう:

$ cp /usr/share/doc/rtorrent/rtorrent.rc ~/.rtorrent.rc

パフォーマンス

ノート: パフォーマンスに関する詳細は次の rTorrent wiki の記事を見て下さい: Performance Tuning

以下のオプションの値はシステムのハードウェアやインターネットの接続速度に合わせます。最適値の見つけ方については次を読んでください: Optimize Your BitTorrent Download Speed

min_peers = 40
max_peers = 52

min_peers_seed = 10
max_peers_seed = 52

max_uploads = 8

download_rate = 200
upload_rate = 28

check_hash オプションは torrent のダウンロードが完了した時や rTorrent が起動したときにハッシュチェックを行います。起動時に、完了済みのファイルに問題がないか確認します。

check_hash = yes

ファイルの作成と管理

directory オプションには torrent データを保存するディレクトリを指定します (相対パスでも指定できます):

directory = ~/downloaded

session オプションを使うことで rTorrent の torrent の進捗を保存することができます。ホームディレクトリにディレクトリを作成することが推奨されます (例: mkdir ~/.rtorrent.session)。

session = ~/.rtorrent.session

schedule オプションを設定すると rTorrent は新しい torrent ファイルが追加されないか特定のディレクトリを監視します。このディレクトリに torrent ファイルを保存すると、自動的にダウンロードが開始されます。かならず監視するディレクトリを作成してください (例: mkdir ~/watch)。また、このオプションを使用すると、rTorrent が torrent ファイルをセッションフォルダに移動してハッシュ値に名前を変更するので注意してください。

schedule = watch_directory,5,5,load_start=/home/user/watch/*.torrent
schedule = untied_directory,5,5,stop_untied=
schedule = tied_directory,5,5,start_tied=

以下の schedule オプションはディスク容量が少なくなった時に rTorrent がデータをダウンロードするのを止めさせます。

schedule = low_diskspace,5,60,close_low_diskspace=100M

ポート設定

port_range オプションでは使用するポートを設定します。49152 以上のポート番号を使用することが推奨されます (参照: ポート番号の一覧)。rTorrent ではポートの範囲を指定することができますが、使用するポートは一つだけに絞ることが推奨されています。

port_range = 49164-49164

また、適切なポートのポートフォワーディングが有効になっていることを確認してください (参照: Port Forward guides)。

その他の設定

encryption オプションは暗号化を有効化または無効化します。このオプションは、あなた自身だけのためではなく、torrent スウォームのピアのためでもあります。たとえセキュリティを上げる必要がなかったとしても、有効にすることに害はありません。

encryption = allow_incoming,try_outgoing,enable_retry

また、全ての接続で強制的に暗号化を使用することもできます。ただし、あまり厳しいルールを使用するとクライアントの可用性が減少していきます:

encryption = require,require_RC4,allow_incoming,try_outgoing

Wikipedia:BitTorrent Protocol Encryption も見て下さい。

最後に、dht オプションは DHT のサポートを有効にします。DHT は主要なトラッカーで使われており、クライアントがより多くのピアを獲得できるようになります。

dht = auto
dht_port = 6881
peer_exchange = yes

キーバインディング

rTorrent では専らキーボードショートカットを使って操作を行います。下のクイックレファレンスを参照してください。完全なガイドは rTorrent wiki にあります (参照: rTorrent User Guide)。

ノート: Ctrl-q を 2 回連続で押すと、接続中のトラッカーへの停止アナウンスの送信を待たずに rTorrent がシャットダウンします。
コマンド 操作
Ctrl-q アプリケーションを終了
Ctrl-s ダウンロードを開始。ハッシュが行われていない場合は先に実行
Ctrl-d ダウンロードを停止または停止したダウンロードを削除
Ctrl-k ファイルのダウンロードを停止して終了
Ctrl-r torrent のハッシュチェックを開始。ダウンロード/アップロードは行わない。
Left 前の画面に戻る
Right 次の画面に移る
Backspace/Return 指定した *.torrent を追加
a|s|d 全体のアップロード速度を 1|5|50 KB/s 間隔で増やす
A|S|D 全体のダウンロード速度を 1|5|50 KB/s 間隔で増やす
z|x|c 全体のアップロード速度を 1|5|50 KB/s 間隔で減らす
Z|X|C 全体のダウンロード速度を 1|5|50 KB/s 間隔で減らす

マッピングの重複

Ctrl-s は画面の出力の停止に、Ctrl-q は画面の出力の開始に使われるのがターミナルでは普通です。これらのマッピングが rTorrent と干渉してしまうことがあります。ターミナルのオプションがマッピングと関連付けられていないか確認してください:

$ stty -a
...
swtch = <undef>; start = ^Q; stop = ^S; susp = ^Z; rprnt = ^R; werase = ^W; lnext = ^V;
...

マッピングを削除するには、ターミナルの特性を変更して前述の特殊文字列を定義します (つまり stopstart):

# stty stop undef
# stty start undef

前述のコマンドを ~/.bashrc ファイルに追加することで、起動時に自動的にマッピングを削除させることができます。

ヒントとテクニック‎

ヘッドレスサーバのための Systemd サービス

このユニット ファイルは、rtorrent という 1 人のユーザーの実行と、rtorrent がデーモンとして実行されるように設定することに依存しています。

次のファイルを作成します。

/etc/systemd/system/rtorrent.service
>
[Unit]
Description=rTorrent System Daemon
After=network.target

[Service]
Type=simple
User=rtorrent
Group=rtorrent
# Modify the next 2 lines to use absolute paths
ExecStartPre=-/bin/rm -f /<home>/.session/rtorrent.lock
ExecStart=/usr/bin/rtorrent -o import=/<home>/rtorrent.rc
Restart=on-failure
RestartSec=3

[Install]
WantedBy=multi-user.target

ユーザーのためのデーモンとしての Systemd サービス

このユニットでは、複数のユーザー、または 1 人のユーザーが rtorrent をデーモンとして実行できるようにします。

ブート時に rtorrent を起動するには、有効 rtorrent@user (user は rtorrent を実行するユーザー) を指定します。

以下のファイルを作成します。

/etc/systemd/system/rtorrent@.service
[Unit]
Description=rTorrent for %i
After=network.target

[Service]
Type=simple
User=%i
Group=%i
WorkingDirectory=/home/%i
# Modify the next line to the absolute path for rtorrent.lock, for example
ExecStartPre=-/bin/rm -f /home/%i/.session/rtorrent.lock
ExecStart=/usr/bin/rtorrent -o system.daemon.set=true
Restart=on-failure
RestartSec=3

[Install]
WantedBy=multi-user.target

tmux や screen を使用する systemd サービスファイル

  • tmux を使用 (rtorrent がクラッシュした場合に再起動)
/etc/systemd/user/rt.service
[Unit]
Description=rTorrent
After=network.target

[Service]
Type=forking
KillMode=none
ExecStart=/usr/bin/tmux new-session -s rt -n rtorrent -d rtorrent
ExecStop=/usr/bin/bash -c "/usr/bin/tmux send-keys -t rt:rtorrent.0 C-q && while pidof rtorrent > /dev/null; do sleep 0.5; echo rtorrent still running...; done"
WorkingDirectory=%h
Restart=on-failure

[Install]
WantedBy=default.target
  • rtorrent ユーザーで実行した tmux を使用 (rtorrent がクラッシュした場合に再起動)
/etc/systemd/system/rtorrent.service
[Unit]
Description=rTorrent Daemon
After=network.target

[Service]
Type=forking
KillMode=none
User=rtorrent
ExecStart=/usr/bin/tmux new-session -c /mnt/storage/rtorrent -s rtorrent -n rtorrent -d rtorrent
ExecStop=/usr/bin/tmux send-keys -t rtorrent C-q && /usr/bin/tmux kill-session -t rtorrent
WorkingDirectory=/home/rtorrent/
Restart=on-failure

[Install]
WantedBy=multi-user.target
  • screen を使用
/etc/systemd/user/rt.service
[Unit]
Description=rTorrent
After=network.target

[Service]
Type=forking
KillMode=none
ExecStart=/usr/bin/screen -d -m -fa -S rtorrent /usr/bin/rtorrent
ExecStop=/usr/bin/killall -w -s 2 /usr/bin/rtorrent
WorkingDirectory=%h

[Install]
WantedBy=default.target

ブート時に起動:

$ systemctl --user enable rt

手動で起動:

$ systemctl --user start rt

停止:

$ systemctl --user stop rt

rtorrent のセッションにアタッチ:

tmux attach -t rt

デタッチ:

Ctrl-b d

事前割り当て

community リポジトリに入っている rTorrent パッケージは事前割り当ての機能が削られています。事前割り当てを有効にして rTorrent をコンパイルすることで、torrent をダウンロードする前にファイルを割り当てることが可能になります。ファイルシステムのフラグメント化を防ぐことができるという利点がありますが、ファイルシステムが fallocate システムコールをサポートしてないかった場合、事前割り当てで遅延が発生することになります。

したがって、ネイティブで fallocate をサポートしている xfs, ext4, btrfs ファイルシステムを使用する場合は、このスイッチを利用することを推奨します。これらのファイルシステムでは事前割り当てで遅延が発生することなく、ファイルシステムのフラグメンテーションを少なくします。他のファイルシステムで事前割り当てを有効にすると遅延が発生します。ただし、ファイルのフラグメント化は防げます。

事前割り当てを利用できるようには、ABS ツリーから以下のスイッチを使って libTorrent をリコンパイルしてください:

$ ./configure --prefix=/usr --disable-debug --with-posix-fallocate

有効化するには、以下を ~/rtorrent.rc に追加します:

~/rtorrent.rc
# Preallocate files; reduces defragmentation on filesystems.
system.file_allocate.set = yes

完了したファイルの管理

ノート: このヒントで困っている場合、こちらも参照して見て下さい。docs

rtorrent は、シードを継続しながら、*.torrent をどの 監視 フォルダーにドロップしたかに基づいて、完了したトレント データを特定のフォルダーに整理することができます。

解決策として、次の例を ~/.rtorrent.rc で使用してください。 パスを変更することを確認してください。

# default path for in progress downloads
directory = /home/user/torrents/incomplete

# schedule a timer event named 'watch_directory_1':
# 1) triggers 10 seconds after rtorrent starts
# 2) triggers at 10 second intervals thereafter
# 3) Upon trigger, attempt to load (and start) new *.torrent files found in /home/user/torrents/watch/
# 4) set a variable named 'custom1' with the value "/home/user/torrents/complete"
# NOTE: if you do not want it to automatically start the torrent, change 'load.start' to 'load.normal'
schedule2 = watch_directory_1,10,10,"load.start=/home/user/torrents/watch/*.torrent,d.custom1.set=/home/user/torrents/complete"

# upon completion, move content to path specified above via custom1
method.insert = d.data_path, simple, "if=(d.is_multi_file), (cat,(d.directory),/), (cat,(d.directory),/,(d.name))"
method.insert = d.move_to_complete, simple, "d.directory.set=$argument.1=; execute=mkdir,-p,$argument.1=; execute=mv,-u,$argument.0=,$argument.1=; d.save_full_session="
method.set_key = event.download.finished,move_complete,"d.move_to_complete=$d.data_path=,$d.custom1="

このように、ウォッチディレクトリとそれに対応する補完ディレクトリを追加することができます。

directory = /home/user/torrents/incomplete

schedule2 = watch_directory_1,10,10,"load.start=/home/user/torrents/watch/*.torrent,d.custom1.set=/home/user/torrents/complete"
schedule2 = watch_directory_2,10,10,"load.start=/home/user/torrents/watch/iso/*.torrent,d.custom1.set=/home/user/torrents/complete/iso"
schedule2 = watch_directory_3,10,10,"load.start=/home/user/torrents/watch/music/*.torrent,d.custom1.set=/home/user/torrents/complete/music"

method.insert = d.data_path, simple, "if=(d.is_multi_file), (cat,(d.directory),/), (cat,(d.directory),/,(d.name))"
method.insert = d.move_to_complete, simple, "d.directory.set=$argument.1=; execute=mkdir,-p,$argument.1=; execute=mv,-u,$argument.0=,$argument.1=; d.save_full_session="
method.set_key = event.download.finished,move_complete,"d.move_to_complete=$d.data_path=,$d.custom1="

また、ウォッチディレクトリごとに不完全なディレクトリを指定することも可能です。

directory = /home/user/torrents/incomplete

schedule2 = watch_directory_1,10,10,"load.start=/home/user/torrents/watch/*.torrent,d.directory.set=/home/user/torrents/incomplete,d.custom1.set=/home/user/torrents/complete"
schedule2 = watch_directory_2,10,10,"load.start=/home/user/torrents/watch/iso/*.torrent,d.directory.set=/home/user/torrents/incomplete/iso,d.custom1.set=/home/user/torrents/complete/iso"
schedule2 = watch_directory_3,10,10,"load.start=/home/user/torrents/watch/music/*.torrent,d.directory.set=/home/user/torrents/incomplete/music,d.custom1.set=/home/user/torrents/complete/music"

method.insert = d.data_path, simple, "if=(d.is_multi_file), (cat,(d.directory),/), (cat,(d.directory),/,(d.name))"
method.insert = d.move_to_complete, simple, "d.directory.set=$argument.1=; execute=mkdir,-p,$argument.1=; execute=mv,-u,$argument.0=,$argument.1=; d.save_full_session="
method.set_key = event.download.finished,move_complete,"d.move_to_complete=$d.data_path=,$d.custom1="

また、bash スクリプトによる補完移動pyrocore の rtcontrol (AUR パッケージがあります) も参照してください。

Google メールでの通知

携帯電話に メール を送ることもできます。

Verizon: 10digitphonenumber@vtext.com
AT&T: 10digitphonenumber@txt.att.net
Former AT&T customers: 10digitphonenumber@mmode.com
Sprint: 10digitphonenumber@messaging.sprintpcs.com
T-Mobile: 10digitphonenumber@tmomail.net
Nextel: 10digitphonenumber@messaging.nextel.com
Cingular: 10digitphonenumber@cingularme.com
Virgin Mobile: 10digitphonenumber@vmobl.com
Alltel: 10digitphonenumber@alltelmessage.com OR
10digitphonenumber@message.alltel.com
CellularOne: 10digitphonenumber@mobile.celloneusa.com
Omnipoint: 10digitphonenumber@omnipointpcs.com
Qwest: 10digitphonenumber@qwestmp.com
Telus: 10digitphonenumber@msg.telus.com
Rogers Wireless: 10digitphonenumber@pcs.rogers.com
Fido: 10digitphonenumber@fido.ca
Bell Mobility: 10digitphonenumber@txt.bell.ca
Koodo Mobile: 10digitphonenumber@msg.koodomobile.com
MTS: 10digitphonenumber@text.mtsmobility.com
President's Choice: 10digitphonenumber@txt.bell.ca
Sasktel: 10digitphonenumber@sms.sasktel.com
Solo: 10digitphonenumber@txt.bell.ca
  • /etc/mail.rc ファイルをクリアして、入力します。
set sendmail="/usr/bin/mailx"
set smtp=smtp.gmail.com:587
set smtp-use-starttls
set ssl-verify=ignore
set ssl-auth=login
set smtp-auth-user=USERNAME@gmail.com
set smtp-auth-password=PASSWORD

本文を送信するには、mailx プログラムにメッセージをパイプで送る必要があります。

  • Bash スクリプトを作成します。
/path/to/mail.sh
echo "$@: Done" | mailx 5551234567@vtext.com

ここで、$@ はスクリプトに渡されるすべての引数を保持する変数です。

   最後に、重要な ~/.rtorrent.rc 行を追加します。

以下分解です,

notify_me はコマンドIDで、他のコマンドで使用される可能性があり、ユニークであれば何でもかまいません。

execute= は、rtorrent コマンドで、この場合はシェル コマンドを実行します。

/path/to/mail.sh は、スクリプトの名前 (または実行するコマンド) と、渡されるすべてのスイッチ/引数をカンマで区切ったリストです。

$d.get_name= d はコマンドのトリガーとなるダウンロードのエイリアス、get_name はダウンロードの名前を返す関数、$ は実行を呼び出す前にコマンドをその出力に置き換えるよう rTorrent に指示します。

最終結果は? 出勤前に開始したトレント、All Live Nudibranches が終了すると、テキストが送信されます。

All Live Nudibranches: Done

アクティブな torrent を表示

デフォルトでは rtorrent はアクティブなタブを正しく表示しません。アクティブな torrent だけを表示するには .rtorrent.rc に以下の行を追加してください:

schedule = filter_active,30,30,"view_filter = active,\"or={d.get_up_rate=,d.get_down_rate=}\""

rTorrent クライアントで 9 押すと動作の変更が確認できます。

手動でトラッカーを torrent に追加

  1. rTorrent のコンソールビューから編集する torrent を選択。
  2. Ctrl+x を押す。
  3. If you had four trackers type following lines one at a time (always press Ctrl+x first) to add four more for example:
d.tracker.insert="5","udp://tracker.publicbt.com:80"
d.tracker.insert="6","udp://tracker.openbittorrent.com:80"
d.tracker.insert="7","udp://tracker.istole.it:80"
d.tracker.insert="8","udp://tracker.ccc.de:80"

トラブルシューティング

CA 証明書

rTorrent で HTTPS を使用するトラッカーを使う場合、root で以下を実行してください:

# cd /etc/ssl/certs
# wget --no-check-certificate https://www.geotrust.com/resources/root_certificates/certificates/Equifax_Secure_Global_eBusiness_CA-1.cer
# mv Equifax_Secure_Global_eBusiness_CA-1.cer Equifax_Secure_Global_eBusiness_CA-1.pem
# c_rehash

そして rTorrent を次のコマンドで実行してください:

$ rtorrent -o http_capath=/etc/ssl/certs

GNU Screen を使っている場合、変更が適用されるように .screenrc 設定ファイルを更新:

$ screen -t rtorrent rtorrent -o http_capath=/etc/ssl/certs

rTorrent 0.8.9 では network.http.ssl_verify_peer.set=0 を設定することで 問題が修正 されます。

詳細は次を参照: rTorrent Error & CA CertificaterTorrent Certificates Problem

ディレクトリのロック

クラッシュや不正のシャットダウンの後、ときどき rTorrent が動かなくなって、ロックファイルについてエラーを表示することがあります。

エラーメッセージによると、ダウンロード ディレクトリの隠しフォルダ .rtorrentsession 内に rtorrent.lock というファイルが見つかった場合、手動で削除することができます。

Event failed: bad return code

これは、system.method.* の行にスペースがある場合や、単にインストールされていない外部スクリプトを呼び出すイベントハンドラ、または0以外の終了コードを返す場合によく起こります。

前者については、偽のスペースを削除するか、意図的にパスなどを引用することで、動作するようになります。

ウェブインターフェイス

rTorrent には様々なウェブインターフェイスやフロントエンドが存在しています:

  • WTorrent は PHP ライブラリの Smarty テンプレートと XMLRPC を使って PHP でプログラミングされた rtorrent のウェブインターフェイスです。
  • nTorrent は rtorrent (cli torrent クライアント) の Java で書かれたグラフィカルユーザーインターフェイスです。
  • rTWi は PHP で書かれたシンプルな rTorrent ウェブインターフェイスです。
  • Rtgui は PHP で書かれたウェブベースの rTorrent フロントエンドで、XML-RPC を使って rTorrent クライアントと対話します。
  • rutorrentForum - uTorrent とよく似たインターフェイスを持つウェブベースのフロントエンドです。多数のプラグインと高度な機能をサポートしています (参照: ruTorrentGuide on forum)。
ノート: rTorrent is currently built using XML-RPC for C/C++, which is required for some web interfaces (e.g. ruTorrent).

XMLRPC インターフェイス

rtorrent をウェブインターフェイス (例: rutorrent) で使いたい場合は設定ファイルに以下の行を追加してください:

scgi_port = localhost:5000

詳細は次を参照: Using XMLRPC with rtorrent

マグネットリンクを watch フォルダに torrent ファイルとして保存

ノート: Rtorrent はネイティブでマグネットリンクによる torrent のダウンロードに対応しています。(Rtorrent を起動して 1 を押すと表示される) メインビューで、エンターを押してください。"load.normal>" にマグネットリンクを貼り付けてエンターを再度押すとダウンロードが開始されます。

マグネットリンクを watch フォルダに自動的に追加したい場合、以下のスクリプトで行うことができます:

#!/bin/bash
watch_folder=~/.rtorrent/watch
cd $watch_folder
[[ "$1" =~ xt=urn:btih:([^&/]+) ]] || exit;
echo "d10:magnet-uri${#1}:${1}e" > "meta-${BASH_REMATCH[1]}.torrent"

(ソース: http://blog.gonzih.org/blog/2012/02/17/how-to-use-magnet-links-with-rtorrent/)

例えば、rtorrent-magnet という名前で保存し、実行権限を与え、$PATH の下のどこかに配置します。次に、Firefox で

  1. ロケーション バー (アドレス バー) に about:config と入力し、Enter キーを押します。
  2. 右クリックする。新規 > Boolean > Name: network.protocol-handler.expose.magnet と入力します。> 値> false です。
  3. 次回マグネットリンクをクリックすると、どのアプリケーションでそれを開くか尋ねられます。先ほど作成したスクリプトを選択すれば完了です。

xdg-open で処理したい場合、Firefox の代わりに chrome を使用している場合は必要ですが、(gnome やその他の DE では xdg-open を上書きする独自のプログラムがあるかもしれません)rtorrent-magnet スクリプト用のデスクトップ エントリを ~/.local/share/applications/rtorrent-magnet.desktop に次の内容で作成する必要があります。

 [Desktop Entry]
 Type=Application
 Name=rtorrent-magnet
 Exec=rtorrent-magnet %U
 MimeType=x-scheme-handler/magnet;
 NoDisplay=true

以下でmimetypeを登録するだけです。

$ xdg-mime default rtorrent-magnet.desktop x-scheme-handler/magnet

マグネットを Torrent に変換

magnet2torrent-gitAUR パッケージを使うことでメタデータをダウンロードして torrent ファイルを作成することができます。

使用方法:

$ magnet2torrent <magnet link> [torrent file]

rtorrent-ps

rTorrent-PS は、UI の強化、カラー化、およびいくつかの機能追加を行ったパッチセット形式の rTorrent ディストリビューションです。

インストール方法

AUR から入手できる様々なパッケージを使うか、GitHub リポジトリにあるビルドスクリプトを使ってパッケージを作成してください。詳しくは the docs を見て下さい。

設定

rTorrent 設定ファイルで pyro.extended を 1 に設定し、rTorrent-PS 機能を有効にします。

method.insert = pyro.extended, value|const, 1

その他の設定例については、pimp-my-box リポジトリの rtorrent-ps テンプレートを参照してください。動作させるには PyroScope のコマンドライン ユーティリティが必要な場合があることに注意してください。

PyroScope コマンドラインユーティリティ

PyroScope コマンドラインユーティリティ は、rTorrent クライアント用のツールのコレクションで、#rtorrent-psパッチセットと一緒に使用すると便利です。 特に、一般的なタスクの自動化や、rTorrent のキュー マネージャを提供します。

インストールと設定については、公式ドキュメント に従ってください。その他の設定例については、pimp-my-box リポジトリの rtorrent-ps テンプレートを参照してください。

参照

フォーラムスレッド