之前大家都是用的哪吒面板,前几天刚好注册了huggingface(俗称的抱脸),就试着部署了一下之前了解到的Komari(一个轻量化的服务器监控工具),现在给大家分享一下部署过程
先上效果图:
注册部署很简单,自行注册即可。
具体的部署步骤如下:
-
新建space,名字随便,选择Docker Blank,配置选免费的CPU Basic,然后创建space
-
选择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
- 设置登录的用户名和密码,路径为当前项目的setting里,往下拉会看到 Variables and secrets,选择New Secret
设置两个变量:ADMIN_USERNAME,ADMIN_PASSWORD
设置完项目会自动重新部署,等待部署完成。切换到APP标签可以查看构建日志和容器运行日志,有错误的话按照日志排查
以上服务端部署完了,我们还可以再在Huggingface部署一个Komari Agent,步骤如下:
-
新建space,名字随便,选择Docker Blank,配置选免费的CPU Basic,然后创建space(跟上边一样)
-
选择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.
改完提交
- 新建文件,文件名: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
-
跟上边一样新建变量,两个变量名称为:
KOMARI_ENDPOINT,值为我们刚才部署的komari的服务端地址 https://用户名-space名称.hf.space
KOMARI_TOKEN,这个值需要登录刚才部署的komari的web界面,新建一个服务器节点,在编辑里可以看到Token令牌,截图如下: -
新建文件,文件名: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来用.
我只能上传一张截图,想玩的可以慢慢研究一下
