Ubuntu 24.04에 TYPO3 CMS 설치하는 방법

TYPO3는 무료이자 오픈 소스의 엔터프라이즈급 콘텐츠 관리 시스템입니다. 이는 다중 사이트 지원, 다국어 설치, 강력한 보안 구현, 빠른 속도와 같은 엔터프라이즈 수준의 기능을 제공합니다. 어디서나 실행할 수 있습니다.

TYPO3 CMS를 사용하면 유연하고 신뢰할 수 있는 웹사이트를 구축할 수 있습니다. TYPO3 CMS는 활기찬 전문 커뮤니티에 의해 지원됩니다. 설계상 TYPO3 CMS는 플러그인 가능한 콘텐츠 관리 시스템으로, 적응 가능하고 분리된 아키텍처를 가지고 있습니다.

이 가이드에서는 Ubuntu 24.04 서버에 TYPO3를 설치합니다. LAMP 스택(Linux, Apache, MySQL/MariaDB, PHP), Composer 및 GraphicsMagick을 사용하여 TYPO3를 설치합니다.

필수 조건

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

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

의존성 설치

TYPO3는 PHP로 작성된 오픈 소스 콘텐츠 관리 시스템이며 MySQL/MariaDB 및 PostgreSQL과 같은 데이터베이스를 지원합니다. 이 섹션에서는 TYPO3의 의존성을 설치합니다. 여기에는 LAMP 스택(Linux, Apache, MySQL/MariaDB, PHP), PHP 의존성 관리 도구인 Composer, 이미지 처리를 위한 GraphicsMagick이 포함됩니다.

시작하기 전에 아래 명령어로 Ubuntu 패키지 인덱스를 업데이트하세요.

sudo apt update

update repo

이제 아래의 ‘apt install’ 명령어를 사용하여 TYPO3 CMS의 패키지 의존성을 설치합니다. 이 명령어를 사용하면 LAMP 스택(Linux, Apache, MySQL/MariaDB, PHP), PHP 패키지 관리자 Composer, Git 및 자동 이미지 처리를 위한 GraphicsMagick과 같은 의존성을 설치합니다.

sudo apt install apache2 mariadb-server composer graphicsmagick php php-common php-mysql libapache2-mod-php php-gd php-curl php-json php-xmlrpc php-intl php-gmagick php-bcmath php-zip php-apcu php-mbstring php-fileinfo php-xml php-soap

설치를 진행하려면 Y를 입력하세요.

설치가 완료되면 Apache 및 MariaDB 서비스의 상태를 확인하고, PHP, Composer 및 GraphicsMagick 버전을 확인하세요.

아래 명령어로 Apache 서비스 상태를 확인하세요. Apache 서비스의 출력은 ‘ enabled ‘ 및 ‘active (running)’ 여야 합니다.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

check apache

다음으로 아래 명령어를 사용하여 MariaDB 서비스 상태를 확인하세요. 출력은 Apache와 유사해야 하며, MariaDB 서버가 ‘ enabled ‘ 및 ‘ active (running) ‘임을 확인할 수 있습니다.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

check mariadb

이제 아래 명령어를 실행하여 PHP 및 Composer 버전을 확인하세요. Ubuntu 24.04에서 기본 PHP 버전은 8.3이며, Composer는 2.7.1입니다.

php -v  
sudo -u www-data composer --version

check php and composer

마지막으로 아래 명령어를 사용하여 GraphicsMagick 버전을 확인하세요. Ubuntu 시스템에 GraphicsMagick 1.3이 설치되어 있어야 합니다.

gm version

check gm version

PHP 구성

TYPO3를 설치하려면 기본 PHP 구성 파일 ‘php.ini’를 변경해야 합니다. Apache 및 PHP CLI 모두에 대해 ‘php.ini’ 파일을 편집하고 TYPO3 설치를 위한 기본 구성을 변경해야 합니다.

다음 nano 편집기 명령어로 Apache 및 PHP CLI 모두에 대한 ‘php.ini’ 파일을 편집하세요.

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

다음과 같이 기본 구성을 변경하세요. ‘ memory_limit ‘ 및 ‘ date.timezone ‘ 옵션을 서버 환경에 맞게 조정하세요.

date.timezone = Europe/Amsterdam  
memory_limit = 512M  
max_execution_time = 240  
max_input_vars = 1500  
post_max_size = 50M  
upload_max_filesize = 50M

파일을 저장하고 종료하세요.

이제 아래 명령어를 실행하여 Apache 서비스를 재시작하고 PHP에서 변경 사항을 적용하세요.

sudo systemctl restart apache2

그 후, 아래 명령어를 실행하여 ‘ /var/www/html ‘ 디렉토리에 새로운 ‘info.php’ 파일을 생성하세요.

echo "" > /var/www/html/info.php

마지막으로 선호하는 웹 브라우저를 사용하여 http://192.168.5.30/info.php를 방문하세요. PHP 구성의 세부 정보를 확인할 수 있으며, ‘ php.ini ‘를 통해 구성한 모든 내용이 적용되었는지 확인하세요.

‘Core’ 섹션을 확인하여 ‘ memory_limit ‘, ‘ post_max_size ‘, ‘ max_execution_time ‘ 및 PHP 설치의 기타 항목을 확인하세요.

phpinfo

MariaDB 서버 구성

이제 PHP를 구성했으므로 MariaDB 서버를 보안하고 TYPO3를 위한 새로운 데이터베이스와 사용자를 생성해야 합니다. 이 섹션에서는 ‘ mariadb-secure-installation ‘ 유틸리티를 사용하여 MariaDB를 보안하고 명령줄에서 새로운 데이터베이스와 사용자를 생성합니다.

아래 명령어를 실행하여 MariaDB 서버 설치를 보안하세요.

sudo mariadb-secure-installation

이제 MariaDB 서버를 구성하라는 메시지가 표시됩니다. 기본 설정을 수락하려면 Y를 입력하거나 거부하려면 n을 입력하세요.

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

MariaDB 서버를 구성한 후, 아래 명령어로 MariaDB에 로그인하세요. 프롬프트가 표시되면 MariaDB 루트 비밀번호를 입력하세요.

sudo mariadb -u root -p

이제 아래 쿼리를 실행하여 새로운 데이터베이스 ‘typo3db’와 비밀번호 ‘Typo3Password’를 가진 새로운 사용자 ‘typo3’를 생성하세요. 필요한 경우 데이터베이스 정보를 변경하세요.

CREATE DATABASE typo3db;  
GRANT ALL PRIVILEGES ON typo3db.* to typo3@localhost IDENTIFIED BY 'Typo3Password';  
FLUSH PRIVILEGES;

다음으로 아래 쿼리를 실행하여 사용자 ‘ typo3 ‘의 권한을 확인하세요. 이는 사용자 ‘ typo3 ‘가 TYPO3 CMS 설치를 위해 데이터베이스 ‘ typo3db ‘에 접근할 수 있도록 보장합니다.

SHOW GRANTS FOR typo3@localhost;

아래 출력은 사용자 ‘ typo3 ‘가 데이터베이스 ‘ typo3db ‘에 접근할 수 있음을 보여줍니다.

마지막으로 quit를 입력하여 MariaDB 서버에서 로그아웃하세요.

check user

Composer를 통한 TYPO3 다운로드

TYPO3 소스 코드를 설치하고 다운로드하는 방법은 여러 가지가 있습니다. 이제 TYPO3 설치 디렉토리를 설정한 후 Composer를 사용하여 TYPO3를 다운로드합니다( PHP 의존성 관리).

먼저 아래 명령어를 실행하여 Composer 캐시 및 구성용 새로운 디렉토리와 TYPO3 설치 디렉토리 ‘ /var/www/typo3 ‘를 생성하세요.

sudo mkdir -p /var/www/{.cache,.config,typo3}

이제 위의 디렉토리 소유권을 사용자 ‘ www-data ‘로 변경하고 ‘/var/www/typo3 ‘ 디렉토리에 대한 읽기 및 쓰기 권한을 부여하는 아래 명령어를 실행하세요.

sudo chown -R www-data:www-data /var/www/{.cache,.config,typo3}  
sudo chmod u+rw /var/www/typo3

다음으로 ‘ /var/www/typo3 ‘ 디렉토리로 이동하여 아래 ‘ composer ‘ 명령어로 TYPO3 CMS를 설치하세요. 이 예제에서는 최신 버전의 TYPO3 CMS v12를 Ubuntu 서버에 설치합니다.

cd /var/www/typo3  
sudo -u www-data composer create-project typo3/cms-base-distribution:^12 .

아래에서 TYPO3 CMS 다운로드 및 설치 과정을 확인할 수 있습니다:

download composer

명령줄을 통한 TYPO3 설정

TYPO3 CMS 소스 코드를 다운로드한 후, 명령줄을 사용하여 TYPO3 설치를 구성합니다. 웹 브라우저를 사용하여 TYPO3 설치를 설정할 수도 있지만, 지금은 터미널에서 TYPO3 CMS 설치를 구성할 것입니다.

명령을 통해 TYPO3 CMS 설치를 구성하려면 다음을 실행하세요:

./vendor/bin/typo3 setup

다음과 같은 구성 프롬프트가 표시됩니다:

웹 서버로 apache를 입력하세요.
데이터베이스 드라이버로 mysqli를 입력하세요.
TYPO3 CMS에 사용할 MariaDB 사용자, 비밀번호, 포트 및 호스트의 세부 정보를 입력하세요.
데이터베이스 이름으로 typo3db를 입력하세요.
TYPO3 CMS의 관리자 사용자, 비밀번호 및 이메일 주소를 입력하세요. 비밀번호에는 최소한 하나의 특수 문자가 포함되어야 합니다.
프로젝트 이름은 기본값으로 두세요.
기본 사이트를 생성하라는 요청이 있을 때 ENTER를 누르세요.

설치가 성공하면 ‘ 축하합니다 - TYPO3 설정이 완료되었습니다 ‘라는 출력을 볼 수 있습니다.

마지막으로 아래 명령어를 다시 실행하여 ‘ /var/www/typo3 ‘ 디렉토리의 소유권을 사용자 ‘ www-data ‘로 변경하세요.

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

configure typo3 via terminal

Apache 가상 호스트 설정

이제 터미널에서 TYPO3를 구성했으므로 TYPO3 설치를 위한 Apache 가상 호스트를 설정하겠습니다. 도메인 이름을 준비했는지 확인하세요.

먼저 아래 명령어로 Apache ‘ rewrite ‘ 모듈을 활성화하세요.

sudo a2enmod rewrite

그런 다음 아래 nano 편집기 명령어를 사용하여 새로운 가상 호스트 파일 ‘ /etc/apache2/sites-available/typo3.conf ‘를 생성하세요.

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

다음 구성을 삽입하고 ServerName 옵션을 TYPO3 CMS 도메인 이름으로 변경하세요. 이 예제에서는 TYPO3 CMS가 도메인 ‘ howtoforge.local ‘에서 실행됩니다.

  
 ServerAdmin [email protected]  
 DocumentRoot /var/www/typo3/public  
 ServerName howtoforge.local  
  
   
 Options FollowSymlinks  
 AllowOverride All  
 Require all granted  
   
  
 ErrorLog ${APACHE_LOG_DIR}/error.log  
 CustomLog ${APACHE_LOG_DIR}/access.log combined  
   
   
 RewriteEngine on  
 RewriteBase /  
 RewriteCond %{REQUEST_FILENAME} !-f  
 RewriteRule ^(.*) index.php [PT,L]

이제 아래 명령어를 실행하여 ‘typo3.conf’ 가상 호스트 파일을 활성화하고 Apache 구문을 확인하세요. 올바른 Apache 구문이 있을 경우 출력에 ‘ Syntax OK ‘가 표시됩니다.

sudo a2ensite typo3.conf  
sudo apachectl configtest

마지막으로 아래 명령어로 Apache 서비스를 재시작하여 TYPO3 CMS 가상 호스트를 적용하세요. 실행하면 TYPO3 CMS 설치가 준비됩니다.

sudo systemctl restart apache2

setup apache

HTTPS로 TYPO3 CMS 보안 설정

이 섹션에서는 Certbot과 Letsencrypt를 사용하여 TYPO3 CMS를 HTTPS로 보안합니다. Certbot은 Letsencrypt에서 SSL/TLS 인증서를 생성하는 데 사용됩니다. 또한 Certbot Apache 플러그인을 사용하여 가상 호스트에서 자동 HTTPS를 설정합니다.

아래 명령어로 Certbot과 Certbot Apache 플러그인을 설치하세요. 설치를 진행하려면 Y를 입력하세요.

sudo apt install certbot python3-certbot-apache

설치 후, 아래 ‘certbot’ 명령어를 실행하여 TYPO3 CMS 도메인 이름에 대한 SSL/TLS 인증서를 생성하세요. 도메인 이름과 이메일 주소를 자신의 정보로 변경하세요.

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

프로세스가 완료되면 TYPO3 CMS가 자동으로 HTTPS로 보안됩니다. SSL/TLS 인증서는 ‘ /etc/letsencrypt/live/domain.com ‘ 디렉토리에 있습니다.

TYPO3 접근

선호하는 웹 브라우저를 사용하여 https://howtoforge.local/typo3의 TYPO3 CMS 로그인 페이지를 방문하세요. 설치가 성공하면 TYPO3 CMS 로그인 페이지가 표시됩니다.

관리자 사용자 및 비밀번호를 입력한 후 로그인을 클릭하여 확인하세요.

로그인 후, 다음과 같은 TYPO3 CMS 관리 대시보드를 볼 수 있습니다:

dashboard

상단 오른쪽 메뉴에서 정보 아이콘을 클릭하여 TYPO3 CMS 스택에 대한 세부 정보를 확인하세요. 아래와 같이 TYPO3 CMS 12.4가 Apache 2.4.58, MariaDB 서버 10.11, PHP 8.3 및 Composer 모드가 활성화된 상태로 설치되어 있습니다.

system info

결론

축하합니다! Ubuntu 24.04 서버에 TYPO3 CMS를 설치했습니다. LAMP 스택(Linux, Apache, MySQL/MariaDB, PHP), GraphicsMagick 이미지 처리 및 Composer 모드가 활성화된 TYPO3 CMS가 실행되고 있습니다. 또한 Certbot과 Letsencrypt를 사용하여 TYPO3 CMS를 HTTPS로 보안했습니다.