Komari 探针教程：功能、用途与一键安装，一台面板机管所有 VPS

这期讲 Komari——一个轻量自托管的服务器监控工具，功能全、占用低、中文友好、还支持网页终端和主题美化。本教程从”它是什么、有什么用”讲到”一键安装 + 接入所有 VPS”，保姆级，看完就能跑起来。

快手上手（一分钟先跑起来）

环境是 Ubuntu / Debian（systemd 系），服务端三行命令：

# 1. 下载一键安装脚本并执行
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

装完浏览器访问 http://<你的IP>:25774 就能看到 Komari 仪表盘。之后在面板里加 Agent 监控其他机器即可。

用 Docker 的话更简单（见第五节），一条 docker run 就起服务。

一、Komari 是什么

Komari 是一款轻量级、自托管的服务器监控工具。核心就两块：

• 服务端（Web 面板）：跑在一台”面板机”上，负责展示数据、管理被监控的服务器（Agent）;
• 轻量 Agent：装在被监控的每台服务器上，采集 CPU/内存/磁盘/网络/进程等指标并上报。

它的几个定位关键词：

1. 实时：数据秒级更新，直观看到服务器当下状态。
2. 轻量：占用极低，多少配置的服务器都能跑，不会拖累面板机。
3. 自托管：数据完全在你自己的机器上，不依赖第三方云监控，隐私可控。
4. Web 界面：开箱即用的监控仪表盘，上手无门槛。
5. 可扩展：支持自定义主题、插件，能美化也能增功能。

二、Komari 的核心功能

三、用途：它适合谁

• 多台 VPS 的集中管理：一台面板机管所有机器，打开网页看全局，不用逐台登录。
• 可视化监控看板：把服务器状态做成一个随时能看的仪表盘，个人或团队都适用。
• 故障告警：磁盘满、负载高、掉线这类问题，配置通知后第一时间收到提醒。
• 隐私优先 / 自托管：不想把监控数据交给第三方云平台，数据自己握着。
• 搭配”面板机”方案：很多玩 VPS 的人会专门开一台最低配机器当探针面板，其余机器装 Agent——低成本、效果好。

和其他探针怎么选（帮你决策）：

判断：要”实时状态 + 终端 + 美化” → Komari；只要”极简监控 + 宕机提醒” → 哪吒；主要关心”网站/端口还活着吗” → Uptime Kuma。 三者都自托管，可按需选，也可组合。

四、安装前置准备

• 一台”面板机”：跑服务端，任意低配 VPS 即可（Komari 很轻）。
• 要监控的机器：每台装一个 Agent（可多台，可无 root 运行）。
• 开放端口：服务端默认端口 25774。若面板机有防火墙 / 云安全组，请放行该 TCP 端口。
• 域名（可选）：想让面板用 HTTPS 域名访问，看第五节的”反代”。

五、安装教程

方式 1：一键管理脚本（Ubuntu / Debian / systemd 系）

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

脚本会安装服务端并注册为 systemd 服务（开机自启）。装完后浏览器访问 http://<你的IP>:25774。

方式 2：Docker（推荐，更省心）

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

• -p 25774:25774：映射服务端口（如需改端口，改这一处）。
• -v $(pwd)/data:/app/data：把数据挂到宿主机，避免容器重建丢数据。
• --restart unless-stopped：开机自启、崩溃自动拉起。

启动后 docker logs komari 看日志，访问 http://<你的IP>:25774。

5.3 验证服务端

• 浏览器打开 http://<你的IP>:25774 能看到登录/仪表盘界面即成功。
• 若打不开：① 确认进程在跑（systemctl status komari 或 docker ps）；② 确认 25774 已放行；③ 面板机是否被云平台安全组拦截。

5.4 接入被监控的服务器（Agent）

在 Komari 面板里添加 Agent（被监控机）。要点：

• 自动发现：支持在本机自动发现 Agent，批量添加省事。
• 无 root 运行：需要的话 Agent 可以不用 root 权限运行，更安全。
• 每台被监控机装好 Agent 后，会在面板显示该机的实时指标（CPU/内存/磁盘/网络等）。

实操：先在面板里”添加服务器”，拿到对应的 Agent 安装命令/令牌，再到被监控机上执行。

5.5 常用配置

• 换端口：改服务端口后，同步更新防火墙与访问地址。
• Nginx 反向代理 + HTTPS：把 http://IP:25774 挂到自己的域名上，并配置 SSL——生产环境强烈建议，避免裸暴露端口。
• 通知告警：在”通知”里配置渠道（如 Gmail，社区也有教程），遇异常时推送。
• 安全设置：面板内置重置密码、强制取消 2FA、强制允许密码登录、禁用 SSH等选项；建议开启 2FA。
• 卸载 Agent：不需要时可在面板端卸载被监控机上的 Agent。

六、上手使用：从面板看什么

• 主页仪表盘：一眼看到所有节点的实时状态与关键指标。
• 后台仪表盘：管理维度更全，含配置与安全项。
• 历史图表：看资源的时序变化，定位”什么时候、为什么”异常。
• 网页终端：浏览器里直接操作服务器，省去来回 SSH。
• 主题市场 / 自定义主题：让面板更顺手、更好看。

七、常见问题 FAQ

Q1：Komari 和哪吒 (Nezha) 怎么选？
A：要”资源监控 + 网页终端 + 主题美化”选 Komari；只要”极简监控 + 宕机提醒”选哪吒；主打”网站/服务存活检测”用 Uptime Kuma。三者自托管，可按需组合。

Q2：Agent 一定要 root 吗？
A：不需要。Komari 支持无 root 运行 Agent（更安全）。需要完整权限的操作需按官方说明配置。

Q3：服务端要多少配置？
A：Komari 很轻，低配 VPS 即可当面板机。它强调”轻量高效”，对面板机要求很低。

Q4：端口 25774 打不开 / 连不上怎么办？
A：① 确认进程在运行；② 确认 Linux 防火墙（ufw/firewalld）和云平台安全组都放行了 25774；③ 用 IP 而非 127.0.0.1 访问；④ 端口被改过就同步改访问地址。

Q5：能只装一套，监控很多台吗？
A：可以。一台面板机装服务端，其余每台装一个 Agent，就能在一个面板里集中监控，这就是它最大的用途之一。

Q6：面板数据会丢吗？
A：Docker 部署时务必把数据目录挂出来（-v $(pwd)/data:/app/data），否则容器重建会丢。数据默认存本地、不传第三方。

Q7：怎么自定义主题 / 装插件？
A：通过”主题市场”下载主题，或自定义主题；插件同理，可在扩展能力上按需添加。

Q8：忘记了面板密码怎么办？
A：用官方提供的”重置密码”功能恢复，或重置后重新登录，建议开启 2FA 加强安全。

八、注意事项与安全

1. 自托管警示：Komari 能执行命令，只部署在你拥有或已授权的服务器上，勿用于未授权监控或滥用。
2. 生产环境走 HTTPS：用 Nginx 反代 + 域名 + SSL，别把 25774 裸暴露到公网。
3. 默认端口放行有讲究：如只在本机/内网用，可限制来源 IP，减小暴露面。
4. 数据备份：Docker 的数据目录记得挂载、备份，防止重建丢数据。
5. 变更前看文档：涉及端口、安全、通知、SSO 等配置，以官方文档（komari.wiki）为准。

结语

Komari 是那种”上手 5 分钟、长期省时间”的探针：一个面板机 + 多台轻量 Agent = 所有 VPS 的状态都在一个网页里，还附带网页终端、通知告警、主题美化这些实用功能。对多机玩家来说，性价比很高。

如果这篇教程帮你跑起来了，记得把面板放行的端口和反向代理做好——能用 HTTPS 就别裸奔。更多服务器相关的真实测评与线路/性能实测，关注 DigWall。

站内相关阅读

哪吒监控（Nezha）搭建教程：一台面板机管所有 VPS（保姆级）

手里三五台 VPS 的兄弟，最头疼的就是"每台都登进去看负载"——今天这台 CPU 爆了、明天那台磁盘满了，全靠手动。哪吒监控（Nezha）就是解决这个问题的：一台机器装面板，其余

VPS 测试脚本使用指南：从硬件性能、网络线路到 IP 质量

一句话结论：测 VPS 不要按"脚本一二三"逐个跑，而是先想清楚你要测什么——综合体检选 NodeQuality 或 LemonBench，硬件跑分选 YABS，线路回程看 Nex

中国互联网“出国线路”完全科普：163、CN2、4837、9929、CMI、CMIN2 到底是什么？

一句话结论：所谓"出国线路"不是一根从中国直通海外的固定网线，而是接入网、国内骨干网、国际出入口、境外骨干网和目的网络共同组成的一次实际路由。判断线路不能只看商家标签，也不能只认某