Rocky Linux 9에 MediaWiki 설치하는 방법

MediaWiki는 Rocky Linux에서 원활하게 실행되는 무료 오픈 소스 위키 소프트웨어 플랫폼으로, 강력한 협업 콘텐츠 생성 및 관리 솔루션을 제공합니다. 원래 위키백과를 위해 설계된 MediaWiki는 현재 수많은 조직과 커뮤니티에서 동적이고 정보가 풍부한 웹사이트를 구축하고 유지하는 데 널리 사용되고 있습니다. 안정성과 보안으로 알려진 기업급 리눅스 배포판인 Rocky Linux에서 MediaWiki는 강력하고 신뢰할 수 있는 운영 환경의 이점을 누립니다. 이 조합은 Rocky Linux에서 MediaWiki 설치가 높은 트래픽 부하와 광범위한 사용자 기여를 처리할 수 있도록 보장하여 포괄적이고 확장 가능한 위키를 만드는 데 이상적인 선택이 됩니다.

이 가이드는 Rocky Linux 9 서버에 MediaWiki를 설치하는 방법을 보여줍니다. LAMP 스택(Apache/Httpd, MySQL/MariaDB 및 PHP)으로 MediaWiki를 설치하고 구성합니다.

필수 조건

이 가이드를 완료하려면 다음이 필요합니다:

Rocky Linux 9 서버.
sudo 권한이 있는 비루트 사용자.
서버 IP 주소를 가리키는 도메인 이름.
상태가 허용된 SELinux.

LAMP 스택 종속성 설치

MediaWiki는 PHP 및 MySQL/MariaDB 기반의 오픈 소스 위키 소프트웨어입니다. 이를 설치하려면 Rocky Linux 시스템에 LAMP 스택(Apache/httpd, MySQL/MariaDB 및 PHP)을 설치해야 합니다. 이 예제에서는 PHP 8.1로 MediaWiki를 설치할 것이므로 서드파티 리포지토리를 추가해야 합니다.

시작하려면 아래 명령어를 실행하여 EPEL 및 Remi 리포지토리를 Rocky Linux 서버에 추가합니다.

sudo dnf install epel-release dnf-utils http://rpms.remirepo.net/enterprise/remi-release-9.rpm

setup repo

이 시점에서 MediaWiki는 PHP 8.1이 필요하므로 Remi 리포지토리를 통해 이를 활성화해야 합니다. 아래 명령어를 실행하여 Remi 리포지토리에서 PHP 8.1 리포지토리를 활성화합니다.

sudo dnf module reset php  
sudo dnf module enable php:remi-8.1

enable php repo

이제 MediaWiki의 LAMP 스택 종속성을 설치하기 위해 다음 명령어를 실행합니다. 설치를 확인하려면 y를 입력합니다.

sudo dnf install httpd httpd-tools mariadb-server mariadb php php-mysqlnd php-gd php-xml php-intl php-mbstring php-json php-curl wget

install deps

설치가 완료되면 다음 systemctl 명령어를 실행하여 httpd 서비스를 시작하고 활성화합니다.

sudo systemctl start httpd  
sudo systemctl enable httpd

아래 명령어로 MariaDB 서비스를 시작하고 활성화합니다.

sudo systemctl start mariadb  
sudo systemctl enable mariadb

start enable mysql apache

마지막으로 아래 명령어를 사용하여 PHP 버전을 확인합니다. Rocky Linux 시스템에 PHP 8.1이 설치되어 있어야 합니다.

php -v  
php -m

check php

Firewalld에 HTTP 및 HTTPS 서비스 추가

LAMP 스택을 설치한 후 Rocky Linux 서버에서 HTTP 및 HTTPS 포트를 열어야 합니다. RHEL 기반 운영 체제에서는 firewalld를 사용하여 서버에 허용된 트래픽을 열고 관리합니다.

다음 명령어를 실행하여 firewalld에 HTTP 및 HTTPS 서비스를 추가합니다.

sudo firewall-cmd --add-service=http --permanent  
sudo firewall-cmd --add-service=https --permanent

이제 아래 명령어로 firewalld를 다시 로드하여 새 규칙을 적용합니다.

sudo firewall-cmd --reload

다시 로드된 후 아래 명령어를 사용하여 firewalld의 규칙 목록을 확인합니다. HTTP 및 HTTPS 서비스가 firewalld에 추가된 것을 확인할 수 있습니다.

sudo firewall-cmd --list-all

setup firewalld

MariaDB 서버 설정

이제 httpd 웹 서버로의 트래픽을 허용했으므로 mariadb-secure-installation 유틸리티를 통해 MariaDB를 보호하고 MediaWiki에서 사용할 새 데이터베이스와 사용자를 생성할 수 있습니다.

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

sudo mariadb-secure-installation

이 과정에서 MariaDB 서버 구성에 대한 몇 가지 질문을 받게 됩니다 - 변경 사항을 확인하려면 y를 입력하고 새 구성을 거부하려면 n을 입력합니다:

unix_socket 인증으로 전환하시겠습니까? n을 입력하고 ENTER를 누릅니다. 기본 MariaDB 루트 사용자는 이미 보호되어 있습니다. y를 입력하여 활성화할 수도 있습니다.
루트 비밀번호를 변경하시겠습니까? y를 입력하여 새 MariaDB 루트 비밀번호를 설정합니다.
익명 사용자를 제거하시겠습니까? y를 입력하여 확인합니다.
원격에서 루트 로그인을 금지하시겠습니까? y를 입력하여 확인합니다. MariaDB 루트 사용자로는 로컬 연결만 허용됩니다.
테스트 데이터베이스와 그 접근을 제거할 수 있습니까? y를 입력하여 확인하고 기본 데이터베이스 ‘test’를 제거합니다.
마지막으로, MariaDB 서버의 모든 테이블 권한을 다시 로드하고 새 변경 사항을 적용하려면 y를 입력합니다.

MariaDB 서버가 보호되면 MediaWiki를 위한 새 데이터베이스와 사용자를 생성할 수 있습니다.

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

sudo mariadb -u root -p

이제 MediaWiki를 위한 새 데이터베이스와 사용자를 생성하기 위해 다음 쿼리를 실행합니다. 이 예제에서는 mediawikidb라는 새 데이터베이스와 비밀번호 p4ssw0rd를 가진 사용자 wikiuser를 생성합니다. 다음 데이터베이스 세부정보를 귀하의 정보로 조정할 수 있습니다.

CREATE DATABASE mediawikidb;  
GRANT ALL PRIVILEGES ON mediawikidb.* TO 'wikiuser'@'localhost' IDENTIFIED BY 'p4ssw0rd' WITH GRANT OPTION;  
FLUSH PRIVILEGES;

create db

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

SHOW GRANTS FOR 'wikiuser'@'localhost';

마지막으로 quit을 입력하여 MariaDB 서버에서 로그아웃합니다.

show db privileges

MediaWiki 소스 코드 다운로드

이제 MariaDB 서버를 구성했으므로 MediaWiki 소스 코드를 다운로드하고 설치 디렉토리에 대한 적절한 권한을 설정합니다.

/var/www/ 디렉토리로 이동하고 아래 wget 명령어를 사용하여 MediaWiki 소스 코드를 다운로드합니다. MediaWiki 다운로드 페이지를 확인하여 최신 버전의 링크를 가져옵니다.

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

다운로드가 완료되면 아래 명령어를 실행하여 MediaWiki 소스 코드를 추출하고 추출된 디렉토리의 이름을 ‘mediawiki’로 변경합니다. 이렇게 하면 MediaWiki 설치를 위한 문서 루트가 /var/www/mediawiki가 됩니다.

tar -zxpvf mediawiki-1.41.0.tar.gz  
mv mediawiki-1.41.0 mediawiki

이제 아래 chown 명령어를 실행하여 /var/www/mediawiki의 소유권을 ‘apache’ 사용자로 변경하고 httpd 웹 서버가 MediaWiki 소스 코드에 접근할 수 있도록 합니다.

sudo chown -R apache:apache /var/www/mediawiki

SELinux가 활성화된 경우 아래 명령어를 실행하여 MediaWiki 소스 코드의 레이블을 수정합니다.

sudo restorecon -FR /var/www/mediawiki/

Httpd 가상 호스트 설정

MediaWiki 소스 코드를 다운로드한 후 MediaWiki를 위한 새로운 가상 호스트 구성을 생성합니다. 따라서 서버 IP 주소를 가리키는 도메인 이름이 필요합니다.

다음 nano 편집기 명령어를 사용하여 새 구성 /etc/httpd/conf.d/mediawiki.conf를 생성합니다.

sudo nano /etc/httpd/conf.d/mediawiki.conf

아래 구성을 삽입하고 ServerName 옵션을 귀하의 도메인 이름으로 변경해야 합니다.

  

ServerName dev.domainhere.info  
ServerAlias dev.domainhere.info  
ServerAdmin [email protected]  
DocumentRoot /var/www/mediawiki  

ErrorLog /var/log/httpd/dev.domainhere.info_error.log  
CustomLog /var/log/httpd/dev.domainhere.info_access.log combined  

  
Options FollowSymlinks  
AllowOverride All  
Require all granted

작업이 완료되면 파일을 저장하고 편집기를 종료합니다.

이제 아래 명령어를 실행하여 httpd 구문을 확인합니다. Syntax OK라는 출력이 나오면 올바른 httpd 구성이 있다는 것을 나타냅니다.

sudo apachectl configtest

마지막으로 아래 명령어로 httpd 서비스를 재시작하여 새로운 httpd 가상 호스트 구성을 적용합니다.

sudo systemctl restart httpd

setup httpd

Letsencrypt를 통한 HTTPS로 MediaWiki 보호

공용 도메인에 MediaWiki를 설치하는 경우 HTTPS를 구현해야 합니다. 이 예제에서는 Letsencrypt에서 SSL/TLS 인증서를 생성하고 MediaWiki를 HTTPS로 보호합니다.

먼저 아래 dnf 명령어를 실행하여 Certbot과 Apache 플러그인을 시스템에 설치합니다. 설치를 확인하려면 y를 입력합니다.

sudo dnf 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

프로세스가 완료되면 MediaWiki 설치가 HTTPS로 보호되고 SSL/TLS 인증서는 /etc/letsencrypt/live/ 디렉토리에 있어야 합니다.

MediaWiki 설치

웹 브라우저를 열고 http://wiki.howtoforge.local/와 같은 MediaWiki 도메인 이름을 방문합니다. 모든 것이 잘 진행되면 MediaWiki의 환영 페이지가 표시됩니다.

위키를 설정하는 링크를 클릭합니다.

setup wiki

MediaWiki 기본 언어를 선택하고 계속을 클릭합니다. MediaWiki는 필요에 따라 다양한 언어를 지원합니다.

select default language

환경 검사 과정에서 시스템이 MediaWiki 요구 사항을 충족하는지 확인합니다. 그런 다음 다시 계속을 클릭합니다.

check env

이제 데이터베이스 이름, 사용자 및 비밀번호를 입력합니다. 그런 다음 계속을 클릭합니다.

setup db

설치와 동일한 계정을 사용하도록 옵션을 선택하고 계속을 클릭합니다. 이렇게 하면 MediaWiki 사용자에 대해 동일한 데이터베이스를 사용하게 됩니다.

db settings

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

setup user

추가 구성을 위해 다시 계속을 클릭합니다. 설치가 완료된 후에 이를 구성할 수 있습니다.

additional settings

이제 MediaWiki 설치를 확인하기 위해 계속을 클릭합니다.

installation

설치가 완료되면 아래 출력이 표시됩니다 - 계속 진행하려면 계속을 클릭합니다:

installation complete

MediaWiki 설치를 완료하기 위한 추가 지침이 표시됩니다:

LocalSettings.php 파일을 다운로드합니다.
LocalSettings.php를 DocumentRoot 디렉토리에 배치합니다.

installation complete

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

touch /var/www/mediawiki/LocalSettings.php  
sudo chown apache:apache /var/www/mediawiki/LocalSettings.php

nano 편집기 명령어를 사용하여 LocalSettings.php 파일을 편집하고 다운로드한 PHP 스크립트를 입력합니다.

nano /var/www/mediawiki/LocalSettings.php

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

MediaWiki 설치 페이지로 돌아가서 위키에 들어가기 위한 링크를 클릭합니다. 다음과 같은 MediaWiki의 기본 메인 페이지가 표시됩니다:

default home

결론

축하합니다! Rocky Linux 9 서버에 LAMP 스택(Apache/httpd, MariaDB 및 PHP)으로 MediaWiki 설치를 완료했습니다. 또한 Certbot과 Letsencrypt를 통해 MediaWiki를 HTTPS로 보호했습니다.