Chuyển đến nội dung

umami-software / umami

Umami

Thống kê truy cập website gọn nhẹ, không cookie, thay thế Google Analytics và tự cài trên máy chủ của bạn

Umami là nền tảng phân tích website và sản phẩm mã nguồn mở, tập trung vào quyền riêng tư: không dùng cookie, dữ liệu nằm trong cơ sở dữ liệu của bạn. Bạn dán một đoạn mã nhỏ vào website, rồi xem số người truy cập, trang được xem nhiều, nguồn truy cập và chuyển đổi trên một bảng điều khiển sạch sẽ, dễ đọc.

  • 40.162 sao
  • 8.554 fork
  • TypeScript
  • Cập nhật hôm qua
  • MIT (dùng tự do, kể cả thương mại)
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Web tự cài (self-host)
Chạy trên
Docker, Node.js, Linux, Web
Chi phí
Miễn phí, có bản trả phí

Trải nghiệm khi dùng Umami

Bạn cài Umami bằng Docker Compose, đăng nhập lần đầu bằng tài khoản mặc định rồi bị yêu cầu đổi mật khẩu ngay. Trong giao diện, bạn thêm một website, nhận một đoạn mã theo dõi nhỏ và dán vào phần head của trang. Chỉ vài phút sau là thấy số lượt xem đầu tiên xuất hiện.

Màn hình thống kê gọn gàng: lượt xem, người truy cập, trang được đọc nhiều, nguồn đến từ Facebook hay Google, quốc gia, trình duyệt, thiết bị. Có thể lọc theo thời gian hoặc theo chiến dịch UTM, đủ cho chủ blog, chủ shop và nhóm marketing nhỏ nắm được tình hình mà không phải học một công cụ phức tạp.

Vì không dùng cookie theo giới thiệu của dự án, bạn thường không cần hiện biểu ngữ xin đồng ý cookie riêng cho phần thống kê. Tuy vậy việc tuân thủ luật bảo vệ dữ liệu còn tuỳ cách bạn cấu hình và thị trường bạn phục vụ, nên hãy kiểm tra thêm.

Tính năng nổi bật

Không cookie, hướng tới quyền riêng tư

Dự án mô tả đây là phân tích riêng tư, không dùng cookie, dữ liệu nằm trên máy chủ của bạn nếu bạn tự host.

Bảng điều khiển dễ hiểu

Nhìn nhanh được lượng truy cập, trang nổi bật, nguồn truy cập và hành vi khách mà không phải làm báo cáo nhiều bước.

Theo dõi sự kiện và mục tiêu

Đo lượt bấm nút, gửi form, mục tiêu chuyển đổi, phễu và hành trình người dùng khi bạn cần phân tích sâu hơn.

Nhiều website, nhiều thành viên

Một bản cài quản lý nhiều website, chia nhóm (team) và chia sẻ liên kết xem thống kê công khai khi cần.

Chọn tự host hoặc dùng bản Cloud

Có thể tự cài bằng Docker hoặc từ mã nguồn, hoặc dùng dịch vụ Cloud của Umami nếu không muốn quản máy chủ.

Tận dụng Umami vào việc gì?

Blogger, người làm nội dung

Thay Google Analytics cho blog cá nhân

Xem bài nào được đọc nhiều, người đọc đến từ đâu mà không gửi dữ liệu cho bên thứ ba.

Chủ shop online, marketer

Theo dõi chiến dịch quảng cáo cho shop

Gắn tham số UTM vào liên kết quảng cáo rồi xem kênh nào mang lại nhiều lượt truy cập và chuyển đổi nhất.

Freelancer, agency nhỏ

Thống kê cho website của nhiều khách hàng

Một bản cài Umami có thể theo dõi nhiều website, mỗi khách một bảng điều khiển hoặc liên kết xem riêng.

Lập trình viên, nhóm sản phẩm

Đo hành vi trong ứng dụng web

Gửi sự kiện tuỳ chỉnh từ ứng dụng để xem tính năng nào được dùng và người dùng bỏ ở bước nào.

Cần chuẩn bị gì?

  • Để cài bằng Docker Compose: một máy chủ có Docker (VPS hoặc máy tính chạy liên tục).
  • Để cài từ mã nguồn: Node.js 20.19 trở lên (khuyến nghị 22 LTS) và cơ sở dữ liệu PostgreSQL 12.14 trở lên.
  • Một tên miền hoặc địa chỉ mà website của bạn gọi tới để gửi dữ liệu thống kê, nên dùng HTTPS.
  • Quyền sửa phần head của website để chèn mã theo dõi.

Hướng dẫn cài đặt chi tiết

Cài trên Docker Compose

  1. Lấy mã nguồn về máy chủ, vì file Docker Compose của dự án nằm trong repo.

    Terminal
    git clone https://github.com/umami-software/umami.git
    cd umami
  2. Chạy Umami cùng cơ sở dữ liệu PostgreSQL theo cấu hình Docker Compose có sẵn. Tài liệu nói lệnh này chạy cả Umami lẫn PostgreSQL.

    Terminal
    docker compose up -d
  3. Mở http://localhost:3000 (hoặc địa chỉ máy chủ, cổng 3000) trên trình duyệt. Tài liệu nói mặc định ứng dụng nghe ở cổng 3000, đặt reverse proxy HTTPS phía trước khi chạy thật.

Cài trên Từ mã nguồn

  1. Cần Node.js 20.19 trở lên, pnpm và một cơ sở dữ liệu PostgreSQL có sẵn. Lấy mã và cài gói.

    Terminal
    git clone https://github.com/umami-software/umami.git
    cd umami
    pnpm install
  2. Tạo file .env, thay chuỗi kết nối bằng thông tin cơ sở dữ liệu thật và APP_SECRET bằng một chuỗi ngẫu nhiên (có thể sinh bằng lệnh openssl rand -hex 32).

    Cấu hình
    DATABASE_URL=postgresql://username:mypassword@localhost:5432/mydb
    APP_SECRET=random-string
  3. Build và chạy. Lần build đầu tiên sẽ tạo bảng trong cơ sở dữ liệu và tạo tài khoản admin mặc định.

    Terminal
    pnpm run build
    pnpm run start

Cài trên Image Docker

  1. Nếu muốn dùng image dựng sẵn, tải về từ địa chỉ chính thức. Bạn vẫn cần tự cấp cơ sở dữ liệu PostgreSQL và các biến môi trường theo tài liệu.

    Terminal
    docker pull docker.umami.is/umami-software/umami:latest

Dùng thử lần đầu

  1. Đăng nhập lần đầu với tên admin và mật khẩu umami theo tài liệu. Từ phiên bản 3.5.0 bạn bắt buộc phải đổi mật khẩu mặc định trước khi tiếp tục.

  2. Thêm một website mới trong giao diện quản trị, nhập tên và tên miền.

  3. Sao chép đoạn mã theo dõi Umami cung cấp và dán vào thẻ head của website cần đo.

  4. Mở website của bạn ở tab khác rồi quay lại Umami để thấy lượt truy cập đầu tiên xuất hiện.

  5. Thử thêm sự kiện cho một nút bấm quan trọng và thêm tham số UTM vào một liên kết quảng cáo để xem báo cáo theo chiến dịch.

Mẹo dùng hay

  • Cấu hình PostgreSQL dùng múi giờ UTC theo khuyến nghị của tài liệu để tránh lệch thời gian.
  • Đừng bỏ qua APP_SECRET: đây là khoá bảo vệ token xác thực, cần đặt giá trị ngẫu nhiên và giữ bí mật.
  • Trang tài liệu có mục loại trừ lượt truy cập của chính bạn để số liệu không bị lẫn.
  • Cập nhật bằng cách pull image mới hoặc pull mã nguồn, cài lại gói, build lại và khởi động lại dịch vụ.

Lưu ý và hạn chế

  • Tự host nghĩa là bạn phải giữ máy chủ và cơ sở dữ liệu an toàn, cập nhật thường xuyên và sao lưu dữ liệu thống kê.
  • Một số tiện ích chặn quảng cáo vẫn có thể chặn mã theo dõi của Umami; tài liệu có mục hướng dẫn cách giảm chuyện này, nên số liệu có thể thấp hơn thực tế.
  • Umami không phải công cụ quảng cáo, nên không có tích hợp sâu như hệ sinh thái Google Ads; nó phù hợp nhất khi bạn cần số liệu website gọn và riêng tư.

Câu hỏi thường gặp

Umami có miễn phí không?

Tự host thì miễn phí, mã nguồn mở giấy phép MIT, bạn chỉ trả tiền máy chủ. Umami cũng có dịch vụ Cloud; xem trang umami.is để biết chi tiết gói và giá hiện tại.

Có cần hiện thông báo cookie không?

Dự án mô tả Umami không dùng cookie, nên thường nhẹ nhàng hơn về mặt này. Tuy vậy quy định pháp lý khác nhau theo từng nơi, bạn nên tự kiểm tra hoặc hỏi người am hiểu.

Cài Umami có khó không?

Với người đã dùng Docker thì khá đơn giản nhờ Docker Compose có sẵn. Người chưa từng đụng tới máy chủ có thể cân nhắc dịch vụ Cloud của Umami.

Tải mã nguồn về máy

Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.

Terminal
git clone https://github.com/umami-software/umami.git

Repo tương tự nên xem

Tự host & máy chủ nhà94,4K

Uptime Kuma

louislam / uptime-kuma

Theo dõi website và dịch vụ còn sống hay chết, báo qua Telegram, Discord, email bằng giao diện đẹp

VừaDockerLinuxWindowsNode.js
Tự host & máy chủ nhà81,4K

Netdata

netdata / netdata

Giám sát máy chủ và hệ thống theo từng giây, cài xong là có bảng điều khiển ngay, gần như không cần cấu hình

VừaLinuxWindowsmacOSDocker
Tự host & máy chủ nhà79,1K

Caddy

caddyserver / caddy

Máy chủ web tự động bật HTTPS, cấu hình chỉ vài dòng, dùng làm reverse proxy cho website và ứng dụng tự cài

VừaWindowsmacOSLinuxDocker

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Tự host & máy chủ nhà

Tự host & máy chủ nhà338K

Awesome-Selfhosted

awesome-selfhosted / awesome-selfhosted

Danh mục khổng lồ các phần mềm mã nguồn mở tự cài trên máy chủ của riêng bạn

DễWeb
Tự host & máy chủ nhà115K

Supabase

supabase / supabase

Nền tảng backend trên Postgres: cơ sở dữ liệu, đăng nhập, lưu file và API tự sinh, thay thế Firebase

KhóDockerWebNode.jsLinux+2
Tự host & máy chủ nhà111K

frp

fatedier / frp

Đưa máy hoặc dịch vụ trong mạng nhà ra internet qua một máy chủ trung gian, không cần mở cổng router

KhóWindowsmacOSLinux
Tự host & máy chủ nhà92,3K

Home Assistant

home-assistant / core

Trung tâm nhà thông minh mã nguồn mở, điều khiển thiết bị ngay trong mạng nhà, ưu tiên riêng tư

VừaLinuxDockerWebWindows+3
Tự host & máy chủ nhà70,8K

Vaultwarden

dani-garcia / vaultwarden

Máy chủ quản lý mật khẩu nhẹ, tự cài ở nhà, dùng chung ứng dụng Bitwarden chính thức

VừaDockerLinuxWeb
Tự host & máy chủ nhà66,1K

Coolify

coollabsio / coolify

Bảng điều khiển tự cài để đưa website, cơ sở dữ liệu và ứng dụng lên máy chủ riêng, kiểu Vercel

VừaLinuxDockerWeb

Xem cả 16 repo Tự host & máy chủ nhà Về Kho Repo