トラブルシューティング

当てはまる症状を探し、原因を読み、対処に従います。例ではコンテナ名を holyarrs としています。違う名前の場合は置き換えてください。

最初の 3 つの確認

1. ログを見ます: docker logs -f holyarrs。秘密の値は伏せ字になります。Ctrl+C を押すと表示が止まります。コンテナは動き続けます。
2. doctor を実行します: docker exec holyarrs /holyarrs doctor。各行に OK、WARN、FAIL のいずれかが表示され、WARN と FAIL には直し方も表示されます。
3. まだ解決しないときは、サポートバンドルをダウンロードして質問します。サポートを受けるを参照してください。

Web ページにアクセスできない

症状: ブラウザーが http://your-server:6262 に接続できません。

原因: コンテナが停止している、ポートが割り当てられていない、またはプロキシが間に入っています。

対処:

1. docker ps を実行します。holyarrs と 0.0.0.0:6262->6262 が表示されます。
2. 再起動を繰り返している場合は、docker logs holyarrs で理由を確認します。
3. /holyarrs のようなパスを使っている場合は、リバースプロキシと URL ベースを参照します。

Permission denied

症状: doctor がフォルダーに書き込めないと報告する、またはインポートが権限エラーで失敗します。

原因: ホスト上のフォルダーの所有者が PUID と PGID に一致していません。

対処: doctor が提案する chown を実行するか、PUID と PGID をフォルダーの所有者に合わせます。NAS では、権限の画面でそのユーザーに読み取りと書き込みを許可します。NAS、Synology、Unraid を参照してください。

何もダウンロードされない

症状: タイトルが未入手のままで、ダウンローダーに何も届きません。

原因: 応答するソースがない、ダウンローダーが接続されていない、または選定ルールを通るリリースがありません。

対処:

1. Settings > Downloaders(設定 > ダウンローダー)を開き、お使いのダウンローダーの Test(テスト)をクリックします。テストが通るはずです。
2. Settings > Sources(設定 > ソース)を開き、各ソースの Test をクリックします。
3. タイトルで Choose a release(リリースを自分で選ぶ)を開き、すべての結果と、それぞれが選ばれなかった理由を確認します。

ダウンローダーとソースを参照してください。

ダウンロードされたがインポートされない

症状: ダウンローダーではダウンロードが完了したのに、タイトルがライブラリにありません。

原因: HolyArrs から同じパスでファイルが見えない、ライブラリフォルダーに書き込めない、またはインポートが判断待ちになっています。

対処:

1. HolyArrs とダウンローダーに、同じダウンロードフォルダーを /downloads のような同じパスで渡します。または、ダウンローダーの Downloader’s path(ダウンローダー側のパス)と HolyArrs’ path(HolyArrs 側のパス)を設定します。
2. doctor を実行し、ダウンロードフォルダーとライブラリフォルダーの FAIL をすべて直します。
3. ダウンロードの一覧で Needs a decision(判断待ち)と表示された項目を探し、計画を承認するか破棄します。

インポートがハードリンクではなくコピーになる

症状: doctor がハードリンクを使えないと報告する、またはインポート後にディスク使用量が 2 倍になります。

原因: ダウンロードフォルダーとライブラリフォルダーが別のディスクまたは別のマウントにあります。

対処: 別々のフォルダーではなく、共通の親フォルダーを 1 つコンテナにマウントします。フォルダーを参照してください。

HolyArrs が起動しない

症状: コンテナがすぐに停止するか再起動します。

原因: ログに原因が書かれています。よくあるのは、/config がネットワーク共有や FUSE のパスにある場合と、パートが壊れている場合です。

対処:

1. ログにそう書かれている場合は、/config をローカルディスクに移します。HolyArrs は共有上ではデータベースを動かしません。
2. それ以外の場合はセーフモードで起動し、Settings(設定)から直して、通常どおり再起動します。

機能が見当たらない

症状: 説明を読んだ機能がアプリにありません。

原因: このリリースでは既定でオフになっている可能性があります。

対処: 既定でオフの機能を参照してください。

ページに名前や画像が表示されない

症状: タイトルがポスターや詳細なしで表示されます。

原因: メタデータサーバーに到達できません。

対処: DNS とファイアウォールを確認してください。doctor の Network セクションで、サーバーが応答しているかがわかります。

上級者向け

doctor の確認項目とオプション

doctor はコンテナの中で、HolyArrs と同じユーザーとして動きます。そのため、HolyArrs がぶつかる問題に同じようにぶつかります。

セクション	表示内容
App	バージョン、ユーザーとグループ、umask、コンテナ内で動いているかどうか。
Config folder	所有者、権限、空き容量、ローカルディスク上にあるかどうか。
Library and download folders	存在するか、所有者、書き込み可能か、空き容量、ダウンロードフォルダーとライブラリフォルダーの間でハードリンクが使えるか。
Network	メタデータサーバーの名前が解決でき、応答があるかどうか。
Clock	時刻、タイムゾーン(TZ)、時計が明らかにずれている場合の警告。

オプション	内容
-config <folder>	/config 以外の HolyArrs 設定フォルダーを確認します。
-json	レポートを JSON で出力します。

終了コード 0 は失敗が 1 つもないこと、1 は FAIL の行があることを示します。レポートにキー、パスワード、トークンが表示されることはありません。読み取りだけを行いますが、小さなテストファイルを書き込んで削除する処理だけは例外です。root で起動した場合は、通常の起動と同じように、設定フォルダーの所有者を PUID:PGID に変更します。

HolyArrs が再起動を繰り返していると、docker exec は失敗します。その場合は、同じフォルダーを使う新しいコンテナで doctor を実行します。

docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> -e TZ=<tz> holyarrs/holyarrs:<tag> doctor

Compose の場合: docker compose run --rm holyarrs doctor。

起動時のフォルダー確認

起動時に、HolyArrs はフォルダーを確認し、folders: 4 ok, 1 not writable のような要約を 1 行ログに出します。続けて、問題のあるフォルダーごとに 1 行ずつ、対処とあわせて出します。起動が止まってしまわないよう、この確認は 3 秒で打ち切られます。応答が遅すぎるフォルダーは未確認として扱われます。多くの場合、スリープから復帰中のディスクか、遅いネットワーク共有です。doctor は時間制限なしで確認します。ログを参照してください。

イメージにシェルがない

イメージには HolyArrs のプログラムしか入っていません。そのためサイズが小さく、攻撃者が利用できるものも少なくなります。docker exec holyarrs sh は仕様として失敗します。詳しく調べたいときは、使い捨ての補助コンテナを横に起動します。

docker run --rm -it --pid container:holyarrs --network container:holyarrs --volumes-from holyarrs busybox sh

このコンテナからは HolyArrs のプロセスが見え、ネットワークを共有し、同じフォルダーが同じパスにあります。root で動くため、見るだけにして変更はしないでください。root で書き込んだファイルは HolyArrs から読めなくなることがあります。HolyArrs のユーザーとして試すには、--user <PUID>:<PGID> を追加します。

バージョンを調べる

docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.version" }}' holyarrs

doctor の App セクションにも同じ内容が表示されます。

関連ページ

• サポートを受ける
• ログ
• ヘルスチェック