komari-monitor/komari

Goss.akz.moe

A simple server monitor tool.

monitoringmonitoring-toolremote-control

主要指標

スター成長

スター

5.4k

フォーク

520

週間成長

—

Issue

2k4k

2025年5月2025年7月2025年9月2025年12月2026年2月2026年5月2026年7月

成果物Go Modulesgo get github.com/komari-monitor/komari

README

Komari

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

Komari is a lightweight, self-hosted server monitoring tool designed to provide a simple and efficient solution for monitoring server performance. It supports viewing server status through a web interface and collects data through a lightweight agent.

[!WARNING] Komari is a self-hosted monitoring and control program intended only for systems you own or are authorized to administer. Do not weaponize Komari, deploy it without consent, or use it for unauthorized access, persistence, command execution, or other abusive activity. For context on real-world abuse risks, see Huntress' analysis: Komari C2 agent abuse. Users are solely responsible for how they deploy and operate Komari. The developers do not accept responsibility for unauthorized or abusive use, or for any resulting consequences. On Windows, when remote control is enabled, the client displays a Windows notification at each user login to remind the user that Komari is remote control software.

Documentation | 文档(镜像站 By Geekertao) | Telegram Group

Features

Lightweight and Efficient: Low resource consumption, suitable for servers of all sizes.
Self-hosted: Complete control over data privacy, easy to deploy.
Web Interface: Intuitive monitoring dashboard, easy to use.

Quick Start

0. One-click Deployment with Cloud Hosting

Rainyun - CNY 4.5/month

1Panel App Store

Available on 1Panel App Store. Install via App Store > Utilities > Komari.

1. Use the One-click Install Script

Suitable for distributions using 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 Deployment

Create a data directory:
```
mkdir -p ./data
```

Run the Docker container:

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

View the default username and password:
```
docker logs komari
```
Access http://<your_server_ip>:25774 in your browser.

[!NOTE] You can also customize the initial username and password through the environment variables ADMIN_USERNAME and ADMIN_PASSWORD.

3. Binary File Deployment

Visit Komari's GitHub Release page to download the latest binary for your operating system.
Run Komari:
```
./komari server -l 0.0.0.0:25774
```
Access http://<your_server_ip>:25774 in your browser. The default port is 25774.
The default username and password can be found in the startup logs or set via the environment variables ADMIN_USERNAME and ADMIN_PASSWORD.

[!NOTE] Ensure the binary has execute permissions (chmod +x komari). Data will be saved in the data folder in the running directory.

Manual Build

Dependencies

Go 1.18+ and Node.js 20+ (for manual build)

Build the frontend static files:

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

Build the backend:
```
git clone https://github.com/komari-monitor/komari
cd komari
```
Copy the static files generated in step 1 to the /web/public/defaultTheme/dist folder in the root of the komari project, and copy komari-theme.json + preview.png/perview.png to /web/public/defaultTheme.
```
go build -o komari
```
Run:
```
./komari server -l 0.0.0.0:25774
```
The default listening port is 25774. Access http://localhost:25774.