共计 3876 个字符,预计需要花费 10 分钟才能阅读完成。
在日常运维中,服务器监控是绕不开的核心环节。相比笨重的 Zabbix、Prometheus,KomariRocky Linux 上快速落地 Komari。
GitHub 项目地址:https://github.com/komari-monitor/komari
Komari 的核心亮点
-
轻量高效:Go 语言开发,资源占用极低。
-
自建可控:数据完全掌握在自己手里,避免第三方泄露风险。
-
Web 界面:开箱即用的可视化监控面板。
-
多种部署方式:支持一键脚本、Docker、二进制文件。

Rocky Linux 环境准备
本次环境系统使用的是 Rocky Linux9
-
更新系统
sudo dnf update -y
-
安装必要工具
sudo dnf install -y curl wget git
-
开放防火墙端口(默认 25774)
sudo firewall-cmd --permanent --add-port=25774/tcp
sudo firewall-cmd --reload
部署方式一:Docker 部署(推荐)
如果你习惯容器化,Docker 是更优雅的选择。
宝塔中部署 docker

# 安装 Docker(若未安装)
sudo dnf install -y dnf-plugins-core
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo dnf install -y docker-ce docker-ce-cli containerd.io
sudo systemctl enable --now docker
# 创建数据目录
mkdir -p /data/docker
# 启动容器
docker run -d \
-p 25774:25774 \
-v /data/docker/komari-data:/app/data \
--name komari \
ghcr.io/komari-monitor/komari:latest

查看默认账号密码:
docker logs komari
部署方式二:一键安装脚本(推荐)
Komari 官方提供了安装脚本,适合快速体验。
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
默认用户名和密码会在安装日志中显示,可通过环境变量 ADMIN_USERNAME 和 ADMIN_PASSWORD 自定义。
部署方式三:二进制文件
适合不想依赖容器的场景。
# 下载最新 release
wget https://github.com/komari-monitor/komari/releases/latest/download/komari-linux-amd64 -O komari
chmod +x komari
# 启动服务
./komari server -l 0.0.0.0:25774
# ./komari server -l 0.0.0.0:25774
2025/11/05 21:59:36 Komari Monitor 1.1.3 (hash: XXXXX)
2025/11/05 21:59:36 Using SQLite database file: ./data/komari.db
2025/11/05 13:59:36 Application timezone is set to 'UTC'.
2025/11/05 13:59:36 Default admin account created. Username: admin , Password: XXXXXXXXXXXXXXX
2025/11/05 13:59:36 Starting server on 0.0.0.0:25774 ...
2025/11/05 13:59:36 Using ipinfo.io as GeoIP provider.
访问与验证
浏览器打开:
http://< 服务器 IP>:25774
输入账号密码即可进入监控面板。此时你已经拥有一个轻量级、自建的服务器监控平台。

登录监控后台

添加节点

再点击编辑
记住令牌

Nginx 反向代理配置
安装 nginx,省略
编辑 Nginx 配置文件:
vi /etc/nginx/conf.d/komari.conf
写入以下内容(假设 Komari 运行在本地 25774 端口):
server {
listen 80;
server_name monitor.example.com;
location / {
proxy_pass http://127.0.0.1:25774;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
就可以使用域名访问 komari
Komari 客户端(Agent)安装指南
Komari 的客户端(Agent)需要安装在被监控的服务器或设备上,用于采集系统信息并上报到 Komari 主控端。安装方式主要有 Linux 二进制安装、Docker 部署 和 Windows 安装(WinSW 托管)
https://komari-document.pages.dev/install/quick-start
获取 Agent
-
GitHub Releases 页面:https://github.com/komari-monitor/komari-agent/releases
-
根据目标系统选择对应版本:
-
Linux:
komari-agent-linux-amd64 -
Windows:
komari-agent-windows-amd64.exe -
ARM 架构:
komari-agent-linux-arm64
-
Linux 客户端安装(推荐)
-
下载并赋权
wget https://github.com/komari-monitor/komari-agent/releases/latest/download/komari-agent-linux-amd64 -O komari-agent
chmod +x komari-agent
-
运行 Agent
./komari-agent -e http://< 主控端地址 >:25774 -t < 注册 Token>
-
-e指定 Komari 主控端地址 -
-t为主控端生成的注册 Token
-
后台运行(systemd)
vim /etc/systemd/system/komari-agent.service
写入:
[Unit]
Description=Komari Agent
After=network.target
[Service]
ExecStart=/usr/local/bin/komari-agent -e http://< 主控端地址 >:25774 -t < 注册 Token>
Restart=always
[Install]
WantedBy=multi-user.target
启用并启动:
sudo systemctl daemon-reload
sudo systemctl enable --now komari-agent
Docker 部署 Agent
docker run -d \
--name komari-agent \
ghcr.io/komari-monitor/komari-agent:latest \
-e http://< 主控端地址 >:25774 \
-t < 注册 Token>
Windows 客户端安装(WinSW 托管)
-
下载
komari-agent-windows-amd64.exe -
下载 ,重命名为
komari-agent.exe -
在同目录下创建
komari-agent.xml,内容示例:
<service>
<id>komari-agent</id>
<name>Komari Agent</name>
<description>Komari Windows Agent Service</description>
<executable>komari-agent-windows-amd64.exe</executable>
<arguments>-e http://<主控端地址 >:25774 -t < 注册 Token></arguments>
</service>
-
以管理员身份运行:
komari-agent.exe install
komari-agent.exe start
验证
-
登录 Komari Web 控制台
-
在 节点管理 中确认客户端是否上线
-
若未上线,检查防火墙端口、Token 是否正确

至此,你的 Komari 客户端已成功安装并接入主控端。
总结
如果你追求 轻量、可控、快速部署 的监控方案,Komari 是一个极具性价比的选择。无论是 一键脚本 还是 Docker 部署






