Quay lại danh sách
DevOps & Hệ thống

Xây dựng hệ thống static site analytics privacy-first tracking từ host trên VPS với Umami và ClickHouse

Khám phá cách thiết lập một hệ thống phân tích trang web tĩnh (static site analytics) tập trung vào quyền riêng tư, hoàn toàn tự host trên VPS bằng Umami và ClickHouse. Hướng dẫn...

DPTCloud Engineering4 phút đọc
Xây dựng hệ thống static site analytics privacy-first tracking từ host trên VPS với Umami và ClickHouse

Khám phá cách thiết lập một hệ thống phân tích trang web tĩnh (static site analytics) tập trung vào quyền riêng tư, hoàn toàn tự host trên VPS bằng Umami và ClickHouse. Hướng dẫn này trình bày từng bước cấu hình, bảo mật, tối ưu hiệu năng và tích hợp dữ liệu để bạn có thể theo dõi hành vi người dùng mà không cần phần mềm theo dõi bên thứ ba, đảm bảo tuân thủ GDPR và các quy định về bảo vệ dữ liệu cá nhân. Hệ thống này phù hợp cho doanh nghiệp, cá nhân hoặc tổ chức cần kiểm soát hoàn toàn dữ liệu người dùng và muốn tránh sự phụ thuộc vào các nền tảng như Google Analytics.

Giới thiệu về hệ thống phân tích trang web tĩnh và quyền riêng tư

Trong bối cảnh ngày càng nhiều người dùng quan tâm đến quyền riêng tư, việc thay thế các công cụ theo dõi phổ biến như Google Analytics bằng các giải pháp tự host là lựa chọn hợp lý. Umami là một nền tảng phân tích trang web tĩnh mã nguồn mở, nhẹ, không theo dõi người dùng và không sử dụng cookie để thu thập dữ liệu. Khi kết hợp với ClickHouse – một hệ thống cơ sở dữ liệu thời gian thực hiệu suất cao – bạn có thể lưu trữ, truy vấn và phân tích dữ liệu người dùng một cách nhanh chóng và an toàn. Hệ thống này cho phép bạn tự kiểm soát toàn bộ dữ liệu, từ lưu trữ đến phân tích, mà không phải chia sẻ thông tin với bên thứ ba.

Yêu cầu và chuẩn bị môi trường VPS

Để triển khai hệ thống này, bạn cần một máy chủ VPS có hiệu năng tốt. Chúng tôi khuyến nghị sử dụng Cloud VPS NVMe cho Docker, Nginx & Database để đảm bảo tốc độ I/O cao và khả năng xử lý đồng thời tốt. Các yêu cầu cơ bản bao gồm:

  • OS: Ubuntu 22.04 LTS hoặc Debian 11
  • RAM: tối thiểu 4GB (8GB trở lên nếu có nhiều truy cập)
  • Storage: 20GB SSD trở lên
  • Đã cài đặt Docker và Docker Compose

Trước khi bắt đầu, hãy đảm bảo bạn đã tạo tài khoản trên VPS, thiết lập SSH key và cập nhật hệ thống. Bạn cũng có thể sử dụng High-Performance Dedicated Servers for Production Clusters nếu cần hiệu năng cao hơn cho quy mô lớn.

Cài đặt và cấu hình Umami

Umami là phần mềm phân tích trang web tĩnh được thiết kế đơn giản, nhẹ và tập trung vào quyền riêng tư. Bạn có thể triển khai Umami bằng Docker Compose. Tạo file `docker-compose.yml` với nội dung sau:

version: '3.8'
services:
  umami:
    image: umami/umami:latest
    container_name: umami
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=clickhouse://clickhouse:8123/umami
      - DATABASE_TYPE=clickhouse
      - PORT=3000
      - ADMIN_USER=admin
      - ADMIN_PASSWORD=your_secure_password
    volumes:
      - ./data:/app/data
    depends_on:
      - clickhouse
  clickhouse:
    image: clickhouse/clickhouse-server:latest
    container_name: clickhouse
    restart: unless-stopped
    ports:
      - "8123:8123"
      - "9000:9000"
    volumes:
      - ./clickhouse/data:/var/lib/clickhouse
    ulimits:
      nofile:
        soft: 262144
        hard: 262144

Chạy lệnh sau để khởi động các dịch vụ:

docker-compose up -d

Sau khi khởi động, truy cập `http://your-vps-ip:3000` để đăng nhập và thiết lập trang web đầu tiên. Umami sẽ tự động kết nối với ClickHouse thông qua URL `clickhouse://clickhouse:8123/umami`.

Tích hợp và tối ưu hiệu năng

Sau khi Umami và ClickHouse chạy ổn định, bạn có thể tích hợp mã theo dõi vào trang web tĩnh. Chèn đoạn script sau vào phần `` của mỗi trang:

<script async src="https://your-umami-domain.com/script.js" data-website-id="YOUR_WEBSITE_ID"></script>

Để tối ưu hiệu năng, bạn nên:

  • Đặt Nginx làm reverse proxy phía trước Umami để quản lý HTTPS và tải cân bằng.
  • Thiết lập lưu trữ dữ liệu ClickHouse với chính sách phân vùng theo ngày để tăng tốc truy vấn.
  • Áp dụng các biện pháp bảo mật như giới hạn IP, tường lửa và cập nhật thường xuyên.

Để kiểm tra dữ liệu, bạn có thể truy cập giao diện quản trị của Umami hoặc sử dụng CLI ClickHouse:

docker exec -it clickhouse clickhouse-client --query="SELECT count(*) FROM umami.visits"

Giải quyết sự cố và bảo trì

Một số vấn đề thường gặp bao gồm:

  • Không thể kết nối Umami với ClickHouse: Kiểm tra lại tên dịch vụ trong `docker-compose.yml` và đảm bảo ClickHouse đang chạy.
  • Dữ liệu không hiển thị: Kiểm tra xem script theo dõi đã được chèn đúng vào trang web và website ID có khớp.
  • Hiệu năng chậm: Tối ưu hóa cấu hình ClickHouse với phân vùng và chỉ mục phù hợp.

Để bảo trì hệ thống, hãy:

  • Thường xuyên sao lưu dữ liệu ClickHouse và Umami.
  • Cập nhật Docker, Umami và ClickHouse định kỳ.
  • Theo dõi nhật ký (logs) để phát hiện sự cố sớm.

Tài nguyên tham khảo

Để tìm hiểu sâu hơn về các công nghệ được sử dụng, bạn có thể tham khảo:

Hạ tầng DPTCloud Tier III

Cấu hình Cloud VPS NVMe khuyến nghị để triển khai

SSD NVMe Enterprise RAID 10, đường truyền CMC & FPT Quận 9 chống DDoS Anycast, Uptime SLA 99.99%.

Xem 22 gói Cloud VPS
ECO · vn-02

VPS-2E

94.600 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 2 vCPU
  • RAM: 2 GB
  • SSD: 30 GB NVMe
ECO · vn-02Khuyên dùng

VPS-3E

170.500 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 2 vCPU
  • RAM: 4 GB
  • SSD: 50 GB NVMe
BASIC · vn-01Khuyên dùng

VPS-05

457.600 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Bài viết liên quan

Xem tất cả
ZaloChat Zalo 24/7Discord0384 753 478