Posted inHomeLab

Tự host Uptime Kuma trên Docker: Ngừng phỏng đoán và bắt đầu giám sát HomeLab của bạn

HomeLab tutorial - IT technology blog
HomeLab tutorial - IT technology blog

Sự ức chế khi hệ thống lỗi trong im lặng

Lúc đó là 9 giờ tối thứ Sáu khi những lời phàn nàn bắt đầu xuất hiện. Gia đình tôi không thể truy cập vào máy chủ Jellyfin ngay khi bộ phim của họ sắp bắt đầu. Sau khi kiểm tra log, tôi phát hiện ra một lỗi cấu hình đơn giản đã làm sập container từ ba giờ trước đó. Tôi hoàn toàn không hay biết gì. Đây là cái bẫy điển hình của HomeLab. Chúng ta dành hàng tuần để hoàn thiện các dịch vụ như Home Assistant hay TrueNAS nhưng lại quên xây dựng một hệ thống cảnh báo khi chúng gặp sự cố.

Kiểm tra URL thủ công là một sự lãng phí thời gian khủng khiếp. Dựa dẫm vào việc người thân báo cáo sự cố chỉ khiến bạn thêm căng thẳng. Từ những gì tôi quan sát được trong thực tế, thay đổi quan trọng nhất bạn nên thực hiện là chuyển từ việc sửa chữa thụ động sang giám sát chủ động. Uptime Kuma là công cụ hoàn hảo cho việc này. Nó cung cấp một dashboard chuyên nghiệp tương tự như UptimeRobot, nhưng chạy cục bộ trên phần cứng của bạn và giữ cho dữ liệu của bạn ở chế độ riêng tư.

Tại sao Uptime Kuma là lựa chọn tốt hơn

Trước đây tôi đã thử các công cụ cấp doanh nghiệp như Zabbix và Nagios. Chúng rất mạnh mẽ, nhưng việc cấu hình chúng giống như một công việc toàn thời gian vậy. Uptime Kuma tìm thấy sự cân bằng hoàn hảo. Nó thường sử dụng ít hơn 200MB RAM, lý tưởng cho Raspberry Pi hoặc một chiếc NUC cũ, tương tự như các hệ thống K3s cho HomeLab tối giản. Đây là lý do tại sao nó nên có mặt trong hệ thống của bạn:

  • Giám sát đa năng: Nó không chỉ theo dõi các trang web. Bạn có thể giám sát các bản ghi DNS, Docker container, máy chủ game Steam và thậm chí cả các cổng TCP/UDP cụ thể.
  • Thông báo tức thì: Nó hỗ trợ hơn 90 dịch vụ. Nếu một ổ cứng bị lỗi hoặc một dịch vụ bị treo, bạn sẽ nhận được thông báo trên Telegram, Discord hoặc Slack chỉ trong vài giây.
  • Trang trạng thái đẹp mắt: Bạn có thể xây dựng các trang công khai để khoe tỷ lệ uptime 99,9% của mình hoặc thông báo cho người dùng khác trong quá trình bảo trì.
  • Sự đơn giản của Docker: Bạn có thể triển khai toàn bộ hệ thống với một file Docker Compose duy nhất trong chưa đầy hai phút.

Triển khai Uptime Kuma với Docker Compose

Tôi luôn khuyên dùng Docker Compose thay vì các lệnh docker run cơ bản. Nó giúp cấu hình của bạn ngăn nắp và việc tự động cập nhật Docker container trở nên dễ dàng hơn. Đây là thiết lập chính xác mà tôi sử dụng cho môi trường thực tế của mình.

1. Chuẩn bị cấu trúc thư mục

Tạo một thư mục riêng để giữ cho dữ liệu giám sát của bạn được lưu trữ bền vững và ngăn nắp.

mkdir -p ~/homelab/uptime-kuma
cd ~/homelab/uptime-kuma

2. Tạo file Docker Compose

Tạo một file có tên docker-compose.yml và dán cấu hình bên dưới vào. Sử dụng volume lưu trữ bền vững đảm bảo lịch sử và các thiết lập cảnh báo của bạn không bị mất khi container khởi động lại.

version: "3.8"
services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    volumes:
      - ./data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock
    ports:
      - "3001:3001"
    restart: always

Mẹo nhỏ: Việc ánh xạ /var/run/docker.sock là một bước ngoặt lớn. Nó cho phép Uptime Kuma giao tiếp trực tiếp với Docker engine của bạn. Nếu một container dừng lại, Kuma sẽ phát hiện sự thay đổi trạng thái ngay lập tức mà không cần đợi timeout của HTTP.

3. Khởi chạy dịch vụ

Khởi động container bằng lệnh sau:

docker-compose up -d

Sau khi hệ thống chạy, hãy truy cập trình duyệt tới địa chỉ http://your-server-ip:3001. Bạn sẽ được yêu cầu tạo tài khoản admin. Hãy sử dụng mật khẩu mạnh. Dashboard này cuối cùng sẽ quản lý trạng thái của toàn bộ hạ tầng mạng của bạn.

Cấu hình Monitor đầu tiên của bạn

Giao diện rất sạch sẽ, nhưng một vài tinh chỉnh nhỏ sẽ giúp cảnh báo của bạn đáng tin cậy hơn nhiều. Hãy thiết lập một kiểm tra tiêu chuẩn cho một dịch vụ như Jellyfin.

  1. Nhấp vào Add New Monitor (Thêm Monitor mới).
  2. Monitor Type: Chọn “HTTP(s)”.
  3. Friendly Name: Sử dụng tên rõ ràng như “Media Server”.
  4. URL: Nhập IP nội bộ hoặc domain cục bộ của bạn.
  5. Heartbeat Interval: Đặt mức này thành 60 giây. Kiểm tra mỗi 5 giây là quá mức cần thiết cho hầu hết các HomeLab và tạo ra log không cần thiết.
  6. Retries: Đặt mức này thành 3. Điều này ngăn chặn tình trạng “chập chờn” (flapping), nơi một sự cố mạng nhỏ trong 1 giây có thể kích hoạt báo động giả.

Nếu bạn đã ánh xạ Docker socket ở bước trước, hãy thử loại monitor “Docker Container”. Chỉ cần nhập tên container và Kuma sẽ theo dõi trạng thái vòng đời của nó trực tiếp.

Thiết lập thông báo chuẩn xác

Một dashboard giám sát chỉ hữu ích nếu nó báo cho bạn biết khi có thứ gì đó hỏng, ví dụ như khi bạn tự host Gotify để nhận cảnh báo tức thì. Telegram là tiêu chuẩn vàng cho những người chơi HomeLab vì nó miễn phí và cực kỳ dễ cấu hình.

Cấu hình cảnh báo Telegram

  1. Tìm kiếm @BotFather trên Telegram để tạo bot mới và lưu lại Bot Token của bạn.
  2. Nhắn tin cho @myidbot để tìm Chat ID duy nhất của bạn.
  3. Trong Uptime Kuma, đi tới Settings > Notifications > Setup Notification.
  4. Chọn “Telegram” và nhập thông tin đăng nhập của bạn.
  5. Nhấp vào Test. Nếu điện thoại của bạn rung lên, bạn đã sẵn sàng cho sự cố tiếp theo.

Tôi cũng khuyên bạn nên thiết lập Email (SMTP) làm phương án dự phòng. Nếu internet tại nhà bị ngắt và Telegram thất bại, bạn vẫn sẽ thấy cảnh báo trong hộp thư đến khi bạn chuyển sang dữ liệu di động. Mật khẩu ứng dụng Gmail hoạt động hoàn hảo cho việc này.

Các mẹo nâng cao để có trải nghiệm tốt hơn

Truy cập an sau với Reverse Proxy

Chạy trên cổng 3001 là ổn để thử nghiệm, nhưng cuối cùng bạn nên sử dụng một URL sạch như status.yourdomain.com. Tôi sử dụng Nginx Proxy Manager cho việc này. Nếu bạn đi theo hướng này, hãy nhớ bật Websockets Support trong cài đặt proxy của bạn. Nếu không có nó, dashboard sẽ không cập nhật theo thời gian thực.

Chiến lược “Giám sát trình giám sát”

Điều gì xảy ra nếu máy chủ chạy Uptime Kuma bị mất điện? Bạn sẽ không nhận được cảnh báo vì bộ máy thông báo đã ngoại tuyến, vì vậy việc làm chủ Network UPS Tools (NUT) là bước cần thiết để theo dõi trạng thái năng lượng của hệ thống. Để khắc phục điều này, tôi sử dụng một instance Uptime Kuma thứ hai trên một VPS giá rẻ 5$ của Hetzner hoặc DigitalOcean. Sử dụng loại monitor Push để gửi heartbeat từ nhà bạn đến VPS. Nếu VPS ngừng nhận heartbeat đó, nó sẽ gửi cảnh báo cho bạn. Điều này giúp bạn được bảo vệ ngay cả khi mất điện toàn bộ khu vực cục bộ.

Sắp xếp ngăn nắp với Tag

Khi hệ thống lab của bạn lớn dần, bạn có thể kết thúc với 40 hoặc 50 monitor. Sử dụng tính năng Tag để nhóm chúng vào các danh mục như “Network”, “Storage”, hoặc “External”. Điều này giúp bạn dễ dàng lọc dashboard và áp dụng các quy tắc thông báo cụ thể cho toàn bộ nhóm cùng một lúc.

Tổng kết

Thêm Uptime Kuma là thời điểm bạn ngừng làm một người chơi nghiệp dư và bắt đầu đối xử với hạ tầng của mình bằng sự chăm sóc chuyên nghiệp. Nó mang lại sự an tâm. Bạn sẽ biết một ổ cứng sắp hỏng hoặc một container bị sập từ lâu trước khi bất kỳ ai khác trong nhà nhận ra. Một khi bạn nhìn thấy dãy thanh trạng thái uptime màu xanh đó, bạn sẽ tự hỏi làm thế nào mình có thể quản lý máy chủ mà không có chúng.

Share:
Tags: