Komari 探针服务部署安装

732 字
4 分钟
Komari 探针服务部署安装
Abstract

这份博客记录了我在 2026年3月15日Ubuntu 24.04 (x86_64) 环境下,搭建 Komari Monitor 的完整实操记录。包含了踩过的 Nginx 版本坑、Tailscale 冲突解决以及后续更新教程。

环境: Ubuntu 24.04 LTS, x86_64

架构: Cloudflare (Proxy) + Nginx + Komari Server

参考文档: 安装 Komari 服务器监控工具 - Dejavu’s Blog


一、 环境准备#

创建一个隔离的系统用户和目录,确保主程序不以 Root 权限运行(安全最佳实践)。

Terminal window
# 1. 创建无登录权限用户
sudo useradd -r -s /usr/sbin/nologin komari
# 2. 创建目录
sudo mkdir -p /opt/komari/server
sudo mkdir -p /etc/nginx/cert
# 3. 设置权限
sudo chown -R komari:komari /opt/komari/server

二、 服务端安装与守护进程#

下载 amd64 架构版本,并配置 Systemd 确保自启。

1. 下载程序#

Terminal window
sudo curl -L -o /opt/komari/komari-server https://github.com/komari-monitor/komari/releases/download/1.1.8/komari-linux-amd64
sudo chown root:root /opt/komari/komari-server
sudo chmod 755 /opt/komari/komari-server

2. 配置 Systemd#

执行 sudo nano /etc/systemd/system/komari.service

[Unit]
Description=Komari Monitor Server
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=komari
Group=komari
WorkingDirectory=/opt/komari/server
ExecStart=/opt/komari/komari-server server -l 127.0.0.1:25774
Restart=always
RestartSec=5s
NoNewPrivileges=yes
ProtectSystem=strict
ProtectHome=yes
PrivateTmp=yes
ProtectKernelTunables=yes
ProtectControlGroups=yes
ReadWritePaths=/opt/komari/server
LimitNOFILE=65536
[Install]
WantedBy=multi-user.target

启动并记录密码:

Terminal window
sudo systemctl daemon-reload && sudo systemctl enable --now komari
sudo journalctl -u komari -f # 在日志中找到 "Password: XXX"

三、 Nginx 反向代理#

1. 证书部署#

从 Cloudflare 获取 Origin CA 证书(15年有效期),模式设为 Full (Strict)

  • 证书内容:sudo nano /etc/nginx/cert/komari.pem

  • 私钥内容:sudo nano /etc/nginx/cert/komari.key

2. Nginx 配置#

关键修复: Ubuntu 24.04 默认 Nginx 不支持 http2 on;。必须将 http2 参数合并到 listen 行。

执行 sudo nano /etc/nginx/sites-available/komari

Nginx

server {
listen 80;
listen [::]:80;
server_name 你的域名;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name 你的域名;
ssl_certificate /etc/nginx/cert/komari.pem;
ssl_certificate_key /etc/nginx/cert/komari.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ecdh_curve X25519:P-256:P-384;
ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-CHACHA20-POLY1305:ECDHE+AES128:RSA+AES128:ECDHE+AES256:RSA+AES256';
ssl_prefer_server_ciphers off;
ssl_session_timeout 1d;
ssl_session_cache shared:MozSSL:10m;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
access_log /var/log/nginx/komari.access.log;
error_log /var/log/nginx/komari.error.log;
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-XSS-Protection "1; mode=block" always;
add_header X-Content-Type-Options "nosniff" always;
add_header Referrer-Policy "no-referrer-when-downgrade" always;
add_header Content-Security-Policy "default-src 'self' http: https: data: blob: 'unsafe-inline' 'unsafe-eval' 'wasm-unsafe-eval'" always;
location / {
proxy_pass http://127.0.0.1:25774;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_buffering off;
client_max_body_size 50M;
proxy_read_timeout 86400;
proxy_send_timeout 86400;
}
}

启用并排错:

Bash

Terminal window
sudo ln -sf /etc/nginx/sites-available/komari /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl restart nginx

四、 避坑排障 (FAQ)#

1. 521 Web server is down#

  • 检查 Nginx 状态: sudo systemctl status nginx

  • 检查端口占用: 如果报 bind() failed (98: Address already in use),通常是 Tailscale 占用了 443 端口。

    • 解决: 将 Nginx 配置中的 listen 0.0.0.0:443 修改为 listen [你的公网IP]:443

2. 安装 Agent (被控端)#

安装被控端很简单,直接在服务器的节点列表添加节点复制指令进行安装即可:

五、 更新维护教程#

当 GitHub 发布新版本时,按以下步骤操作。

1. 更新服务端 (Server)#

sudo systemctl stop komari
# 替换下方 URL 中的版本号
sudo curl -L -o /opt/komari/komari-server https://github.com/komari-monitor/komari/releases/download/新版本号/komari-linux-amd64
sudo chmod +x /opt/komari/komari-server
sudo systemctl start komari

2. 更新被控端 (Agent)#

sudo systemctl stop komari-agent
# 替换下方 URL 中的版本号
sudo curl -L -o /opt/komari/komari-agent https://github.com/komari-monitor/komari-agent/releases/download/新版本号/komari-agent-linux-amd64
sudo chmod +x /opt/komari/komari-agent
sudo systemctl start komari-agent

六、 配置推送#

可以配置邮件推送或者Telegram 推送。 配置都比较简单,网页端操作即可,不记录。

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

Komari 探针服务部署安装
https://blog.idotcar.top/posts/uehz9f5x/
作者
老鼠溺水
发布于
2026-04-07
许可协议
CC BY-NC-SA 4.0

评论区

Profile Image of the Author
老鼠溺水
事实上,我们每个人都不过是在给自己写信。
分类
标签
站点统计
文章
7
分类
2
标签
9
总字数
29,837
运行时长
0
最后活动
0 天前

目录