Debian 12にAdminerデータベース管理ツールをインストールする方法

Adminer（以前はphpMinAdmin）は、MySQL/MariaDB、PostgreSQL、SQLite、MS SQL、OracleなどのRDBMS（リレーショナルデータベース管理システム）およびMongoDBなどのNoSQLをサポートするPHPで書かれた完全な機能を持つデータベース管理ツールです（プラグイン経由）。

AdminerはphpMyAdminの代替です。軽量でユーザーフレンドリー、高性能なデータベース管理ツールであり、データベースを簡単に管理できます。

このガイドでは、Debian 12サーバーにAdminerデータベース管理ツールをインストールする方法を示します。また、Apacheのbasic_authモジュールを使用してAdminerを保護します。

前提条件

始める前に、以下のものを用意してください：

Debian 12サーバー。
管理者権限を持つ非rootユーザー。
MySQL/MariaDBデータベースがインストールされていること。

DebianにAdminerをインストールする

AdminerはphpMyAdminの代替ですが、PostgreSQLデータベースもサポートしています。また、PHPで書かれており、ApacheまたはNginxウェブサーバーを使用するほぼすべてのOSで実行できます。

Debianでは、adminerパッケージはデフォルトで利用可能であり、リポジトリを介して簡単にインストールできます。PHPパッケージとApacheウェブサーバーが自動的にインストールされるため、クリーンなサーバーにadminerをインストールすることをお勧めします。

adminerをインストールする前に、以下のコマンドでDebianパッケージインデックスを更新します。

sudo apt update

update repo

以下のコマンドでデフォルトのDebianリポジトリからadminerパッケージを見つけます。

sudo apt info adminer

以下のように、adminerパッケージがDebianリポジトリのwebセクションにあり、少なくともPHP 8.2とApacheウェブサーバーが必要であることがわかります。

info packages

次に、以下のコマンドでadminerをインストールします。これにより、PHPやApacheなどの必要なパッケージも自動的にインストールされます。インストールを確認するためにyと入力します。

sudo apt install adminer

install adminer

インストールが完了したら、以下のコマンドでApacheサービスを確認します。Apacheサービスが実行中であることを確認してください。

sudo systemctl status apache2

verify apache2

Adminerインストールの保護

adminerをインストールしたので、次のステップはadminerインストールを構成することです。この例では、AdminerのデフォルトURLパスを変更し、basic_authを介して追加の認証を追加します。これにより、2層の認証が得られます。

また、adminerは/etc/apache2/conf-available/adminer.confに新しいApache構成ファイルを生成することを知っておく必要があります。このファイルを修正してadminerインストールを構成します。

構成を編集する前に、以下のコマンドを実行してパスワードファイル/etc/adminer/.htpasswdを生成します。また、ユーザー名dbmanagerを自分のユーザーに変更してください。

/ etc/adminer/.htpasswdは、AdminerのApache basic_authモジュールを介した追加の認証として使用されます。

sudo htpasswd -B -c /etc/adminer/.htpasswd dbmanager

プロンプトが表示されたらパスワードを入力し、繰り返します。

次に、nanoエディタを使用して生成されたApache構成ファイルadminer /etc/apache2/conf-available/adminer.confを開きます。

sudo nano /etc/apache2/conf-available/adminer.conf

最初の行で、‘/adminer ‘のデフォルトURLを新しいURLパスに変更します。この例では、adminerはURLパス’ /dbmanager ‘を介してアクセス可能になります。

Alias /dbmanager /etc/adminer  
  
  
Require all granted  
DirectoryIndex conf.php

次に、’ /dbmanager ‘パスのApache basic_authを有効にするために、以下の構成を挿入します。これにより、’ /dbmanager ‘パスにアクセスするたびに、追加の認証Apache basic_authが求められます。

  
 AuthType Basic  
 AuthName "Restricted Resource"  
 AuthBasicProvider file  
 AuthUserFile /etc/adminer/.htpasswd  
 Require valid-user

完了したら、ファイルを保存して閉じます。

次に、以下のコマンドを実行してApacheで追加の構成’adminer.conf’を有効にし、全体のApache構文を確認します。

sudo a2enconf adminer.conf  
sudo apachectl configtest

適切な構文があることを確認し、Syntax OKのような出力を得ます。

setup admin

最後に、以下のコマンドを実行してApacheサービスを再起動し、Adminerの新しい構成を適用します。コマンドを実行した後、Adminerインストールは準備完了です。

sudo systemctl restart apache2

MySQL/MariaDBサーバーの設定

この時点で、Adminerは準備が整いましたが、Adminerログイン用に指定された新しいユーザーを作成することでMySQLサーバーを準備する必要があります。rootユーザーを直接使用することは推奨されません。

注意：リモートホストを介して接続している場合は、接続を暗号化するためにSSHトンネリングを使用していることを確認してください。単一のサーバー（MySQL + Adminerが同じサーバー上）を使用している場合は、準備が整いました。

以下のコマンドでMySQL/MariaDBサーバーにログインします。プロンプトが表示されたらMySQL rootパスワードを入力します。

sudo mysql -u root -p

以下のクエリを実行して、MySQLサーバー用の新しいユーザーdbmanagerを作成します。この例では、このユーザーはAdminerを介してMySQLサーバーにログインするために使用されます。したがって、以下のパスワードを新しいパスワードに変更してください。

CREATE USER 'dbmanager'@'127.0.0.1' IDENTIFIED BY 'dbpassword';  
GRANT ALL PRIVILEGES ON *.* TO 'dbmanager'@'127.0.0.1' WITH GRANT OPTION;  
FLUSH PRIVILEGES;

setup user

次に、以下のクエリを実行してMySQLサーバー内のユーザーリストを確認します。ユーザーdbmanagerがデフォルトホスト127.0.0.1で表示されるはずです。

SELECT user,host FROM mysql.user;

show users

最後に、MySQLサーバーから退出するにはquitと入力します。

Adminerを介してMySQLサーバーにログインする

ウェブブラウザを開き、AdminerインストールURL http://192.168.5.15/dbmanagerにアクセスします。インストールが成功していれば、basic_auth認証が求められます。作成したユーザー名とパスワードを入力し、サインインをクリックします。

成功すると、Adminerのログインページが表示されます。データベースシステムとしてMySQLを選択し、ホストとポート、ユーザー名、MySQLサーバーのパスワードの詳細を入力します。ログインをクリックして確認します。

適切なデータベース資格情報があれば、Adminerを介してMySQLに接続されるはずです。

adminer dashboard

Adminerを介して新しいデータベースとユーザーを作成する

このセクションでは、Adminerを介してMySQL/MariaDBに新しいデータベースとユーザーを作成する方法を学びます。その後、新しいユーザーを介して新しいデータベースにログインします。

Adminerのダッシュボードで、データベースを作成リンクをクリックします。次のページが表示されます。

新しいデータベース名を入力し、保存をクリックします。この例では、新しいデータベースtestdbを作成します。

create database

次に、新しいMySQL/MariaDBユーザーを作成するには、ダッシュボードの特権をクリックし、次にユーザーを作成をクリックします。

create user

データベースのユーザー名とパスワードを入力し、特権セクション内にデータベース名を入力します。下にスクロールして保存をクリックします。

次の例では、新しいユーザーtestuserを作成し、そのユーザーにデータベースtestdbへの特権を与えます。

create user

最後に、ユーザーtestuserでデータベースtestdbにAdminerでログインします。

成功すると、Adminerを介してtestdbにログインしているはずです。

logged in to testdb

結論

おめでとうございます！Debian 12サーバーにMySQL/MariaDBおよびPostgreSQL用のデータベース管理ツールとしてAdminerを正常にインストールしました。また、デフォルトのURLパスを変更し、Apacheのbasic_authモジュールを介して追加の認証レイヤーを有効にすることでAdminerを保護しました。最後に、Adminerツールを介してMySQLサーバーにログインしました。