Deploy Komari and the corresponding Komari-agent using huggingface

之前大家都是用的哪吒面板,前几天刚好注册了huggingface(俗称的抱脸),就试着部署了一下之前了解到的Komari(一个轻量化的服务器监控工具),现在给大家分享一下部署过程

先上效果图:


注册部署很简单,自行注册即可。

具体的部署步骤如下:

  1. 新建space,名字随便,选择Docker Blank,配置选免费的CPU Basic,然后创建space

  2. 选择Files,会看到项目的文件,然后编辑README.md,内容如下:

---
title: Test
emoji: 🐨
colorFrom: gray
colorTo: pink
sdk: docker
pinned: false
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

改完提交
3. 新建文件,文件名:Dockerfile,内容如下:

FROM ghcr.io/komari-monitor/komari:latest

# 切到镜像内工作目录(官方要求是 /app)
WORKDIR /app

# 在镜像内创建 /app/data 目录并赋予权限
RUN mkdir -p /app/data && chmod -R 777 /app/data

# Hugging Face 会用 README.yaml 配置的 app_port 检查服务
EXPOSE 25774

# 保留官方镜像的 ENTRYPOINT,不要覆盖 CMD
  1. 设置登录的用户名和密码,路径为当前项目的setting里,往下拉会看到 Variables and secrets,选择New Secret
    设置两个变量:ADMIN_USERNAME,ADMIN_PASSWORD

设置完项目会自动重新部署,等待部署完成。切换到APP标签可以查看构建日志和容器运行日志,有错误的话按照日志排查


以上服务端部署完了,我们还可以再在Huggingface部署一个Komari Agent,步骤如下:

  1. 新建space,名字随便,选择Docker Blank,配置选免费的CPU Basic,然后创建space(跟上边一样)

  2. 选择Files,会看到项目的文件,然后编辑README.md,内容如下:

---

title: Komari-Agent

colorFrom: gray

colorTo: blue

sdk: docker

app_port: 7860

---

# Komari Agent Docker Deployment

This is a simple Docker deployment for Komari Agent, designed to run on Hugging Face Spaces.

改完提交

  1. 新建文件,文件名:start.sh
#!/bin/bash

# 使用 Hugging Face Spaces 的环境变量来启动 Komari Agent

# 注意:参数用双引号包裹,以防值中包含特殊字符

/usr/local/bin/komari-agent -e "$KOMARI_ENDPOINT" -t "$KOMARI_TOKEN" &

# 启动一个简单的 Python HTTP 服务器

# 监听 7860 端口,并保持前台运行

python3 -m http.server 7860
  1. 跟上边一样新建变量,两个变量名称为:
    KOMARI_ENDPOINT,值为我们刚才部署的komari的服务端地址 https://用户名-space名称.hf.space
    KOMARI_TOKEN,这个值需要登录刚才部署的komari的web界面,新建一个服务器节点,在编辑里可以看到Token令牌,截图如下:

  2. 新建文件,文件名:Dockerfile,内容如下

# 阶段一:构建者,从 Komari Agent 镜像中提取可执行文件

FROM skylerhe/komari-agent:amd64 AS builder

# 阶段二:最终镜像,使用轻量级的 Python 镜像

FROM python:3.10-slim

# 复制 Komari Agent 可执行文件到最终镜像中

COPY --from=builder /app/komari-agent /usr/local/bin/

# 暴露 7860 端口,这是 Hugging Face Spaces 默认监听的端口

EXPOSE 7860

# 复制启动脚本到容器中

COPY start.sh /start.sh

# 容器启动时,执行 start.sh 脚本

CMD ["bash","/start.sh"]

等待项目构建完成,过一会就可以在监控页面看到Huggingface的服务器了。
监控自己的VPS小鸡的话,新建一个节点,然后点击后边那个类似下载的图标,里边可以直接复制一键部署的命令。

设置里可以更换主题,我用的 PurCarte,地址如下:

https://github.com/Montia37/komari-theme-purcarte
下载完上传到主题配置切换即可。

更改文件和变量名都会导致项目重新构建,服务器数据会丢失,设置里可以自行备份。
当成玩具体验一下就可以,稳定的话还是部署到自己靠谱的vps来用.
我只能上传一张截图,想玩的可以慢慢研究一下

15 Likes

:xhj003:

干得漂亮
正好需要
喂饭教程超级棒
:xhj18:

1 Like

huggingface这个是长期免费嘛 :xhj007:

目前免费配置2C16G,目前没说收费

学习学习

厉害了,学习一下

这个可以

学习学习

学习一下,支持技术帖

48小时限制

大佬牛逼

好厉害

楼主抱脸怎么注册的 前几年就听说过 但是全是英文就没怎么了解 但是看到很多大佬都在抱脸部署有项目

Thanks for sharing

I registered directly with Gmail

Take a look

Bookmark

感谢大佬分享

Got it, thanks for sharing, boss.