우분투 24.04 서버에 PyroCMS 설치하는 방법

PyroCMS는 PHP 및 Laravel 웹 프레임워크를 기반으로 한 오픈 소스 CMS입니다. MySQL/MariaDB를 데이터베이스로 사용하는 강력한 콘텐츠 관리 시스템이며, 더 쉬운 관리를 위한 직관적이고 간단한 웹 관리 기능을 제공합니다.

이 튜토리얼에서는 LEMP 스택(리눅스, Nginx, MySQL/MariaDB 및 PHP-FPM)과 Composer를 사용하여 우분투 24.04에 PyroCMS를 설치하는 방법을 안내합니다.

전제 조건

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

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

의존성 설치

PyroCMS는 MySQL/MariaDB를 데이터베이스로 사용하는 Laravel 기반 콘텐츠 관리 시스템입니다. PyroCMS를 설치하기 전에 우분투 시스템에 LEMP 스택(리눅스, Nginx, MySQL/MariaDB 및 PHP-FPM)과 Composer를 설치합니다.

먼저, 다음 apt 명령을 실행하여 패키지 인덱스를 업데이트하고 LEMP 스택(리눅스, Nginx, MySQL/MariaDB 및 PHP-FPM)과 Composer를 설치합니다.

sudo apt update sudo apt install nginx mariadb-server composer php-cli php-fpm php-mysql php-curl php-sqlite3 php-mbstring php-gd php-xml

설치 확인을 위해 Y를 입력합니다.

install deps

설치 후, LEMP 스택 서비스가 실행 중인지 확인합니다.

아래의 systemctl 명령으로 Nginx 웹 서버를 확인합니다.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

이제 다음 명령으로 MariaDB 서버 상태를 확인합니다:

check nginx

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

check mariadbn

다음으로, PHP-FPM 서비스를 확인하기 위해 다음 명령을 실행합니다.

sudo systemctl is-enabled php8.3-fpm  
sudo systemctl status php8.3-fpm

check php-fpm

마지막으로, 아래 명령을 사용하여 Composer 버전을 확인합니다. Composer 2.4.7이 설치되어 있는 것을 볼 수 있습니다.

sudo -u www-data composer --version

PHP-FPM 구성

의존성 설치가 완료되면 php.ini 파일을 통해 기본 구성을 변경하고 PHP-FPM 서비스를 재시작하여 PHP-FPM을 구성합니다.

nano 편집기로 PHP-FPM의 php.ini 파일을 엽니다.

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

다음과 같이 기본 구성을 변경하고 date.timezone 및 memory_limit 옵션을 현재 환경에 맞게 조정합니다.

date.timezone = Europe/Amsterdam  
max_execution_time = 130  
memory_limit = 256M  
allow_url_fopen = On  
allow_url_include = Off  
post_max_size = 128M  
upload_max_filesize = 128M  
max_input_vars = 5000

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

이제 아래의 systemctl 명령을 실행하여 PHP-FPM 서비스를 재시작하고 php.ini에서 변경 사항을 적용합니다.

sudo systemctl restart php8.3-fpm

MariaDB 서버 구성

PHP-FPM 구성이 완료되면 MariaDB 서버 설치를 보안하고 PyroCMS를 위한 새로운 데이터베이스와 사용자를 생성합니다.

아래의 mariadb-secure-installation 명령으로 MariaDB 서버 설치를 보안합니다.

sudo mariadb-secure-installation

다음 구성에 대해 질문을 받게 됩니다:

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

MariaDB 구성이 완료되면 PyroCMS를 위한 새로운 데이터베이스와 사용자를 생성합니다.

아래의 mariadb 명령으로 MariaDB 서버에 로그인합니다. 프롬프트가 표시되면 루트 비밀번호를 입력합니다.

sudo mariadb -u root -p

이제 다음 쿼리를 실행하여 새로운 데이터베이스 pyrocmsdb, 새로운 사용자 pyrocms@localhost, 비밀번호는 passw0rd를 생성합니다. 필요에 따라 데이터베이스 이름, 사용자 이름 및 비밀번호를 변경합니다.

CREATE DATABASE pyrocmsdb;  
GRANT ALL PRIVILEGES ON pyrocmsdb.* TO pyrocms@localhost IDENTIFIED BY 'passw0rd';  
FLUSH PRIVILEGES;

create database and user

다음으로, 아래 쿼리를 실행하여 사용자 pyrocms@localhost의 권한을 확인합니다. pyrocms@localhost 사용자로 pyrocmsdb 데이터베이스에 접근할 수 있는 것을 볼 수 있습니다.

SHOW GRANTS FOR pyrocms@localhost;

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

show db privileges

PyroCMS 소스 코드 다운로드

Composer와 PyroCMS를 위한 새로운 디렉토리를 생성하고 /var/www/pyrocms로 이동한 후, 새로운 디렉토리의 소유권을 www-data 사용자로 변경합니다. 이 경우, /var/www/pyrocms는 PyroCMS의 문서 루트로 사용됩니다.

mkdir -p /var/www/{.config,.cache,pyrocms}; cd /var/www/pyrocms  
sudo chown -R www-data:www-data /var/www/{.config,.cache,pyrocms}

이제 아래의 composer 명령을 실행하여 PyroCMS 소스 코드를 다운로드하고 PHP 의존성을 설치 및 업데이트합니다.

sudo -u www-data composer create-project pyrocms/pyrocms .  
sudo -u www-data composer update

아래에서 composer 명령을 통해 PyroCMS 설치를 볼 수 있습니다:

download and install pyrocms dependencies

설치가 완료되면 다음 섹션으로 이동합니다.

Nginx 서버 블록 설정

이 섹션에서는 PyroCMS 설치를 위한 새로운 Nginx 서버 블록 구성을 생성합니다. 따라서 도메인 이름이 우분투 서버 IP 주소를 가리키고 있는지 확인하십시오. 이 예제에서는 도메인 이름으로 howtoforge.local을 사용합니다.

nano 편집기로 새로운 Nginx 서버 블록 /etc/nginx/sites-available/pyrocms.conf를 생성합니다.

sudo nano /etc/nginx/sites-available/pyrocms.conf

다음 구성을 복사하여 붙여넣고 server_name을 도메인 이름으로 변경합니다.

server {  
 listen 80;  
 server_name howtoforge.local;  
  
 index index.php index.html;  
 root /var/www/pyro/public;  
   
 location / {  
  try_files $uri $uri/ /index.php?$args;  
 }  
  
 location ~ \.php$ {  
  include fastcgi_params;  
  fastcgi_pass unix:/run/php/php-8.3-fpm.sock;  
  fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  
  fastcgi_index index.php;  
 }  
}

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

이제 아래 명령을 실행하여 pyrocms.conf 파일의 심볼릭 링크를 /etc/nginx/sites-enabled 디렉토리에 생성하고 Nginx 구문을 확인합니다.

sudo ln -s /etc/nginx/sites-available/pyrocms.conf /etc/nginx/sites-enabled/  
sudo nginx -t

올바른 Nginx 구문이 있는 경우 test is successful - syntax is ok라는 출력을 볼 수 있습니다.

setup nginx

마지막으로, 아래 systemctl 명령을 실행하여 Nginx 웹 서버를 재시작하고 변경 사항을 적용합니다.

sudo systemctl restart nginx

Letsencrypt를 통한 HTTPS로 PyroCMS 보안

PyroCMS를 보안하기 위해 Letsencrypt를 통해 HTTPS를 구현합니다. 이를 위해 SSL/TLS 인증서를 생성하고 PyroCMS 설치에 HTTPS를 자동으로 구현하기 위해 Certbot을 설치해야 합니다.

다음 명령으로 certbot 및 python3-certbot-nginx 패키지를 설치합니다. 설치 확인을 위해 Y를 입력합니다.

sudo apt install certbot python3-certbot-nginx

이제 아래 certbot 명령을 실행하여 SSL 인증서를 생성하고 PyroCMS를 HTTPS로 보안합니다.

sudo certbot --nginx --agree-tos --no-eff-email --redirect --hsts --staple-ocsp --email [email protected] -d howtoforge.local

프로세스가 완료되면 /etc/letsencrypt/live/domain.com 디렉토리에 인증서를 받게 되며, 이제 PyroCMS는 HTTPS로 보안됩니다.

웹 설치 프로그램을 사용하여 PyroCMS 설치

웹 브라우저를 열고 https://howtoforge.local/와 같은 도메인 이름을 방문합니다. 이제 PyroCMS 설치의 단일 페이지를 볼 수 있습니다:

PyroCMS 설치 라이센스를 수락하려면 I Agree를 선택합니다.
데이터베이스 이름, 사용자 및 비밀번호를 입력합니다.
PyroCMS의 새 관리자 사용자, 이메일 주소 및 비밀번호를 입력합니다.
도메인 이름, 언어 및 시간대와 같은 설치 세부정보를 입력합니다.
설치를 확인하려면 Install을 클릭합니다.

install pyrocms

설치가 완료되면 다음 페이지를 볼 수 있습니다:

install complete

View Site를 클릭하여 PyroCMS 홈페이지에 액세스합니다. 아래에서 PyroCMS의 기본 인덱스 페이지를 볼 수 있습니다.

homepage

Login을 클릭하여 PyroCMS의 로그인 화면에 액세스합니다. 관리자 사용자와 비밀번호를 입력한 후 Login을 클릭합니다.

성공하면 다음과 같은 PyroCMS 관리자 대시보드를 볼 수 있습니다:

dashboard

결론

축하합니다! 우분투 24.04 서버에 PyroCMS 설치를 완료했습니다. LEMP 스택(리눅스, Nginx, MySQL/MariaDB 및 PHP-FPM)으로 PyroCMS가 설치되었습니다. 또한 Composer로 PyroCMS를 다운로드하고 Certbot 및 Letsencrypt를 통해 PyroCMS를 HTTPS로 보안했습니다.