Long：如何部署服务器状态监控—— uptime kuma

2026-01-31T06:45:41Z

如何部署服务器状态监控—— 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 系统：

<syntaxhighlight lang="bash">
# 切换到 root 用户（如果当前不是 root，建议执行此步）
sudo -i

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

# 安装必要的常用工具（curl, wget, nano编辑器, git）
apt install curl wget nano git -y
</syntaxhighlight>
[[File:0ff5fe52.png|center|thumb|600x600px]]
----

== 三、安装 Docker 环境 ==

我们将使用 Docker 官方的安装脚本，这是最快、最标准的安装方式。

=== 1. 一键安装 Docker ===

执行以下命令，系统会自动识别架构并安装最新版的 Docker 引擎：

<syntaxhighlight lang="bash">
curl -fsSL https://get.docker.com | bash
</syntaxhighlight>
[[File:7cd2.png|center|thumb|600x600px]]

=== 2. 启动 Docker 并设置开机自启 ===

安装完成后，执行以下命令启动 Docker 服务并设置为开机自自动运行：

<syntaxhighlight lang="bash">
systemctl enable --now docker
</syntaxhighlight>

=== 3. 安装 Docker Compose ===

为了运行后续的配置文件，我们需要安装 Docker Compose 独立工具。

<syntaxhighlight lang="bash"># 下载 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</syntaxhighlight>
[[File:354.png|center|thumb|600x600px]]
----

== 四、部署 Uptime Kuma ==

环境配置好后，我们开始正式部署 Uptime Kuma。

=== 1. 创建项目目录 ===

为了方便管理，我们将所有文件放在专门的目录中：

<syntaxhighlight lang="bash">
# 创建目录
mkdir -p /root/data/docker_data/uptime-kuma

# 进入目录
cd /root/data/docker_data/uptime-kuma
</syntaxhighlight>
[[File:D90.png|center|thumb|600x600px]]

=== 2. 创建配置文件 ===

使用 <code>nano</code> 编辑器创建并编辑 <code>docker-compose.yml</code> 文件：

<syntaxhighlight lang="bash">
nano docker-compose.yml
</syntaxhighlight>

将以下代码块完整复制并粘贴到编辑器中：

<syntaxhighlight lang="yaml">
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
</syntaxhighlight>

'''操作提示：'''

# 粘贴完成后，按 <code>Ctrl + O</code> 保存文件。
# 按 <code>Enter</code> 确认文件名。
# 按 <code>Ctrl + X</code> 退出编辑器。
[[File:D3ca340.png|center|thumb|600x600px]]

=== 3. 启动容器 ===

在当前目录下执行以下命令启动服务：

<syntaxhighlight lang="bash">
docker compose up -d
</syntaxhighlight>

等待几秒钟，当看到 <code>Creating uptime-kuma ... done</code> 字样时，说明部署成功。
[[File:77ef4b7.png|center|thumb|600x600px]]

----

== 五、放行防火墙端口（重要） ==

由于我们直接通过 IP + 端口访问，必须确保服务器的防火墙放行了 '''3001''' 端口。（这里已VPS安装了ufw防火墙为例）

<syntaxhighlight lang="bash">
ufw allow 3001/tcp
ufw reload
</syntaxhighlight>

----

== 六、访问与设置 ==

=== 1. 初始化设置 ===

打开浏览器，在地址栏输入：

<code>http://你的服务器IP:3001</code>

例如：<code>http://192.168.1.100:3001</code>

* 第一次访问会要求创建管理员账号。
* 语言选择“中文”，设置好用户名和密码，点击 '''创建'''。
[[File:94d4d.png|center|thumb|600x600px]]

=== 2. 开始使用 ===

进入仪表盘后，点击左上角的 '''“添加监控项”''' 即可开始监控。

你可以用来监控：

* '''网站状态'''（HTTP/HTTPS）：监控网站是否可以正常访问。
* '''服务器存活'''（Ping）：监控服务器是否在线。
* '''端口状态'''（TCP Port）：监控特定的服务端口（如 SSH 的 22 端口）是否通畅。
[[File:011a6.png|center|thumb|600x600px]]
至此，一个属于你自己的服务器监控面板就搭建完成了！
[[File:A5e4.png|center|thumb|600x600px]]
[[File:124gdf.png|center|thumb|600x600px]]

== 七、最后 ==
如果后面有想过通过域名进行访问，可以看同站里的 '''NPM''' 安装教学'''。'''
[[Category:500 常见应用指南 — Application Guides]]

如何在搬瓦工VPS搭建Uptime Kuma服务器状态监控 - 版本历史

Long：​如何部署服务器状态监控—— uptime kuma

Long：如何部署服务器状态监控—— uptime kuma