Komari服务器探针搭建及配置图文教程

2.1 Docker Compose 部署#

先确保服务器已经安装 Docker。比较新的 Docker 版本通常自带 docker compose，一般不需要再单独安装旧版 docker-compose。

准备一个目录用于保存 Komari 配置和数据，本文示例使用：

1
/data/komari

进入该目录，新建 compose.yaml：

写入下面内容：

1
services:
2
  komari:
3
    image: ghcr.io/komari-monitor/komari:latest
4
    container_name: komari
5
    ports:
6
      - 25774:25774
7
    volumes:
8
      - ./data:/app/data
9
    environment:
10
      # 可选：自定义初始管理员账号
11
      # ADMIN_USERNAME: admin
12
      # ADMIN_PASSWORD: yourpassword
13
    restart: unless-stopped

接下来建议做三处检查：

1. 如果服务器在国内，镜像可以从 ghcr.io/komari-monitor/komari:latest 改成 ghcr.1ms.run/komari-monitor/komari:latest。
2. 25774:25774 前面的 25774 是宿主机端口，可以按需改成其他端口。
3. 把 ADMIN_USERNAME 和 ADMIN_PASSWORD 前面的注释去掉，并设置为自己的管理员账号和密码。

修改后的示例大概是这样：

保存后，在 /data/komari 目录运行：

1
docker compose up -d

容器正常启动后，Docker Compose 方式就完成了。

2.2 1Panel 部署#

如果服务器已经安装了 1Panel，可以直接使用更省心的应用部署方式。

先在服务器执行 Komari 的 1Panel 应用安装脚本：

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

然后进入 1Panel 后台：

1. 打开“应用商店”
2. 点击“同步本地应用”
3. 关闭同步弹窗

搜索 komari，点击安装。

安装页面里可以按需修改端口、管理员用户名和密码。如果暂时不配置反向代理，或者你需要直接通过端口访问，就勾选“端口外部访问”。

如果服务器在国外，通常直接确认即可。如果服务器在国内，可以下拉到底部，勾选“编辑 compose 文件”，把：

1
ghcr.io/komari-monitor/komari

替换为：

1
ghcr.1ms.run/komari-monitor/komari

安装完成后关闭弹窗。

此时应用商店里已经能看到 Komari。

2.3 可选：配置反向代理#

如果你有域名，建议给 Komari 配置反向代理，这样后续可以直接通过域名访问，也方便申请 HTTPS 证书。

下面还是以 1Panel 为例。

进入：

1
网站 -> 网站 -> 创建网站

类型选择“反向代理”，填写用于访问 Komari 的域名。

如果是 1Panel 应用方式部署，可以在下拉框中选择 komari。如果是 Docker Compose 或其他方式部署，代理地址可以写：

1
127.0.0.1:25774

如果你改过宿主机端口，就把 25774 换成自己的端口。

创建完成后，如果需要 HTTPS，可以进入网站配置页，在 HTTPS 里启用证书。

3.1 登录 Komari#

如果你配置了反向代理，直接访问绑定的域名。如果没有配置反向代理，就访问：

1
服务器IP:25774

如果改过端口，把 25774 替换成自己的端口。

进入页面后，点击右上角登录，输入前面设置的管理员账号和密码。

首次进入时按提示接受即可。

3.2 可选：配置 PurCarte 主题#

PurCarte 是一个 Komari 主题，项目地址：

https://github.com/Montia37/komari-theme-purcarte

先进入 Releases 页面下载主题包：

https://github.com/Montia37/komari-theme-purcarte/releases

回到 Komari 后台，进入：

1
设置 -> 主题管理 -> 上传主题

上传刚刚下载的主题包。

上传完成后，点击齿轮按钮，设置为当前主题。

主题配置可以在前台入口里调整，也可以在后台的 PurCarte 设置 中调整。

默认配置已经可以正常使用。后续如果想折腾外观，建议把每个配置项都翻一遍，按自己的站点风格慢慢调整。

如果需要背景图片，原文作者也提供了一个双端自适应二次元图片 API：

1
https://www.loliapi.com/acg/

3.3 可选：配置 KomariBeautify#

KomariBeautify 是基于 PurCarte 主题的一套自定义代码，项目地址：

https://github.com/YoungYannick/KomariBeautify

先进入 Komari 后台：

1
设置 -> 站点

找到 自定义头部 和 自定义 Body 两个位置。

然后打开 KomariBeautify 仓库，点击 KomariBeautify.html。

需要注意：里面的 CSS/HTML 和 JS 要分开放。

• CSS/HTML：放到 Komari 的“自定义头部”
• JS：放到 Komari 的“自定义 Body”

以 KomariBeautify 0.4.2 为例，原文中提到可以翻到第 1071 行附近找分界；不同版本行号可能会变化，所以建议按代码内容判断。

如果项目更新后找不到分界，可以把代码结构贴给 AI 帮你判断哪一段该放头部，哪一段该放 Body。

粘贴完成后，分别保存。

补充一点：0.4.2 版本里可以通过修改相关行的图片和标题，调整欢迎小面板。

完成主题和美化代码后，前台效果大概如下。

3.4 添加服务器节点#

最后一步是把需要监控的服务器接入 Komari。

进入后台：

1
服务器 -> 添加节点

填写节点名称后，点击添加。

添加完成后，点击“一键部署指令”。根据目标服务器系统和网络情况选择安装参数。

如果是国内服务器，可以勾选 Github 代理，代理地址可按实际情况填写。原文示例使用：

1
https://ghfast.top/

这类代理地址可能随时变化，建议以自己测试可用为准。

把复制出来的命令放到对应服务器上执行，等待安装完成。

回到 Komari 前台，如果配置正常，就能看到刚刚添加的机器在线了。