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 서버.
관리자 권한이 있는 비루트 사용자.
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를 통해 추가 인증을 추가합니다. 이렇게 하면 두 개의 인증 계층이 생깁니다.

또한 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 구성을 엽니다 /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 ‘ 경로에 접근할 때마다 추가 인증을 요구합니다.

  
 AuthType Basic  
 AuthName "제한된 리소스"  
 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 서버를 준비해야 합니다. 루트 사용자를 직접 사용하는 것은 권장되지 않습니다.

참고: 원격 호스트를 통해 연결하는 경우 SSH 터널링을 통해 연결을 암호화해야 합니다. 단일 서버(MySQL + Adminer가 동일한 서버에 있는 경우)를 사용하는 경우 준비가 완료되었습니다.

아래 명령어로 MySQL/MariaDB 서버에 로그인합니다. 프롬프트가 나타나면 MySQL 루트 비밀번호를 입력합니다.

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 서버의 사용자 목록을 확인합니다. 기본 호스트 127.0.0.1와 함께 사용자 dbmanager를 볼 수 있어야 합니다.

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 사용자로 Adminer에 로그인하여 데이터베이스 testdb에 접근합니다.

성공적으로 로그인하면 Adminer를 통해 testdb에 로그인됩니다.

logged in to testdb

결론

축하합니다! 이제 Debian 12 서버에 MySQL/MariaDB 및 PostgreSQL용 데이터베이스 관리 도구로 Adminer를 성공적으로 설치했습니다. 또한 기본 URL 경로를 변경하고 Apache basic_auth 모듈을 통해 추가 인증 계층을 활성화하여 Adminer를 보안했습니다. 마지막으로 Adminer 도구를 통해 MySQL 서버에 로그인했습니다.