Komari 是一款轻量级的自托管服务器监控工具

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

特性

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

快速开始

1. 使用一键安装脚本

适用于使用了 systemd 的发行版（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

2. Docker 部署

创建数据目录：
```
mkdir -p ./data
```

运行 Docker 容器：

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

查看默认账号和密码：
```
docker logs komari
```
在浏览器中访问 http://<your_server_ip>:25774。

Note

你也可以通过环境变量 ADMIN_USERNAME 和 ADMIN_PASSWORD 自定义初始用户名和密码。

3. 二进制文件部署

访问 Komari 的 GitHub Release 页面下载适用于你操作系统的最新二进制文件。
运行 Komari：
```
./komari server -l 0.0.0.0:25774
```
在浏览器中访问 http://<your_server_ip>:25774，默认监听 25774 端口。
默认账号和密码可在启动日志中查看，或通过环境变量 ADMIN_USERNAME 和 ADMIN_PASSWORD 设置。

Note

确保二进制文件具有可执行权限（chmod +x komari）。数据将保存在运行目录下的 data 文件夹中。

手工构建

依赖

Go 1.18+ 和 Node.js 20+（手工构建）

构建前端静态文件：

git clone https://github.com/komari-monitor/komari-web
cd komari-web
npm install
npm run build

构建后端：
```
git clone https://github.com/komari-monitor/komari
cd komari
```
将步骤1中生成的静态文件复制到 komari 项目根目录下的 /public/dist 文件夹。
```
go build -o komari
```
运行：
```
./komari server -l 0.0.0.0:25774
```
默认监听 25774 端口，访问 http://localhost:25774。

前端开发指南

Komari 主题开发指南 | Komari

在 Crowdin 上翻译 Komari

客户端 Agent 开发指南

Komari Agent 信息上报与事件处理文档

特性