ウェブ分析 · 2 min read · Dec 17, 2025

Debian 9にMatomoウェブ分析をインストールする方法

Matomo（旧Piwik）は、国際的な開発者チームによって開発された無料でオープンソースのウェブ分析アプリケーションで、PHP/MySQLウェブサーバー上で動作します。これは、1つまたは複数のウェブサイトへのオンライン訪問を追跡し、これらの訪問に関するレポートを表示して分析します。Google Analyticsの代替品と考えることができます。Matomoはオープンソースで、そのコードはGithubで公開されています。いくつかの機能には、A/Bテスト、ヒートマップ、ファネル、トラッキングおよびレポーティングAPI、Google AdWords、Facebook広告、Bing広告、クリック単価（CPC）などがあります。このチュートリアルでは、Nginxをウェブサーバーとして使用して、Debian 9（stretch）システムにMatomoをインストールする方法を示し、Let’s Encrypt SSL証明書でウェブサイトを保護します。

要件

DebianシステムでMatomo（Piwik）を実行するには、いくつかのものが必要です：

  • ApacheまたはNginxなどのウェブサーバー。
  • pdoおよびpdo_mysqlまたはmysqli、gd、xml、curl、mbsting拡張機能を備えたPHPバージョン5.5.9以上。PHP 7+が推奨されます。
  • MySQLバージョン5.5以上、または同等のMariaDBバージョン。MySQL 5.7+が推奨されます。

前提条件

  • Debian 9（stretch）を実行しているオペレーティングシステム。
  • sudo権限を持つ非rootユーザー。

初期ステップ

Debianバージョンを確認します：

lsb_release -ds  
# Debian GNU/Linux 9.6 (stretch)

タイムゾーンを設定します：

dpkg-reconfigure tzdata

オペレーティングシステムのパッケージ（ソフトウェア）を更新します。これは重要な最初のステップであり、オペレーティングシステムのデフォルトソフトウェアパッケージに最新の更新とセキュリティ修正があることを確認します：

apt update && apt upgrade -y

Debianオペレーティングシステムの基本管理に必要な必須パッケージをいくつかインストールします：

apt install -y curl wget vim git unzip socat sudo

ステップ1 - MySQLをインストールし、Matomo用のデータベースを作成する

MatomoはMySQLおよびMariaDBデータベースをサポートしています。DebianチームはDebian 9（stretch）からデフォルトデータベースとしてMySQLをMariaDBに置き換えたため、このチュートリアルではMariaDBをデータベースサーバーとして使用します。元のMySQLをインストールしたい場合は、Oracleが管理する公式MySQLリポジトリを追加して使用できます。

MariaDBデータベースサーバーをインストールします：

sudo apt install -y mariadb-server

MariaDBのバージョンを確認します：

mysql --version  
# mysql  Ver 14.14 Distrib 5.7.24, for Linux (x86_64) using  EditLine wrapper

mysql_secure_installationスクリプトを実行してMariaDBのセキュリティを向上させ、MariaDBのrootユーザーのパスワードを設定します：

sudo mysql_secure_installation

各質問に答えます：

``Enter current password for root (enter for none): Press Enter  
Set root password? [Y/n] y  
New password: your_secure_password  
Re-enter new password: your_secure_password  
Remove anonymous users? [Y/n] Y  
Disallow root login remotely? [Y/n] Y  
Remove test database and access to it? [Y/n] Y  
Reload privilege tables now? [Y/n] Y``

rootユーザーとしてMariaDBシェルに接続します：

sudo mysql -u root -p  
# Enter password

空のMariaDBデータベースとMatomo用のユーザーを作成し、資格情報を覚えておきます：

mysql> CREATE DATABASE dbname;  
mysql> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';  
mysql> FLUSH PRIVILEGES;

MariaDBから退出します：

mysql> exit

dbname、username、およびpasswordを自分の名前に置き換えます。

ステップ2 - PHPと必要なPHP拡張機能をインストールする

PHPと必要なPHP拡張機能をインストールします：

sudo apt install -y php7.0 php7.0-cli php7.0-fpm php7.0-common php7.0-curl php7.0-gd php7.0-xml php7.0-mbstring php7.0-mysql

PHPのバージョンを確認します：

php --version  
  
# PHP 7.0.33-0+deb9u1 (cli) (built: Dec  7 2018 11:36:49) ( NTS )  
# Copyright (c) 1997-2017 The PHP Group  
# Zend Engine v3.0.0, Copyright (c) 1998-2017 Zend Technologies  
#     with Zend OPcache v7.0.33-0+deb9u1, Copyright (c) 1999-2017, by Zend Technologies

PHP-FPMサービスはDebian 9システムで自動的に開始され、再起動時に有効になりますので、手動で開始および有効にする必要はありません。次のステップに進むことができます。それは、Let’s Encrypt CAから無料のSSL証明書を取得することです。

ステップ3 - acme.shクライアントをインストールし、Let’s Encrypt証明書を取得する（オプション）

ウェブサイトをHTTPSで保護することは必須ではありませんが、サイトトラフィックを保護するための良いプラクティスです。Let’s EncryptからTLS証明書を取得するために、acme.shクライアントを使用します。Acme.shは、ゼロ依存関係でLet’s EncryptからTLS証明書を取得するための純粋なUnixシェルソフトウェアです。

acme.shをダウンロードしてインストールします：

sudo mkdir /etc/letsencrypt  
git clone https://github.com/Neilpang/acme.sh.git  
cd acme.sh  
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail [email protected]  
cd ~

acme.shのバージョンを確認します：

/etc/letsencrypt/acme.sh --version  
# v2.8.0

あなたのドメイン/ホスト名のためにRSAおよびECC/ECDSA証明書を取得します：

# RSA 2048  
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength 2048  
# ECDSA  
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength ec-256

上記のコマンドを実行した後、あなたの証明書とキーは以下にあります：

  • RSAの場合：/etc/letsencrypt/example.comディレクトリ。
  • ECC/ECDSAの場合：/etc/letsencrypt/example.com_eccディレクトリ。

ステップ3 - NGINXをインストールし、Matomo用にNGINXを構成する

Matomoは多くの人気のあるウェブサーバーソフトウェアで正常に動作します。このチュートリアルでは、Nginxを選択しました。

DebianリポジトリからNginxをダウンロードしてインストールします：

sudo apt install -y nginx

Nginxのバージョンを確認します：

sudo nginx -v  
# nginx version: nginx/1.10.3

Matomo用にNginxを構成するには、次のコマンドを実行します：

sudo vim /etc/nginx/sites-available/matomo.conf

次の構成でファイルを埋めます：

server {  
  
  listen [::]:443 ssl http2;  
  listen 443 ssl http2;  
  listen [::]:80;  
  listen 80;  
  
  server_name example.com;  
  root /var/www/matomo/;  
  index index.php;  
  
  ssl_certificate /etc/letsencrypt/example.com/fullchain.cer;   
  ssl_certificate_key /etc/letsencrypt/example.com/example.com.key;   
  ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.cer;  
  ssl_certificate_key /etc/letsencrypt/example.com_ecc/example.com.key;  
  
  location ~ ^/(index|matomo|piwik|js/index).php {  
    include snippets/fastcgi-php.conf;  
    fastcgi_param HTTP_PROXY "";   
    fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;   
  }    
  
  location = /plugins/HeatmapSessionRecording/configs.php {  
    include snippets/fastcgi-php.conf;  
    fastcgi_param HTTP_PROXY "";  
    fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;  
  }  
  
  location ~* ^.+\.php$ {  
    deny all;  
    return 403;  
  }  
  
  location / {  
    try_files $uri $uri/ =404;  
  }    
  
  location ~ /(config|tmp|core|lang) {  
    deny all;  
    return 403;  
  }  
  
  location ~ \.(gif|ico|jpg|png|svg|js|css|htm|html|mp3|mp4|wav|ogg|avi|ttf|eot|woff|woff2|json)$ {  
    allow all;  
  }  
  
  location ~ /(libs|vendor|plugins|misc/user) {  
    deny all;  
    return 403;  
  }  
  
}

注意：Matomo用の完全で本番環境に適したNginx構成については、https://github.com/matomo-org/matomo-nginxを訪問してください。

新しいmatomo.conf構成を有効にするには、ファイルをsites-enabledディレクトリにリンクします。

sudo ln -s /etc/nginx/sites-available/matomo.conf /etc/nginx/sites-enabled

Nginx構成に構文エラーがないか確認します：

sudo nginx -t

Nginxサービスを再読み込みします：

sudo systemctl reload nginx.service

ステップ4 - Matomo Analyticsをインストールする

/var/wwwディレクトリを作成します：

sudo mkdir -p /var/www

/var/wwwディレクトリに移動します：

cd /var/www/

wgetを使用して最新のMatomoリリースをダウンロードし、解凍します：

sudo wget https://builds.matomo.org/matomo.zip && sudo unzip matomo.zip

ダウンロードしたmatomo.zipファイルを削除します：

sudo rm matomo.zip

/var/www/matomoディレクトリの所有権をwww-dataユーザーに変更します：

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

ステップ5 - Matomo Analyticsのセットアップを完了する

ウェブブラウザでサイトを開き、Matomoのウェブインストールウィザードに従います。

最初に、Matomoのウェルカムメッセージが表示されます。「次へ」ボタンをクリックします：

Matomoインストールウィザード

次に、「システムチェック」ページが表示されます。何かが欠けている場合は警告が表示されます。すべてが緑のチェックマークで表示されている場合は、「次へ」ボタンをクリックして次のステップに進みます：

システムチェック

次に、データベースの詳細を入力し、「次へ」ボタンをクリックします：

データベース設定

データベース設定がうまくいった場合は、「テーブルが正常に作成されました！」というメッセージが表示されます：

データベーステーブルの作成

Matomoのスーパーユーザーアカウントを作成し、「次へ」ボタンをクリックします：

スーパーユーザーアカウントの作成

次に、Matomoで追跡および分析したい最初のウェブサイトを設定します。後で、Matomoで追跡するためにさらに多くのサイトを追加できます：

Matomoにウェブサイトを追加

次に、追跡を開始するためにサイトに追加する必要があるJavaScriptトラッキングコードが提供されます。

JavaScriptトラッキングコード

次に、Matomoのインストールが完了したことが表示されます。

Matomoインストール完了

おめでとうございます！あなたのMatomoインストールは完了しました。

リンク

Share: X/Twitter LinkedIn
#ウェブ分析

新しい投稿を受信箱で受け取る

スパムはありません。いつでも購読を解除できます。