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.
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 `
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://. Đă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://để xem trạng thái:3001
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 3001nế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
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%.
VPS-4E
Đã gồm VAT 10%
- CPU: 4 vCPU
- RAM: 8 GB
- SSD: 50 GB NVMe
VPS-5E
Đã gồm VAT 10%
- CPU: 8 vCPU
- RAM: 16 GB
- SSD: 100 GB NVMe
