Komari 从入门到入土

mantou • • 代码程序

Komari 从入门到入土

<-前往本博客获取更好阅读体验->

请务必务必前往博客，并在电脑端查看文章以获得最好体验，论坛平台对 Markdown 支持有限: https://genmin.icu/p/komari-intro

前言

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

简单来说就是探针监控，算是最近比较热门的探针服务了

由于一些问题太过小白，遂有本文

请注意，以下是你寻找帮助的渠道，从前往后尝试: (详情请看本博客古老文章)

  1. Komari Docs
  2. Nodeseek 论坛搜索
  3. Bing / Google
  4. Telegram 群组

Why Komari

所以，为什么选择 Komari 而不是 Nezha、Beszel、Akile Monitor 呢？

老实说我完全没有需要监控服务的需求，为 Komari 开发各种奇奇怪怪的东西以及为 Komari 写这篇文章也是完全出于兴趣

作为一个监控服务，其实还是有很多优点的:

  • 开发者活跃: 包括在 Maintainers、主题开发者、Agent 开发者以及 7788 的社区开发者，在目前都还在积极活跃。所以比一些比较烂尾的项目好多了 (对比的是 Akile Monitor，主仓库已 9 月没更新)
  • 轻量化: 当然吹的是本人开发的 komari-monitor-rs，作为一个 Agent 可以保证是同类中最低占用的
  • … 挺多的

现在的功能是越来越多了，流量统计、到期日设置等均已实现

安装主控

首先，你需要一台机器来安装主控，不论是 ClawRun 这类容器云服务、还是 VPS、抑或是实体机都好…

并且该节均使用 Linux 安装主控，其他系统自行研究

对于安装方式的选择，我不建议所有人都使用 一键脚本 来安装环境，不论是小白还是希望规范化自己机器的环境的大佬，但我仍会介绍该种方式

一键脚本安装

一键脚本适用于 systemd 发行版，且架构需要为 amd64 / x86 / arm64 / riscv64 其一

若你的 Linux 为现代且主流的版本即可直接使用 (Ubuntu / Debian 等)

curl -fsSL https://raw.githubusercontent.com/komari-monitor/komari/main/install-komari.sh -o install-komari.sh
chmod +x install-komari.sh
sudo ./install-komari.sh

若机器环境无法访问到 Github，可以尝试下面的命令:

curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/komari-monitor/komari/main/install-komari.sh -o install-komari.sh
sed -i 's|https://github.com|https://ghfast.top/https://github.com|g' install-komari.sh
chmod +x install-komari.sh
sudo ./install-komari.sh

alt text

全新安装，在此处选择 1 并回车即可:

alt text

到了这一步，即可进行下一步

Docker 安装

Docker 环境

这需要你安装 Docker 环境，这里不再赘述，只给出相关一键脚本:

# 下载并执行Docker官方安装脚本
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# 启动Docker服务
sudo systemctl start docker
sudo systemctl enable docker
Docker 创建容器

创造新的文件夹以存放数据:

mkdir -p /opt/komari/data

创建新的容器:

docker run -d \
  -p 25774:25774 \
  --restart=always \
  -v /opt/komari/data:/app/data \
  --name komari \
  ghcr.io/komari-monitor/komari:latest

若机器环境无法访问到 Github，可以尝试下面的命令:

docker run -d \
  -p 25774:25774 \
  --restart=always \
  -v /opt/komari/data:/app/data \
  --name komari \
  ghcr.linkos.org/komari-monitor/komari:latest

你可以使用自己的数据目录，建议存放到 /opt/komari，这同样也是官方一键脚本使用的，可以将上面命令的 /opt/komari 改为其他路径

如果你需要监听其他端口，可以将第一个 25774 改为你需要的端口

获取账号密码

若成功创建 Docker 容器，即可通过以下命令输出的日志来获取随机生成的账号密码:

docker logs komari
总流程图

alt text

二进制 Binary 安装

一些极度的小白就不要尝试了

初始化环境

找个文件夹放 Binary 与数据，这里还是以 /opt/komari 举例:

mkdir -p /opt/komari
cd /opt/komari
下载 Binary

从 Release 获取对应系统、架构的 Binary 下载链接:

alt text

比如我是 Linux Arm64，复制出来下载链接长这样:

https://github.com/komari-monitor/komari/releases/download/1.0.7/komari-linux-arm64

若机器环境无法访问到 Github，可以尝试在链接前加 https://ghfast.top/

随后使用 wget / cUrl 下载即可:

# 任选一个即可
wget -O ./komari [PASTE UR LINK HERE]
curl -o ./komari [PASTE UR LINK HERE]

给 Binary 添加可执行权限:

chmod +x ./komari

初次执行

在 Binary 所在目录执行:

./komari server -l 0.0.0.0:25774

待到输出如图即可 Ctrl-C 直接停止:

alt text

保存好展示的随机生成的账号密码

保活服务

这同样需要系统使用 SystemD，若不是，请自行寻找方法

cat <<EOF > /etc/systemd/system/komari.service
[Unit]
Description=Komari Monitoring Service
After=network.target

[Service]
ExecStart=/opt/komari/komari server -l 0.0.0.0:25774
WorkingDirectory=/opt/komari
Restart=always
User=root

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable komari --now

这是三条命令，直接执行即可，默认直接启动并打开开机自启 (记得替换必要的路径、端口等参数)

随后即可用 systemctl 管理该服务:

  • 开机自启：systemctl enable komari
  • 启动服务：systemctl start komari
  • 服务状态：systemctl status komari

初次登录到 Komari

登录

不论通过什么方式安装了 Komari，你应该都会在上面的命令输出的尾部找到带有 Username: admin, Password: xxxxx 这一行，这就是默认的初始账号密码

访问你的后台: http://[IP]:25774 (在当前步骤应该直接为 IP 或未经 CDN 等服务代理的域名，若未更改过端口即为 25774)

点击右上角登录，输入初始账号密码:

alt text

有一大部分人在此处报告使用默认密码无法登录，请注意在终端不要复制多余字符

更改用户名和密码

alt text

在左侧栏中找到 账户，先修改用户名，后修改密码

请注意，修改用户名并不需要重新登陆，而修改密码需要以新密码登录 (刷新后)

更改基础信息

alt text

在左侧栏中找到 设置-站点，修改站点名称以及描述

最好打开跨域请求开关，并关闭私有模式，这对以后的基于 Komari 的 API 服务非常有帮助 (当然并不强制)

设置反向代理与 CDN

初次登录 Komari 主要是为了验证服务以及建立，接下来我们需要根据自己需求来配置，这非常个性化，不要尝试直接套用本文参数

请应用在生产环境用户仔细阅读该篇，目前大部分的配置问题都来源于反代或 CDN 配置错误

下面的步骤是可选的，但建议做

在可选择的情况下，我的推荐度 (上者推荐度高):

  1. Komari 监听 80 端口 + CDN 80
  2. 非常规端口实现 CDN 代理
  3. 任意端口与 Cloudflare Tunnels 联动
  4. 在 80 端口反代 25774 的 Komari + CDN 80
  5. 其他方案

在 80 端口反代 25774 的 Komari

若你的 80 端口还需要运行其他的服务，则可以通过 反向代理 实现

由于 Komari 需要大文件上传以及 Websocket 支持，所以较难配置

如果你是直接运行 Nginx 等核心的用户，相信你不会需要该教程，直接移步 Komari Doc

如果你使用 1Panel / BTPanel 等服务，自行研究配置即可

Komari 直接监听 80 端口

若你的服务器 80 端口不被其他服务所占用，直接让 Komari 服务监听于 80 端口即可

通过更改部署命令，可以实现该效果，详情请见上文

CloudFlare CDN

Cloudflare CDN 是使用最广泛的 CDN，所以用来举例，其他 CDN 自行研究

为什么推荐使用 CDN？

因为探针服务特殊性，需要全世界各地的 Agent 连接并最好需要双栈服务，CDN 是最简单的方式

普通 80 端口直接 CDN 代理

在 DNS 处直接添加解析，并打开小黄云即可

默认情况下，Cloudflare 会打开 Websocket 开关，并配置好证书，所以不需要其他操作

最后访问域名查看效果

非常规端口实现 CDN 代理

Cloudflare 支持非常用端口的代理，配置还算简单

对于不想使用反向代理，或反向代理不会配置的用户来说是最好的选择

用常规方法解析到 IP 并打开小黄云后，来到 域名-规则-创建规则-源服务器规则:

alt text

名称随意填写，选择 自定义筛选表达式，规则写成 主机名-等于-[你的 Komari 使用的域名]:

alt text

最后的重定向端口写成 Komari 服务的端口即可 (默认为 25774):

alt text

默认情况下，Cloudflare 会打开 Websocket 开关，并配置好证书，所以不需要其他操作

最后保存，访问域名查看效果

任意端口与 Cloudflare Tunnels 联动

Cloudflare Tunnels 类似于内网穿透服务，若你的机器没有公网 IP 或者 CF 回源困难可尝试

在 Cloudflare 账户主页找到 Zero Trust:

alt text

左侧栏目 网络-Tunnels-新建隧道:

alt text

选择 Cloudflared:

alt text

名字随便起，根据自己系统和架构选择，然后执行 Cloudflare 所提供的命令即可:

alt text

按照如图配置你的域名、本地的 Komari 服务链接:

alt text

默认情况下，Cloudflare 会打开 Websocket 开关，并配置好证书，所以不需要其他操作

最后保存，访问域名查看效果

为被监控机安装 Agent

选择 Agent

Agent 有官方与第三方之分，目前较为主流的第三方 Agent 为本人编写的 komari-monitor-rs (有点吹牛逼了哈)

本文的第三方 Agent 会以 komari-monitor-rs 为例

官方 Agent 优点:

  • 都是官方的了，当然最适配 Komari
  • 兼容性较好

komari-monitor-rs 优点:

  • 占用小: 不论是可执行文件大小、还是运行时的 CPU / 内存占用，都是比官方的不止低了一点
  • 支持虚假倍率: 简单来说就是把本机的信息都翻倍然后传输到主控，可以伪装高性能机器 (拳打太湖之光)
  • Prebuilt 架构多: 由于 Rust 语言的特性，可以轻松地交叉编译，覆盖了可以编译通过的所有架构。官方仅仅提供了 Linux / Darwin / Windows / FreeBSD 的 amd64 / x86 / arm / arm64 的架构支持
  • 获取机器信息方式优雅: 说实话这个有点牵强，但我举例下就知道了:
    • 官方在 Agent 使用了大量平台特化与命令执行的方式来获取信息，并且依赖于第三方软件包
    • 第三方 Agent 使用了健全第三方库，并保证了最小体积，不会擅自执行外部命令
    • 比如有关网络信息获取，官方 Agent 直接执行了 vnstat 命令以获取，并解析其输出。我个人不认为这是一个正确的方式来获取系统信息。而第三方 Agent 则使用了系统级库，直接读取网卡信息

所以，你需要根据自己需要来选择 Agent:

  • 若你是纯纯的小白，请使用官方 Agent
  • 若你不希望依赖第三方软件，请尝试使用第三方 Agent
  • 若你的机器环境较为恶劣，可用的资源较少，请尝试使用第三方 Agent
  • 若你的机器架构较为少见，官方无 Prebuilt 的情况下，请使用第三方 Agent (不论是官方还是第三方，均不建议自行编译)
  • 若你需要虚假倍率的功能，请务必使用第三方 Agent
  • 若你是一个极客，并且知道自己在做什么，请务必使用第三方 Agent

在后台创建新的服务器

Komari 从入门到入土

如图，在 后台-服务器-添加节点，输入自己想要的服务器名称，随后添加节点即可

Komari 从入门到入土

成功后，会在后台展示一个带有联合国旗帜的图标。在没有任何数据传输到 Komari 之前，这是正常的

官方 Agent

一键脚本安装

官方 Agent 提供了方便的一键脚本，并与 Komari 主控绑定在一起

点击服务器右侧的类似下载一样的图标，即可获取自动安装的一键脚本:

Komari 从入门到入土

首先选择你需要的系统，目前仅支持 Linux 和 Windows 主流架构一键脚本安装

这里有很多选项，我们来一一解释一下:

  • 禁用远程控制: 如果你不需要使用到网页终端 (俗称 WebSSH) 功能，请禁用它以更安全
  • 禁用自动更新: 在一些需要稳定的场景下，可以禁用自动更新，但长期不更新可能有安全隐患以及有可能无法连接至更高版本的主控
  • 忽略不安全证书: 若服务端已配置 HTTPs，该选项才有效，否则无效。可以忽略与主控通信的证书，安全性自己保证
  • 包含缓冲区内存: 这里需要一些计算机常识，内存一般分为三部分: 使用中-已缓存-可用
    • 虽然但是拿的是 Win 任务管理器举例 Komari 从入门到入土
    • 使用中的部分，是应用程序真正在使用的部分，该部分无论如何都会被统计
    • 已缓存部分，可以被随时清理出来用来供给应用程序使用，这个选项有关的就是这里
    • 可用的部分，可以供给应用程序使用
    • 若开启该选项，则会统计 使用中的部分+已缓存部分 的内存总量，反之为 使用中的部分
    • 若你不知道或不想了解这是什么，请关闭该开关
  • Github 代理: 若你的网络环境无法直接访问 Github，请打开该选项，不建议更改 Github 代理·链接
  • 安装目录 与 服务名称: 顾名思义，若需要自定义可使用
  • 只监测特定网卡 或 排除特定网卡: 这两个选其一即可，可以根据网卡名来获取网络信息，以 , 分割。若你不知道这选项有何用，请保持关闭
  • 只监测特定挂载点: 该选项关于磁盘获取，若仅需要监测特定挂载点，可使用，以 ; 分割 。若你不知道这选项有何用，请保持关闭
  • 网络统计月重置日: 若不需要使用流量监控服务，可关闭。每个月的第一天清零流量统计

配置完后，下方会生成一个可执行的一键命令，在被控机器上运行即可:

Komari 从入门到入土

手动安装
获取 Token

在 Komari 中，一个服务器对应一个 Token，这是主控与被控端通信的重要令牌

可以在后台，点击服务器条目右侧第三个铅笔按钮 编辑信息 来查看:

Komari 从入门到入土

每一个服务器的 Token 都是独一无二的，下文需要使用

下载 Binary

找个文件夹放 Binary 与数据，这里还是以 /opt/komari 举例:

mkdir -p /opt/komari
cd /opt/komari

从 Release 获取对应系统、架构的 Binary 下载链接:

比如我是 Linux Arm64，复制出来下载链接长这样:

https://github.com/komari-monitor/komari-agent/releases/download/1.0.72/komari-agent-linux-arm64

若机器环境无法访问到 Github，可以尝试在链接前加 https://ghfast.top/

随后使用 wget / cUrl 下载即可:

# 任选一个即可
wget -O ./komari-agent [PASTE UR LINK HERE]
curl -o ./komari-agent [PASTE UR LINK HERE]

给 Binary 添加可执行权限:

chmod +x ./komari-agent

在 Binary 所在目录执行可执行文件，获取帮助信息:

./komari-agent --help

成功输出即表示下载成功

构建执行命令

对于官方 Agent，至少需要提供 2 个参数以正常运行，即主控地址 和 Token

./komari-agent -e http://192.168.31.2:25774 -t RSe6wsEcF7xTKblV

请按照上面的格式，替换主端的 URL 以及上面获取的 Token

剩余的参数请通过 ./komari-agent --help 获取，与上文一键脚本安装时的参数解析相差不大，查看即可

随后先在本地测试执行命令，保证其可以连接到主控，若输出类似下方即算完成:

Komari 从入门到入土

即可 Ctrl-C 直接停止

保活

这同样需要系统使用 SystemD，若不是，请自行寻找方法

cat <<EOF > /etc/systemd/system/komari-agent.service
[Unit]
Description=Komari Monitoring Agent Service
After=network.target

[Service]
ExecStart=/opt/komari/komari-agent -e http://192.168.31.2:25774 -t RSe6wsEcF7xTKblV
WorkingDirectory=/opt/komari
Restart=always
User=root

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable komari --now

请自行替换其中的执行命令、执行目录

这是三条命令，直接执行即可，默认直接启动并打开开机自启 (记得替换必要的路径、端口等参数)

随后即可用 systemctl 管理该服务:

  • 开机自启：systemctl enable komari-agent
  • 启动服务：systemctl start komari-agent
  • 服务状态：systemctl status komari-agent

第三方 Agent

还是以 komari-monitor-rs 举例

获取 Token

在 Komari 中，一个服务器对应一个 Token，这是主控与被控端通信的重要令牌

可以在后台，点击服务器条目右侧第三个铅笔按钮 编辑信息 来查看:

Komari 从入门到入土

一键脚本

当然，我们也有一键脚本:

交互式

该脚本会逐步询问你有关 Agent 连接的信息

wget -O setup-client-rs.sh "https://ghfast.top/https://raw.githubusercontent.com/GenshinMinecraft/komari-monitor-rs/refs/heads/main/install.sh" && chmod +x setup-client-rs.sh && sudo bash ./setup-client-rs.sh

Komari 从入门到入土

传入参数式

该脚本也可以类似官方 Agent 的脚本一样传入参数

bash install.sh --http-server "http://your.server:port" --ws-server "ws://your.server:port" --token "your_token" [--terminal]

需要注意与官方 Agent 不同的一点是，官方的 Websocket URL 是从 HTTP URL 推导出来的，而第三方 Agent 可以自定义，所以你需要同时写

当然也支持 HTTPs 与 WSs，更改协议头即可

--terminal 为可选参数，若打开则启用 Terminal 功能 (WebSSH)

Komari 从入门到入土

手动安装
下载 Binary

找个文件夹放 Binary 与数据，这里还是以 /opt/komari 举例:

mkdir -p /opt/komari
cd /opt/komari

从 Release 获取对应系统、架构的 Binary 下载链接

需要注意的是，如果你的系统使用的并非 GlibC 运行库，请下载带有 musl 后缀的文件

后缀有 musl 字样的可以在任何 Linux 系统下运行

后缀有 gnu 字样的仅可以在较新的，通用的，带有 Glibc 的 Linux 系统下运行，占用会小一些

比如我是 Linux Arm64，复制出来下载链接长这样:

https://github.com/GenshinMinecraft/komari-monitor-rs/releases/download/latest/komari-monitor-rs-linux-aarch64-gnu

若机器环境无法访问到 Github，可以尝试在链接前加 https://ghfast.top/

随后使用 wget / cUrl 下载即可:

# 任选一个即可
wget -O ./komari-agent-rs [PASTE UR LINK HERE]
curl -o ./komari-agent-rs [PASTE UR LINK HERE]

给 Binary 添加可执行权限:

chmod +x ./komari-agent-rs

在 Binary 所在目录执行可执行文件，获取帮助信息:

./komari-agent-rs --help

成功输出即表示下载成功:

Komari 从入门到入土

构建执行命令

对于第三方 Agent，至少需要提供 3 个参数以正常运行，即主控 HTTP 地址、主控 WS 地址 和 Token

./komari-agent-rs --http-server "http://192.168.31.2:25774" --ws-server "ws://192.168.31.2:25774" -t "RSe6wsEcF7xTKblV"

请按照上面的格式，替换主端的 URL 以及上面获取的 Token

剩余的参数请通过 ./komari-agent-rs --help 获取:

  • --terminal: 开启 Terminal 功能 (WebSSH)，默认关闭以保证安全性
  • --terminal-entry <COMMAND>: Terminal 的可执行文件，默认在 Linux 下为 bash
  • --fake <F64>: 虚假倍率，主要功能之一，可接受小数点
  • --realtime-info-interval <MS>: 每隔多少 ms 上传一次信息，默认为 1000 ms
  • --ignore-unsafe-cert: 忽略通信证书验证

随后先在本地测试执行命令，保证其可以连接到主控，若输出类似下方即算完成:

Komari 从入门到入土

即可 Ctrl-C 直接停止

保活

这同样需要系统使用 SystemD，若不是，请自行寻找方法

cat <<EOF > /etc/systemd/system/komari-agent-rs.service
[Unit]
Description=Komari Monitoring Agent Service
After=network.target

[Service]
ExecStart=/opt/komari/komari-agent-rs --http-server "http://192.168.31.2:25774" --ws-server "ws://192.168.31.2:25774" -t "RSe6wsEcF7xTKblV"
WorkingDirectory=/opt/komari
Restart=always
User=root

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable komari --now

请自行替换其中的执行命令、执行目录

这是三条命令，直接执行即可，默认直接启动并打开开机自启 (记得替换必要的路径、端口等参数)

随后即可用 systemctl 管理该服务:

  • 开机自启：systemctl enable komari-agent-rs
  • 启动服务：systemctl start komari-agent-rs
  • 服务状态：systemctl status komari-agent-rs

安装之后

恭喜你，你已经完全设置了一个生产环境下的 Komari，接下来的操作是可选的，但能让你使用的体验大幅提高

安装主题

说到监控服务，界面美观是肯定需要的

若你以及看烦了官方的主题，开发者也提供了众多的主题给你使用:

https://komari-document.pages.dev/community/theme.html

Komari 从入门到入土

Komari 从入门到入土

展示的主题分别为 PurCarte 与 Mochi

我们以 Mochi 为例，展示如何安装主题:

来到主题的 Github Release，下载最新的主题包 (.zip 格式):

Komari 从入门到入土

随后来到 Komari 后台 设置-主题管理-上传主题-上传 zip 文件，成功后即可在主题列表切换到新主题:

Komari 从入门到入土

Komari 从入门到入土

一些主题还有丰富的可配置项目:

Komari 从入门到入土

效果如图:

Komari 从入门到入土

更换壁纸

默认的背景太单调了，确实

与众多的监控服务类似，Komari 提供了前端嵌入代码的方式，所以我们可以轻易地改变壁纸:

在后台 设置-站点-自定义-自定义头部 下，填入如下代码并保存:

    <style>
      body {
        /* 背景图片地址,替换成你喜欢的 */
        background-image: url("https://img.genmin.icu/117610969_p0.jpg");
        background-size: cover;
        background-position: center center;
        background-repeat: no-repeat;
        background-attachment: fixed;
      }
      .layout {
        background-color: transparent;
      }
    </style>

Komari 从入门到入土

效果如图:

Komari 从入门到入土

配置延迟监测

Komari 一大亮点即为支持延迟监测

选择 Ping 方式

Komari 现在支持三种 Ping 方式:

  • ICMP Ping: 最普通的，使用 ICMP 的 Ping
  • TCPing: 发送包到握手成功建立连接的延迟，需要 TCP 端口
  • Http Ping: 发送请求到收到回复的延迟，简单的可以理解为网页首页加载时间，这需要被测服务器有 HTTP 服务

一般来说，对于同一个服务器，ICMP Ping < TCPing < Http Ping

若你不清楚这三个的区别，请选择 ICMP Ping

选择 Ping 服务器

Ping 的目标地址可以是任何地址，不论是内网还是外网

比较常用的检测方式为测试到国内各个省份三网的 ICMP Ping 延迟

对于该种方式，可以到 https://tcping.wuxie.de/ 去寻找需要的地区的服务器

我们以 河南移动 为例:

Komari 从入门到入土

它提供了 IPv4 / IPv6 的检测地址，我们可以用 ICMP Ping / TCPing 来测试该网站提供的所有地址，但不可使用 Http Ping

对于河南移动，我们可以这样设置:

  • ICMP Ping v4: 111.7.88.239 / v4-ha-cm.oojj.de
  • ICMP Ping v6: 2409:8c44:b00:ff2f:3::7d0 / v6-ha-cm.oojj.de
  • TCPing v4: 111.7.88.239:80 / v4-ha-cm.oojj.de:80
  • TCPing v6: [2409:8c44:b00:ff2f:3::7d0]:80 / v6-ha-cm.oojj.de:80

当然，也不一定需要这里的地址，任何地址都是接受的

创建 Ping 任务

来到 Komari 后台 延迟监测-添加

Komari 从入门到入土

名称可自定义，比如我想监测 河南移动 V4，即可将这个作为名字

类型即为你选择的 Ping 方式，目标即为上面确定的地址

请注意，这两个选项必须匹配，比如 ICMP Ping 必须为单独的一个域名或者地址，不能带端口和协议头

随后可以选择服务器，可以为多个服务器同时配置监测服务:

20250913131348.png

随后填写间隔时间，不建议小于 30 sec，有可能会导致数据库过大 (特别是多服务器、多监测点、保存时间长的环境)

最终设置结果如图:

Komari 从入门到入土

保存即可

等待一定时间后，即可在主页的特定服务器下找到 延迟监测结果:

Komari 从入门到入土

关于结果保存

默认情况下，Komari 会保存 24 Hours 内的所有 Agent、所有监测点的上报数据

这会导致 Komari 数据库非常大

以 10 台被控机、每台机器三个地区的三网监测点 (共 9 个)、每 60 sec 测试一次、数据保存 7 天 这样的环境为例，需要使用约 181 MB 的硬盘空间

所以，你应该合理分配数据库保存时间、监测点数量、以及测试时间

关于数据库保存时间，可以在 Komari 后台 设置-通用-历史记录-Ping 数据保存时间 来设置:

Komari 从入门到入土

如果你恰巧财力雄厚，服务器磁盘大且不担心性能下降问题，7 Days = 168 Hours 是一个不错的选择

Komari 从入门到入土

当然我们贴心的 Komari 也给我们在 延迟监测 界面配上了预计的数据库使用量

请不要尝试设置类似于 每秒监测 的东西，不仅对自己磁盘有较大的读写负担，而且还有可能引起性能下降等问题

配置 OAuth 登录

OAuth 可使用第三方账号登录到 Komari，而不用输入 Komari 的账号密码

本文以 Github OAuth 为例，这需要你拥有一个 Github 账户

获取 Callback URL

来到 Komari 后台 设置-登录-单点登录，服务商选择 Github:

Komari 从入门到入土

下方有生成的 Callback 回调 URL，请复制备用

Github 设置

来到 Github Developers Settings，登陆账号后点击 New OAuth APP:

Komari 从入门到入土

名字、网址等自己填写，然后 Authorization callback URL 处填写上面复制的 Callback 回调 URL

Komari 从入门到入土

如图所示，填写完成后，点击 Register application 即可

此处的 Client ID 复制保存:

Komari 从入门到入土

然后点击 Generate a new client secret，此处可能被要求验证 totp 或密码

Komari 从入门到入土

输出的 Client Secret 请妥善保存，复制备用

配置 Komari

回到 Komari，将上面获取到的信息填写回后台并保存:

Komari 从入门到入土

记得打开 启用单点登录 的开关

不要着急退出，还需要绑定账号

来到 Komari 后台 账户-单点登录-绑定外部账户:

alt text

授权后，回到该界面，看到自己的账户被绑定成功即可:

alt text

测试登录

右上角登出 Komari 后，即可尝试使用 Github 登录到 Komari:

原创文章，作者：mantou，如若转载，请注明出处：https://v2ez.com/1646.html

赞 (0)
mantoumantou
0
上一篇 2026年4月22日
下一篇 2026年1月27日

相关推荐

发表回复

登录后才能评论