Debian 12에 MediaWiki 설치하는 방법

MediaWiki는 Wikipedia 및 Wikimedia와 같은 가장 큰 위키 사이트에서 사용되는 오픈 소스 위키 소프트웨어입니다. 협업 및 문서화 플랫폼으로 사용할 수 있는 무료 위키 소프트웨어입니다. 강력하고 확장 가능하며 기능이 풍부한 위키 구현입니다.

이 튜토리얼에서는 Debian 12 서버에 LAMP 스택(Apache, MariaDB 및 PHP)을 사용하여 MediaWiki를 설치하는 방법을 보여줍니다. 또한 Certbot 및 Letsencrypt를 통해 HTTPS로 MediaWiki를 보호하는 방법도 보여줍니다.

전제 조건

시작하기 전에 다음 사항을 확인하십시오:

Debian 12 서버.
관리자 권한이 있는 비루트 사용자.
서버 IP 주소를 가리키는 도메인 이름.

LAMP 스택 설치

MediaWiki는 MySQL/MariaDB를 데이터 저장소로 사용하는 PHP 기반의 오픈 소스 소프트웨어입니다. 현재 MediaWiki의 안정적인 최신 버전(1.41)은 최소 PHP 7.3.4 이상 및 MariaDB 10.3.0이 필요합니다. 웹 서버의 경우 Apache 또는 Nginx를 사용할 수 있습니다.

이 섹션에서는 MediaWiki 설치를 실행하는 데 사용할 LAMP 스택(Apache, MariaDB 및 PHP)을 설치합니다.

먼저 다음 명령어로 Debian 저장소를 업데이트합니다.

sudo apt update

저장소가 업데이트되면 아래 명령어로 LAMP 스택 종속성을 설치합니다. 설치를 확인하려면 Y를 입력하십시오.

sudo apt install apache2 mariadb-server imagemagick libapache2-mod-php php php-common php-intl php-xml php-curl php-gd php-mbstring php-mysql php-apcu

install deps

설치가 완료되면 Apache 및 MariaDB 서비스가 모두 실행되고 있는지 확인합니다.

아래 명령어로 Apache 웹 서버를 확인합니다. 출력에 enabled가 표시되면 Apache가 활성화되어 있으며 시작 시 자동으로 시작됩니다. 실행 중일 때는 active (running)이라는 출력이 표시됩니다.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

verify apache2

다음으로 아래 명령어로 MariaDB 데이터베이스 서버를 확인합니다. 출력은 유사해야 하며, enabled라는 출력은 MariaDB가 활성화되었음을 확인하고 active (running)는 MariaDB가 실행 중임을 확인합니다.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

verify mariadb

마지막으로 아래 명령어로 PHP 버전을 확인하고 활성화된 모듈 목록을 나열합니다. Debian 서버에 설치된 PHP 8.2를 볼 수 있습니다.

php -v  
php -m

verify php

PHP 구성

LAMP 스택을 설치한 후 php.ini 파일을 편집하여 MediaWiki에 대한 일부 기본 매개변수를 변경하여 PHP 설치를 구성합니다.

PHP를 구성하려면 다음 nano 편집기 명령어로 PHP 구성 /etc/php/8.2/apache2/php.ini를 엽니다.

sudo nano /etc/php/8.2/apache2/php.ini

기본 구성을 다음과 같이 변경하고 date.timezone 및 memory_limit를 현재 환경에 맞게 조정하십시오.

date.timezone = Europe/Amsterdam  
upload_max_filesize = 80M  
memory_limit = 512M  
max_execution_time = 360

파일을 저장하고 종료합니다.

이제 아래 명령어를 실행하여 Apache 서비스를 재시작하고 변경 사항을 적용합니다.

sudo systemctl restart apache2

MariaDB 서버 구성

PHP 구성이 완료되면 다음 단계는 MariaDB 서버를 보호하고 MediaWiki를 위한 새 데이터베이스와 사용자를 만드는 것입니다. 이 예에서는 명령줄 mariadb-secure-installation을 사용하여 MariaDB 서버를 보호하고 MariaDB 클라이언트를 통해 새 데이터베이스와 사용자를 생성합니다.

MariaDB 서버 설치를 보호하려면 아래 mariadb-secure-installation 명령어를 실행합니다.

sudo mariadb-secure-installation

이제 MariaDB 서버의 새 구성 수락 여부를 묻는 메시지가 표시되면 Y를 입력하여 수락하거나 n을 입력하여 거부합니다:

기본 MariaDB 설치는 비밀번호 없이 제공됩니다. 비밀번호를 묻는 메시지가 표시되면 ENTER를 누릅니다.
이제 Y를 입력하여 MariaDB 루트 비밀번호를 설정합니다. 그런 다음 MariaDB의 새 비밀번호를 입력하고 비밀번호를 반복합니다.
MariaDB 설치에서 익명 사용자를 제거하려면 Y를 입력합니다.
MariaDB 루트 사용자에 대한 원격 로그인을 비활성화하라는 메시지가 표시되면 Y를 다시 입력합니다.
MariaDB에서 기본 데이터베이스 테스트를 제거하려면 Y를 입력합니다.
마지막으로 Y를 입력하여 테이블 권한을 다시 로드하고 새 변경 사항을 적용합니다.

MariaDB 서버 배포를 보호한 후 아래 mariadb 명령어를 사용하여 MariaDB 서버에 로그인합니다. 프롬프트가 표시되면 MariaDB 루트 비밀번호를 입력합니다.

sudo mariadb -u root -p

이제 다음 쿼리를 실행하여 MediaWiki를 위한 새 MariaDB 데이터베이스와 사용자를 생성합니다. 이 예에서는 새 데이터베이스 mediawikidb, 사용자 mediawiki 및 비밀번호 mediawikipassdb를 생성합니다. 다음 내용을 자격 증명에 맞게 조정할 수 있습니다.

CREATE DATABASE mediawikidb;  
CREATE USER mediawiki@localhost IDENTIFIED BY 'mediawikipassdb';  
GRANT ALL ON mediawikidb.* TO mediawiki@localhost WITH GRANT OPTION;  
FLUSH PRIVILEGES;

create database and user

다음으로 아래 쿼리를 실행하여 MariaDB 사용자 mediawiki의 권한을 확인합니다. 사용자 mediawiki가 데이터베이스 mediawikidb에 접근할 수 있는지 확인하십시오.

SHOW GRANTS FOR mediawiki@localhost;

마지막으로 완료되면 quit를 입력하여 MariaDB에서 종료합니다.

check user privileges

MediaWiki 소스 코드 다운로드

이제 종속성이 설치되고 구성되었으므로 MediaWiki를 설치할 수 있습니다. MediaWiki에는 안정적인 버전, 레거시 버전 및 LTS 버전 등 여러 버전이 있습니다. 이 경우 최신 안정 버전인 MediaWiki 1.41을 설치합니다.

/var/www 디렉토리로 이동하고 아래 wget 명령어를 통해 MediaWiki 소스 코드를 다운로드합니다. MediaWiki 다운로드 페이지를 방문하여 최신 버전을 가져오십시오.

cd /var/www/  
wget https://releases.wikimedia.org/mediawiki/1.41/mediawiki-1.41.0.tar.gz

다운로드가 완료되면 아래 명령어로 소스 코드를 추출합니다. 그런 다음 추출된 디렉토리의 이름을 mediawiki로 변경합니다. 따라서 MediaWiki의 DocumentRoot 디렉토리는 /var/www/mediawiki가 됩니다.

tar -xvzf mediawiki-*.tar.gz  
mv mediawiki-*/ mediawiki/

마지막으로 /var/www/mediawiki 디렉토리의 소유권을 사용자 www-data로 변경하고 권한을 0755로 변경합니다.

sudo chown -R www-data:www-data /var/www/mediawiki  
sudo chmod 755 /var/www/mediawiki

Apache 가상 호스트 설정

이제 MediaWiki 소스 코드를 다운로드했으므로 이 섹션에서는 MediaWiki를 실행하기 위한 새 Apache 가상 호스트 파일을 생성합니다. 서버 IP 주소를 가리키는 도메인 이름이 준비되어 있는지 확인하십시오. 프로덕션 환경에서는 공개 도메인을 구매하거나 로컬 도메인 이름을 사용할 수 있습니다.

시작하기 전에 아래 명령어로 Apache rewrite 모듈을 활성화합니다.

sudo a2enmod rewrite

이제 nano 편집기 명령어로 새 Apache 가상 호스트 구성 파일 /etc/apache2/sites-available/mediawiki.conf를 생성합니다.

sudo nano /etc/apache2/sites-available/mediawiki.conf

다음 구성을 삽입하고 ServerName 옵션을 도메인 이름과 액세스 및 오류 로그의 경로로 변경하십시오.

  
  
 ServerName wiki.howtoforge.local  
  
 ServerAdmin [email protected]  
 DocumentRoot /var/www/mediawiki  
  
 ErrorLog /var/log/apache2/wiki.howtoforge.local_error.log  
 CustomLog /var/log/apache2/wiki.howtoforge.local_access.log combined  
  
   
 Options FollowSymlinks  
 AllowOverride All  
 Require all granted

파일을 저장하고 편집기를 종료합니다.

다음으로 mediawiki.conf 가상 호스트 파일을 활성화하고 아래 명령어로 Apache 구문을 확인합니다. 올바른 Apache 구문이 있는 경우 Syntax OK와 같은 출력이 표시됩니다.

sudo a2ensite mediawiki.conf  
sudo apachectl configtest

마지막으로 Apache 웹 서버를 재시작하여 MediaWiki에 대한 새 가상 호스트를 적용합니다. 재시작 후 MediaWiki 설치가 준비되어야 합니다.

sudo systemctl restart apache2

setup apache vhost

HTTPS로 MediaWiki 보호

이제 MediaWiki에 대한 Apache 가상 호스트 구성을 생성했으므로 Certbot 및 letsencrypt를 통해 HTTPS로 설치를 보호합시다. 이는 공개 도메인을 사용하는 경우에만 적용되지만 로컬 도메인을 사용하는 경우에는 자체 서명된 인증서를 생성하고 HTTPS를 수동으로 적용할 수 있습니다.

아래 명령어로 Certbot 및 Certbot Apache 플러그인을 설치합니다. 설치를 확인하려면 Y를 입력하십시오.

sudo apt install certbot python3-certbot-apache

설치가 완료되면 아래 certbot 명령어를 실행하여 MediaWiki 도메인 이름에 대한 SSL/TLS 인증서를 생성합니다. 도메인 이름과 이메일 주소를 귀하의 정보로 변경하십시오.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d wiki.howtoforge.local

프로세스가 완료되면 인증서는 /etc/letsencrypt/live/domain.com 디렉토리에 저장되며, 가상 호스트도 HTTPS로 구성됩니다.

MediaWiki 설치

선호하는 웹 브라우저를 열고 http://wiki.howtoforge.local/와 같은 도메인 이름을 방문합니다. 모든 것이 잘 진행되면 MediaWiki 환영 페이지가 표시됩니다. 위키 설정 링크를 클릭합니다.

setup wiki

MediaWiki의 기본 언어를 선택하고 계속을 클릭합니다.

select language

환경 검사를 위해 시스템이 MediaWiki 요구 사항을 충족하는지 확인하십시오. 그런 다음 다시 계속을 클릭합니다.

environment check

데이터베이스를 MariaDB로 선택하고 이름, 사용자 및 비밀번호를 입력합니다. 그런 다음 계속을 클릭하여 진행합니다.

db configuration

다음으로 MediaWiki의 관리자 사용자 이름, 이메일 및 비밀번호를 입력한 후 계속을 클릭합니다.

setup admin

추가 설정을 위해 사용하려는 기본 테마를 선택한 후 계속을 클릭하여 설치를 진행합니다.

default settings

MediaWiki 설치를 확인하려면 계속을 클릭합니다.

confirm the installation

complete

설치가 완료되면 LocalSettings.php 파일이 자동으로 로컬 컴퓨터에 다운로드되며 MediaWiki 설치 디렉토리에 파일을 업로드하라는 지침이 표시됩니다.

installation finished

터미널로 돌아가서 아래 명령어를 실행하여 새 파일 LocalSettings.php를 생성합니다.

sudo -u www-data nano /var/www/mediawiki/LocalSettings.php

다운로드한 LocalSettings.php 파일을 열고 PHP 코드를 서버에 복사하여 붙여넣습니다. 그런 다음 파일을 저장하고 종료합니다.

웹 브라우저로 돌아가서 위키에 들어가기 링크를 클릭합니다. 설치한 MediaWiki의 기본 홈페이지가 표시됩니다.

mediawiki home

결론

축하합니다! 이제 Debian 12 서버에 MediaWiki를 성공적으로 설치했습니다. LAMP 스택(Apache, MariaDB 및 PHP)을 사용하여 MediaWiki를 설치하고 Letsencrypt를 통해 HTTPS로 MediaWiki를 보호했습니다.