当前位置：

社区首页

电脑数码

存储设备

网络存储

文章详情

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

1.1 Komari 简介
1.2 Komari主要功能
2.1 本地环境规划
2.2 本次实践介绍
3.1 检查Docker服务状态
3.2 检查Docker版本
3.3 检查docker compose 版本
5.1 创建部署目录
5.2 docker compose方式部署
5.3 创建Komari容器
5.4 查看Komari容器状态
5.5 查看初始登录密码
6.1 访问Komari首页
6.2 登录Komari
6.3 被控端操作
6.4 监控效果

一、Komari介绍

1.1 Komari 简介

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

1.2 Komari主要功能

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

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。

2.2 本次实践介绍

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

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

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

3.2 检查Docker版本

检查Docker版本

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

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

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

四、拉取Komari镜像

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

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

五、部署Komari服务

5.1 创建部署目录

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

5.2 docker compose方式部署

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

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文件，宿主机映射端口可自行设置，注意防止端口冲突。

vim docker-compose.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容器。

docker compose up -d在这里插入图片描述

在这里插入图片描述

5.4 查看Komari容器状态

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

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登录账号与初始密码。

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.

六、访问Komari服务

6.1 访问Komari首页

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

6.2 登录Komari

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

6.3 被控端操作

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

在被控端服务器中执行刚才复制的指令，如下所示：

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

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监控页，监控效果如下所示：

七、总结

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