コミュニティソリューション

ZimaOSでMotionEyeを安全に最新バージョンへアップデートする

A user needed a newer MotionEye build for Telegram alerts; a community reply suggested Tugtainer, but no migration-safe update procedure was posted.

ZimaOSのMotionEyeパッケージが古いビルドのままなら、汎用のコンテナ自動更新ツールに頼ってMotionEyeのメジャーバージョンを無条件に一気に上げないでください。設定と録画をバックアップし、実行中のイメージを特定してから、バージョンと移行に伴う変更を確認したうえで、メンテナンスされているMotionEyeイメージに切り替えてください。

MotionEye 0.44.0はセキュリティ上重要なリリースであり、認証方式の変更、複数の脆弱性の修正、リモート MotionEye インスタンス同士の認証方法の変更が含まれているため、これは以前にも増して重要です。

実行中のバージョンとイメージを確認する

docker ps --format 'table {.Names}	{.Image}' | grep -i motioneye
docker logs --tail 100 motioneye

App Storeのカードに表示されたバージョンと、実際に動作しているイメージが同じだとは限りません。

MotionEye 0.44.0は現行のセキュリティ基準

現在のMotionEyeリリースページでは、0.44.0が最新リリースとして掲載されており、認証の強化やセキュリティ勧告に関する修正が含まれています。

まず設定と動画をバックアップする

MotionEyeの設定とメディアに割り当てられているホスト側のパスを記録してください。コンテナイメージを置き換える前に、これらのディレクトリをコピーします。

メンテナンスされているGHCRイメージを使う

上流プロジェクトは現在、ghcr.io/motioneye-project/motioneye でマルチアーキテクチャ対応イメージを公開しています。長期間更新されていない古いイメージや変動する開発タグではなく、0.44.0 のような固定された安定版タグを選びましょう。

リリースノートを確認せずに自動更新しない

MotionEye 0.44.0ではリモート MotionEye の認証方式が変更され、以前のデプロイでは空欄でもよかった可能性のあるパスワードが必須になりました。そのため、自動でコンテナイメージを取得すると起動自体は成功しても、リモートカメラに接続できなくなる場合があります。

Tugtainerだけでは解決しない理由

フォーラムの返信では、コンテナの更新に Tugtainer が提案されていました。コンテナ更新ツールでイメージを取得して再デプロイすることはできますが、古いボリューム構成、認証情報、リモートカメラの秘密情報、または互換性を損なう変更に対応できるかどうかまでは判断できません。

アップグレード後にカメラを確認する

ローカルカメラ、MotionEyeのリモートカメラ、録画先、通知、必要に応じてTelegram連携を確認してください。ポート8765でUIが表示されることを確認し、認証エラーやカメラエラーがないかログを調べてください。

MotionEyeをインターネットに直接公開しない

セキュリティ更新後も、ポートを直接転送するのではなく、プライベートネットワーク、VPN、または認証付きHTTPS経由で管理UIを保護してください。

カスタムDockerガイドでは、ZimaOSのコンテナ運用手順を説明しています。

イメージのアーキテクチャを確認する

ZimaOSホストのアーキテクチャに合ったイメージを使用してください。現在、上流のコンテナレジストリでは複数のLinuxアーキテクチャ向けのイメージが公開されているため、amd64対応のためだけに古いイメージを再ビルドする必要はありません。

0.44.0以降の認証変更に備える

MotionEye 0.44.0では、より強固な認証情報の運用が求められ、MotionEyeのリモート認証も変更されています。アップグレード後にリモートカメラが動作しなくなった場合は、ロールバックする前に、新しい共有シークレット/認証情報の手順を確認してください。

構成のロールバック用コピーを保管する

最初のアップグレードでは、唯一の正常な構成を上書きしないでください。移行で問題が起きた場合に以前のコンテナと設定を復元できるよう、構成ディレクトリのタイムスタンプ付きコピーを保管してください。

よくある質問

MotionEyeの現在のリリースは何ですか?

上流プロジェクトでは、0.44.0が最新リリースとして掲載されています。

イメージタグを変更するだけでよいですか?

データをバックアップし、リリースノートを読んでからにしてください。特に0.44.0では認証の動作が変更されています。

Tugtainerはすべてのアップグレードを安全に処理できますか?

いいえ。イメージの更新は自動化できますが、アプリケーションレベルの互換性を破る移行の検証はできません。

古いバージョンがまだ動くのに、なぜ更新するのですか?

0.44.0にはセキュリティ修正が含まれているため、脆弱性のある古いバージョンを使い続けると、避けられるリスクを抱えることになります。