웹 분석 · 5 min read · Oct 10, 2025

Debian 12에 Matomo 웹 분석 설치하는 방법

Matomo, 이전의 Piwik,은 웹사이트 방문을 추적하고 데이터 및 청중 분석을 위한 보고서를 표시하는 데 사용할 수 있는 무료 오픈 소스 웹 분석 소프트웨어입니다. Matomo는 GPL 라이센스 하에 배포되며, PHP로 작성되었고 MySQL 또는 MariaDB 데이터베이스 서버에서 실행될 수 있습니다.

Matomo는 웹사이트에서 사용자 추적을 위한 통찰력 있는 보고서를 제공합니다. 여기에는 리퍼러 검색 엔진 및 키워드, 언어, 페이지 방문, 파일 방문자의 다운로드 등이 포함됩니다. Matomo는 Google Analytics와 같은 분석 서비스의 대안으로 점점 더 인기를 얻고 있습니다.

이 튜토리얼에서는 Debian 12 서버에 Matomo 웹 분석을 설치하는 방법을 배웁니다. LAMP 스택으로 Matomo를 설정하고 Certbot과 Letsencrypt를 통해 HTTPS로 Matomo를 보호합니다.

전제 조건

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

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

종속성 설치

Matomo는 MySQL/MariaDB를 데이터베이스로 사용하는 PHP 기반 웹 분석입니다. Matomo를 설치하려면 시스템에 LAMP(리눅스, 아파치, MySQL/MariaDB 및 PHP) 또는 LEMP(리눅스, Nginx, MySQL/MariaDB 및 PHP-FPM) 스택을 설치해야 합니다. 이 예제에서는 Debian 서버에서 LAMP 스택으로 Matomo를 실행합니다.

먼저, 아래의 apt 명령을 실행하여 Debian 패키지 인덱스를 업데이트합니다.

sudo apt update

이제 다음 명령으로 LAMP 스택(리눅스, 아파치, MySQL/MariaDB 및 PHP) 패키지를 설치합니다:

sudo apt install apache2 mariadb-server php php-cli libapache2-mod-php php-common php-curl php-gd php-mbstring php-mysql php-xml php-intl php-zip wget unzip

설치를 확인하려면 Y를 입력하십시오.

install deps

설치가 완료되면 아래 명령으로 MariaDB 서버 상태를 확인하십시오. MariaDB 서버가 활성(실행 중) 및 활성화된 상태로 표시됩니다.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

check mariadb

이제 다음 명령으로 Apache 서비스 상태를 확인하십시오. 다음 출력에서 Apache 웹 서버가 실행 중인 것을 볼 수 있습니다.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

check apache

마지막으로, 아래의 php 명령을 실행하여 PHP 버전을 확인하십시오. PHP 8.3이 설치되어 있는 것을 볼 수 있습니다.

php -v

check php

PHP 구성

LAMP 스택을 설치한 후, php.ini 파일을 편집하여 PHP 설치를 구성하고 Apache 웹 서버를 재시작합니다.

다음 nano 편집기로 기본 PHP 구성 파일 /etc/php/8.3/apache2/php.ini를 엽니다.

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

기본 구성을 다음과 같이 변경하십시오 - 현재 서버 환경에 맞게 date.timezone 및 memory_limit 옵션을 변경해야 합니다.

date.timezone = Europe/Stockholm  
memory_limit = 256M  
upload_max_filesize = 16M  
max_execution_time = 300

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

이제 아래의 systemctl 명령을 실행하여 Apache 웹 서버를 재시작하고 PHP에 대한 변경 사항을 적용합니다.

sudo systemctl restart apache2

MariaDB 서버 구성

이 섹션에서는 MariaDB 서버를 보호하고 루트 비밀번호를 설정합니다. 그런 다음 Matomo에서 사용할 새 데이터베이스와 사용자를 생성합니다.

아래의 mariadb-secure-installation 명령을 실행하여 MariaDB를 보호하고 루트 비밀번호를 설정합니다.

sudo mariadb-secure-installation

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

  • 로컬 인증을 unix_socket으로 전환하시겠습니까? n을 입력하십시오.
  • 새로운 MariaDB 루트 비밀번호를 설정하십시오. y를 입력하여 확인한 후, MariaDB 서버 배포를 위한 새 비밀번호를 입력하십시오.
  • 익명 사용자를 제거하시겠습니까? y를 입력하여 확인하십시오.
  • 배포에서 기본 데이터베이스 테스트를 제거하시겠습니까? y를 입력하여 확인하십시오.
  • 원격 연결에서 MariaDB 루트 로그인을 금지하시겠습니까? y를 입력하여 확인하십시오.
  • 테이블 권한을 다시 로드하고 변경 사항을 적용하시겠습니까? y를 입력하고 ENTER를 누르십시오.

다음으로, 아래의 mariadb 명령을 실행하여 MariaDB 서버에 로그인합니다. 요청 시 루트 비밀번호를 입력하십시오.

sudo mariadb -u root -p

이제 다음 쿼리를 실행하여 새 데이터베이스와 사용자 matomo를 비밀번호 p4ssword로 생성합니다. 아래 데이터베이스 세부정보를 조정하십시오.

CREATE DATABASE matomo;  
CREATE USER 'matomo'@'localhost' IDENTIFIED BY 'p4ssword';  
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, INDEX, DROP, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES ON matomo.* TO 'matomo'@'localhost';  
FLUSH PRIVILEGES;

마지막으로, 아래 쿼리를 실행하여 사용자 matomo@localhost를 확인하고 MariaDB 서버에서 종료합니다. 이는 사용자 matomo@localhost가 데이터베이스 matomo에 접근할 수 있도록 보장합니다.

SHOW GRANTS FOR matomo@localhost;  
quit

check db user

Matomo 소스 코드 다운로드

이제 PHP를 구성하고 데이터베이스와 사용자를 생성했으므로 Matomo를 설치할 수 있습니다. 이제 Matomo 소스 코드를 다운로드하고 문서 루트 디렉토리를 설정한 다음 적절한 Apache 사용자로 소유권을 변경합니다.

/var/www 디렉토리로 이동하여 아래의 wget 명령을 사용하여 Matomo 소스 코드를 다운로드합니다.

cd /var/www/  
wget https://builds.matomo.org/matomo.zip

다운로드가 완료되면 아래의 unzip 명령을 실행하여 matomo.zip 파일을 추출합니다. 그런 다음 /var/www/matomo 디렉토리의 소유권을 사용자 www-data로 변경합니다.

unzip matomo.zip  
sudo chown -R www-data:www-data /var/www/matomo

Apache 가상 호스트 설정

Matomo를 다운로드한 후, Matomo를 위한 새로운 Apache 가상 호스트 파일을 생성합니다. 따라서 도메인 이름이 서버 IP 주소를 가리키고 있는지 확인하십시오.

다음 nano 편집기로 새로운 Apache 가상 호스트 파일 /etc/apache2/sites-available/matomo.conf를 생성합니다.

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

아래 구성을 삽입하고 ServerName 옵션을 도메인 이름으로 바꾸는 것을 잊지 마십시오.


    ServerAdmin webmaster@localhost
    ServerName matomo.howtoforge.local
    DocumentRoot /var/www/matomo/

    
        DirectoryIndex index.php
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    

    
        Options None
        Require all denied
    

    
        Options None
        Require all granted
    

    
        Options None
        Require all denied
    

    
        Options None
        Require all denied
    

    ErrorLog ${APACHE_LOG_DIR}/matomo_error.log
    CustomLog ${APACHE_LOG_DIR}/matomo_access.log combined

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

이제 아래의 a2ensite 명령을 실행하여 matomo.conf 파일을 활성화합니다. 그런 다음 아래의 apachectl 명령을 실행하여 Apache 구성을 확인합니다. Apache 구문이 올바르면 Syntax is OK라는 출력을 볼 수 있습니다.

sudo a2ensite matomo.conf  
sudo apachectl configtest

마지막으로, 아래의 systemctl 명령을 실행하여 Apache 웹 서버를 재시작하고 변경 사항을 적용합니다. Apache가 재시작되면 Matomo 설치가 준비됩니다.

sudo systemctl restart apache2

setup apache

HTTPS로 Matomo 보호

이 섹션에서는 SSL/TLS 인증서를 생성하고 Certbot과 Letsencrypt를 통해 Matomo를 HTTPS로 보호합니다.

아래 명령으로 certbot 및 python3-certbot-apache 패키지를 설치합니다.

sudo apt install certbot python3-certbot-apache

이제 아래의 certbot 명령을 실행하여 SSL 인증서를 생성하고 Matomo 도메인 이름을 보호합니다. 도메인 이름과 이메일 주소를 귀하의 정보로 변경해야 합니다.

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

프로세스가 완료되면 SSL 인증서는 /etc/letsencrypt/live/donmain.com 디렉토리에 저장됩니다. 또한 Matomo 설치가 HTTPS로 보호됩니다.

Matomo 웹 분석 설치

웹 브라우저를 열고 https://matomo.howtoforge.local/와 같은 Matomo 도메인 이름을 방문하십시오. 설치가 성공하면 다음과 같은 환영 메시지가 표시됩니다:

다음을 클릭하여 설치를 확인하십시오.

welcome message

시스템 검사 섹션에서 시스템이 준비되었는지 확인하고 다시 다음을 클릭하십시오.

system check

이제 MariaDB 데이터베이스 이름, 사용자 및 비밀번호를 포함한 세부정보를 입력한 후 다음을 클릭하여 데이터베이스를 마이그레이션합니다.

setup database

마이그레이션이 완료되면 다시 다음을 클릭하십시오.

database migration

새로운 관리자 사용자 이름, 이메일 주소 및 Matomo 웹 분석 비밀번호를 입력하십시오.

setup admin

이제 Matomo로 첫 번째 추적을 생성하기 위한 정보를 입력하고 다음을 클릭하십시오.

create first tracking

생성된 추적 코드를 복사하고 다음을 클릭하십시오.

tracking code

설치가 완료되면 다음 메시지가 표시됩니다:

install complete

Matomo 홈페이지를 방문하면 Matomo 로그인 페이지로 리디렉션됩니다. 관리자 사용자와 비밀번호를 입력하고 로그인을 클릭하십시오.

logging in

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

dashboard

결론

축하합니다! Debian 12 서버에 Matomo 웹 분석 설치를 완료했습니다. Matomo 웹 분석은 Apache 웹 서버, MariaDB 데이터베이스 서버 및 PHP 8.3와 함께 실행되고 있습니다. 또한 Certbot과 Letsencrypt를 통해 Matomo를 HTTPS로 보호했습니다.

Share: X/Twitter LinkedIn
#웹 분석

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

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