CMS 설치 · 4 min read · Oct 20, 2025

Debian에서 Nginx로 Node 기반 Roadiz CMS 설치하기

Roadiz는 노드 시스템을 기반으로 한 무료 오픈 소스 콘텐츠 관리 시스템입니다. Roadiz를 사용하면 처음부터 자신의 데이터 스키마를 만들고 필요에 따라 콘텐츠를 구성할 수 있습니다. Roadiz는 디자이너와 개발자가 함께 강력한 경험을 구축할 수 있도록 특별히 설계되었습니다. Roadiz는 모든 이미지, 비디오 및 PDF를 저장하는 데 사용할 수 있는 중앙 집중식 문서 관리 인터페이스를 사용합니다. Roadiz는 하나의 콘텐츠 기반에 대해 여러 테마를 전환할 수 있습니다.

이 튜토리얼에서는 Debian 11 서버에 Roadiz를 설치하는 방법을 배웁니다.

요구 사항

  • Debian 11이 실행되는 서버.
  • 서버에 루트 비밀번호가 설정되어 있어야 합니다.

Nginx, PHP, MariaDB 설치

먼저, Nginx 웹 서버, MariaDB 데이터베이스 서버, PHP 및 기타 필요한 PHP 확장을 서버에 설치해야 합니다. 다음 명령어로 모두 설치할 수 있습니다:

apt-get install -y nginx mariadb-server php php-cli php-fpm php-common php-mysql php-mbstring php-gd php-intl php-xml php-curl php-zip php-pgsql php-sqlite3 php-opcache php-apcu curl unzip wget -y

필요한 패키지가 모두 설치되면 php.ini 파일을 열고 필요한 변경을 합니다:

nano /etc/php/7.4/fpm/php.ini

다음 줄을 변경합니다:

memory_limit = 128M 
post_max_size = 16M 
upload_max_filesize = 16M 
date.timezone = Asia/Kolkata

파일을 저장하고 닫습니다. 그런 다음, 다음 명령어로 Nginx 및 MariaDB 서비스를 시작하고 재부팅 후 시작하도록 활성화합니다:

systemctl start nginx  
systemctl enable nginx  
systemctl start mariadb  
systemctl enable mariadb

작업이 완료되면 다음 단계로 진행할 수 있습니다.

Roadiz용 데이터베이스 구성

다음으로, Roadiz를 위한 데이터베이스, 데이터베이스 사용자 및 비밀번호를 생성해야 합니다.

이를 위해 다음 명령어로 MariaDB 셸에 로그인합니다:

mysql -u roo -p

루트 비밀번호를 입력한 후 다음 명령어로 Roadiz용 데이터베이스와 사용자를 생성합니다:

MariaDB [(none)]> CREATE DATABASE roadizdb;  
MariaDB [(none)]> GRANT ALL ON roadizdb.* TO 'roadiz' IDENTIFIED BY 'password';

다음으로, 권한을 플러시하고 다음 명령어로 MariaDB 셸에서 종료합니다:

MariaDB [(none)]> FLUSH PRIVILEGES;  
MariaDB [(none)]> EXIT;

데이터베이스가 생성되면 다음 단계로 진행할 수 있습니다.

Roadiz 설치

먼저, Nginx 문서 루트 디렉토리에 Git 저장소에서 Roadiz의 최신 버전을 다운로드해야 합니다. 다음 명령어로 다운로드할 수 있습니다:

cd /var/www/html/  
git clone https://github.com/roadiz/roadiz.git

다운로드가 완료되면 roadiz 디렉토리로 변경하고 config.mysql.travis.yml 파일을 엽니다:

cd roadiz  
nano conf/config.mysql.travis.yml

데이터베이스에 따라 다음과 같이 변경합니다:

    driver: "pdo_mysql"
    host: "localhost"
    user: "roadiz"
    password: "password"
    dbname: "roadizdb"

작업이 완료되면 파일을 저장하고 닫습니다.

다음으로, index.php 파일을 열고 AllowedIP 섹션 아래에 IP 주소를 정의합니다:

nano install.php

다음과 같이 IP 주소를 추가합니다:

$allowedIp = [
    '10.0.2.2',     // vagrant host (forwarded)
    '192.168.33.1', // vagrant host (private)
    '127.0.0.1', 'fe80::1', '::1', ':ffff:127.0.0.1', '::ffff:127.0.0.1', 'YOUR-IP-ADDRESS'
];

파일을 저장하고 닫습니다. 그런 다음, 필요한 PHP 종속성을 설치하기 위해 Composer를 설치해야 합니다. 다음 명령어로 설치할 수 있습니다:

curl -sS https://getcomposer.org/installer -o composer-setup.php php composer-setup.php --install-dir=/usr/local/bin --filename=composer

다음과 같은 출력을 볼 수 있습니다:

All settings correct for using Composer
Downloading...

Composer (version 1.8.6) successfully installed to: /usr/local/bin/composer
Use it: php /usr/local/bin/composer

다음으로, 다음 명령어로 모든 필요한 PHP 종속성을 설치합니다:

composer install

다음으로, roadiz 디렉토리에 적절한 권한을 부여합니다:

chown -R www-data:www-data /var/www/html/roadiz  
chmod -R 755 /var/www/html/roadiz

Roadiz용 Nginx 구성

다음으로, Roadiz를 위한 Nginx 가상 호스트 파일을 생성합니다. /etc/nginx/sites-available/ 디렉토리에 roadiz.conf 파일을 생성하여 수행할 수 있습니다.

nano /etc/nginx/sites-available/roadiz.conf

다음 줄을 추가합니다:

server {
    listen 80;
    listen [::]:80;

    server_name example.com;             
    root /var/www/html/roadiz/;             

    index index.php;

    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ ^/(dev|install|preview|clear_cache)\.php(/|$) {
        fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
        fastcgi_split_path_info ^(.+\.php)(/.*)$;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        fastcgi_param DOCUMENT_ROOT $realpath_root;
    }

    location ~ ^/index\.php(/|$) {
        fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
        fastcgi_split_path_info ^(.+\.php)(/.*)$;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        fastcgi_param DOCUMENT_ROOT $realpath_root;
        internal;
     }
}

파일을 저장하고 닫습니다. 그런 다음, 다음 명령어로 가상 호스트 파일을 활성화합니다:

ln -s /etc/nginx/sites-available/roadiz.conf /etc/nginx/sites-enabled/

다음으로, 다음 명령어로 Nginx의 구문 오류를 테스트합니다:

nginx -t

마지막으로, 다음 명령어로 Nginx 및 PHP-FPM 서비스를 재시작하여 모든 구성 변경 사항을 적용합니다:

systemctl restart nginx  
systemctl restart php7.4-fpm

Roadiz 대시보드에 접근

이제 웹 브라우저를 열고 URL http://example.com/install.php를 입력합니다. 다음 페이지로 리디렉션됩니다:

Roadiz 설치

언어를 선택하고 Requirements를 클릭합니다. 다음 페이지가 표시됩니다:

Requirements

모든 필요한 확장이 설치되어 있는지 확인합니다. 그런 다음, Database 버튼을 클릭합니다. 다음 페이지가 표시됩니다:

Database settings

다음으로, 데이터베이스 세부정보를 제공하고 Build database 버튼을 클릭합니다. 다음 페이지가 표시됩니다:

Database installed

다음으로, Theme 버튼을 클릭합니다. 다음 페이지가 표시됩니다:

Site information

다음으로, 사이트 이름, 이메일 주소를 제공하고 Save informations 버튼을 클릭합니다. 다음 페이지가 표시됩니다:

Theme setup

다음으로, Perform theme install 버튼을 클릭합니다. 다음 페이지가 표시됩니다:

Import Theme content

다음으로, User 버튼을 클릭하여 관리자 사용자를 생성합니다. 다음 페이지가 표시됩니다:

Create admin user

다음으로, 관리자 사용자 세부정보를 제공하고 Create user 버튼을 클릭합니다. 다음 페이지가 표시됩니다:

user created

다음으로, Done 버튼을 클릭합니다. 다음 페이지가 표시됩니다:

Roadiz successfully installed

이제 Exit installation 버튼을 클릭합니다. 다음 페이지가 표시됩니다:

Success

이제 다음 명령어로 Roadiz 문서 루트 디렉토리에서 install.php를 제거합니다:

rm -rf /var/www/html/roadiz/install.php

다음으로, 웹 브라우저를 열고 URL http://example.com/rz-admin으로 관리자 인터페이스에 접근합니다. Roadiz 로그인 페이지로 리디렉션됩니다:

Login to Roadiz

로그인 세부정보를 제공하고 Log in 버튼을 클릭합니다. 다음 페이지에서 Roadiz 대시보드를 볼 수 있습니다:

Roadiz Dashboard

축하합니다! Debian 10 서버에 Roadiz를 성공적으로 설치했습니다. 질문이 있으면 언제든지 문의해 주세요.

Share: X/Twitter LinkedIn
#CMS 설치

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

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