如何在搬瓦工VPS搭建Uptime Kuma伺服器狀態監控

Uptime Kuma 是一款開源、高顏值的自託管監控工具。它界面美觀，功能強大，支持 HTTP(s) / TCP / Ping / DNS 等多種監控方式。

下面將演示如何在一台全新的搬瓦工 Linux 伺服器上，使用 Docker 快速部署一套屬於自己的監控系統。

一、環境準備

在開始之前，請確保你已經準備好了以下內容：

伺服器：一台安裝了 Linux 系統的 VPS（推薦 Debian 10+ 或 Ubuntu 20.04+）。
工具：SSH 客戶端（本文使用windows 11 自帶的 PowerShell 進行演示，命令是通用的，你也可以選擇其他SSH客戶端）。

二、伺服器初始化與更新

首先，使用 SSH 連接到你的伺服器。為了保證軟體的兼容性和安全性，我們先對系統軟體包進行更新。

以下命令適用於 Debian 和 Ubuntu 系統：

# 切换到 root 用户（如果当前不是 root，建议执行此步）
sudo -i

# 更新软件包列表并升级已安装的软件
apt update -y && apt upgrade -y

# 安装必要的常用工具（curl, wget, nano编辑器, git）
apt install curl wget nano git -y

三、安裝 Docker 環境

我們將使用 Docker 官方的安裝腳本，這是最快、最標準的安裝方式。

1. 一鍵安裝 Docker

執行以下命令，系統會自動識別架構並安裝最新版的 Docker 引擎：

curl -fsSL https://get.docker.com | bash

2. 啟動 Docker 並設置開機自啟

安裝完成後，執行以下命令啟動 Docker 服務並設置為開機自自動運行：

systemctl enable --now docker

3. 安裝 Docker Compose

為了運行後續的配置文件，我們需要安裝 Docker Compose 獨立工具。

# 下载 Docker Compose 二进制文件
curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 赋予可执行权限
chmod +x /usr/local/bin/docker-compose

# 验证安装是否成功（出现版本号即为成功）
docker-compose --version

四、部署 Uptime Kuma

環境配置好後，我們開始正式部署 Uptime Kuma。

1. 創建項目目錄

為了方便管理，我們將所有文件放在專門的目錄中：

# 创建目录
mkdir -p /root/data/docker_data/uptime-kuma

# 进入目录
cd /root/data/docker_data/uptime-kuma

2. 創建配置文件

使用 nano 編輯器創建並編輯 docker-compose.yml 文件：

nano docker-compose.yml

將以下代碼塊完整複製並粘貼到編輯器中：

version: '3.3'

services:
  uptime-kuma:
    image: louislam/uptime-kuma
    container_name: uptime-kuma
    volumes:
      - ./uptime-kuma-data:/app/data
    ports:
      - 3001:3001
    restart: always

操作提示：

粘貼完成後，按 Ctrl + O 保存文件。
按 Enter 確認文件名。
按 Ctrl + X 退出編輯器。

3. 啟動容器

在當前目錄下執行以下命令啟動服務：

docker compose up -d

等待幾秒鐘，當看到 Creating uptime-kuma ... done 字樣時，說明部署成功。

五、放行防火牆埠（重要）

由於我們直接通過 IP + 埠訪問，必須確保伺服器的防火牆放行了 3001 埠。（這裡已VPS安裝了ufw防火牆為例）

ufw allow 3001/tcp
ufw reload

六、訪問與設置

1. 初始化設置

打開瀏覽器，在地址欄輸入：

http://你的服务器IP:3001

例如：http://192.168.1.100:3001

第一次訪問會要求創建管理員帳號。
語言選擇「中文」，設置好用戶名和密碼，點擊創建。

2. 開始使用

進入儀錶盤後，點擊左上角的 「添加監控項」 即可開始監控。

你可以用來監控：

網站狀態（HTTP/HTTPS）：監控網站是否可以正常訪問。
伺服器存活（Ping）：監控伺服器是否在線。
埠狀態（TCP Port）：監控特定的服務埠（如 SSH 的 22 埠）是否通暢。

至此，一個屬於你自己的伺服器監控面板就搭建完成了！

七、最後

如果後面有想過通過域名進行訪問，可以看同站里的 NPM 安裝教學。

一、 環境準備

二、 伺服器初始化與更新

三、 安裝 Docker 環境