本文作者：猫猫摸大鱼 原文地址：[https://www.iloli.love/archives/1769602819038](https://www.iloli.love/archives/1769602819038)

## 1\. 前言

Komari 是一个服务器监控/探针面板，github地址为 [https://github.com/komari-monitor/komari](https://github.com/komari-monitor/komari)

本文基于 Komari 1.1.3 版本，Purcarte主题 1.2.5 版本，KomariBeautify 0.4.2 版本

本文中搭建Komari使用的是腾讯云轻量应用服务器，可以参加腾讯云活动 [https://cloud.tencent.com/act/pro/double12-2025](https://cloud.tencent.com/act/pro/double12-2025) 进行购买，4核4G服务器新客38元/年起，当然买不买都无所谓，毕竟我也没有AFF

## 2\. 部署搭建Komari

首先是部署Komari，这里我们介绍docker compose 部署和 1panel 部署两种方式（2.1与2.2两种方式二选一即可）

如果想要使用更多部署方式（例如一键脚本）可以参考Komari官方文档 [https://www.komari.wiki/install/quick-start.html](https://www.komari.wiki/install/quick-start.html)

### 2.1 docker compose 部署

首先确保你的服务器安装了 Docker ，安装 Docker 的教程遍地都是，这里就不多赘述了（建议使用 [https://linuxmirrors.cn/](https://linuxmirrors.cn/) ）

另外只要不是非常久远版本的 Docker 都是自带 compose 的，所以一般来说不需要额外安装 docker-compose

确定安装好 Docker 了以后，就可以找一个目录来部署和保存Komari的数据了（本文中使用 `/data/komari` ）

在 /data/komari 目录下新建文件 `compose.yaml`

![](https://developer.qcloudimg.com/http-save/yehe-6836203/6ed2b92f76fbc578c51ae1df5899a129.png)

将以下内容复制粘贴进`compose.yaml`

    services:
      komari:
        image: ghcr.io/komari-monitor/komari:latest
        container_name: komari
        ports:
          - 25774:25774
        volumes:
          - ./data:/app/data
        environment:
          # 可选：自定义初始管理员账号
          # ADMIN_USERNAME: admin
          # ADMIN_PASSWORD: yourpassword
        restart: unless-stopped

![](https://developer.qcloudimg.com/http-save/yehe-6836203/134092e6c7848d2730856fc223e3545b.png)

接下来进行修改

首先，如果你的服务器位于大陆，可以将 `ghcr.io/komari-monitor/komari:latest` 替换为 `ghcr.1ms.run/komari-monitor/komari:latest` （1ms.run加速镜像）

其次，可以将 `- 25774:25774` 中**前面的**那个25774修改为其它端口（这个也可以不修改，默认即可）

然后，将 `# ADMIN_USERNAME` 和 `# ADMIN_PASSWORD` 前面的 `#` 删除，并分别修改后面的值为你要给komari设置的账号 密码（要修改）

我的服务器位于大陆，不修改端口，设置了账号密码，修改后的示例：

![](https://developer.qcloudimg.com/http-save/yehe-6836203/c11b2891f56f72406759831bc2ef944e.png)

保存后，在 /data/komari 目录下运行命令 `docker compose up -d` ，如下图，容器启动即成功

![](https://developer.qcloudimg.com/http-save/yehe-6836203/636b2e89ef43e9dd95b4368356035781.png)

### 2.2 1panel部署

如果你的服务器在使用1panel面板，那么可以使用更简单的部署方式

首先在服务器上运行脚本

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

![](https://developer.qcloudimg.com/http-save/yehe-6836203/d5b4519c86aafbd86af8415096339f44.png)

接下来 来到1panel面板，点击 应用商店 - 同步本地应用 然后关闭弹窗

![](https://developer.qcloudimg.com/http-save/yehe-6836203/f7500e9533f7d20b636913408b7494f3.png)

接下来输入 komari ，点击搜索，点击安装

![](https://developer.qcloudimg.com/http-save/yehe-6836203/7e87d15a31150e358d5b6349011512d1.png)

然后 可选修改端口（一般默认即可），修改管理员用户名和密码，如果不配置反代或需要端口访问，则将 `端口外部访问` 勾选

![](https://developer.qcloudimg.com/http-save/yehe-6836203/cb97b435cfc1ea6e001a952cfbd7d127.png)

如果你的服务器位于境外，直接点击确认即可  
如果你的服务器位于大陆，那么下拉到底部，勾选 `编辑 compose 文件` ，然后在下方框内将 `ghcr.io/komari-monitor/komari` 替换为 `ghcr.1ms.run/komari-monitor/komari` （1ms.run加速镜像），点击确认

![](https://developer.qcloudimg.com/http-save/yehe-6836203/fbd30988977940a6d235310cf8d44121.png)

安装完成，关闭弹窗即可

![](https://developer.qcloudimg.com/http-save/yehe-6836203/15c59b761d530101688e94a821e825b6.png)

已经可以在应用商店看到刚刚安装的komari了

![](https://developer.qcloudimg.com/http-save/yehe-6836203/259adb8622650eb581c81e1c491e41d8.png)

### 2.3 （可选）配置反代

1panel面板的反代模板内容很全面，所以为了方便，这里我使用1panel配置反代

点击网站 - 网站 - 创建网站

![](https://developer.qcloudimg.com/http-save/yehe-6836203/955d4e839e592943626619a2581e3791.png)

选择 反向代理 ，填写你反代komari的域名

如果你是1panel部署的komari，则点击下拉框，点击komari，点击确认

如果你是其它方式部署的komari，则在代理地址里填 `127.0.0.1:25774` （如果你自定义了其它端口则将25774修改为你的端口），点击确认

![](https://developer.qcloudimg.com/http-save/yehe-6836203/0b69f5484114adb8735f6ecdf98a7ccd.png)

如果需要为刚刚创建的网站域名配置证书，则点击配置 - HTTPS - 启用HTTPS，可以在里面配置你的证书，本文不再赘述

![](https://developer.qcloudimg.com/http-save/yehe-6836203/1390aaf2b12de632d98206aefad08509.png)

![](https://developer.qcloudimg.com/http-save/yehe-6836203/82fa04f4a7165de42cfefe253bfde9a0.png)

## 3\. 配置 Komari

已经部署完成了，接下来就可以访问并配置komari了

### 3.1 访问komari

如果你配置了反代，则访问你的域名  
如果你没有配置反代，则访问 `服务器IP:25774` （如果你自定义了其它端口则将25774修改为你的端口）

点击右上角登录，输入你刚刚设置的账号密码，点击登录

![](https://developer.qcloudimg.com/http-save/yehe-6836203/0390c1a12811b601d5cec5fc67731103.png)

点击接受

![](https://developer.qcloudimg.com/http-save/yehe-6836203/60135961a0064bb99daa3a30ecc1dfcc.png)

### 3.2 （可选）配置PurCarte主题

PurCarte主题github地址：[https://github.com/Montia37/komari-theme-purcarte](https://github.com/Montia37/komari-theme-purcarte) 

首先，访问releases，下载最新版的主题包到本地 [https://github.com/Montia37/komari-theme-purcarte/releases](https://github.com/Montia37/komari-theme-purcarte/releases)

![](https://developer.qcloudimg.com/http-save/yehe-6836203/b2f8e1abf91d9f14c5c86f2ed99576a4.png)

在后台点击设置 - 主题管理 - 上传主题，上传刚刚下载的主题包

![](https://developer.qcloudimg.com/http-save/yehe-6836203/6caf8518696f4a1ce6c3354e616f59f4.png)

点击齿轮按钮，设置为当前主题

![](https://developer.qcloudimg.com/http-save/yehe-6836203/c100b763706ce991eed70a9a2e77a377.png)

可以在前台点击如图按钮进行主题配置，也可以在后台 `PurCarte设置` 进行主题配置

![](https://developer.qcloudimg.com/http-save/yehe-6836203/cf5a86f78b8bc4643f4d3498942ded08.png)

![](https://developer.qcloudimg.com/http-save/yehe-6836203/e95c8ee86f0b36e266a39832e1e8a638.png)

默认配置即可用，建议自行全部翻阅一遍进行自定义配置

（这里夹带一点点私货，公益站点，跪求大佬放过）欢迎大家将背景图片设置为我的双端自适应二次元图片API `https://www.loliapi.com/acg/`

![](https://developer.qcloudimg.com/http-save/yehe-6836203/6f40cefa65c708e4de0c6ec0fe7a81c3.png)

### 3.3 （可选）配置KomariBeautify - 基于PurCarte主题的自定义代码

进入后台，点击设置 - 站点，找到`自定义头部`和`自定义Body`的位置

![](https://developer.qcloudimg.com/http-save/yehe-6836203/1e853288d66e3ba4f994d1d38d1f9ff3.png)

接下来，访问KomariBeautify的github地址：[https://github.com/YoungYannick/KomariBeautify](https://github.com/YoungYannick/KomariBeautify)

点击 KomariBeautify.html

![](https://developer.qcloudimg.com/http-save/yehe-6836203/9f0e8121944da48e59df0b3338ce73e2.png)

**重要！！！**需要将其中的 `CSS/HTML` 相关代码和 `JS` 相关代码，分别复制到 **自定义头部** 和 **自定义Body** 里

对于KomariBeautify V0.4.2版本，可以翻到第 1071 行，其它版本请自行寻找，上面的全部为CSS/HTML代码，下面的全部为JS代码

![](https://developer.qcloudimg.com/http-save/yehe-6836203/d62f225e2e3c8bfb9fffaad8c9640cd6.png)

（如果该项目更新了新的版本，自己实在找不到分界在哪里，可以试试问AI）

![](https://developer.qcloudimg.com/http-save/yehe-6836203/d4be6d6a2211e1273a458bff65c06507.png)

粘贴完成后分别点击保存

![](https://developer.qcloudimg.com/http-save/yehe-6836203/d66dd2e028f04f7da447b901de9b83e6.png)

（补充）0.4.2版本，可以通过修改792和793行的代码，来修改欢迎小面板的图片和标题

![](https://developer.qcloudimg.com/http-save/yehe-6836203/bc859d10f42516729aa3430ffa003c58.png)

![](https://developer.qcloudimg.com/http-save/yehe-6836203/d4764226bfb5917c28d52c2a5733fb35.png)

![](https://developer.qcloudimg.com/http-save/yehe-6836203/ba193c48751b61f2b6569fc2afd0e75a.png)

目前添加了主题和增强的效果

![](https://developer.qcloudimg.com/http-save/yehe-6836203/f009e8e87c9c3129bb790eee27846c66.png)

### 3.4 添加服务器节点

进入后台，点击服务器 - 添加节点，可选填写节点名称，点击添加节点

![](https://developer.qcloudimg.com/http-save/yehe-6836203/defbea5aafc9069d33a34359d0fdf243.png)

点击一键部署指令按钮，根据服务器的类型和自己所需自行选择安装选项，如果是大陆机器，可以勾选**Github代理**，然后填写 `https://ghfast.top/` （目前可用，可能随时不可用，建议自己寻找），点击复制

![](https://developer.qcloudimg.com/http-save/yehe-6836203/c72ee7accbaf42d1e9e672c5e9428415.png)

在对应的服务器上运行刚刚复制的命令，很快就安装完了

![](https://developer.qcloudimg.com/http-save/yehe-6836203/e2707ef85e242f381b05c607780ee4ec.png)

返回前台，已经可以看到刚刚添加的机器了

![](https://developer.qcloudimg.com/http-save/yehe-6836203/c509a9eb46c04997e88045115e9d4994.png)

## 4\. 总结

欢迎大家来我的探针参观 [https://status.iloli.love/](https://status.iloli.love/) ，蹭蹭大家的流量（bushi

到这里，Komari的搭建及基础配置就完成了，感谢你的阅读，komari还有一些好玩的配置项，这里就先不多赘述了，以后 ~~（下辈子）~~ 再填坑吧

本文作者：猫猫摸大鱼 原文地址：https://www.iloli.love/archives/1769602819038

【玩转LightHouse】小白向Komari搭建及配置图文教程

搭建及配置Komari 服务器监控/探针面板图文教程

腾云先锋（TDP）成员

运维

后端

Komari服务器监控面板搭建教程，详细介绍docker compose和1panel两种部署方式，包含反代配置、PurCarte主题安装及KomariBeautify美化插件使用指南。适用于腾讯云轻量服务器，提供大陆镜像加速方案，帮助用户快速搭建个性化服务器监控系统。

轻量应用服务器

服务器

容器

Docker

lighthouse

domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

【玩转LightHouse】小白向Komari搭建及配置图文教程-腾讯云开发者社区-腾讯云

【玩转LightHouse】小白向Komari搭建及配置图文教程

【玩转LightHouse】小白向Komari搭建及配置图文教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐