Komari 是什么?

Komari 是什么?

Komari 是一款轻量级的自托管服务器监控工具(server monitoring tool),开源免费,基于 Go 和 Node.js 开发。它可以帮助你监控服务器性能(如 CPU、内存、磁盘、网络等),支持 Web 界面查看数据,并通过轻量级 Agent 收集远程服务器信息。资源占用低(内存 <50MB),适合个人开发者或小型团队监控 VPS、多台服务器。项目 GitHub:https://github.com/komari-monitor/komari,官方文档:https://komari-document.pages.dev/。

注意:从搜索结果看,这不是 Discord bot(虽然有同名 bot,但你的问题更偏向服务器监控)。如果是指 Discord 的 Komari bot,请澄清,我可以补充说明。

如何使用 Komari?

Komari 的使用分为两个部分:部署主控面板(监控中心)和添加 Agent(监控远程服务器)。部署后,通过浏览器访问 Web 界面(默认端口 25774)进行管理。以下是快速上手指南,支持 Linux 系统(推荐 Ubuntu/CentOS),其他系统可参考文档。

1. 部署主控面板(安装 Komari)

有三种方式:一键脚本(推荐新手)、Docker 或二进制文件。安装后会生成默认账号密码(admin + 随机密码)。

  • 一键脚本安装(最简单,5 分钟搞定):
  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
  • 安装完成后,查看日志获取密码:docker logs komari(或类似命令,输出中会有 “Username: admin, Password: xxxxx”)。
  • 访问:http://你的服务器IP:25774(替换为你的 IP)。用默认账号登录。
  • Docker 安装(如果已安装 Docker):
  mkdir -p ./data  # 创建数据目录
  docker run -d \
    -p 25774:25774 \
    -v $(pwd)/data:/app/data \
    --name komari \
    --restart unless-stopped \
    ghcr.io/komari-monitor/komari:latest
  docker logs komari  # 查看密码
  • Docker Compose 示例(创建 docker-compose.yml 文件): version: '3.8' services: komari: image: ghcr.io/komari-monitor/komari:latest container_name: komari ports: - "25774:25774" volumes: - ./data:/app/data restart: unless-stopped 运行:docker-compose up -d
  • 二进制安装(无 Docker 环境):
  • 从 GitHub Release 下载对应系统的二进制文件(https://github.com/komari-monitor/komari/releases)。
  • 解压并赋予权限:chmod +x komari
  • 运行:./komari(数据保存在当前目录的 data 文件夹)。

登录与基本使用

  • 浏览器访问 http://IP:25774,登录后进入仪表盘。
  • 功能包括:实时监控图表、告警设置、API 接口、终端访问(需 Agent 支持)。
  • 自定义:可在环境变量中设置初始密码,如 ADMIN_PASSWORD=yourpassword
  • 常见问题:如果登录失败,检查终端输出密码(避免复制多余字符);端口被占?改 -p 你的端口:25774

2. 如何添加服务器(监控远程服务器)?

Komari 通过安装 Agent(轻量客户端)来监控其他服务器。Agent 会将数据上报到主控面板。步骤如下:

  • 在主控面板添加服务器
  1. 登录 Web 界面 > 导航到 “服务器列表” 或 “Agents” 页面。
  2. 点击 “添加服务器” 或 “New Agent”,系统会生成一个专属 Token(令牌)和安装命令(类似一键脚本)。
    • 示例命令(从面板复制,替换你的主控地址和 Token):
      curl -fsSL https://raw.githubusercontent.com/komari-monitor/komari/main/install-agent.sh -o install-agent.sh chmod +x install-agent.sh sudo ./install-agent.sh --http-server "http://你的主控IP:25774" --token "生成的Token"
  3. 在目标服务器(要监控的机器)上运行这个命令。Agent 会自动连接主控。
  • 验证连接
  • 返回主控面板 “服务器列表”,新服务器状态应为 “在线”。
  • 如果无 root 权限,参考文档:https://komari-document.pages.dev/faq/agent-no-root.html(使用非 root 模式)。
  • 第三方 Agent 示例(Rust 版,更高效):
    如果官方 Agent 不够用,可用 komari-monitor-rs:
  wget -O setup-client-rs.sh "https://raw.githubusercontent.com/GenshinMinecraft/komari-monitor-rs/main/install.sh"
  chmod +x setup-client-rs.sh
  bash setup-client-rs.sh --http-server "http://你的主控IP:25774" --ws-server "ws://你的主控IP:25774" --token "生成的Token"

支持额外选项如 --terminal(启用远程终端)。

高级配置

  • Nginx 反向代理(推荐生产环境,加 HTTPS):
  • 安装 Nginx,编辑 conf 文件:
    server { listen 80; server_name your-domain.com; location / { proxy_pass http://127.0.0.1:25774; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }
  • 运行 nginx -s reload。用 Certbot 加 SSL。
  • 告警与通知:面板支持邮件/微信/离线通知设置。
  • 资源监控:Agent 自动收集 CPU/内存/网络数据,面板实时图表显示。

如果部署中遇到问题(如端口冲突、Docker 未安装),查看日志 docker logs komari 或官方 FAQ。Demo 站点(临时):https://komari.akz.moe(账号: admin,密码: azVlSV80dhM6),但别在 Demo 上加敏感 Agent。

如果这是指 Discord bot 的 Komari(用于服务器管理、语音频道等),添加方式是:访问 https://top.gg/bot/810501287903756291 > 点击 “Add to Server” > 选择你的 Discord 服务器 > 授权权限。告诉我更多细节,我可以细化!

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注