웹사이트 검색

Ubuntu 22.04에 Matomo Web Analytics를 설치하는 방법

이 튜토리얼은 다음 OS 버전에 대해 존재합니다.

  • Ubuntu 22.04(Jammy Jellyfish)
  • Ubuntu 18.04(Bionic Beaver)

이 페이지에서

  1. 전제 조건
  2. MariaDB 서버 설치 및 구성
  3. Apache2 웹 서버 및 PHP 8 설치
  4. Matomo 소스 코드 다운로드
  5. 가상 호스트 Matomo 설정\n
  6. Certbot 및 Letsencrypt를 통해 SSL/TLS로 Matomo 보호\n
  7. Matomo Web Analytics 설치
  8. 결론

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

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

이 자습서에서는 Ubuntu 22.04 서버에서 Matomo를 사용하여 웹 분석을 설정하고 보호합니다. PHP 8.1, Apache2 웹 서버 및 MariaDB 데이터베이스와 함께 Matomo 웹 분석을 설치하고 Certbot 및 Letsencrypt를 통해 SSL/TLS 인증서로 배포를 보호합니다. 이 튜토리얼을 마치면 웹 사이트의 트래픽을 추적 및 모니터링할 수 있으며 자체 호스팅 Matomo 설치에 대한 세부 추적 결과를 얻을 수 있습니다.

전제 조건

다음은 이 자습서를 완료하는 데 필요한 요구 사항입니다.

  • Ubuntu 22.04 서버 - 이 예에서는 호스트 이름이 matomo-server인 Ubuntu 서버를 사용합니다.\n
  • sudo/root 관리자 권한이 있는 루트가 아닌 사용자.\n
  • 서버 IP 주소를 가리키는 도메인 이름 - 이 예에서는 analytics.hwdomain.io 하위 도메인을 사용합니다.\n

모든 요구 사항이 충족되면 이제 시작할 수 있습니다.

MariaDB 서버 설치 및 구성

Matomo는 MySQL 또는 MariaDB를 데이터베이스 백엔드로 사용한 오픈 소스 웹 분석입니다. 이 글을 작성할 당시 Matomo에는 최소한 MySQL Server v8 또는 MariaDB v10.x가 필요했습니다. 이 가이드에서는 MariaDB를 Matomo 웹 분석용 데이터베이스로 설치하고 사용합니다.

첫 번째 단계에서는 MariaDB 서버를 설치하고 MariaDB 배포를 설정하고 새 MariaDB 데이터베이스 및 사용자를 생성합니다.

시작하기 전에 아래 apt 명령을 실행하여 패키지 인덱스를 업데이트하고 새로 고칩니다.

sudo apt update

이제 아래의 apt 명령을 통해 MariaDB 서버를 설치하십시오. 메시지가 표시되면 y를 입력하고 Enter 키를 눌러 계속 진행합니다.

sudo apt install mariadb-server

MariaDB 서버가 설치된 후 아래 systemctl 명령 유틸리티를 실행하여 MariaDB 서버가 실행 중인지 확인합니다.

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

다음과 유사한 출력이 표시되어야 합니다. MariaDB 서버는 기본적으로 활성화되어 실행 중입니다. 또한 MariaDB 서버는 부팅 시 자동으로 시작됩니다.

다음으로 MariaDB 서버 패키지에서 제공하는 mariadb-secure-installation 명령을 통해 MariaDB 서버 배포를 보호합니다.

아래 명령을 실행하여 MariaDB 서버 배포를 보호하십시오.

sudo mariadb-secure-installation

이제 다음 MariaDB 구성에 대한 질문이 표시됩니다.

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

이제 MariaDB 서버 배포를 보호해야 하며 MariaDB 루트 사용자의 암호를 추가했습니다.

다음으로 MariaDB 셸을 통해 Matomo 설치를 위한 새 MariaDB 데이터베이스 및 사용자를 생성합니다.

아래 mariadb 명령을 실행하여 MariaDB 루트 사용자를 통해 MariaDB 셸에 로그인합니다. 비밀번호를 묻는 메시지가 표시되면 MariaDB 루트 비밀번호를 입력합니다.

sudo mariadb -u root -p

이제 다음 쿼리를 실행하여 새 MariaDB 데이터베이스 및 사용자를 생성합니다. 이 예에서는 Matomo 설치를 위한 데이터베이스 및 사용자 matomo를 생성합니다. 또한 다음 쿼리에서 기본 비밀번호를 바꿔야 합니다.

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

다음으로 아래 쿼리를 실행하여 [email 사용자의 권한 목록을 확인합니다.

SHOW GRANTS FOR 'matomo'@'localhost';
quit

다음과 유사한 출력이 표시되어야 합니다. MariaDB 사용자[email 는 matomo 데이터베이스에 액세스할 수 있는 모든 권한이 있습니다.

이 섹션에서는 MariaDB 서버를 설치하고 mariadb-secure-installation 명령을 통해 MariaDB 배포를 보호했으며 Matomo에 대한 새 데이터베이스와 사용자를 만들었습니다. 다음으로 Apache2 웹 서버와 PHP 8.x를 설치합니다.

Apache2 웹 서버 및 PHP 8 설치

Matomo는 PHP로 작성된 오픈 소스 웹 분석입니다. 설치를 위해 최신 버전의 Matomo는 PHP 8.x에서 완벽하게 지원됩니다. 또한 Matomo는 Apache2 및 Nginx 웹 서버와 함께 실행할 수 있습니다.

이 단계에서는 이제 Apache2 웹 서버와 PHP 8.1을 설치하고 PHP 설치를 구성한 다음 Apache2 서비스와 PHP 버전을 확인합니다.

기본 Ubuntu 리포지토리는 Apache2 및 PHP 패키지를 모두 제공합니다. Ubuntu 22.04 리포지토리는 최신 PHP 버전 PHP8.1을 제공하며 Matomo 설치를 완벽하게 지원합니다.

아래 apt 명령을 실행하여 Apache2 및 PHP 8.1 패키지를 설치합니다.

sudo apt install apache2 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를 입력하여 확인하고 ENTER를 눌러 계속 진행합니다.

Apache2 및 PHP가 설치된 후 아래 systemctl 명령 유틸리티를 실행하여 Apache2 서비스를 확인하고 서비스가 실행 중인지 확인합니다.

sudo systemctl is-enabled apache2
sudo systemctl status apache2

다음과 같은 출력이 표시됩니다. Apache2 서비스가 활성화되고 부팅 시 자동으로 실행됩니다. 그리고 Apache2 서비스의 상태가 실행 중입니다.

다음으로 아래 nano 편집기 명령을 통해 Apache2용 php.ini 파일을 엽니다.

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

다음 줄을 사용하여 기본 php.ini 구성을 변경합니다. 현재 환경에서 date.timezone 및 memory_limit 값을 조정하십시오.

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

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

이제 아래 systemctl 명령 유틸리티를 실행하여 Apache2 서비스를 다시 시작하고 변경 사항을 적용하십시오.

sudo systemctl restart apache2

이제 Apache2 웹 서버가 새 php.ini 구성 파일과 함께 실행 중이어야 합니다.

마지막으로 아래 php 명령을 실행하여 시스템에 설치된 PHP 버전을 확인하십시오. 그런 다음 활성화된 PHP 확장 목록을 확인합니다.

sudo php --version
sudo php -m

다음과 유사한 출력이 표시되어야 합니다. Ubuntu 시스템에 PHP 8.1이 설치되어 있습니다. 또한 Matomo에 필요한 PHP 확장이 활성화되어 있는지 확인하십시오.

이제 MariaDB 서버, Apache2 웹 서버 및 PHP 8.1을 포함하여 Matomo 웹 분석에 대한 종속성 설치를 완료했습니다.

다음 단계에서는 Matomo 소스 코드를 다운로드하고 PHP 및 Apache2가 Matomo 애플리케이션을 읽고 실행할 수 있도록 Matomo 설치 디렉토리에 대한 적절한 권한을 설정합니다.

Matomo 소스 코드 다운로드

이 단계에서는 Matomo 소스 코드를 다운로드하고 Matomo 설치 디렉토리에 대한 적절한 권한을 설정합니다.

현재 작업 디렉토리를 /var/www/로 변경하고 wget 명령을 통해 MAtomo 소스 코드를 다운로드합니다.

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

matomo 소스 코드를 다운로드한 후 아래의 unzip 명령을 통해 Matomo 소스를 추출합니다. 그리고 현재 작업 디렉토리에 새 디렉토리 matomo를 가져와야 합니다.

unzip matomo.zip

이를 통해 Matomo 설치 디렉토리는 /var/www/matomo여야 합니다.

아래 명령을 실행하여 Matomo 설치 디렉토리 /var/www/matomo의 소유권을 www-data 사용자 및 그룹으로 변경합니다.

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

Matomo 설치 디렉토리를 구성하고 Matomo 소스 코드를 다운로드한 후. 다음으로 Matomo 웹 분석을 실행하는 데 사용할 새 가상 호스트 구성을 만듭니다.

가상 호스트 Matomo 설정

시작하기 전에 서버 IP 주소를 가리키는 도메인 이름이 있는지 확인하십시오. 이 예에서는 Matomo 설치를 위해 하위 도메인 analytics.hwdomain.io를 사용합니다.

아래의 nano 편집기 명령을 사용하여 새 Apache2 가상 호스트 파일 /etc/apache2/sites-available/matomo.conf을 만듭니다.

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

파일에 다음 행을 추가하고 도메인 이름을 도메인으로 변경했는지 확인하십시오.

<VirtualHost *:80>
    ServerAdmin 
    ServerName analytics.hwdomain.io
    DocumentRoot /var/www/matomo/

    <Directory /var/www/matomo>
        DirectoryIndex index.php
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    <Files "console">
        Options None
        Require all denied
    </Files>

    <Directory /var/www/matomo/misc/user>
        Options None
        Require all granted
    </Directory>

    <Directory /var/www/matomo/misc>
        Options None
        Require all denied
    </Directory>

    <Directory /var/www/matomo/vendor>
        Options None
        Require all denied
    </Directory>

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

</VirtualHost>

완료되면 파일을 저장하고 편집기를 종료하십시오.

다음으로 아래 명령을 실행하여 새 가상 호스트 구성 matomo.conf을 활성화합니다. 그런 다음 Apache2 구성을 확인하여 올바른 구성에 오류가 없는지 확인하십시오.

sudo a2ensite matomo.conf
sudo apachectl configtest

적절한 Apache2 구성이 있으면 Syntax OK와 같은 출력을 받아야 합니다.

마지막으로 아래 systemctl 명령 유틸리티를 실행하여 Apache2 서비스를 다시 시작하고 변경 사항을 적용합니다.

sudo systemctl restart apache2

이로써 Matomo 웹 분석을 위한 Apache2 가상 호스트 구성이 완료되었습니다. 이는 이제 네트워크 외부에서 Maomo에 액세스할 수 있으며 웹 브라우저를 통해 액세스할 수 있음을 의미합니다. 그러나 이것은 여전히 안전하지 않은 HTTP 연결을 사용합니다.

다음 단계에서는 Certbot 및 Letsencrypt를 통해 SSL/TLS 인증서로 Matomo 웹 분석 설치를 보호합니다.

Certbot 및 Letsencrypt를 통해 SSL/TLS로 Matomo 보호

이 단계에서는 Apache2 웹 서버용 Certbot 도구 및 플러그인을 설치합니다. 그런 다음 Matomo 웹 분석을 위한 새 SSL/TLS 인증서를 생성합니다.

시작하기 전에 도메인 이름이 서버 IP 주소를 가리키는지 확인하십시오. 또한 Letsencrypt에 등록하는 데 사용할 이메일 주소가 필요합니다.

이제 아래 apt 명령을 실행하여 Apache2 웹 서버용 Certbot 도구 및 Certbot 플러그인을 설치합니다.

sudo apt install certbot python3-certbot-apache2

메시지가 표시되면 y를 입력하고 ENTER를 눌러 계속 진행합니다.

다음으로 아래 certbot 명령을 실행하여 도메인 이름에 대한 SSL/TLS 인증서를 생성합니다. 다음 명령에서 도메인 이름과 이메일 주소를 변경해야 합니다.

sudo certbot --apache2 --agree-tos --redirect --hsts --staple-ocsp --email  -d analytics.hwdomain.io

프로세스가 완료되면 Apache 웹 서버에서 보안 HTTPS가 활성화된 상태로 Mato 웹 분석이 실행됩니다. 또한 HTTP에서 HTTPS로 자동 리디렉션을 구성하고 OSCP 스테이플을 활성화했습니다.

Matomo 웹 애널리틱스 설치

웹 브라우저를 열고 matomo 설치의 도메인 이름(예: https://analytics.hwdomain.io)을 방문하십시오. 이제 아래 스크린샷과 같이 Matomo에 대한 환영 페이지가 표시되어야 합니다.

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

이제 Matomo 설치 프로그램이 설치를 위해 서버 환경을 확인합니다. 아래와 같이 모든 요구 사항 및 구성이 녹색으로 선택되었는지 확인합니다.

또한 주요 요구 사항이 Matomo 시스템 요구 사항을 충족하는지 확인해야 합니다.

계속하려면 다음을 클릭하십시오.

이제 Matomo 웹 분석을 위한 MariaDB 데이터베이스 세부 정보를 설정합니다. 올바른 데이터베이스 사용자 이름과 암호를 입력했는지 확인하십시오. 그런 다음 다음을 다시 클릭하십시오.

matomo 웹 설치 프로그램은 데이터베이스 세부 정보가 정확할 때 자동으로 테이블을 생성해야 합니다.

계속하려면 다음을 클릭하십시오.

다음으로 Matomo 웹 분석 설치를 위한 새 관리 사용자를 생성해야 합니다. Matomo 관리 사용자에 대해 강력한 암호를 사용해야 합니다. 그런 다음 다시 다음을 클릭합니다.

여기에서 웹사이트에 대한 첫 번째 추적을 설정합니다. 추적하려는 웹사이트의 도메인 이름에서 시간대를 선택한 후 다음을 클릭합니다.

이제 웹 사이트에 입력해야 하는 JavaScript 코드가 표시되어야 합니다. 계속하려면 다음을 다시 클릭하십시오.

이제 Matomo 설치를 완료했다는 축하 메시지가 표시됩니다. 페이지 하단에 있는 CONTINUE TO MATOMO 버튼을 클릭하십시오.

이제 Matomo 관리 로그인 페이지에 대한 보안 HTTPS 연결로 리디렉션됩니다. Matomo 사용자 이름과 암호를 입력한 다음 SIGN IN을 클릭하십시오.

올바른 관리자 사용자 및 암호가 있는 경우 Matomo 웹 분석 웹 관리를 받아야 합니다.

이제 오른쪽 상단의 모든 웹사이트 메뉴를 클릭하여 활성 추적 웹사이트 목록을 가져옵니다. Matomo 설치 중에 생성한 첫 번째 웹사이트 추적이 표시되어야 합니다.

이제 Matomo Web Analytics 설치가 완료되었습니다. 더 많은 웹사이트를 추가하고 자체 호스팅 Matomo 웹 분석을 통해 추적을 시작합니다.

결론

이 기사에서는 Ubuntu 22.04 서버에 MariaDB 데이터베이스 서버, Apache2 웹 서버 및 PHP 8.1과 함께 Matomo 오픈 소스 웹 분석을 설치했습니다. 또한 Certbot 및 Letsencrypt를 통해 생성된 SSL/TLS 인증서로 Matomo를 보호했습니다.

기본 Matomo 웹 분석이 설치되었으므로 이제 Matomo를 WordPress, TYPO3, Joomla, Drupal 등과 같은 CMS(콘텐츠 관리 시스템)와 통합할 수 있습니다. 또한 Magento, Prestashop과 같은 전자 상거래 애플리케이션과 통합할 수 있습니다. , Woocomeerce 및 OpenCart.