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...
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:
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%.
VPS-3E
Đã gồm VAT 10%
- CPU: 2 vCPU
- RAM: 4 GB
- SSD: 50 GB NVMe
