トラブルシューティング

問題が発生したら、まず本章の症状と照らし合わせて確認してください。該当するものがない場合は、末尾の「サポート窓口」からお問い合わせください。

1. 映像が表示されない(ライブがずっとバッファリング中)

考えられる原因	確認方法	解決方法
RTSP URL が間違っている	VLC で同じ URL を試す	URL を修正して再保存する。ONVIF 自動検出のアドレスが間違っている場合は、手動 RTSP に切り替える
認証情報が間違っている	Web 管理画面で認証失敗と表示される	カメラ詳細に戻ってパスワードを修正する。ONVIF のパスワードと RTSP のパスワードは別物です
低遅延チャンネルがブロックされている	DevTools → Network で接続エラーを確認する	ファイアウォールで UDP 23515 を開放する。開放できない場合は自動的に安定チャンネルに切り替わります(遅延 2〜4 秒)
カメラが独自プロトコルを使用している(Tapo / Xiaomi など)	カメラのブランドがカメラの一覧にないか確認する	go2rtc ブリッジを経由する
ストリーミングゲートウェイが起動していない	`docker logs yunkan` で起動エラーを確認する	多くの場合はポートの競合です。コンテナを再起動してみてください

2. 再生画面が真っ黒 / 進捗バーが動かない

録画が無効:カメラ詳細 → 録画設定 → 有効化
ディスクフル:df -h で data のあるパーティションを確認し、古い録画を削除するか保持日数を短くする
録画セグメントの破損:該当する data/recordings/<id>/<date>/<HH-MM-SS>.mp4 を見つけて VLC で再生を試す。破損セグメントで失われるのは最大 5 分です
時刻が合っていない:サーバーとカメラのタイムゾーンが同期していないと、再生タイムラインが 8 時間ずれます。timedatectl で確認してください

3. AI 検出が機能しない

症状	原因	解決方法
イベントページがずっと空のまま	グローバル検出スイッチがオフになっている	設定 → 検出 → 有効化
特定のカメラだけ検出しない	そのカメラが「検出失敗」状態になっている	カメラ詳細 → 「検出エラーをクリア」
GPU 使用率が 0	イメージのバリアントが間違っている(GPU 搭載機で cpu イメージを実行している)	対応するバリアントのイメージを取得して再起動する
顔が常に「見知らぬ人」と判定される	ライブラリにこの人物が登録されていない / 閾値が厳しすぎる	顔を追加する / 顔類似度の閾値を下げる
転倒の誤検知が多い	降下速度の閾値が低すぎる	転倒の降下速度閾値を少し上げる

4. コンテナが再起動を繰り返す

docker logs --tail 200 yunkan で直近の出力を確認してください。よくあるエラー:

設定が未完了:ウィザードモードのままヘルスチェックが失敗する → ブラウザで /setup ウィザードを完了させれば解決します
ポートが使用中:ss -tnlp | grep 23406 で確認し、競合しているサービスを停止するかポートを変更する
ハードウェアファイルが未マウント:bind-mount に /etc/machine-id が含まれておらず、ライセンス検証がクラッシュしています。インストールの手順に従って追加してください
アーキテクチャ非対応:SkyView は x86_64 と RK3588(arm64)のイメージのみを提供しており、それ以外の ARM マシンでは動作しません(uname -m の出力は x86_64 であるべきです。aarch64 の場合は RK3588 ボードのみ動作します。RK3588 デプロイを参照)

5. 115 へのアップロードが失敗する

ログイン情報の期限切れ(30 日程度):設定 → 115 → QR コードを再スキャンしてログイン
VIP の期限切れ:非常に大きなファイルには 115 VIP の瞬間アップロードチャンネルが必要です。VIP でない場合は速度制限付きのチャンネルを使用します
保存先フォルダが削除された:115 側でフォルダを作り直してから、SkyView に戻って選び直してください
ネットワークが不安定:アップロードタスクには自動リトライが組み込まれています。具体的なエラーは docker logs yunkan で確認してください

6. オートメーションがトリガーされない

おやすみ時間:設定 → 通知 → おやすみ時間を確認し、現在その時間帯に該当していないか確認する
クールダウン:30 秒以内の重複イベントは無視されます。クールダウン時間を短くするか、別のイベントタイプに変更してください
条件が一致しない:ルールに「認識された人物 = 張三」という条件を追加していても、実際には「見知らぬ人」と認識された場合、ルールはトリガーされません。条件を緩めてください
MQTT が接続できていない:設定 → 連携 → MQTT で接続状態を確認し、アドレスと認証情報を確認してください

7. アップグレード後にウィザードが再度表示される / データが消えた

アップグレード後に /setup へ飛ばされる場合、ほぼ確実に data ディレクトリが正しくマウントされていないことが原因です——コンテナが前回書き込んだ設定ファイルを見つけられず、新規インストールだと判断してしまいます。以下を確認してください:

bash

docker inspect yunkan | grep -A 2 Mounts
# Source: /home/.../data, Destination: /app/data と表示されるはずです
# パスが変わっていたり、マウントされていない場合は、コンテナを docker rm し、次回の docker run で正しくマウントしてください

ウィザードを再度実行しないでください

そのまま setup を進めると、新しい空のデータベースが作成されます。元のデータベースは残っていますが無効化されます。まずコンテナを停止してマウントを修正し、再起動すれば、通常モードに直接入れます。

8. パスワードを忘れてログインできない

まず、どのケースかを確認してください：

状況	対処
パスワードは分かっていて、変更したいだけ	ログインして「設定 → ユーザー管理」で変更
家族のアカウントのパスワードを忘れた	管理者に「設定 → ユーザー管理」でリセットしてもらう
管理者本人が忘れて、誰もログインできない	下のコマンドでリセット

SkyView はご自宅の機器で動作しているため、パスワード再設定メールという仕組みはありません。管理者がログインできなくなった場合は、SkyView をインストールした機器で次のコマンドを実行してください。その機器を操作できる人は、もともと最上位の権限を持っています。

bash

# システム上のアカウントを確認する
docker exec -it yunkan skyview-reset-password --list

# 指定したアカウントのパスワードをリセットする（新しいパスワードを 2 回入力、画面には表示されません）
docker exec -it yunkan skyview-reset-password --user admin

コマンドの表示は英語です

New password (not shown) は新しいパスワードの入力、Type it again はもう一度入力する意味です。パスワードの条件は画面と同じで、8 文字以上、英字と数字の両方を含みます。

そのアカウントが無効化されている場合、パスワードをリセットしただけではログインできません。末尾に --activate を付けると、リセットと同時に有効化されます：

bash

docker exec -it yunkan skyview-reset-password --user admin --activate

コンテナ名が yunkan でない場合

コマンド内の yunkan は、ワンライナーのインストーラーが作成する既定のコンテナ名です。NAS のアプリストアや Home Assistant アドオンから導入した場合は名前が異なることがあります。docker ps で確認し、コマンド内の yunkan を実際の名前に置き換えてください。

パスワードのリセットで強制ログアウトはされません

すでにログインしているスマートフォンやブラウザーは、有効期限が切れるまでそのまま使えます。第三者に使われている心配がある場合は、「設定 → ユーザー管理」でそのアカウントを無効化するか削除してください。

9. ログの確認方法

bash

# シングルイメージ構成:すべての機能のログが混在しています
docker logs --tail 500 -f yunkan

# 検出関連だけを見たい場合:
docker logs yunkan 2>&1 | grep -i detection

# マルチコンテナ構成:各コンポーネントが独立しています
docker compose logs -f api detection

サポート窓口

サポートチケット:カスタマーポータル → 注文履歴 → チケットを起票から、docker logs --tail 200 yunkan の出力を添付してください。最も早く対応できます
メール:support@yun-kan.com(24 時間以内に返信)
WeChat グループ:購入後、カスタマーポータルの「注文履歴」ページにグループ参加用の QR コードがあります(有料ユーザー限定)

このページは役に立ちましたか？