如何在搬瓦工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 环境