NAS、Synology、Unraid

はじめての方

適切なフォルダー、所有者、再起動の設定で、NAS 上で HolyArrs を実行します。先にインストールを読んでください。

始める前に

/config はローカルのボリュームかプールに置きます。ネットワーク共有には絶対に置かないでください。
メディアは 1 つの共有フォルダーにまとめ、その中に downloads、movies、tv、music を置きます。それぞれをマウントするか、ハードリンクを使うなら親フォルダーを 1 回だけマウントします。フォルダーを参照してください。

NAS を設定する

::tab[Synology]

File Station で docker/holyarrs/config を作成します。
共有フォルダー media を 1 つ作成し、その中に downloads、movies、tv、music を置きます。
Container Manager で Project > Create(プロジェクト > 作成)を開き、インストールの Compose ファイルを貼り付けます。
ボリュームを /volume1/docker/holyarrs/config:/config に設定し、続いて /volume1/media/movies:/movies、/volume1/media/tv:/tv、/volume1/media/music:/music、/volume1/media/downloads:/downloads を設定します。
PUID と PGID を自分のユーザーに合わせます。多くの場合 1026 と 100 です。SSH で id <user> を実行して確認します。
そのユーザーに media の読み取りと書き込みの権限を与えます: Control Panel > Shared Folder > Edit > Permissions(コントロールパネル > 共有フォルダ > 編集 > 権限)。
Enable auto-restart(自動再起動を有効にする)にチェックを入れます。
http://your-server:6262 を開きます。初回セットアップのウィザードが表示されます。/movies、/tv、/music をライブラリフォルダーとして追加します。

::tab[Unraid]

Community Applications のテンプレートはまだないので、コンテナを手動で追加します。

Docker タブで、HolyArrs のイメージを使ってコンテナを追加します。
ポート 6262 を割り当てます。
/config を、/mnt/<pool>/appdata/holyarrs のようなプールのパスに割り当てます。<pool> は自分のプールの名前です。/mnt/user/appdata は使いません。
メディアフォルダーを、ディスクまたはプールのパスを使って /movies、/tv、/music、/downloads に割り当てます。たとえば /mnt/<pool>/media/movies:/movies、/mnt/<pool>/media/tv:/tv、/mnt/<pool>/media/music:/music、/mnt/<pool>/media/downloads:/downloads です。
PUID=99、PGID=100(Unraid の nobody:users)、UMASK=022 を設定します。
コンテナの自動起動をオンにして、自動で再起動するようにします。
http://your-server:6262 を開きます。初回セットアップのウィザードが表示されます。

::tab[QNAP]

Container/holyarrs/config と、共有 media を 1 つ作成し、その共有の中に downloads、movies、tv、music を置きます。
Container Station で Applications > Create(アプリケーション > 作成)を開き、Compose ファイルを貼り付けます。
/share/Container/holyarrs/config:/config を使い、続いて /share/media/movies:/movies、/share/media/tv:/tv、/share/media/music:/music、/share/media/downloads:/downloads を使います。
PUID と PGID を、共有 media の所有者に合わせます。
再起動ポリシーを unless-stopped に設定します。
http://your-server:6262 を開きます。初回セットアップのウィザードが表示されます。

::tab[TrueNAS SCALE]

データセットを 2 つ作成します: apps/holyarrs-config と media。media の中に downloads、movies、tv、music のフォルダーを置きます。
Apps で、Compose ファイルを使って YAML からカスタムアプリを追加します。
/mnt/<pool>/apps/holyarrs-config:/config を使い、続いて /mnt/<pool>/media/movies:/movies、/mnt/<pool>/media/tv:/tv、/mnt/<pool>/media/music:/music、/mnt/<pool>/media/downloads:/downloads を使います。
PUID と PGID をデータセットの所有者に合わせます。多くの場合 568 です。データセットの ACL で、そのユーザーに書き込み権限を与えます。
再起動ポリシーを unless-stopped に設定します。
http://your-server:6262 を開きます。初回セットアップのウィザードが表示されます。

どの NAS でも、NAS の権限画面で、PUID のユーザーにメディアフォルダーの読み取りと書き込みの権限を与えます。設定フォルダーは HolyArrs が自分で面倒を見ます。コンテナの自動再起動をオンにします(Docker の unless-stopped ポリシー)。

ハードリンクは余分な容量を使わず、一瞬で終わります。ハードリンクを使うには、4 つの代わりにメディアフォルダーを 1 つだけマウントし、ダウンローダーにも同じマウントを同じパスで渡します。メディアフォルダーを参照してください。

オプション

個別のマウント

/movies、/tv、/music、/downloads を 1 つずつマウントしても動きますが、インポートはすべて丸ごとのコピーになります。各マウントはコンテナ内でそれぞれ別のファイルシステムになり、ハードリンクはファイルシステムをまたげません。1 つの親の下にある別々の共有やデータセットでも、コピーになります。HolyArrs がコピーせざるを得ないときは、Settings > Library folders(設定 > ライブラリフォルダー)に警告が出ます。

ディスクをスリープさせる

次のジョブは、メディアのディスクを起こします。実行する頻度は Schedules(スケジュール)ページで変更します。

ジョブ	読み取る対象
Rescan the Library(ライブラリを再スキャン)	すべてのライブラリフォルダー。ディスクを最もよく起こします。
Check Library folders(ライブラリフォルダーをチェック)	各フォルダーの詳細と空き容量。書き込みとハードリンクのテストは、起動時、Run now(今すぐ実行)を押したとき、フォルダーが変わったときにだけ実行されます。
Look for missing subtitles(不足している字幕を探す)、Look for better subtitles(より良い字幕を探す)	各動画の横のフォルダー。

/config とダウンロードフォルダーは、SSD かキャッシュプールに置きます。
/config があるディスクには 1 GB の空きを残します。それを下回ると、稼働状態の警告が出ます。
Unraid では、Cache Directories プラグインがフォルダーの一覧をメモリに保持するので、スキャンでディスクに触れずに済みます。
インポート、追加、削除は、その処理が行われるときに、対象のディスクに触れます。
再スキャンを 7 日ごと、またはオフに設定します。その場合、手動で追加したファイルは、Rescan the Library で Run now を押したときにだけ見つかります。
シード中のトレントは、そのファイルを読み取ります。ライブラリにハードリンクされている場合、シードが止まるまでそのディスクは起きたままになります。

うまくいかないとき

症状	原因	対処
起動せず、FUSE パス、ネットワーク共有、または Unraid のユーザー共有を名指しする	`/config` がローカルディスク上にない(Unraid では `/mnt/user` を指している)	`/config` を、`/mnt/<pool>/appdata/holyarrs` のようなローカルディスクかプールのパスに移します。
再起動や復元のあと、停止したままになる	自動再起動がオフになっている	オンにして、コンテナを起動します。
インポートが権限エラーで失敗する	`PUID` のユーザーがメディアに書き込めない	NAS の権限画面で読み取りと書き込みの権限を与えます(Synology では Control Panel > Shared Folder > Edit > Permissions)。
インポートがハードリンクではなくコピーになる	ダウンロードとライブラリが別々のマウントまたはディスクにある	HolyArrs とダウンローダーの両方で、共有フォルダーを 1 つ、1 回だけマウントします。

そのほかの対処: トラブルシューティング。

上級者向け

HolyArrs が一部の設定パスを拒否する理由

HolyArrs はデータベースを /config に保管します。ネットワーク共有や FUSE パスではデータベースが壊れることがあるため、HolyArrs はそうした場所では起動を拒否し、理由を示します。

Unraid では、/mnt/user は FUSE パスです。プールのパスを使うか、appdata を Exclusive にします。Settings > Global Share Settings(設定 > グローバル共有設定)で Permit exclusive shares(排他的共有を許可)をオンにし、Shares > appdata(共有 > appdata)で、プライマリストレージを 1 つのプールに、セカンダリストレージをなしに設定します。

存在しないプール上の /config パスはメモリ上に作られ、再起動で失われます。HolyArrs はこれも拒否します。メディアにも /mnt/user は避けてください。そこをまたぐハードリンクは失敗することがあります。

自動再起動が重要な理由

アプリ内からの再起動、セーフモード、バックアップの復元は、いずれも HolyArrs を停止し、Docker が起動し直すことを前提にしています。自動再起動がないと、停止したままになります。パートとセーフモードを参照してください。

ポートとアップデート

ポート 6262 は、自宅のネットワークにだけ割り当てます。外部の誰かに開放する前に、セキュリティの基本を読んでください。
アップデートするには、新しいイメージを pull して、コンテナを再作成します。データは /config に残ります。アップデートを参照してください。