우분투 24.04에 MediaWiki 설치하는 방법

MediaWiki는 PHP와 MySQL로 작성된 오픈 소스 위키 소프트웨어입니다. Wikipedia와 Wikimedia와 같은 사이트를 지원하는 확장 가능하고 확장 가능한 위키 소프트웨어입니다. MediaWiki는 협업 및 문서화 플랫폼으로 사용할 수 있습니다. 문서를 조직하고 모든 사람이 공개할 수 있도록 할 수 있습니다. 다국어를 지원하며 테마/스킨, 플러그인 및 편집기와 같은 다양한 측면에 대한 사용자 지정을 제공합니다.

이 가이드는 우분투 24.04 서버에 MediaWiki 소프트웨어를 설치하는 방법을 보여줍니다. LAMP 스택(리눅스, 아파치, MySQL/MariaDB 및 PHP)을 사용하여 MediaWiki를 설치한 후 Certbot과 Letsencrypt를 통해 HTTPS로 보안합니다.

전제 조건

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

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

종속성 설치

MediaWiki를 설치하려면 시스템에 종속성이 설치되어 있는지 확인해야 합니다. 현재 안정적인 MediaWiki 1.41 버전은 PHP 8.1-83을 요구합니다. 이 섹션에서는 MediaWiki의 종속성으로 Apache, MariaDB 서버, PHP 8.3 및 ImageMagick을 설치합니다.

먼저, 다음 명령어를 실행하여 우분투 저장소를 업데이트합니다.

sudo apt update

이제 다음 명령어를 사용하여 MediaWiki의 종속성을 설치합니다. 프로세스를 확인하려면 Y를 입력하십시오. 이렇게 하면 LAMP 스택(아파치, MySQL/MariaDB 및 PHP) 및 ImageMagick 패키지가 설치됩니다.

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 dependencies

설치가 완료되면 아래 명령어로 apache2 서비스의 상태를 확인합니다. 아파치 웹 서버가 실행 중이고 활성화되어 있는 것을 볼 수 있습니다.

sudo systemctl is-enabled apache2
sudo systemctl status apache2

check apache2

다음 명령어로 mariadb 서비스를 확인합니다. 다음과 같이 MariaDB 서버가 실행 중이고 활성화되어 있는 것을 볼 수 있습니다.

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

check mariadb

마지막으로 다음 명령어를 사용하여 PHP 버전을 확인합니다. 시스템에 PHP 8.3이 설치되어 있는 것을 볼 수 있습니다.

sudo php -v

check php version

UFW 설정

다음 명령어로 UFW에서 Apache Full 프로필을 추가하고 활성화합니다.

sudo ufw allow “Apache Full”

이제 아래의 ufw status 명령어로 UFW에서 활성화된 규칙을 확인합니다. Apache Full 프로필은 HTTP 및 HTTPS 프로토콜 모두에 대한 포트를 엽니다.

sudo ufw status

setup ufw

PHP 구성

종속성을 설치한 후, 기본 구성 파일 /etc/php/8.3/apache2/php.ini를 편집하여 PHP를 설정합니다.

다음 nano 명령어를 실행하여 PHP 구성 파일 /etc/php/8.3/apache2/php.ini를 엽니다.

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

기본 PHP 구성을 다음과 같이 주석을 제거하고 변경합니다. 필요에 따라 memory_limit 및 date.timezone 옵션을 조정하십시오.

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

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

이제 아래 명령어를 실행하여 아파치 웹 서버를 재시작하고 PHP 구성을 적용합니다.

sudo systemctl restart apache2

MariaDB 서버 구성

이제 PHP가 구성되었으므로 MariaDB 서버를 보안하고 MediaWiki를 위한 새 데이터베이스와 사용자를 생성합니다. mariadb-secure-installation 유틸리티로 MariaDB를 보안한 후, mariadb 클라이언트를 통해 새 데이터베이스와 사용자를 생성합니다.

아래 명령어로 MariaDB 서버 설치를 보안합니다.

sudo mariadb-secure-installation

이제 다음 MariaDB 서버 구성에 대한 질문을 받게 됩니다:

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

MariaDB가 보안된 후, 아래 명령어로 MariaDB 서버에 로그인합니다 - 프롬프트가 표시되면 root 비밀번호를 입력합니다.

sudo mariadb -u root -p

다음으로, MediaWiki를 위한 새 데이터베이스와 사용자를 생성하기 위해 아래 쿼리를 실행합니다. 이 예제에서는 새 데이터베이스 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

이제 아래 쿼리를 실행하여 사용자 mediawiki의 권한을 확인합니다. 아래에서 사용자 mediawiki가 데이터베이스 mediawikidb에 접근할 수 있는 것을 볼 수 있습니다.

SHOW GRANTS FOR mediawiki@localhost;

마지막으로, quit을 입력하여 MariaDB 서버에서 종료합니다.

check user privileges

MediaWiki 다운로드

이 섹션에서는 MediaWiki 1.41 소스 코드를 다운로드하고 MediaWiki 설치 디렉토리를 설정합니다.

/var/www 디렉토리로 이동하여 아래의 curl 명령어로 MediaWiki 소스 코드를 다운로드합니다. 최신 버전을 얻으려면 MediaWiki 다운로드 페이지를 방문하십시오.

cd /var/www/
curl -O https://releases.wikimedia.org/mediawiki/1.41/mediawiki-1.41.1.tar.gz

다운로드가 완료되면 MediaWiki 소스 코드를 추출하고 디렉토리 이름을 mediawiki로 변경합니다. 이렇게 하면 MediaWiki의 문서 루트 디렉토리가 /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

아파치 가상 호스트 설정

이제 MediaWiki 소스 코드를 다운로드했으므로 다음 단계는 MediaWiki를 실행하기 위한 새 아파치 가상 호스트 파일을 만드는 것입니다. MediaWiki 서버를 가리키는 도메인 이름이 있는지 확인하십시오.

먼저, 다음 명령어를 실행하여 아파치 웹 서버에서 rewrite 모듈을 활성화합니다.

sudo a2enmod rewrite

이제 다음 nano 편집기 명령어로 새 가상 호스트 파일 /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를 활성화하고 아파치 구문을 확인합니다. 올바른 아파치 구문이 있으면 Syntax is OK라는 출력이 표시됩니다.

sudo a2ensite mediawiki.conf
sudo apachectl configtest

마지막으로, 아래 명령어를 실행하여 아파치를 재시작하고 변경 사항을 적용합니다. 이렇게 하면 MediaWiki 설치가 준비됩니다.

sudo systemctl restart apache2

setup vhost

HTTPS로 MediaWiki 보안

이 가이드에서는 MediaWiki를 HTTPS로 보안합니다. 공개 도메인을 사용하는 경우, Letsencrypt에서 무료 SSL 인증서를 사용하고 HTTPS를 자동으로 설정할 수 있습니다. 로컬 도메인 사용자의 경우 SSL 인증서를 생성하고 HTTPS를 수동으로 설정할 수 있습니다.

다음 명령어로 certbot 및 python3-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

SSL/TLS 인증서는 /etc/letsencrypt/live/domain.com 디렉토리에 있습니다. MediaWiki 설치는 자동으로 HTTPS로 보안되어야 합니다.