Chuyển đến nội dung

louislam / uptime-kuma

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

Uptime Kuma là công cụ tự cài để giám sát: cứ mỗi vài chục giây nó kiểm tra website, cổng, DNS hay container của bạn và báo ngay khi có sự cố. Giao diện web đẹp, gọn, có biểu đồ độ trễ, trang trạng thái công khai và hơn 90 kênh thông báo. Giống UptimeRobot nhưng dữ liệu nằm trên máy của bạn. Giấy phép MIT.

  • 94.425 sao
  • 8.845 fork
  • JavaScript
  • Cập nhật 2 ngày trước
  • 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, Linux, Windows, Node.js
Chi phí
Miễn phí hoàn toàn

Trải nghiệm khi dùng Uptime Kuma

Sau khi chạy lệnh Docker, bạn mở trình duyệt vào địa chỉ máy chủ ở cổng 3001, tạo tài khoản quản trị lần đầu rồi thêm monitor đầu tiên: dán địa chỉ website của shop, chọn kiểm tra mỗi bao lâu, vậy là xong. Danh sách monitor hiện màu xanh khi ổn và chuyển đỏ khi trang không trả lời.

Phần hay nhất là thông báo. Bạn chọn kênh như Telegram, Discord, Slack, Pushover hay email SMTP, hoặc một trong hơn 90 dịch vụ trong danh sách của dự án, rồi gắn vào monitor. Khi website sập lúc nửa đêm, điện thoại của bạn nhận tin và khi trang sống lại bạn cũng được báo.

Ngoài kiểm tra website bằng HTTP, nó còn kiểm tra từ khoá trên trang, cổng TCP, ping, bản ghi DNS, container Docker, và nhận tín hiệu push từ tác vụ định kỳ. Bạn còn dựng được trang trạng thái công khai để khách xem dịch vụ có đang hoạt động không.

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

Nhiều kiểu kiểm tra

HTTP(S), từ khoá, JSON query, TCP, ping, bản ghi DNS, WebSocket, container Docker, máy chủ game Steam và tín hiệu push.

Thông báo đa kênh

Telegram, Discord, Gotify, Slack, Pushover, email SMTP và hơn 90 dịch vụ khác.

Kiểm tra nhanh

Khoảng cách kiểm tra có thể xuống tới 20 giây.

Trang trạng thái

Tạo nhiều trang trạng thái công khai và gắn vào tên miền riêng của bạn.

Biểu đồ và thông tin chứng chỉ

Biểu đồ độ trễ ping và thông tin chứng chỉ SSL giúp bạn biết khi nào sắp hết hạn.

Bảo mật tài khoản

Có 2FA, hỗ trợ proxy, nhiều ngôn ngữ giao diện.

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

Chủ shop online, người làm web

Báo ngay khi website bán hàng sập

Theo dõi trang chủ và trang thanh toán, nhận tin báo trên điện thoại khi có sự cố.

Người quản trị website

Theo dõi hạn chứng chỉ SSL

Xem ngày hết hạn chứng chỉ để gia hạn kịp thời, không để trình duyệt cảnh báo khách.

Người chạy server nhà

Giám sát dịch vụ trong homelab

Kiểm tra các dịch vụ chạy ở nhà còn hoạt động, kể cả container Docker.

Agency, công ty phần mềm nhỏ

Trang trạng thái cho khách hàng

Đưa trang trạng thái công khai để khách tự xem hệ thống đang ổn hay đang bảo trì.

Cần chuẩn bị gì?

  • Docker (cách dễ nhất) hoặc Node.js từ 20.4 trở lên cùng Git và pm2 nếu chạy không dùng Docker.
  • Hệ điều hành: các bản Linux phổ biến hoặc Windows 10 (x64) trở lên; README ghi không hỗ trợ FreeBSD, OpenBSD, NetBSD.
  • Một máy chạy liên tục. Nếu monitor máy đó thì nên đặt ở nơi khác với dịch vụ cần giám sát.
  • Hệ thống tệp mạng như NFS không được hỗ trợ; dữ liệu nên đặt ở ổ cục bộ.

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

Cài trên Docker Compose

  1. Cài Docker rồi mở Terminal. Tạo thư mục, tải tệp compose chính thức và chạy.

    Terminal
    mkdir uptime-kuma
    cd uptime-kuma
    curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
    docker compose up -d
  2. Mở http://localhost:3001 (hoặc http://IP-máy-chủ:3001 nếu cài ở máy khác) và tạo tài khoản quản trị.

Cài trên Docker (một lệnh)

  1. Chạy một lệnh duy nhất. Dữ liệu lưu trong volume tên uptime-kuma.

    Terminal
    docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2
  2. Nếu chỉ muốn truy cập trên chính máy đó, đổi phần cổng thành 127.0.0.1:3001:3001 theo gợi ý của README.

    Văn bản
    -p 127.0.0.1:3001:3001

Cài trên Không dùng Docker

  1. Cần Node.js từ 20.4, Git và pm2. Tải mã nguồn rồi chạy lệnh setup.

    Terminal
    git clone https://github.com/louislam/uptime-kuma.git
    cd uptime-kuma
    npm run setup
  2. Cài pm2 và chạy nền bằng pm2 (cách README khuyến nghị).

    Terminal
    npm install pm2 -g && pm2 install pm2-logrotate
    pm2 start server/server.js --name uptime-kuma
  3. Muốn tự chạy khi khởi động máy thì thêm lệnh dưới.

    Terminal
    pm2 startup && pm2 save

Dùng thử lần đầu

  1. Mở trang quản trị, tạo tài khoản và đặt mật khẩu mạnh.

  2. Thêm monitor loại HTTP(S) cho website của bạn và đặt khoảng thời gian kiểm tra.

  3. Vào phần thông báo, thêm kênh bạn dùng nhất (ví dụ Telegram) và gửi thử một tin để chắc chắn nhận được.

  4. Tạm dừng thử một dịch vụ thử nghiệm, hoặc thêm monitor tới một địa chỉ không tồn tại, để xem cảnh báo gửi đi ra sao.

  5. Tạo một trang trạng thái và thêm các monitor muốn công khai.

Mẹo dùng hay

  • Hãy chạy Uptime Kuma ở một máy hay một mạng khác với thứ cần giám sát; nếu cùng một chỗ thì khi chỗ đó mất điện, cả giám sát cũng tắt.
  • Bật 2FA cho tài khoản quản trị nếu mở ra ngoài internet.
  • Cẩn thận trang giả: README cảnh báo kết quả hàng đầu trên Google tên uptimekuma.co không phải trang chính thức; dùng hướng dẫn từ repo GitHub.

Lưu ý và hạn chế

  • Hệ thống tệp mạng như NFS không được hỗ trợ; dữ liệu phải ở ổ cục bộ hoặc volume Docker.
  • Giao diện không hỗ trợ FreeBSD, OpenBSD, NetBSD, Replit hay Heroku theo README.
  • Dịch vụ kiểm tra từ một chỗ nên nếu chính máy chạy Uptime Kuma mất mạng, bạn sẽ thấy báo sai hoặc không thấy báo.

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

Uptime Kuma có miễn phí không?

Có, mã nguồn mở theo giấy phép MIT. Bạn chỉ trả chi phí máy chạy nó.

Có tiếng Việt không?

README nói giao diện có nhiều ngôn ngữ, nhưng không liệt kê chi tiết. Hãy kiểm tra trong phần cài đặt ngôn ngữ sau khi cài.

Máy yếu chạy được không?

README không nêu yêu cầu phần cứng cụ thể. Hãy thử trên máy của bạn và theo dõi mức dùng tài nguyên; nếu không chắc, chạy thử trước bằng Docker.

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/louislam/uptime-kuma.git

Repo tương tự nên xem

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

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à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
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

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