






# 一、Komari介绍








## 1.1 Komari 简介

>`Komari` 是一款轻量级、自托管的服务器监控工具，专为追求简洁高效与数据隐私的用户设计。它通过在被监控服务器上运行一个轻量级代理程序，实时采集系统性能数据，并通过美观直观的网页界面集中展示，帮助用户轻松掌握服务器运行状态。无论是个人开发者、小型团队还是资源受限的边缘设备，Komari 都能提供低开销、高可用的监控体验。



## 1.2 Komari主要功能

- **轻量高效**：代理程序资源占用极低，对系统性能影响微乎其微，适用于从树莓派到生产级服务器的各种环境。
- **完全自托管**：所有数据存储和处理均在本地完成，无需依赖第三方服务，保障数据安全与隐私。
- **直观网页仪表板**：提供清晰易读的可视化界面，实时展示 CPU、内存、磁盘、网络等关键指标。
- **简易部署**：支持一键安装或容器化部署（如 Docker），配置简单，快速上线。
- **多服务器支持**：可同时监控多台主机，统一管理，一目了然。
- **开源透明**：代码开放，社区驱动，便于审计、定制与扩展。


















# 二、本次实践规划
## 2.1 本地环境规划
>本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。


|hostname| IP地址  | 操作系统版本   |Docker版本   |部署项目|备注
|--|--| --|  --|--|--|
|jeven |192.168.3.88  | Ubuntu 24.04.2 LTS| 28.5.0   | Komari   |  ——


## 2.2 本次实践介绍
>1.本次实践部署环境为个人测试环境，生产环境请谨慎；
>2.在Docker环境下部署Komari轻量级监控工具。





# 三、本地环境检查

## 3.1 检查Docker服务状态
>检查Docker服务是否正常运行，确保Docker正常运行。



```bash
root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Tue 2025-12-02 00:51:31 CST; 1min 11s ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 75393 (dockerd)
      Tasks: 32
     Memory: 34.1M (peak: 34.8M)
        CPU: 1.248s
     CGroup: /system.slice/docker.service
```
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/abb255efc952dabcb17c36c31c1cd133.png)




## 3.2  检查Docker版本
>检查Docker版本

```bash
root@jeven:~# docker -v
Docker version 28.5.0, build 887030f
```


## 3.3 检查docker compose 版本
>检查Docker compose版本，确保2.0以上版本。


```bash
root@jeven:~# docker compose version
Docker Compose version v2.39.4

```


# 四、拉取Komari镜像



>下载Komari镜像，镜像名称为：`registry.cn-hangzhou.aliyuncs.com/jeson/journiv-app:main`。



```bash
docker pull registry.cn-hangzhou.aliyuncs.com/jeson/komari:1.1.3
```





![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/8f83b012904a60e54fe07fcb399ca4b6.png)











# 五、部署Komari服务

## 5.1 创建部署目录
- 创建部署目录

```bash
mkdir -p /data/komari/data && cd  /data/komari
```



## 5.2 docker compose方式部署


>使用docke-cli方式部署，DOMAIN_NAME注意改为自己IP。

```bash
docker run -d \
  -p 25774:25774 \
  -v $(pwd)/data:/app/data \
  --name komari \
  registry.cn-hangzhou.aliyuncs.com/jeson/komari:1.1.3


```


>新建及编辑docker-compose.yaml文件，宿主机映射端口可自行设置，注意防止端口冲突。

```bash
vim docker-compose.yaml
```

```yaml
version: '3'

services:
  komari:
    image:  registry.cn-hangzhou.aliyuncs.com/jeson/komari:1.1.3
    container_name: komari
    restart: always
    ports:
      - 25774:25774
    volumes:
      - /data/komari/data:/data
 

```



## 5.3 创建Komari容器

>执行以下命令，创建Komari容器。


```bash
docker compose up -d
```



![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/4492f2fbff3affe5d56fbaf6039a399b.png)












## 5.4 查看Komari容器状态
>检查Komari容器运行状态，确保Komari容器正常启动。

```bash
root@jeven:/data/komari#  docker compose ps
WARN[0000] /data/komari/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
NAME      IMAGE                                                  COMMAND                SERVICE   CREATED         STATUS         PORTS
komari    registry.cn-hangzhou.aliyuncs.com/jeson/komari:1.1.3   "/app/komari server"   komari    4 minutes ago   Up 4 minutes   0.0.0.0:25774->25774/tcp, [::]:25774->25774/tcp
```









## 5.5 查看初始登录密码

>检查容器运行日志，确保Komari服务正常运行。同时，我们通过容器查看到Komari登录账号与初始密码。




```bash
root@jeven:/data/komari# docker compose logs
WARN[0000] /data/komari/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
komari  | 2025/12/07 16:25:16 Komari Monitor 1.1.3 (hash: b62fb1f70889fc1ac94e7c58ed928d7a27df5d09)
komari  | 2025/12/07 16:25:16 Using SQLite database file: /app/data/komari.db
komari  | 2025/12/07 16:25:16 Application timezone is set to 'UTC'.
komari  | 2025/12/07 16:25:16 Default admin account created. Username: admin , Password: WmG0lKGkkaDw
komari  | 2025/12/07 16:25:16 Starting server on 0.0.0.0:25774 ...
komari  | 2025/12/07 16:25:16 Using ipinfo.io as GeoIP provider.
```



![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/c5f4bf39f7959625715252e84134bfd2.png)




# 六、访问Komari服务
## 6.1 访问Komari首页





>浏览器地址： `http://<个人的服务器IP>:25774`，访问Komari初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/a969b238d67de09cfa130f300c5c0d4c.png)

## 6.2 登录Komari


>使用刚才查询到的账号密码，登录Komari。


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/b5d50221cb9bb9ee1d10db70c106297e.png)
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/41eade2e6d21fd38a15a694cfd4b6868.png)
## 6.3 被控端操作

>在节点列表新增服务器，获取被控端一键部署指令。

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/1f693c31cbf57a50fa89ed3ef3d8ac0d.png)
>在被控端服务器中执行刚才复制的指令，如下所示：


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/65f9fdd422e6e738d1d572479a228ee0.png)


>如果下载脚本过慢，则可以使用docker方式部署：

```yaml
services:
  komari-agent:
    image: registry.cn-hangzhou.aliyuncs.com/jeson/komari-agent
    container_name: komari-agent
    network_mode: host
    restart: unless-stopped
    dns:
      - 8.8.8.8            # Google DNS
      - 114.114.114.114    # 114 DNS
    command: >
      --endpoint=http://192.168.3.88:25774
      --token=kfEgMmLV3AAF0RHHU0XoVS
      --interval=1
      --info-report-interval=5
      --reconnect-interval=5
      --max-retries=3
      --disable-auto-update
      --ignore-unsafe-cert
```

## 6.4 监控效果

>回到Komari监控页，监控效果如下所示：

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/e2980cee753e4c6c2460ca536b716dc2.png)
# 七、总结

>通过本次实战，我们成功使用 Docker 快速部署了 Komari 轻量级服务器监控工具，整个过程简洁高效，充分体现了其“轻量、自托管、易用”的核心优势。Komari 不仅资源占用低，还提供了直观的 Web 界面，便于实时掌握服务器运行状态。借助 Docker Compose 编排，服务的部署与管理变得极为便捷，适合个人开发者和小型团队快速搭建私有监控系统。未来可进一步探索其多节点监控、告警集成等高级功能，提升运维效率。



Komari 是一款轻量级、自托管的服务器监控工具，专为追求简洁高效与数据隐私的用户设计。它通过在被监控服务器上运行一个轻量级代理程序，实时采集系统性能数据，并通过美观直观的网页界面集中展示，帮助用户轻松掌握服务器运行状态。无论是个人开发者、小型团队还是资源受限的边缘设备，Komari 都能提供低开销、高可用的监控体验。

运维新宠：基于Docker的Komari轻量监控实战指南

运维

开发工具

云计算

Komari是一款轻量级自托管服务器监控工具，支持Docker快速部署，提供CPU、内存、磁盘等实时监控。开源透明、资源占用低，适合个人开发者和小型团队搭建私有监控系统，保障数据安全与隐私。

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

运维新宠：基于Docker的Komari轻量监控实战指南-腾讯云开发者社区-腾讯云

运维新宠：基于Docker的Komari轻量监控实战指南

运维新宠：基于Docker的Komari轻量监控实战指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐