رفتن به محتوای اصلی
کرگدن | ارائه‌کننده سرورهای ابری و اختصاصی
راهنمای نصب و پیکربندی Matomo

راهنمای نصب و پیکربندی Matomo

Matomo یک ابزار متن‌باز و جایگزین Google Analytics است که تحلیل دقیق و خصوصی‌سازی‌شده‌ای از رفتار کاربران ارائه می‌دهد. در این راهنما، نصب کامل Matomo روی Ubuntu آموزش داده شده است؛ از نصب Apache، PHP، MySQL تا تنظیم Virtual Host و گواهی SSL.

۱. Matomo چیست و چرا از آن استفاده کنیم؟

Matomo یک نرم‌افزار متن‌باز و جایگزین Google Analytics است که به شما امکان می‌دهد بازدیدکنندگان وب‌سایت خود را تحلیل کنید و اطلاعات دقیقی از رفتار کاربران به دست آورید. برخلاف Google Analytics، داده‌های شما کاملاً در اختیار خودتان است و حریم خصوصی کاربران بهتر حفظ می‌شود.


۲. پیش‌نیازهای نصب Matomo

برای اجرای Matomo، سیستم شما باید دارای موارد زیر باشد:

وب‌سرور: یکی از این گزینه‌ها را داشته باشید:

  • Apache
  • Nginx
  • IIS
  • LiteSpeed

نسخه PHP مورد نیاز:

  • Matomo 4.x: حداقل PHP 7.2.5 یا نسخه‌های جدیدتر
  • Matomo 4.16 و Matomo 5: پیشنهاد می‌شود از PHP 8.x استفاده کنید (چون سریع‌تر و کم‌مصرف‌تر است)

پایگاه داده:

  • MySQL 5.5 یا جدیدتر (ترجیحاً MySQL 8+)
  • یا MariaDB

افزونه‌های PHP مورد نیاز:

  • pdo و pdo_mysql یا mysqli (پیش‌فرض فعال هستند)

 

سیستم‌عامل‌های سازگار: Matomo روی هر سیستم‌عاملی اجرا می‌شود، مانند:

  • لینوکس (Ubuntu, CentOS, Debian, Raspberry Pi OS و...)
  • ویندوز سرور
  • macOS Server
  • FreeBSD

نکته: اگر از وردپرس استفاده می‌کنید، نیازی به نصب دستی نیست! کافیست افزونه "Matomo Analytics" را نصب کنید.


۳. راه‌اندازی و نصب Matomo روی اوبونتو (Ubuntu 20.04/22.04)

مرحله ۱: به‌روزرسانی سیستم

ابتدا سیستم را آپدیت کنید تا از آخرین نسخه‌های بسته‌ها استفاده شود:

sudo apt update && sudo apt upgrade -y
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید

مرحله ۲: نصب وب‌سرور (Apache)

Apache را نصب کنید:

sudo apt install apache2 -y
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید

پس از نصب، سرویس Apache را فعال کنید:

2 خط
sudo systemctl enable apache2 
sudo systemctl start apache2
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید

مرحله ۳: نصب PHP و افزونه‌های مورد نیاز

برای اجرای Matomo، PHP و چند افزونه دیگر لازم است. این موارد را نصب کنید:

sudo apt install php php-curl php-gd php-cli php-mysql php-xml php-mbstring -y
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید

برای بررسی نسخه PHP:

php -v
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید

مرحله ۴: نصب MySQL و ایجاد پایگاه داده

نصب MySQL

برای مدیریت داده‌های Matomo، می بایست MySQL را نصب کنید:

sudo apt install mysql-server -y
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید

پس از نصب، سرویس MySQL را فعال کنید:

2 خط
sudo systemctl enable mysql 
sudo systemctl start mysql
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید

ایجاد پایگاه داده برای Matomo

وارد MySQL شوید:

2 خط
sudo mysql -u root -p
password
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید

دستورات زیر را وارد کنید (نام کاربری، پایگاه داده و رمز عبور را به دلخواه تغییر دهید):

5 خط
CREATE DATABASE matomo_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; 
CREATE USER 'matomo_user'@'localhost' IDENTIFIED BY 'password'; 
GRANT ALL PRIVILEGES ON matomo_db.* TO 'matomo_user'@'localhost'; 
FLUSH PRIVILEGES;
quit;
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید
 

۴. دانلود و نصب Matomo

🔹 مرحله ۱: دانلود فایل‌های Matomo

وارد مسیر /var/www/html شوید:

cd /var/www/html
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید

سپس، Matomo را دانلود کنید:

wget https://builds.matomo.org/matomo.zip
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید

🔹 مرحله ۲: استخراج فایل‌ها

پس از دانلود، فایل را استخراج کنید:

unzip matomo.zip
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید

🔹 مرحله ۳: تنظیم سطح دسترسی فایل‌ها

برای اجرای صحیح Matomo، دسترسی‌های لازم را تنظیم کنید:

2 خط
sudo chown -R www-data:www-data /var/www/html/matomo 
sudo chmod -R 755 /var/www/html/matomo
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید

۵. تنظیم وب‌سرور برای Matomo

🔹 تنظیم Virtual Host در Apache

یک فایل تنظیمات برای Matomo ایجاد کنید:

sudo nano /etc/apache2/sites-available/matomo.conf
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید
 

محتوای زیر را داخل فایل قرار دهید (به‌جای your-domain.com نام دامنه یا آی‌پی سرور را وارد کنید):

13 خط
<VirtualHost *:80>
    ServerName your-domain.com
    DocumentRoot /var/www/html/matomo

    <Directory /var/www/html/matomo>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/matomo_error.log
    CustomLog ${APACHE_LOG_DIR}/matomo_access.log combined
</VirtualHost>
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید
 

🔹 فعال‌سازی تنظیمات و راه‌اندازی مجدد Apache

2 خط
sudo a2ensite matomo.conf 
sudo systemctl restart apache2
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید

۶. نصب نهایی از طریق مرورگر

  1. مرورگر را باز کنید و به آدرس http://your-domain.com/matomo/ بروید.
  2. دستورالعمل‌های روی صفحه را دنبال کنید:
    • اطلاعات پایگاه داده را وارد کنید.
    • تنظیمات ادمین را مشخص کنید.
    • نصب را تکمیل کنید.

۷. نکات تکمیلی

بهینه‌سازی برای سایت‌های پرترافیک:
اگر ماهانه بیش از ۱ میلیون بازدید دارید:

  • از دو سرور جداگانه برای پایگاه داده و پردازش درخواست‌ها استفاده کنید.
  • از MySQL 8+ برای عملکرد بهتر بهره ببرید.

افزودن HTTPS برای امنیت بیشتر:
اگر از دامنه استفاده می‌کنید، بهتر است گواهی SSL رایگان با Let’s Encrypt نصب کنید:

2 خط
sudo apt install certbot python3-certbot-apache 
sudo certbot --apache -d your-domain.com
برای کپی کردن کد، روی دکمه کپی در بالا کلیک کنید