概述

Komari 是一个轻量级自托管服务器监控工具：你在一台服务器上部署 Web 面板（Server），然后在需要监控的机器上运行 Agent 上报数据。适合：

• 需要自建监控面板、数据不想上云的人

• VPS 多台、想要一个“简单能用”的概览仪表盘

Komari 项目地址：

• https://github.com/komari-monitor/komari

官方文档：

• https://komari-document.pages.dev/（镜像：https://www.komari.wiki）

一,部署前准备（通用）

1,你需要一台“面板服务器”

• 一般选一台公网可访问的 VPS

• 系统建议：Ubuntu / Debian（教程以此为主）

• 确保你能用 SSH 登录，并有 sudo 权限

2,规划端口与域名（可选但推荐）

• Komari 默认端口：25774

• 若你要用域名访问：准备一个域名，并能添加 DNS 解析

• 防火墙/安全组：放行 25774/tcp（或你反代后的 80/443）

二,部署方式 ：一键安装脚本（最省事，适合 systemd 系发行版）

适用：Ubuntu、Debian 等使用 systemd 的系统。(Docker 部署与二进制部署可查看官方文档)

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

2,启动后如何拿到初始账号密码

• 根据 Komari README：默认账号密码会在启动日志中输出

• 如果脚本安装成 systemd 服务，常见查看方式：

sudo systemctl status komari --no-pager
# 或
sudo journalctl -u komari -n 200 --no-pager

3,访问面板

浏览器打开：

• http://<你的服务器IP>:25774

如果你能打开登录页，说明 Server 端已经跑起来了。

4,更新方式

• 连接服务器的 SSH 终端，在命令行输入下面的命令即可根据提示升级：

 sudo ./install-komari.sh

4,常见坑

• 打不开端口：检查云厂商安全组 + 本机防火墙（ufw/iptables）

• 访问慢：建议后面加 Nginx 反代 + HTTPS

三,添加服务器

• 进入后台，点击“服务器”→“添加节点”，可选填写节点名称，然后点击“添加节点”。

• 点击“一键部署指令”按钮，根据服务器类型和自身需求选择安装选项（建议勾选“禁用远程控制”）。

• 连接需要添加的服务器，通过 SSH 终端运行刚刚复制的命令。

• 返回前台，即可看到刚刚添加的机器。