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

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をインターネットに直接公開しない

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

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

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

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

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

MotionEye 0.44.0では、より強固な認証情報の運用が必要になり、リモートMotionEyeの認証方式も変更されました。アップグレード後にリモートカメラが停止した場合は、ロールバックする前に、新しい共有シークレット/認証情報の仕組みを確認してください。

設定のロールバック用コピーを保管する

最初のアップグレードで、動作している唯一の設定を上書きしないでください。設定ディレクトリのコピーを日時付きで保管し、移行で問題が発生した場合に以前のコンテナと設定を復元できるようにします。

FAQ

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

アップストリームでは、0.44.0が最新リリースとして掲載されています。

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

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

Tugtainerであらゆるアップグレードを安全に処理できますか?

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

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

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