Komari 探针与服务器监控搭建指南

┌─────────────────────────────────────────────────────────────┐
│ 🖥️ 主控面板 (Master)：Docker 极简运行                        │
│    - 单二进制引擎 + 内置 SQLite 数据库，内存仅占 ~50MB；     │
│    - 聚合展示全网所有机器的实时水位、网络延迟与在线状态。     │
├─────────────────────────────────────────────────────────────┤
│ 📡 被控端 (Agent)：主动出站心跳（被控机 0 门槛）              │
│    - 占用内存仅 ~10MB，编译为单个二进制文件；                │
│    - 🔑 核心特性：被控机完全不需要公网 IP、不需要开任何入站端口！│
│    - 哪怕是家里的内网软路由、动态 IP 小鸡，只要能联网，     │
│    - 就能主动顺着 WebSocket 向上汇报数据，安全又稳定！       │
└─────────────────────────────────────────────────────────────┘

# 1. 创建 Komari 专属数据目录
mkdir -p /opt/komari && cd /opt/komari

# 2. 写入干净纯净的 Docker Compose 编排清单
cat << 'EOF' > /opt/komari/docker-compose.yaml
version: "3"
services:
  komari:
    image: ghcr.io/komari-monitoring/komari:latest
    container_name: komari
    restart: unless-stopped
    volumes:
      # 数据持久化挂载
      - /opt/komari/data:/app/data
    ports:
      # 绑定本地 25774 端口，准备供 Nginx 反代接入
      - "127.0.0.1:25774:25774"
EOF

# 3. 后台静默启动面板
docker compose up -d
docker compose ps

MONITOR_DOMAIN="server.example.com"

cat << EOF > /etc/nginx/sites-available/${MONITOR_DOMAIN}.conf
server {
    listen 80;
    listen [::]:80;
    server_name ${MONITOR_DOMAIN};

    location / {
        proxy_pass http://127.0.0.1:25774;

        # 核心标头透传
        proxy_set_header Host \$host;
        proxy_set_header X-Real-IP \$remote_addr;
        proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto \$scheme;

        # 核心必须：启用 WebSocket 动态长连接升级
        proxy_http_version 1.1;
        proxy_set_header Upgrade \$http_upgrade;
        proxy_set_header Connection "upgrade";

        # 调优长连接保活超时（防止心跳被 Nginx 提前切断）
        proxy_read_timeout 3600s;
        proxy_send_timeout 3600s;
    }
}
EOF

# 激活站点并自检重载
ln -sf /etc/nginx/sites-available/${MONITOR_DOMAIN}.conf /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx

# 1. 自动探测架构并下载官方最新 Agent 二进制
ARCH=$(uname -m)
case $ARCH in
    x86_64)  FILE="komari-agent-linux-amd64" ;;
    aarch64) FILE="komari-agent-linux-arm64" ;;
    *) echo "未知架构: $ARCH"; exit 1 ;;
esac

mkdir -p /opt/komari-agent && cd /opt/komari-agent
curl -sSL "https://github.com/komari-monitoring/komari-agent/releases/latest/download/${FILE}" -o komari-agent
chmod +x komari-agent

# 2. 定义连接主控的信息（填入你在第 3 步获得的面板域名与节点 Token！）
MASTER_URL="https://server.example.com"
NODE_TOKEN="你的节点专属Token"

# 3. 注册为 systemd 开机自启服务
cat << EOF > /etc/systemd/system/komari-agent.service
[Unit]
Description=Komari Monitoring Agent
After=network.target

[Service]
Type=simple
ExecStart=/opt/komari-agent/komari-agent -e ${MASTER_URL} -t ${NODE_TOKEN}
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

# 4. 启动 Agent 服务
systemctl daemon-reload
systemctl enable --now komari-agent
systemctl is-active komari-agent