Adminerは、SQLite、MySQL、PostgreSQLなどのデータベースシステムに対応した、軽量なブラウザベースのデータベース管理ツールです。このガイドでは、ZimaOS App StoreからAdminerをインストールし、Embyを例としてSQLiteデータベースのディレクトリへのアクセスを許可する方法を説明します。
重要： Adminerではアプリケーションデータに直接アクセスできます。変更を加える前にデータベースをバックアップし、Adminerをインターネットへ直接公開せず、アプリケーションのデータベース構造を理解するまでは読み取り専用のクエリを使用してください。
始める前に
- ZimaOSがインストールされ、稼働していること。
- ZimaOSのWebインターフェースとApp Storeにアクセスできること。
- 既存のSQLiteデータベースを確認する場合は、その
.dbファイルが保存されているホスト側ディレクトリを把握していること。 - 書き込み操作を行う前に、最新のデータベースバックアップがあること。
既存のデータベースがなくてもAdminerをインストールでき、ディレクトリのマウントは後から設定できます。
Adminerをインストールする
- ZimaOSの App Store を開きます。
- Adminer を検索します。
- Adminerの詳細ページを開き、Install をクリックします。
- インストールが完了するまで待ち、ZimaOSダッシュボードにAdminerが表示されることを確認します。
Adminerにデータベースディレクトリへのアクセスを許可する
- ZimaOSダッシュボードで、Adminerアプリカードの右上にあるメニューを開きます。
- Manage Adminer を選択して、コンテナ設定ページを開きます。
- Volumes を展開し、Mount を見つけてマウントを追加します。
- マウントタイプを Bind mount に設定します。
- Host で、データベースファイルを含むディレクトリを選択します。Embyの標準的なインストールでは、通常
/DATA/AppData/emby/config/dataです。 - Container に
/config/dataと入力します。 - Save をクリックし、ZimaOSによって自動的に再起動されない場合はAdminerを再起動します。
別のアプリケーションで使用する場合は、Embyのホストパスをそのアプリケーションのデータベースディレクトリに置き換えてください。広い範囲のストレージパスではなく、Adminerが必要とするディレクトリだけをマウントします。
SQLiteデータベースを開く
- ZimaOSダッシュボードからAdminerを開きます。
- インストールされているAdminerイメージで利用できる場合は、データベースシステムとして SQLite を選択します。
- マウントしたディレクトリを参照し、
/config/data/library.dbなどのデータベースファイルを選択します。 - Adminerイメージで必要な認証情報を入力してログインします。
SQLite認証の処理方法は、Adminerのイメージやバージョンによって異なる場合があります。インストールしたイメージがパスワードなしのSQLite接続を拒否する場合、他のアプリケーションの認証情報を弱くしたり、Adminerを公開したりしないでください。データベースに対応したAdminerイメージまたは認証設定を使用し、長期利用する前に更新状況とセキュリティ状態を確認してください。
例：Embyのライブラリデータベースを確認する
Embyの標準データディレクトリを /config/data にマウントすると、次のファイルが見つかる場合があります。
library.dbにはメディアライブラリのメタデータが含まれます。users.dbにはユーザーアカウントのデータが含まれます。
SQL Command ページで読み取り専用の確認を実行します。SQLiteデータベースの整合性を確認するには、次を実行します。
PRAGMA integrity_check; |
結果が ok であれば、SQLiteは整合性エラーを検出していません。Embyのメディア名と保存先パスの一部を確認するには、次を実行します。
SELECT Name, Path FROM MediaItems LIMIT 20; |
データベーススキーマは、アプリケーションのバージョンによって変わる場合があります。テーブルや列が見つからない場合は、クエリを変更する前にスキーマを確認してください。テスト済みのバックアップがあり、影響を理解している場合を除き、UPDATE、DELETE、スキーマ変更は避けてください。
その他のデータベースタイプに接続する
MySQLとPostgreSQLは、単独のファイルではなくネットワークデータベースサービスです。接続するには、Adminerからデータベースホストへのネットワークアクセス、正しいポート、有効なデータベース認証情報が必要です。ボリュームのマウントだけでは接続できません。
データベースが別のコンテナで稼働している場合は、適切なDockerネットワークを介して両方のコンテナが通信できることを確認してください。Adminerを接続するためだけに、データベースポートを公開しないでください。
セキュリティとメンテナンスのヒント
- Adminerへのアクセスは、信頼できるローカルネットワークまたは安全な別のアクセス方法に限定します。
- データベースを編集する前にバックアップし、データベースファイルを置き換える前に元のアプリケーションを停止します。
- コミュニティが保守するAdminerイメージを使用する前に、リリース日とセキュリティ状態を確認します。
- データベースへの直接アクセスが不要になったら、Adminerを停止または削除します。
参考情報
サポートが必要な場合
ZimaOSでAdminerをインストールまたは使用する際に問題が発生した場合は、ZimaSpaceのDiscordコミュニティにご参加ください。IceWhaleチームとコミュニティメンバーが設定のトラブルシューティングをお手伝いします。