Debian 12에 WonderCMS 설치하기

WonderCMS는 단순성과 사용 용이성을 위해 설계된 경량의 오픈 소스 콘텐츠 관리 시스템(CMS)입니다. 많은 다른 CMS 플랫폼이 광범위한 설정이나 많은 리소스를 요구하는 것과 달리, WonderCMS는 단일 평면 파일 데이터베이스에서 작동하므로 MySQL과 같은 전통적인 데이터베이스 시스템이 필요하지 않습니다. 이는 CMS 파일을 서버에 업로드하는 것 외에는 설치 및 관리가 매우 간단하다는 것을 의미합니다. 작은 크기에도 불구하고 WonderCMS는 콘텐츠 편집, SEO 옵션, 테마 사용자 정의 및 플러그인 지원과 같은 필수 기능을 제공하여 웹사이트를 구축하고 관리하기 위한 최소한의 간단한 솔루션을 원하는 사용자에게 적합한 옵션이 됩니다.

이 튜토리얼에서는 Apache 웹 서버와 PHP 8.x가 설치된 Debian 12 서버에 WonderCMS를 설치하는 방법을 보여줍니다.

필수 조건

시작하기 전에 다음 사항을 확인하세요:

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

의존성 설치

WonderCMS는 PHP로 작성된 오픈 소스 콘텐츠 관리 시스템입니다. 이는 평면 CMS로, MySQL/MariaDB와 같은 데이터베이스가 필요하지 않습니다. 텍스트 파일을 데이터베이스로 사용합니다.

이 가이드에서는 Apache 웹 서버와 PHP 8.2로 WonderCMS를 설치합니다.

패키지를 설치하기 전에 아래 명령어를 사용하여 Debian 저장소를 새로 고치고 업데이트하세요.

sudo apt update

업데이트가 완료되면 아래 명령어를 실행하여 WonderCMS의 의존성을 설치합니다. WonderCMS는 평면 CMS이므로 데이터베이스가 필요하지 않습니다. 따라서 Apache 웹 서버와 PHP 패키지만 설치합니다.

sudo apt install apache2 php php-common php-mbstring php-curl php-zip unzip

설치를 확인하려면 y를 입력하세요.

install deps

설치가 완료되면 아래 명령어로 Apache 서비스를 확인하세요. Apache는 기본적으로 실행되고 활성화되어 있어야 합니다.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

아래에서 Apache 서비스가 활성화되고 실행 중인 것을 확인할 수 있습니다.

verify apache

마지막으로 PHP 버전을 확인하고 아래 명령어로 확장을 활성화하세요.

php -m  
php -v

아래 출력에서 PHP 8.2가 설치된 것을 확인할 수 있습니다.

verify php

PHP 구성

의존성을 설치한 후, WonderCMS를 위해 PHP를 구성해야 합니다. Apache 웹 서버의 php.ini 구성을 수정하고, 시간대, 메모리 한도, 실행 시간 및 최대 업로드 파일 크기와 같은 기본 설정을 변경해야 합니다.

다음 nano 편집기 명령어를 사용하여 Apache 웹 서버의 php.ini 구성을 엽니다.

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

기본 PHP 구성을 다음과 같이 변경하세요 - 현재 서버 환경에 맞게 시간대와 memory_limit을 조정해야 합니다.

date.timezone = "Europe/Amsterdam"  
memory_limit = 512M  
  
upload_max_filesize = 128MB  
post_max_size = 128MB  
  
max_execution_time = 300  
max_input_vars = 5000

작업이 완료되면 파일을 저장하고 종료하세요.

이제 Apache 서비스를 재시작하여 PHP에 대한 수정을 적용하세요.

sudo systemctl restart apache2

방화벽 구성

이 가이드에서는 방화벽이 활성화된 상태에서 WonderCMS를 실행합니다. 이 예제에서는 UFW를 사용할 것입니다. 따라서 이제 UFW를 설치하고 SSH, HTTP 및 HTTPS 서비스에 대한 포트를 열어야 합니다.

다음 명령어를 사용하여 Debian 서버에 UFW를 설치하세요. y를 입력하여 설치를 확인하고 진행하세요.

sudo apt install ufw

install ufw

설치가 완료되면 OpenSSH 프로필을 활성화하여 포트 22를 열고, “WWW Full” 프로필을 활성화하여 HTTP 및 HTTPS 포트를 모두 엽니다.

sudo ufw allow OpenSSH  
sudo ufw allow "WWW Full"

이제 다음 명령어를 실행하여 UFW를 시작하고 활성화하세요. y를 입력하여 확인한 후, UFW가 실행되고 활성화되어야 합니다.

sudo ufw enable

setup ufw

마지막으로 아래 명령어를 사용하여 UFW 상태를 확인하세요. OpenSSH 및 “WWW Full” 프로필이 UFW에서 활성화되어 있습니다.

sudo ufw status

verify ufw

WonderCMS 소스 코드 다운로드

이 섹션에서는 WonderCMS 소스 코드를 다운로드하고 문서 루트 디렉토리를 적절한 권한과 소유권으로 구성합니다. 시작하기 전에 WonderCMS GitHub 페이지를 방문하여 최신 다운로드 링크를 가져오세요.

/var/www 디렉토리로 이동하여 아래 wget 명령어를 사용하여 WonderCMS 소스 코드를 다운로드하세요.

cd /var/www/  
wget https://github.com/WonderCMS/wondercms/releases/download/3.4.3/wondercms-343.zip

다운로드가 완료되면 unzip 명령어를 사용하여 WonderCMS 소스 코드를 /var/www/wondercms 디렉토리에 추출하세요.

unzip wondercms-343.zip -d /var/www/wondercms

마지막으로 /var/www/wondercms 디렉토리의 소유권을 www-data 사용자로 변경하세요. 이렇게 하면 Apache가 WonderCMS 문서 루트 디렉토리에 대한 읽기, 쓰기 및 실행 권한을 부여합니다.

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

Apache 가상 호스트 구성

이 예제에서는 Apache에서 WonderCMS를 실행하므로 이를 위한 가상 호스트 구성을 생성해야 합니다. 도메인 이름이 Debian 서버 IP 주소를 가리키고 있는지 확인하세요.

먼저 아래 명령어를 사용하여 Apache에서 rewrite 모듈을 활성화하세요. WonderCMS는 mod_rewrite가 활성화되어 있어야 합니다.

sudo a2enmod rewrite

활성화되면 nano 편집기 명령어를 사용하여 새로운 가상 호스트 구성 /etc/apache2/sites-available/wondercms.conf를 생성하세요.

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

다음 구성을 삽입하세요. 도메인 이름, 문서 루트 디렉토리의 경로 및 로그 파일을 귀하의 정보에 맞게 변경해야 합니다.

  
ServerName cms.howtoforge.local  
DirectoryIndex index.php  
DocumentRoot /var/www/wondercms  
Redirect /wondercms/loginURL /loginURL  
  
ErrorLog /var/log/apache2/cms.howtoforge.local-error.log  
CustomLog /var/log/apache2/cms.howtoforge.local-access.log combined  
  
  
Options FollowSymLinks  
AllowOverride All  
Require all granted

작업이 완료되면 파일을 저장하고 종료하세요.

다음으로 아래 명령어를 실행하여 wondercms.conf 가상 호스트 파일을 활성화하세요. 그런 다음 Apache를 확인하고 구문이 올바른지 확인하세요.

sudo a2ensite wondercms.conf  
sudo apachectl configtest

올바른 Apache 구문이 있는 경우 “Syntax OK”라는 출력이 표시되어야 합니다.

setup vhost

마지막으로 아래 명령어를 실행하여 Apache 서비스를 재시작하고 변경 사항을 적용하세요. 이렇게 하면 WonderCMS 설치가 준비됩니다.

sudo systemctl restart apache2

Letsencrypt로 WonderCMS 보안 설정

Apache 가상 호스트를 구성한 후 HTTPS로 WonderCMS 설치를 보호하세요. 이 경우 Certbot과 Letsencrypt를 사용할 것입니다.

로컬 도메인 이름이나 내부 네트워크에 대해 자체 서명된 인증서를 생성하여 WonderCMS 설치를 보호할 수 있습니다.

아래 명령어를 사용하여 Certbot과 Certbot Apache 플러그인을 설치하세요. 설치를 확인하려면 y를 입력하세요.

sudo apt install certbot python3-certbot-apache

설치가 완료되면 WonderCMS 도메인 이름에 대한 SSL 인증서를 생성하세요. 또한 도메인 이름과 이메일 주소를 귀하의 정보에 맞게 변경해야 합니다.

sudo certbot --apache --agree-tos --no-eff-email --redirect --hsts --staple-oscp --email [email protected] -d cms.howtoforge.local

프로세스가 완료되면 인증서는 /etc/letsencrypt/live/howtoforge.local 디렉토리에 있어야 합니다. WonderCMS 설치는 자동으로 HTTPS로 보호됩니다.

WonderCMS 설치 접근

웹 브라우저를 열고 WonderCMS 도메인 이름(예: https://howtoforge.local/)을 방문하세요. WonderCMS 홈페이지에서 생성된 비밀번호를 볼 수 있어야 합니다. 비밀번호를 복사하여 안전한 곳에 저장하세요.

index

결론

축하합니다! Debian 12 서버에 Apache 웹 서버와 PHP 8.2와 함께 WonderCMS를 성공적으로 설치했습니다. 또한 UFW와 Letsencrypt의 SSL 인증서로 WonderCMS를 보호했습니다.