Komari：一款专为开发者打造的轻量级服务“看守神器”

最新推荐文章于 2025-11-20 05:09:02 发布

原创最新推荐文章于 2025-11-20 05:09:02 发布 · 414 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#监控

框架篇专栏收录该内容

41 篇文章

订阅专栏

01 引言

在当今的互联网服务开发中，确保应用的稳定性和可用性至关重要。无论是个人项目、初创公司还是企业级应用，都需要一套可靠的监控系统来及时发现服务中断、性能瓶颈等问题。然而，像 Prometheus 或 Datadog 这样的专业监控方案虽然功能强大，但对于小型项目或个人开发者来说，往往显得过于沉重和复杂。

正是在这样的背景下，一个名为 Komari 的轻量级监控工具在 GitHub 上悄然诞生，它旨在用最简单的方式，解决最核心的监控需求。

02 `Komari`简介

Komari 是一款轻量级的自托管服务器监控工具，旨在提供简单、高效的服务器性能监控解决方案。它支持通过 Web 界面查看服务器状态，并通过轻量级 Agent 收集数据。

特性

轻量高效：低资源占用，适合各种规模的服务器。
自托管：完全掌控数据隐私，部署简单。
Web 界面：直观的监控仪表盘，易于使用。

GitHub地址：https://github.com/komari-monitor/komari

文档地址：https://komari-document.pages.dev/

在线演示地址：https://ss.akz.moe/

03 服务部署

官方提供了三种安装方式：

Docker部署
二进制安装
手动编译

本节部署以Docker为例：

3.1 创建数据目录

mkdir -p ./data

3.2 运行 Docker 容器

docker run -d \
  -p 25774:25774 \
  -v $(pwd)/data:/app/data \
  --name komari \
  ghcr.io/komari-monitor/komari:latest

3.3 查看默认账号和密码

docker logs komari

3.4 访问

地址：http://<your_server_ip>:25774

这里需要登录才能设置其他信息。登录的用户名和密码就是日志中框的信息。

登录成功之后，需要在账户这里更改密码，方式临时密码丢失。

到这里就完成监控服务的基础配置。

04 添加监控节点

添加监控节点需要在服务后台手动建立临时节点，然后通过Agent关联，变成真正的监控节点。

4.1 增加临时节点

临时节点添加完，只是一个空壳，没有详细信息：

4.2 获取Agent命令

部署的命令根据服务的类型而不同，这里以Linux为例。安装的选项，可以按需选择。然后复制指令即可：

bash <(curl -sL https://raw.githubusercontent.com/komari-monitor/komari-agent/refs/heads/main/install.sh) -e http://127.0.0.1:25774 
-t HxrV90Hp7ZB5Vnw2HHpWwI

这里需要注意的是，服务端默认需要支持Https协议，否则无法使用复制命令。

所以这里我们直接手动复制即可。

命令行中需要主要的是：-t的参数，该参数是当前客户端（节点的唯一标识）

4.3 安装Agent

获取到指令以后，就可在需要监控的服务器上执行指令即可。

指令会自动下载komari-agent-linux-amd64，成功会后就可以在服务端查看监控的详细信息了。但是部分机器或者配置原因会导致komari-agent-linux-amd64下载失败，我们需要手动安装Agent，安装步骤参考官方文档：

4.4 手动安装Agent

我们需要在https://github.com/komari-monitor/komari-agent/releases上下载属于自己的Agent：

下载验证

下载完之后上传到服务器，可以按照官网步骤检查文件是否完整：

komari-agent为下载的Agent文件，可以重命名。

# 检查文件大小（应该大于 0）
ls -lh komari-agent

# 检查文件类型
file komari-agent

赋予执行权限

在下载完成后，您需要为 Komari Agent 文件赋予执行权限：

chmod +x komari-agent

4.5 启动Agent

在终端中运行以下命令来启动 Komari Agent：

./komari-agent [运行参数]

这里我们需要指定两个参数：

监控服务的地址：-e http://127.0.0.1:25774
临时节点的唯一标识：-t HxrV90Hp7ZB5Vnw2HHpWwI

完整命令：

./komari-agent -e http://10.100.213.25:25774 -t HxrV90Hp7ZB5Vnw2HHpWwI

也可以通过启动检查的命令：

# 检查进程
ps aux | grep komari-agent

上面的命令是临时窗口，关闭之后Agent随之关闭。如果需要后台启动，继续参考官方文档，这里不再演示。如下：

05 成品展示

回到节点列表，就会发现已经识别了IP以及位置。

回到主页就可以看到服务器的总览信息：

点击进去可以查看服务详细监控信息：

看看多服务的展示的效果。这里就不直接演示了，直接使用官方提供的地址查看，颜值杠杠的。

06 小结

如果你正在寻找一个简单、可靠、不占资源的工具来守护你的网站、API 或数据库，那么 Komari 绝对值得一试。访问其 GitHub 仓库，阅读详细的文档，并开始你的服务监控之旅吧！