Komari

简体中文 | 繁體中文 | 日本語

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

特性

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

快速开始

0. 云托管一键部署

• 雨云 - 4.5元/月

• 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。

[!NOTE] 您也可以通过环境变量 ADMIN_USERNAME 和 ADMIN_PASSWORD 自定义初始用户名和密码。

3. 二进制文件部署

1. 访问 Komari 的 https://github.com/komari-monitor/komari/releases%EF%BC%8C%E4%B8%8B%E8%BD%BD%E9%80%82%E7%94%A8%E4%BA%8E%E6%82%A8%E6%93%8D%E4%BD%9C%E7%B3%BB%E7%BB%9F%E7%9A%84%E6%9C%80%E6%96%B0%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%E3%80%82
2. 运行 Komari：

./komari server -l 0.0.0.0:25774

3. 在浏览器中访问 http:// :25774。默认端口为 25774。
4. 默认用户名和密码可在启动日志中查看，或通过环境变量 ADMIN_USERNAME 和 ADMIN_PASSWORD 进行设置。

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

手动构建

依赖项

• 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 Theme Development Guide | Komari

客户端代理开发指南

Komari Agent Information Reporting and Event Handling Documentation

贡献

欢迎提交 Issues 和 Pull Requests！

致谢

破碎工坊云

破碎工坊云 - 专业云计算服务平台，提供高效、稳定、安全的高防服务器与CDN解决方案

DreamCloud

DreamCloud - 极高性价比解锁直连亚太高防

🚀 Sponsored by SharonNetworks

SharonNetworks 为您的业务起飞保驾护航！

亚太数据中心提供顶级的中国优化网络接入 · 低延时&高带宽&提供Tbps级本地清洗高防服务, 为您的业务保驾护航, 为您的客户提供极致体验. 加入社区 ***群组 可参与公益募捐或群内抽奖免费使用

开源软件社区

所有提交 PR 和创建主题的开发者

Star 历史