komari-monitor/komari
GitHub: komari-monitor/komari
一个轻量、自托管的服务器监控工具，通过低资源消耗的 agent 采集数据并提供直观的 Web 仪表盘。
Stars: 4631 | Forks: 433
# Komari
[](https://deepwiki.com/komari-monitor/komari)
[简体中文](./docs/README_zh.md) | [繁體中文](./docs/README_zh-TW.md) | [日本語](./docs/README_ja.md)
Komari 是一个轻量级、自托管的服务器监控工具，旨在提供一个简单高效的解决方案来监控服务器性能。它支持通过 Web 界面查看服务器状态，并通过轻量级的 agent 收集数据。
[文档](https://komari-document.pages.dev/) | [文档(镜像站 By Geekertao)](https://www.komari.wiki) | [Telegram 群组](https://t.me/komari_monitor)
## 特性
- **轻量且高效**：资源消耗低，适合各种规模的服务器。
- **自托管**：完全掌控数据隐私，部署简单。
- **Web 界面**：直观的监控仪表盘，易于使用。
## 快速开始
### 0. 云主机一键部署
- 雨云 (Rainyun) - 每月 4.5 元
[](https://app.rainyun.com/apps/rca/store/6780/NzYxNzAz_)
- 1Panel 应用商店
可在 1Panel 应用商店中获取。通过 **应用商店 > 实用工具 > Komari** 进行安装。
### 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 部署
1. 创建数据目录：
mkdir -p ./data
2. 运行 Docker 容器：
docker run -d \
-p 25774:25774 \
-v $(pwd)/data:/app/data \
--name komari \
ghcr.io/komari-monitor/komari:latest
3. 查看默认用户名和密码：
docker logs komari
4. 在浏览器中访问 `http://:25774`。
### 3. 二进制文件部署
1. 访问 Komari 的 [GitHub Release 页面](https://github.com/komari-monitor/komari/releases) 下载适用于您操作系统的最新二进制文件。
2. 运行 Komari：
./komari server -l 0.0.0.0:25774
3. 在浏览器中访问 `http://:25774`。默认端口为 `25774`。
4. 默认用户名和密码可以在启动日志中找到，也可以通过环境变量 `ADMIN_USERNAME` 和 `ADMIN_PASSWORD` 进行设置。
### 手动构建
#### 依赖项
- Go 1.18+ 和 Node.js 20+（用于手动构建）
1. 构建前端静态文件：
git clone https://github.com/komari-monitor/komari-web
cd komari-web
npm install
npm run build
2. 构建后端：
git clone https://github.com/komari-monitor/komari
cd komari
将步骤 1 中生成的静态文件复制到 `komari` 项目根目录下的 `/public/defaultTheme/dist` 文件夹中，并将 `komari-theme.json` + `preview.png`/`perview.png` 复制到 `/public/defaultTheme`。
go build -o komari
3. 运行：
./komari server -l 0.0.0.0:25774
默认监听端口为 `25774`。访问 `http://localhost:25774`。
## 前端开发指南
[Komari 主题开发指南 | Komari](https://komari-document.pages.dev/dev/theme.html)
## 客户端 Agent 开发指南
[Komari Agent 信息上报与事件处理文档](https://komari-document.pages.dev/dev/agent.html)
### 开源软件社区
感谢所有提交 PR 和创建主题的开发者
## Star 历史
[](https://www.star-history.com/#komari-monitor/komari&Date)
标签：1Panel, Agent代理, EVTX分析, IT运维, LangChain, MITM代理, Socks5代理, Web仪表盘, 主机监控, 可视化面板, 开源, 性能监控, 无线安全, 日志审计, 服务器状态, 私有化部署, 自托管, 请求拦截, 资源监控, 轻量级, 运维工具, 防御规避