Debian 12에 DokuWiki 설치하는 방법

DokuWiki는 데이터베이스가 필요 없는 간단하고 다재다능한 오픈 소스 위키 소프트웨어입니다. 유지 관리 용이성, 가독성 및 사용자 관리로 잘 알려져 있어 기업 또는 협업 환경에서 문서를 생성하고 관리하는 데 이상적입니다. PHP로 구동되는 이 다재다능한 위키 소프트웨어는 내장된 접근 제어(ACL)를 지원하여 주요 인증 드라이버를 지원합니다. DokuWiki는 쉬운 관리 기능을 제공하며, 설치, 유지 관리 및 백업이 간편합니다.

이 가이드에서는 Debian 12 서버에 DokuWiki를 설치하는 방법을 안내합니다. LAMP 스택(Apache2, MariaDB 및 PHP), UFW 및 Letsencrypt를 통한 SSL/TLS 인증서를 사용하여 DokuWiki를 설치합니다.

필수 조건

이 가이드를 진행하기 위해 다음 사항을 확인하십시오:

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

종속성 설치

기본적으로 DokuWiki 패키지는 Debian 저장소에서 사용할 수 있습니다. 하지만 최신 버전의 DokuWiki를 설치하기 위해 DokuWiki를 수동으로 Debian 서버에 설치할 것입니다.

이 섹션에서는 DokuWiki에 필요한 종속성을 설치합니다. 여기에는 LAMP 스택 패키지(Apache2, MariaDB 및 PHP), UFW 및 Certbot이 포함됩니다.

시작하기 전에 아래 명령어를 사용하여 Debian 저장소를 업데이트하십시오.

sudo apt update

다음 apt install 명령어를 사용하여 LAMP 스택, UFW 및 Certbot 패키지를 설치합니다. 프롬프트가 표시되면 Y를 입력하고 ENTER를 누르십시오.

sudo apt install apache2 mariadb-server php libapache2-mod-php php-xml php-mbstring php-zip php-intl php-gd ufw certbot python3-certbot-apache

install deps

설치가 완료되면 Apache 및 MariaDB 서비스 상태를 확인하여 서비스가 실행 중인지 확인하십시오.

다음 명령어를 실행하여 apache2 서비스를 확인하십시오.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

apache2가 실행 중이면 ‘active (running)’이라는 출력이 표시됩니다. ‘enabled’라는 출력은 apache2가 시스템 부팅 시 시작될 것임을 확인합니다.

verify apache2

이제 다음 명령어를 실행하여 mariadb 서비스를 확인하십시오.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Debian 머신에서 mariadb 서비스가 ‘enabled’ 및 ‘active (running)’인지 확인하십시오.

verify mariadb

UFW 구성

이 가이드에서는 UFW(간단한 방화벽)를 사용하여 Debian 서버를 보호합니다. 이 경우 원격 액세스를 위해 SSH 포트를 열고 DokuWiki 설치를 실행하기 위해 HTTP 및 HTTPS 프로토콜의 포트를 열어야 합니다.

다음 명령어를 실행하여 OpenSSH 및 ‘WWW Full‘ 프로필을 UFW에 추가하십시오.

OpenSSH 프로필은 기본 SSH 포트 22를 열고, ‘WWW Full’ 프로필은 HTTP 및 HTTPS 포트를 모두 엽니다.

sudo ufw allow OpenSSH  
sudo ufw allow 'WWW Full'

이제 다음 명령어를 실행하여 Debian 머신에서 UFW를 시작하고 활성화하십시오.

sudo ufw enable

확인을 요청받으면 y를 입력하고, ‘ Firewall is active and enabled on system startup ‘와 같은 출력이 표시되어야 합니다. UFW는 시스템 부팅 시 자동으로 실행됩니다.

setup ufw

마지막으로 다음 명령어를 실행하여 UFW 상태를 확인하십시오. OpenSSH 및 ‘WWW Full’ 프로필이 UFW 활성화 규칙에 나열되어 있는지 확인하십시오.

sudo ufw status

verify ufw

php.ini 구성

다음 섹션에서는 기본 php.ini 파일을 수정하여 PHP를 구성하고 DokuWiki 설치를 위한 일부 구성을 조정합니다.

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

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

기본 구성을 다음과 같이 변경하십시오. memory_limit 매개변수를 현재 서버 RAM에 맞게 조정하십시오.

memory_limit=256M  
upload_max_filesize=32M  
post_max_size=32M  
max_execution_time=60

작업이 완료되면 파일을 저장하고 닫으십시오.

이제 아래의 systemctl 명령어를 실행하여 apache2 서비스를 재시작하고 변경 사항을 적용하십시오.

sudo systemctl restart apache2

MariaDB 서버 구성

이제 PHP를 구성했으므로 다음 단계는 MariaDB 서버 설치를 구성하고 DokuWiki에서 사용할 새 데이터베이스와 사용자를 만드는 것입니다.

아래의 mariadb-secure-installation 명령어를 실행하여 MariaDB 구성 프로세스를 시작합니다.

sudo mariadb-secure-installation

MariaDB에 새 구성을 적용할 것인지 묻는 질문에 Y를 입력하십시오. 아니오를 선택하려면 n을 입력할 수 있습니다. 아래는 프롬프트에서 요청받는 MariaDB 구성 항목입니다:

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

MariaDB 구성이 완료되면 DokuWiki에서 사용할 새 데이터베이스와 사용자를 만들어야 합니다.

아래의 mariadb 명령어를 실행하여 MariaDB 서버에 로그인하십시오. 프롬프트에서 MariaDB 루트 비밀번호를 입력하십시오.

sudo mariadb -u root -p

이제 다음 쿼리를 실행하여 새 데이터베이스 dokuwikidb, 사용자 dokuwiki, 비밀번호 ‘p4ssword‘를 생성하십시오. 비밀번호를 새 비밀번호로 변경해야 합니다.

CREATE DATABASE dokuwikidb;  
CREATE USER dokuwiki@localhost IDENTIFIED BY 'p4ssword';  
GRANT ALL PRIVILEGES ON dokuwikidb.* TO dokuwiki@localhost;  
FLUSH PRIVILEGES;

create database user

다음으로, 데이터베이스 dokuwikidb에 대한 권한을 확인하기 위해 사용자 dokuwiki를 확인하십시오.

SHOW GRANTS FOR dokuwiki@localhost;

다음 출력에서 사용자 dokuwiki가 데이터베이스 dokuwikidb에 대한 모든 권한을 구성한 것을 확인할 수 있습니다.

show dtabase user

마지막으로 quit를 입력하여 MariaDB 서버에서 로그아웃하고 다음 단계로 이동하십시오.

DokuWiki 소스 코드 다운로드

이 섹션에서는 DokuWiki 소스 코드를 다운로드하고 설치 디렉토리를 적절한 권한으로 설정합니다.

/var/www/ 디렉토리로 이동하고 아래의 wget 명령어를 사용하여 DokuWiki의 최신 안정 버전을 다운로드합니다.

cd /var/www/  
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz

이제 dokuwiki-stable.tgz 파일을 추출하고 추출된 디렉토리의 이름을 dokuwiki로 변경합니다. 즉, DokuWiki 설치 디렉토리는 /var/www/dokuwiki에 위치하게 됩니다.

tar xzvf dokuwiki-stable.tgz  
sudo mv dokuwiki-*a dokuwiki

마지막으로 아래의 명령어를 실행하여 /var/www/dokuwiki 디렉토리의 소유권을 사용자 www-data 및 그룹 www-data로 변경합니다. 이렇게 하면 Apache2 웹 서버가 DokuWiki 소스 코드를 읽을 수 있습니다.

sudo chown -R www-data:www-data /var/www/dokuwiki

Apache2 가상 호스트 구성

DokuWiki를 다운로드한 후 이제 DokuWiki를 실행하기 위해 새로운 Apache2 가상 호스트 파일을 생성합니다. 시작하기 전에 도메인 이름이 준비되어 있는지 확인하십시오. 이 예제에서는 도메인 wiki.howtoforge.local을 사용합니다.

이제 아래의 nano 편집기 명령어를 실행하여 새로운 Apache2 가상 호스트 구성 파일 /etc/apache2/sites-available/dokuwiki.conf를 생성합니다.

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

다음 구성을 삽입하고 도메인 이름 wiki.howtoforge.local을 귀하의 도메인으로 변경하십시오.

  
    ServerName    wiki.howtoforge.local        
    DocumentRoot  /var/www/dokuwiki  
  
      
          
            AllowOverride All  
            Require all denied  
          
          
            Order allow,deny  
            Deny from all  
          
      
  
    ErrorLog   /var/log/apache2/wiki.howtoforge.local_error.log  
    CustomLog  /var/log/apache2/wiki.howtoforge.local_access.log combined

작업이 완료되면 파일을 저장하고 닫으십시오.

다음으로 아래의 명령어를 실행하여 dokuwiki.conf 가상 호스트를 활성화하고 Apache 구문을 확인하여 오류가 없는지 확인하십시오.

sudo a2ensite dokuwiki.conf  
sudo apachectl configtest

구문이 올바르고 오류가 없으면 ‘ Syntax OK ‘라는 출력이 표시됩니다.

setup apache2

마지막으로 아래의 명령어를 실행하여 Apache2 서버를 재시작하고 수정 사항을 적용하십시오.

sudo systemctl restart apache2

SSL/TLS 인증서로 DokuWiki 보호

이 시점에서 DokuWiki가 실행 중이며 접근 가능합니다. 그러나 설치가 안전하도록 Letsencrypt를 통해 SSL/TLS 인증서를 설정해야 합니다.

아래의 certbot 명령어를 실행하여 DokuWiki 도메인 이름에 대한 SSL/TLS 인증서를 생성하십시오. 이메일 주소와 도메인 이름을 귀하의 정보로 변경해야 합니다.

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

프로세스가 완료되면 DokuWiki 설치가 자동으로 HTTPS로 구성되어야 합니다. SSL/TLS 인증서는 /etc/letsencrypt/live/yourdomain.com 디렉토리에 있어야 합니다.

웹 설치 프로그램을 통한 DokuWiki 설치

웹 브라우저를 열고 DokuWiki 설치를 위해 도메인 이름을 방문하십시오. 예: https:/wiki.howtoforge.local/install.php. DokuWiki 웹 설치 프로그램이 표시되어야 합니다.

ACL 활성화 옵션을 선택하고 DokuWiki의 관리자 사용자, 이메일 및 비밀번호를 입력한 후 저장을 클릭하십시오.

install dokuwiki

설치가 성공적으로 완료되면 ‘ The configuration was finished successfully.‘라는 출력이 표시됩니다.

installation finished

이제 터미널로 돌아가 아래의 명령어를 사용하여 install.php 스크립트를 삭제하십시오.

sudo rm /var/www/dokuwiki/install.php

다음으로 ‘ your new DokuWiki ‘ 링크를 클릭하여 계속 진행하십시오. 그러면 다음과 같은 DokuWiki 홈페이지가 표시됩니다.

dokuwiki homepage

이제 로그인 버튼을 클릭하면 다음과 같은 DokuWiki 로그인 페이지가 표시됩니다.

관리자 사용자와 비밀번호를 입력한 후 로그인 버튼을 클릭하십시오. 성공하면 DokuWiki 대시보드가 표시됩니다.

dockuwiki dashboard

결론

축하합니다! 이제 Debian 12 서버에 DokuWiki 설치를 완료했습니다. LAMP 스택(Apache2, MariaDB 및 PHP)으로 DokuWiki를 설치했습니다. 또한 UFW(간단한 방화벽) 및 Letsencrypt의 SSL/TLS 인증서로 DokuWiki 설치를 보호했습니다.