Uptime-Kuma
2025-10-02 16:03:52 #Uptime-Kuma

Uptime Kuma 安装指南

1. 简介

Uptime Kuma 是一款开源、免费且易于使用的自托管监控工具。它兼容多种平台，包括 Linux、Windows 10 (x64) 和 Windows Server。

Uptime Kuma 的仪表板简洁高效，功能强大，让监控服务正常运行时间变得前所未有的简单。

2. Windows（Docker方式）

2.1 环境准备

  • Windows 10 以上操作系统
  • Docker Desktop
  • Uptime Kuma 版本：1.23.16

2.2 开启 Hyper-V 虚拟化技术

控制面板 → 程序和功能 → 启用或关闭 Windows 功能 → Hyper-V → 勾选 Hyper-V 工具和 Hyper-V 管理平台

2.3 安装 Docker Desktop

按照常规流程安装 Docker Desktop。

2.4 拉取 Uptime Kuma 镜像

2.5 运行 Uptime Kuma

在终端中运行以下命令：

1
2
3
4
5
# 创建数据卷
docker volume create uptime-kuma

# 启动容器
docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma --network host louislam/uptime-kuma:1.23.16

2.6 访问使用

1
http://127.0.0.1:3001

3. Windows（NPM方式）

3.1 环境准备

  • Windows 10 (x64), Windows Server 2012 R2 (x64) 或更高版本
  • Git
  • Node.js 14 / 16 / 18 / 20.4
  • npm ≥ 7
  • pm2
  • Uptime Kuma 版本：1.23.16

3.2 安装 Node.js 20.19.4

下载链接：https://nodejs.org/dist/v20.19.4/node-v20.19.4-x64.msi

3.3 安装 Uptime Kuma

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 配置 npm 镜像源
npm config set registry https://registry.npmmirror.com

# 克隆仓库
git clone https://github.com/louislam/uptime-kuma.git

# 如果存在网络问题，可使用加速地址（加速节点参考 https://ghproxy.link/）
git clone https://ghfast.top/github.com/louislam/uptime-kuma.git

# 安装依赖
cd uptime-kuma
git checkout 1.23.16
npm run setup

# 如果 npm run setup 下载前端文件较慢，可以修改 extra/download-dist.js 文件中的 const url
# 修改为：https://ghfast.top/github.com/louislam/uptime-kuma/releases/download/1.23.16/dist.tar.gz
# 保存后重新执行 npm run setup

3.4 配置 PM2

PM2 主要用于进程管理和服务守护。

1
2
3
4
5
6
7
8
9
10
11
12
# 安装 PM2
npm install pm2 -g
pm2 install pm2-logrotate

# 启动进程
pm2 start server/server.js --name uptime-kuma

# 实时监控资源使用情况
pm2 monit

# 配置开机自启
pm2 save && pm2 startup

3.5 访问使用

1
http://127.0.0.1:3001

4. CentOS 7（NPM方式）

4.1 环境准备

  • CentOS Linux release 7.9.2009 (Core)
  • 内核版本：3.10.0-1160.119.1.el7.x86_64
  • Git
  • Node.js 18 / 20.4
  • npm ≥ 7
  • pm2
  • Uptime Kuma 版本：2.0.0-beta.2

4.2 安装 Node.js

由于 CentOS 7 默认的 glibc 版本较低，需要选择基于 glibc 2.17 构建的 Node.js 20。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 下载 Node.js
cd /opt
wget -c https://unofficial-builds.nodejs.org/download/release/v20.12.2/node-v20.12.2-linux-x64-glibc-217.tar.xz

# 安装 Node.js
cd /usr/local
tar -xvf /opt/node-v20.12.2-linux-x64-glibc-217.tar.xz
mv node-v20.12.2-linux-x64-glibc-217 node-v20.12.2

# 配置环境变量
cat >> /etc/profile << 'EOF'
export NODE_HOME=/usr/local/node-v20.12.2
export PATH=$PATH:$NODE_HOME/bin
EOF

# 使环境变量生效
source /etc/profile

# 配置 npm 镜像源
npm config set registry https://registry.npmmirror.com

4.3 安装 Uptime Kuma

注意：

  • 安装脚本默认会将 git 分支切换回 main，需要修改 package.json 文件
  • 建议将 dist.tar.gz 下载链接修改为国内加速源
1
2
3
4
5
6
7
8
9
10
11
12
# 克隆仓库
git clone https://github.com/louislam/uptime-kuma.git

# 如果存在网络问题，可使用加速地址
git clone https://ghfast.top/github.com/louislam/uptime-kuma.git
cd uptime-kuma

# 切换到指定版本分支
git checkout release-2.0.0-beta.2

# 修改 package.json 文件，避免安装脚本自动切换分支
vim package.json

将 scripts 部分修改为：

1
2
3
"scripts": {
  "setup": "npm ci --omit dev && npm run download-dist"
}
1
2
# 配置 dist.tar.gz 下载链接为国内加速源
vim extra/download-dist.js

修改为：

1
https://ghfast.top/github.com/louislam/uptime-kuma/releases/download/2.0.0-beta.2/dist.tar.gz
1
2
# 执行安装脚本
npm run setup

4.4 配置 PM2

PM2 主要用于进程管理和服务守护。

1
2
3
4
5
6
7
8
9
10
11
12
# 安装 PM2
npm install pm2 -g
pm2 install pm2-logrotate

# 启动进程
pm2 start server/server.js --name uptime-kuma

# 实时监控资源使用情况
pm2 monit

# 配置开机自启
pm2 save && pm2 startup

4.5 访问使用

1
http://127.0.0.1:3001

5. PM2 命令清单

以下是常用的 PM2 命令清单，适用于管理 Uptime Kuma 或其他 Node.js 应用：

5.1 安装和基础操作

1
2
3
4
5
6
7
8
9
# 全局安装 PM2
npm install pm2 -g

# 启动应用
pm2 start server.js --name uptime-kuma

# 查看运行中的进程列表
pm2 list
pm2 status

5.2 进程管理

1
2
3
4
5
6
7
8
9
10
11
12
13
# 停止指定应用
pm2 stop uptime-kuma

# 重启指定应用
pm2 restart uptime-kuma

# 删除指定应用
pm2 delete uptime-kuma

# 停止/重启/删除所有应用
pm2 stop all
pm2 restart all
pm2 delete all

5.3 日志管理

1
2
3
4
5
6
7
8
# 查看应用日志（实时输出）
pm2 logs uptime-kuma

# 查看错误日志
pm2 logs uptime-kuma --err

# 查看最近 100 行日志
pm2 logs uptime-kuma --lines 100

5.4 自动重启与开机自启

1
2
3
4
5
6
7
8
# 保存当前进程列表，开机自动恢复
pm2 save

# 生成开机启动脚本
pm2 startup

# 删除开机启动设置
pm2 unstartup

5.5 资源监控

1
2
# 实时监控 CPU/内存等资源使用情况
pm2 monit
上一页
2025-10-02 16:03:52 #Uptime-Kuma
下一页