Komari 是一款轻量级、自托管的服务器监控工具，通过一个 Web 界面集中展示被监控服务器的性能数据。它的部署方式非常灵活，支持 Docker、一键脚本、二进制文件等多种方式。本文将根据你的使用场景，介绍几种最主流的部署方案。

⚙️ 部署前准备

无论选择哪种方式，都需要先满足以下基础条件：

  • 一台服务器：用于安装 Komari 服务端（面板）。
  • 网络与端口：确保服务器的防火墙或安全组放行 25774 端口（默认），这是 Komari Web 界面的访问端口。
  • （可选）域名与 SSL：为了安全，强烈建议配置域名并开启 HTTPS 访问，避免敏感数据（如登录密码、Agent 通信令牌）在网络上明文传输。

🚀 部署方式一：Docker 部署（推荐）

这是官方推荐且最通用的方式，适合大多数用户，尤其适合熟悉容器化技术的场景。

1. 使用 Docker CLI 快速启动

这是最快的启动方式，只需一行命令。建议将数据持久化到宿主机目录，避免容器重建后配置丢失。

1
2
3
4
5
6
7
8
9
10
11
12
13
# 1. 创建数据存储目录
mkdir -p ./komari-data

# 2. 运行容器
docker run -d \
  --name komari \
  --restart unless-stopped \
  -p 25774:25774 \
  -v $(pwd)/komari-data:/app/data \
  ghcr.io/komari-monitor/komari:latest

# 3. 查看默认的管理员密码（首次启动时会生成）
docker logs komari

中国大陆用户加速：如果拉取镜像较慢，可以将镜像地址 ghcr.io/komari-monitor/komari:latest 替换为 ghcr.1ms.run/komari-monitor/komari:latest（1ms.run 加速镜像）。

2. 使用 Docker Compose（便于管理）

如果你习惯使用 docker-compose 管理服务，可以创建一个 docker-compose.yml 文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
services:
  komari:
    image: ghcr.io/komari-monitor/komari:latest
    container_name: komari
    restart: unless-stopped
    ports:
      - "25774:25774"
    volumes:
      - ./data:/app/data
    environment:
      # 可选：通过环境变量预设管理员账户，避免首次查看日志
      - ADMIN_USERNAME=admin
      - ADMIN_PASSWORD=你的强密码

在文件所在目录执行 docker compose up -d 启动服务。

🛠 部署方式二：一键脚本部署（Linux）

如果你不希望依赖 Docker，可以使用官方提供的一键安装脚本。此方式适用于 systemd 系统（如 Ubuntu、Debian、CentOS）。

  1. 下载并执行脚本：

    1
    2
    3
    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. 跟随提示：脚本会自动完成安装，并将 Komari 注册为系统服务。安装完成后，脚本会输出默认的管理员账号和密码，请注意保存。

⚙️ 部署方式三：二进制文件（高级用户）

对于追求极致控制或不想安装 Docker 的用户，可以直接下载并运行二进制文件。

  1. 下载二进制文件：从 Releases 页面 下载对应系统架构的最新版本（如 komari-linux-amd64）。

  2. 赋予执行权限并启动：

    1
    2
    3
    wget https://github.com/komari-monitor/komari/releases/latest/download/komari-linux-amd64 -O komari
    chmod +x komari
    ./komari server -l 0.0.0.0:25774

    启动后，日志中会显示初始的管理员账号密码。

☁️ 部署方式四：Railway 一键部署（无需服务器）

对于不想管理服务器、追求极简部署的用户，可以使用 Railway 平台的一键部署功能。

  1. 访问 Railway 上的 Komari 部署模板。
  2. 点击 Deploy Now 按钮，并授权 Railway 连接你的 GitHub 账号。
  3. 关键配置：在部署界面，务必设置环境变量 ADMIN_USERNAME 和 ADMIN_PASSWORD（这是你的登录凭证）。
  4. Railway 会自动处理构建、网络和持久化存储（挂载到 /app/data）。部署完成后，平台会生成一个可供访问的域名。

📊 配置监控节点（Agent）

面板部署成功后，接下来需要添加被监控的服务器节点。

  1. 登录面板：在浏览器中访问 http://你的服务器IP:25774，使用管理员账号登录。
  2. 获取安装命令：进入后台的 节点列表，点击 新增节点，为节点起一个便于识别的名字。保存后，点击节点旁的 ↓ 按钮，即可获得一条 Agent 一键安装命令。
  3. 安装 Agent：在需要被监控的目标服务器上，以 root 权限 运行你复制的那条命令。命令中已包含了面板地址和通信令牌。
  4. 验证状态：片刻后，面板上的节点状态应变为在线，并开始显示 CPU、内存等监控数据。

🔒 安全建议

  • 使用 HTTPS：如果通过公网访问面板，强烈建议使用 Nginx 或 Caddy 配置反向代理并开启 HTTPS。Komari 的通信包含敏感信息，明文传输风险极高。
  • 设置强密码：部署时务必通过环境变量修改默认的管理员密码。
  • 最小权限运行 Agent：Agent 仅需读取系统监控数据的权限（如 /proc、/sys），不需要 root 权限。建议创建专用非特权用户来运行 Agent 服务。

更详细的配置、主题更换和插件使用方法，请参考 Komari 官方文档。