Flarum 설치 · 6 min read · Oct 31, 2025

우분투 24.04에 Flarum 차세대 포럼 설치하기

Flarum은 PHP, JavaScript 및 TypeScript로 작성된 무료 오픈 소스 포럼 소프트웨어입니다. 이는 최소한의 디자인과 확장성을 갖춘 차세대 포럼 소프트웨어입니다. Flarum은 포럼 소프트웨어에 대한 현대적인 솔루션으로, 빠르고 간단하며 사용 및 설치가 용이합니다.

이 튜토리얼에서는 우분투 24.04에 Flarum을 설치하는 방법을 보여줍니다. LAMP 스택(Linux, Apache, MySQL/MariaDB 및 PHP)을 사용하여 Flarum을 설치한 후, Certbot 및 letsencrypt를 사용하여 HTTPS를 통해 보안 설정을 합니다.

전제 조건

이 튜토리얼을 따라 하려면 다음 요구 사항이 충족되어야 합니다:

  • 우분투 24.04 ‘Noble Numbat’.
  • 관리자 권한이 있는 비루트 사용자.
  • UFW(간단한 방화벽)가 실행 중.
  • 서버 IP 주소를 가리키는 도메인 이름.

의존성 설치

Flarum은 PHP로 작성된 오픈 소스 포럼 소프트웨어입니다. 이를 설치하려면 우분투 서버에 의존성을 설치해야 합니다. 여기에는 LAMP 스택(Linux, Apache, MySQL/MariaDB), Git 및 Composer가 포함됩니다.

이 섹션에서는 우분투 저장소를 통해 Flarum의 의존성을 설치합니다.

먼저, 아래 명령어를 실행하여 우분투 패키지 인덱스를 업데이트합니다.

sudo apt update

update repo

이제 다음 명령어를 실행하여 LAMP 스택(Linux, Apache, MySQL/MariaDB 및 PHP), Composer 및 Git과 같은 의존성을 우분투 시스템에 설치합니다.

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

설치를 확인하려면 Y를 입력합니다.

install dependencies

설치 후, 다음 명령어로 Apache 서비스 상태를 확인합니다. Apache 웹 서버가 활성화되어 있으며 상태가 ‘활성(실행 중)‘으로 표시됩니다.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

check apache2

이제 다음 명령어로 MariaDB 서버를 확인합니다. MariaDB가 활성화되고 실행 중인 유사한 출력을 볼 수 있습니다.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

check mariadb

마지막으로, 다음 명령어로 PHP 및 Composer 버전을 확인합니다. PHP 8.3 및 Composer 2.7.1이 우분투 시스템에 설치되어 있음을 확인할 수 있습니다.

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

check php composer

UFW(간단한 방화벽) 설정

의존성을 설치한 후, UFW(간단한 방화벽)를 통해 Apache 웹 서버에 대한 액세스를 허용해야 합니다. Apache 웹 서버는 HTTP 및 HTTPS 액세스를 모두 허용하는 UFW 애플리케이션 프로필 ‘Apache Full‘을 제공합니다.

아래 명령어를 실행하여 ‘ Apache Full ‘ 프로필을 통해 HTTP 및 HTTPS 액세스를 모두 열어줍니다. 추가되면 ‘ 규칙 추가됨 ‘이라는 출력을 볼 수 있습니다.

sudo ufw allow 'Apache Full'

이제 다음 명령어로 UFW의 규칙 목록을 확인합니다.

sudo ufw status

방화벽에서 ‘ Apache Full ‘ 프로필이 활성화되어 있어야 합니다. 이를 통해 Apache 웹 서버에 대한 HTTP 및 HTTPS 액세스가 허용됩니다.

setup ufw

PHP 구성

이 섹션에서는 ‘php.ini’ 파일을 편집하여 Flarum을 위한 PHP를 구성합니다. Flarum 설치를 위해 memory_limit 및 upload_max_filesize와 같은 일부 PHP 구성을 조정해야 합니다.

다음 nano 편집기 명령을 사용하여 기본 PHP 구성 ‘php.ini‘를 엽니다.

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

다음과 같이 기본 PHP 구성을 변경합니다. memory_limit 및 date.timezone 옵션의 값을 조정해야 합니다.

memory_limit = 512M  
upload_max_filesize = 150M  
max_execution_time = 600  
date.timezone = Europe/Paris

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

이제 아래 명령어를 실행하여 Apache 웹 서버를 재시작하고 새로운 PHP 구성을 적용합니다.

sudo systemctl restart apache2

MariaDB 서버 구성

PHP 구성이 완료된 후, MariaDB 서버를 보안 설정하고 Flarum에서 사용할 새 데이터베이스와 사용자를 생성합니다. ‘ mariadb-secure-installation ‘ 명령을 통해 MariaDB를 보안 설정한 후, ‘ mariadb ‘ 클라이언트를 통해 새 데이터베이스와 사용자를 생성할 수 있습니다.

MariaDB 서버를 보안 설정하려면 아래 ‘ mariadb-secure-installation ‘ 명령을 실행합니다. 이 과정에서 MariaDB의 일부 구성에 대한 질문을 받게 됩니다.

sudo mariadb-secure-installation

아래는 질문받을 구성입니다:

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

MariaDB 보안 설정이 완료되면 다음 명령어로 MariaDB 서버에 로그인합니다. 메시지가 표시되면 MariaDB 루트 비밀번호를 입력합니다.

sudo mariadb -u root -p

이제 다음 쿼리를 실행하여 Flarum을 위한 새 데이터베이스와 사용자를 생성합니다. 이 예에서는 새 데이터베이스 ‘flarum‘, 사용자 ‘flarum‘, 비밀번호 ‘password‘를 생성합니다. 이를 귀하의 정보로 대체할 수 있습니다.

CREATE DATABASE flarum;  
CREATE USER flarum@localhost IDENTIFIED BY 'password';  
GRANT ALL PRIVILEGES ON flarum.* TO flarum@localhost;  
FLUSH PRIVILEGES;

create database

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

SHOW GRANTS FOR flarum@localhost;

아래에서 사용자 ‘flarum‘이 데이터베이스 ‘flarum‘에 접근할 수 있음을 확인할 수 있습니다.

이제 quit을 입력하여 MariaDB 서버에서 종료합니다.

show privileges

Flarum 소스 코드 다운로드

모든 의존성이 구성되었으므로 Flarum 소스 코드를 다운로드할 준비가 되었습니다. 이 섹션에서는 Flarum을 위한 새 문서 루트 디렉토리를 생성한 후, Composer를 통해 Flarum 소스 코드를 다운로드합니다.

먼저, 아래 명령어를 실행하여 새 Flarum 설치 디렉토리 ‘/var/www/flarum/‘와 Composer를 위한 ‘/var/www/.cache‘ 및 ‘/var/www/.config‘ 디렉토리를 생성합니다. 그런 다음 이러한 디렉토리의 소유권을 사용자 ‘www-data‘로 변경합니다.

mkdir -p /var/www/{.cache,.config,flarum}  
chown -R www-data:www-data /var/www/{.cache,.config,flarum}

이제 ‘/var/www/flarum/‘ 디렉토리로 이동하여 아래 Composer 명령을 통해 Flarum 소스 코드를 다운로드합니다.

cd /var/www/flarum/  
sudo -u www-data composer create-project flarum/flarum .

아래에서 Flarum 소스 코드 다운로드 과정을 볼 수 있습니다.

downloading flarum

다운로드 과정이 완료되면 다음 ‘ ls ‘ 명령을 실행하여 Flarum 소스 코드를 확인합니다.

ls -ah

다운로드된 Flarum 소스 코드를 다음과 같이 확인할 수 있습니다:

Flarum을 위한 Apache 가상 호스트 설정

Flarum을 다운로드한 후, 새 Apache 가상 호스트를 생성해야 합니다. 따라서 Flarum 설치를 위한 도메인 이름을 준비했는지 확인하세요.

가상 호스트를 생성하기 전에 아래 명령어를 실행하여 Apache 모듈 ‘ssl‘, ‘rewrite‘, 및 ‘headers‘를 활성화합니다.

sudo a2enmod ssl rewrite headers

enable modules

이제 다음 nano 편집기 명령을 사용하여 새 가상 호스트 구성 ‘/etc/apache2/sites-available/flarum.conf‘를 생성합니다.

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

아래 구성을 삽입하고, ServerName 옵션을 귀하의 도메인 이름으로 변경하고, Flarum 설치를 위한 Document-Root 디렉토리의 경로를 변경해야 합니다.

  
 ServerAdmin [email protected]  
 DocumentRoot /var/www/flarum/public  
 ServerName forum.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]

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

다음으로, 아래 명령어를 실행하여 가상 호스트 파일 ‘flarum.conf’를 활성화하고 Apache 구문을 확인합니다.

sudo a2ensite flarum.conf  
sudo apachectl configtest

적절한 Apache 구성이 있을 경우 ‘ Syntax OK ‘라는 출력을 볼 수 있습니다.

setup vhost

마지막으로, 아래 명령어를 실행하여 Apache 웹 서버를 재시작하고 새로운 Flarum 가상 호스트 구성을 적용합니다. 이를 통해 Flarum에 접근할 수 있어야 합니다.

sudo systemctl restart apache2

HTTPS로 Flarum 보안 설정

공용 도메인에서 Flarum을 실행하는 경우, Certbot 및 Letsencrypt 인증서를 사용하여 HTTPS로 보안 설정할 수 있습니다. 로컬 도메인을 사용하는 경우, 자체 서명된 인증서를 사용할 수 있습니다.

아래 명령어로 Certbot 및 Certbot Apache 플러그인을 설치합니다. 설치를 확인하려면 Y를 입력합니다.

sudo apt install certbot python3-certbot-apache

이제 아래 ‘certbot’ 명령을 실행하여 Flarum 설치를 위한 SSL/TLS 인증서를 생성합니다. 도메인 이름 및 이메일 주소의 세부정보를 귀하의 정보로 변경해야 합니다.

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

프로세스가 완료되면 Flarum 설치가 HTTPS로 보안 설정되어야 합니다. SSL/TLS 인증서는 ‘/etc/letsencrypt/live/domain.com‘ 디렉토리에서 사용할 수 있어야 합니다.

Flarum 설치

웹 브라우저를 열고 https://forum.howtoforge.local/와 같은 도메인 이름을 방문합니다. 구성에 성공하면 Flarum 설치 마법사가 표시됩니다.

포럼 제목, MariaDB 데이터베이스의 세부정보, 사용자 및 비밀번호를 입력합니다. 그런 다음 새 Flarum 설치를 위한 관리자 사용자, 이메일 및 비밀번호를 입력합니다.

‘ Flarum 설치 ‘ 버튼을 클릭하여 설치를 계속합니다.

install flarum

설치가 완료되면 다음과 같은 Flarum 관리 대시보드가 표시됩니다:

flarum installed

이제 사용자 아이콘을 클릭하고 관리자를 선택합니다. 그러면 Flarum 설치의 세부정보가 표시됩니다.

아래에서 Flarum 1.8.5가 PHP 8.3 및 MariaDB 서버 10.11과 함께 설치된 것을 볼 수 있습니다.

admin dashboard flarum

결론

축하합니다! 이제 우분투 24.04에 Flarum 설치를 완료했습니다. LAMP 스택(Linux, Apache, MySQL/MariaDB 및 PHP)으로 Flarum이 실행되고 있으며, Certbot 및 Letsencrypt를 통해 HTTPS로 Flarum을 보안 설정했습니다.

Share: X/Twitter LinkedIn
#Flarum 설치

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.