Komari 服务器监控系统完整安装教程

概述

Komari 是一款开源的服务器监控系统，支持多种部署方式。本教程将详细介绍 Komari 的各种安装方法，从最简单的快速安装到高级的手动编译，满足不同用户的需求。

方式一：快速安装（推荐新手）

使用一键管理脚本

适用于使用 systemd 的 Linux 发行版（Ubuntu、Debian、CentOS 等）：

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

执行完成后，访问 http://<你的服务器IP>:25774即可使用。

方式二：Docker 部署（推荐生产环境）

环境要求

已安装 Docker 的服务器
至少 1 核 CPU、512MB 内存
15GB 以上存储空间

安装步骤

安装 Docker（如果尚未安装）：

bash <(curl -sL get.docker.com)

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

在日志中查找类似信息：

Default admin account created. Username: admin , Password: 2ioEnIPwn17a

访问 Komari：
打开浏览器访问 http://<你的服务器IP>:25774，使用获得的用户名密码登录。

使用 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

方式三：二进制文件部署

步骤详解

下载二进制文件：
- 访问 GitHub Release 页面
- 根据系统选择对应文件：
  - Linux: komari_linux_amd64
  - Windows: komari_windows_amd64.exe
  - macOS: komari_darwin_amd64
设置执行权限（Linux/macOS）：

chmod +x komari

运行 Komari：

./komari server -l 0.0.0.0:25774

获取登录信息：
查看启动日志中的默认账号密码。
设置为系统服务（Linux）：
创建 /etc/systemd/system/komari.service：

[Unit]
Description=Komari Monitoring Service
After=network.target

[Service]
ExecStart=/path/to/komari server -l 0.0.0.0:25774
WorkingDirectory=/path/to/komari
Restart=always
User=root

[Install]
WantedBy=multi-user.target

启用服务：

sudo systemctl daemon-reload
sudo systemctl enable komari
sudo systemctl start komari

方式四：1Panel 部署

环境要求

已安装 1Panel 的服务器
配置不低于：1 核 CPU、512MB 内存
至少 15GB 存储空间

安装步骤

添加 Komari 到应用商店：

bash -c "$(curl -sSL https://1panel.komari.wiki/install.sh)"

同步并安装：
- 打开 1Panel 应用商店
- 点击「同步本地应用」
- 搜索「komari」并安装
配置参数：
- 自定义应用端口
- 设置后台账号密码
- 配置网络访问权限

方式五：手动编译安装

适用于开发者和高级用户

构建前端：

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

构建后端：

git clone https://github.com/komari-monitor/komari
cd komari
# 将前端构建产物复制到 public/dist 目录
CGO_ENABLED=1 go build -o komari

运行：

./komari server -l 0.0.0.0:25774

Agent 自动发现和批量部署

快速安装 Agent

Linux/macOS：

bash <(curl -sL https://raw.githubusercontent.com/komari-monitor/komari-agent/main/install.sh) \
  -e https://你的komari服务器地址 \
  --auto-discovery 你的自动发现密钥

Windows：

powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "iwr 'https://raw.githubusercontent.com/komari-monitor/komari-agent/main/install.ps1' -UseBasicParsing -OutFile 'install.ps1'; & '.\install.ps1' '-e' 'https://你的komari服务器地址' '--auto-discovery' '你的自动发现密钥'"

批量部署脚本示例

#!/bin/bash
KOMARI_SERVER="https://你的服务器地址"
AD_KEY="你的自动发现密钥"
SERVERS=("server1" "server2" "server3")

for server in "${SERVERS[@]}"; do
  echo "正在部署到 $server..."
  ssh root@$server "bash <(curl -sL https://raw.githubusercontent.com/komari-monitor/komari-agent/main/install.sh) -e $KOMARI_SERVER --auto-discovery $AD_KEY"
done

更新指南

Docker 方式更新

备份数据（在 Komari 面板中操作）
拉取最新镜像：

docker pull ghcr.io/komari-monitor/komari:latest

重启容器：

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

二进制方式更新

停止服务
替换二进制文件
重新启动服务

故障排除

常见问题

连接失败：检查防火墙和网络设置
证书错误：确认服务器证书有效性
权限问题：确保以管理员权限运行
服务启动失败：查看日志文件定位问题

日志查看

Docker 方式：

docker logs komari -f

系统服务方式：

journalctl -u komari -f
# 或
tail -f /var/log/komari-agent.log

安全建议

生产环境避免使用 --ignore-unsafe-cert参数
定期备份 data 目录
配置 HTTPS 或使用反向代理
限制不必要的网络访问

结语

Komari 提供了多种灵活的部署方式，从简单的 Docker 部署到高级的手动编译，满足不同场景的需求。建议新手从 Docker 方式开始，生产环境考虑使用系统服务方式确保稳定性。

无论选择哪种方式，Komari 都能为您提供强大的服务器监控能力。开始使用 Komari，让服务器监控变得简单高效！

本文档基于 Komari 官方文档整理，最新信息请参考 Komari 官方文档

Komari 安装教程

Komari 服务器监控系统完整安装教程

概述

方式一：快速安装（推荐新手）

使用一键管理脚本

方式二：Docker 部署（推荐生产环境）

环境要求

安装步骤

使用 docker-compose（可选）

方式三：二进制文件部署

步骤详解

方式四：1Panel 部署

环境要求

安装步骤

方式五：手动编译安装

适用于开发者和高级用户

Agent 自动发现和批量部署

快速安装 Agent

批量部署脚本示例

更新指南

Docker 方式更新

二进制方式更新

故障排除

常见问题

日志查看

安全建议

结语

忘却的旋律

分享文章

文章目录