Quay lại danh sách
AI & Cloud

Hướng dẫn triển khai Uptime Kuma để theo dõi trạng thái website và tự động gửi thông báo qua Telegram

Hướng dẫn chi tiết triển khai Uptime Kuma trên VPS để theo dõi trạng thái website, tự động cảnh báo khi có sự cố và gửi thông báo qua Telegram.

DPTCloud Engineering4 phút đọc
Hướng dẫn triển khai Uptime Kuma để theo dõi trạng thái website và tự động gửi thông báo qua Telegram

Nguồn ảnh: jamesmarkosborne · Pixabay Content License

Giới thiệu về Uptime Kuma

Uptime Kuma là một công cụ theo dõi trạng thái website mã nguồn mở, cho phép bạn giám sát các trang web, API, dịch vụ mạng và nhiều dịch vụ khác. Với giao diện người dùng trực quan, Uptime Kuma cung cấp thông báo tự động qua Telegram, Email, Slack và nhiều nền tảng khác khi phát hiện sự cố.

Trong hướng dẫn này, bạn sẽ học cách triển khai Uptime Kuma trên một VPS (Cloud VPS) để theo dõi trạng thái website và nhận thông báo tự động qua Telegram. Hướng dẫn được tối ưu cho người dùng Việt Nam sử dụng VPS tại Việt Nam hoặc quốc tế.

Yêu cầu hệ thống và chuẩn bị

Để triển khai Uptime Kuma, bạn cần:

  • Một máy chủ VPS (Cloud VPS) với ít nhất 1GB RAM và 2GB SSD (có thể dùng VPS RAM lớn cho Self-Host LLM & API Gateway)
  • Hệ điều hành Linux (Ubuntu 20.04/22.04 hoặc Debian 11)
  • Truy cập SSH vào VPS
  • Telegram Bot API (tạo bot tại BotFather)
  • Địa chỉ IP công khai của VPS (để Uptime Kuma gửi thông báo)

Triển khai Uptime Kuma trên VPS

Sử dụng Docker để triển khai Uptime Kuma một cách nhanh chóng và dễ dàng.

1. Cài đặt Docker

Chạy các lệnh sau trên VPS:

# Cập nhật hệ thống
sudo apt update && sudo apt upgrade -y

# Cài đặt các gói cần thiết
sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release

# Thêm khóa GPG của Docker
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# Thêm kho Docker
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Cập nhật và cài Docker
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# Bật và khởi động dịch vụ Docker
sudo systemctl enable docker
sudo systemctl start docker

2. Tạo Telegram Bot và lấy Token

Truy cập BotFather trên Telegram, tạo bot mới và nhận token API.

Chạy lệnh sau để lấy ID người dùng Telegram (bạn cần gửi tin nhắn cho bot):

curl -s "https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates" | jq '.result[0].message.chat.id'

Thay `` bằng token bạn nhận được.

3. Cài đặt Uptime Kuma bằng Docker

Tạo thư mục lưu trữ dữ liệu:

mkdir -p ~/uptime-kuma/data

Chạy Uptime Kuma với Docker Compose:

# ~/uptime-kuma/docker-compose.yml
version: '3.8'

services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    volumes:
      - ./data:/app/data
    ports:
      - "3001:3001"
    restart: unless-stopped

Chạy:

cd ~/uptime-kuma
docker-compose up -d

Cấu hình thông báo qua Telegram

Truy cập giao diện web tại http://:3001. Đăng nhập (tài khoản mặc định: admin/admin).

Đi đến Settings → Notifications → Add Notification.

  • Chọn Telegram làm phương thức thông báo
  • Nhập Bot Token từ BotFather
  • Nhập Chat ID (ID người dùng hoặc nhóm)
  • Lưu lại

Thêm website để theo dõi

Trong giao diện Uptime Kuma, nhấn Add New Monitor.

  • Chọn loại kiểm tra: HTTP, Ping, TCP, v.v.
  • Nhập URL website cần theo dõi
  • Đặt thời gian kiểm tra (ví dụ: 1 phút)
  • Chọn thông báo qua Telegram
  • Lưu lại

Xác minh và kiểm tra

Để kiểm tra, bạn có thể:

  • Giả vờ tắt website (tắt server, ngắt kết nối)
  • Chờ 1 phút, kiểm tra xem có thông báo từ Telegram không
  • Truy cập http://:3001 để xem trạng thái

Khắc phục sự cố

  • Không thể truy cập giao diện: Kiểm tra port 3001 đã mở chưa (dùng sudo ufw allow 3001 nếu dùng UFW)
  • Không nhận thông báo Telegram: Kiểm tra Token và Chat ID, đảm bảo bot có quyền gửi tin nhắn
  • Docker không chạy: Chạy docker ps để kiểm tra trạng thái container

Tài liệu tham khảo

Hạ tầng DPTCloud Tier III

Cấu hình Cloud VPS RAM cao tối ưu cho AI, Database & Cache

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-02Khuyên dùng

VPS-4E

297.000 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe
ECO · vn-02

VPS-5E

614.900 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 8 vCPU
  • RAM: 16 GB
  • SSD: 100 GB NVMe
ADVANCED · vn-03Khuyên dùng

VPS-4T

548.900 ₫ / 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