尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案

SkillHub部署完全指南：Docker Compose、Helm与K8s三条路径及多架构镜像实战

发布时间：2026/11/8 19:17:21来源：尧图网络资讯中心
首页/资讯中心/文章详情
SkillHub部署完全指南：Docker Compose、Helm与K8s三条路径及多架构镜像实战
SkillHub部署完全指南Docker Compose、Helm与K8s三条路径及多架构镜像实战【免费下载链接】skillhubSelf-hosted, open-source agent skill registry for enterprises. Publish version skill packages, govern with RBAC and audit logs, deploy on-premise with Docker or Kubernetes.项目地址: https://gitcode.com/gh_mirrors/sk/skillhubSkillHub 是一个自托管的开源 AI Agent 技能注册中心支持技能包发布与版本管理、RBAC 权限治理、审计日志可通过 Docker 或 Kubernetes 私有化部署。本文将带你完整走通SkillHub 部署的三条路径Docker Compose 单机交付、Kubernetes Kustomize 原生部署、Helm Chart 企业级部署并实战验证多架构镜像amd64 / arm64 / riscv64的使用方式。 1分钟选对部署路径你的场景推荐路径核心文件单台服务器、快速上线、对外演示Docker Composecompose.release.yml已有 K8s 集群想用最简单的 YAML 部署Kustomizedeploy/k8s/README.md生产级集群需要 HA、HPA、GitOpsHelm Chartcharts/skillhub/README.md无论哪条路径SkillHub 的运行模型一致WebNginx 前端→ ServerSpring Boot 后端→ PostgreSQL Redis外加可选的安全扫描器 Scanner。✅ 部署前置条件三条路径通用Docker 路径Docker Engine Compose 插件若使用 GHCR 私有镜像需先docker login ghcr.ioK8s 路径Kubernetes 1.24、已配置kubectl、默认 StorageClassHelm 路径额外需要 Helm 3.8网络只开放80/443公网入口避免直接暴露5432PostgreSQL和6379Redis先获取源码git clone https://gitcode.com/gh_mirrors/sk/skillhub cd skillhub 路径一Docker Compose 单机部署最快上手这是最省心的路径一条命令拉起全部容器PostgreSQL 与 Redis 默认只绑定127.0.0.1安全性有保障。三步完成 SkillHub 部署第 1 步准备环境变量文件cp .env.release.example .env.release.env.release.example 是运行时变量模板包含镜像名、镜像版本、端口、数据库凭证、外部 S3 对象存储参数和首登管理员参数。重点关注这几项变量说明SKILLHUB_VERSION镜像版本标签latest/edge/vX.Y.Z三选一POSTGRES_PASSWORD务必改为非默认强密码BOOTSTRAP_ADMIN_PASSWORD首登管理员密码默认值会被校验脚本拒绝SKILLHUB_PUBLIC_BASE_URL最终 HTTPS 域名不带尾部/影响 OAuth 回调与 CookieSKILLHUB_STORAGE_S3_*对象存储接入参数推荐生产使用外部 S3/OSS第 2 步启动前校验配置make validate-release-config该脚本由 scripts/validate-release-config.sh 实现可提前拦截replace-me占位值、URL 格式错误、缺失的 OSS 凭据和危险明文默认值——上线前的体检步骤强烈建议每次都跑。第 3 步一键启动docker compose --env-file .env.release -f compose.release.yml up -d启动拓扑见 docs/09-deployment.mdWeb 容器提供静态资源并把/api/*、/oauth2/*反代到后端后端运行dockerprofile所有服务都带健康检查和depends_on依赖编排启动顺序自动保证。开发模式彩蛋如果只是本地开发make dev-all会基于 docker-compose.yml 只拉起 PostgreSQL / Redis / MinIO / Scanner前后端跑在宿主机上热更新更友好。☸️ 路径二Kubernetes Kustomize 部署适合已经熟悉 K8s、希望用纯 YAML kustomize管理部署的团队。目录结构在 deploy/k8s/base/基础配置Deployment、Service、ConfigMap、Ingressoverlays/with-infra/完整部署内置 PostgreSQL Redis StatefulSetoverlays/external/外部数据库模式复用已有 PG/Redis一键部署内置数据库版kubectl create namespace skillhub # 1. 配置敏感信息 cd deploy/k8s/base cp secret.yaml.example secret.yaml # 编辑数据库连接、管理员密码 # 2. 一键部署含内置 PG Redis kubectl apply -k overlays/with-infra/ # 3. 验证 kubectl get pods -n skillhub kubectl wait --forconditionready pod --all -n skillhub --timeout300s本地测试可用端口转发访问kubectl port-forward svc/skillhub-web -n skillhub 8080:80已有数据库修改base/configmap.yaml的 Redis 地址与secret.yaml的数据库凭据后执行kubectl apply -k overlays/external/即可SkillHub 还支持外部 Redis Cluster / Sentinel 接入详见 deploy/k8s/README.md。⚓ 路径三Helm Chart 企业级部署charts/skillhub/ 是功能最全的方案内置 Bitnami PostgreSQL / Redis 子 Chart支持主从复制、哨兵模式、HPA 自动扩缩容、PDB Pod 中断预算、TLS 证书管理、Prometheus 指标导出并内置values.schema.json交叉校验。生产安装标准流程第 1 步准备受保护的 values 文件secrets: allowAutoGenerated: false # 禁止随机生成保证 GitOps 可复现 bootstrapAdminPassword: 固定管理员密码 downloadAnonCookieSecret: 至少32字符的固定随机值 postgresql: auth: postgresPassword: 固定管理员密码 password: 固定业务密码 redis: auth: password: 固定Redis密码第 2 步构建依赖并安装helm dependency build ./charts/skillhub kubectl create namespace skillhub helm -n skillhub upgrade -i skillhub ./charts/skillhub \ -f values-production.yaml \ --set publicBaseUrlhttps://skills.example.com所有 values 在安装前会先经过 schema 校验无效的组件 / Ingress / HPA / 存储组合会直接失败不会留下半成品部署。进阶玩法速查完整参数见 charts/skillhub/values.yaml# 高可用模式PG 主从 Redis 哨兵 --set postgresql.architecturereplication \ --set redis.architecturereplication # 多副本Server 扩到 3 副本本地存储需 RWX否则建议 S3 --set server.replicaCount3 --set server.storage.accessModeReadWriteMany # 外部数据库模式 --set postgresql.enabledfalse --set redis.enabledfalse \ --set externalDatabase.hostpostgres.example.com \ --set externalRedis.hostredis.example.com # 复用已有 Secret避免明文密码 --set existingSecretmy-custom-secretGitOps 用户注意Argo CD 等工具使用离线helm template无法读取集群已有 Secret。因此 Chart 默认allowAutoGeneratedfalse——缺失固定密码时会明确报错指出具体配置项而不是静默随机生成导致漂移。️ 多架构镜像实战AMD / ARM / RISC-V 通吃SkillHub 通过 GitHub Actions 发布多架构 manifest这是私有化部署在国产化环境中的重要能力组件支持架构skillhub-server后端linux/amd64、linux/arm64、linux/riscv64skillhub-web前端linux/amd64、linux/arm64、linux/riscv64skillhub-scanner扫描器linux/amd64、linux/arm64镜像标签怎么选标签含义推荐场景latest仅在语义化版本 tag 发布时更新默认快速启动edgemain 分支最新构建团队内部持续验证vX.Y.Z对应 Git tag对外演示 / 严格可复现环境在.env.release中通过SKILLHUB_VERSIONv1.2.3固定版本即可同一份 Compose 文件在 x86 服务器和 ARM 服务器如 Apple 芯片、国产飞腾/鲲鹏上都能正确拉取对应架构镜像无需任何修改。RISC-V 平台的支持细节构建方式、运行时限制见 docs/RISCV64.md私有化离线环境可参考 deploy/runtime-mirror-images.txt 做镜像源映射。 部署验证与避坑清单健康检查三件套# 后端健康检查 curl -i http://127.0.0.1:8080/actuator/health # Compose 服务状态 docker compose --env-file .env.release -f compose.release.yml ps # K8s Pod 状态 kubectl get pods -n skillhub全部就绪后浏览器打开SKILLHUB_PUBLIC_BASE_URL即可看到 SkillHub 首页——搜索、技能详情、命名空间与审核列表一览无余。高频避坑要点首登后立即改密码bootstrap admin默认用户名admin完成首次登录后应立刻修改密码完全走 OAuth 的场景可将BOOTSTRAP_ADMIN_ENABLED设为false公网 URL 别忘填SKILLHUB_PUBLIC_BASE_URL必须是最终 HTTPS 域名否则 OAuth 回调、设备码链接、Cookie 安全判断都会异常子路径部署三件套网关部署在/skillhub/时需同时设置SKILLHUB_WEB_BASE_PATH/skillhub/、SKILLHUB_WEB_API_BASE_URL/skillhub和公网 URL 前缀K8s Pod 一直 Pending先查 PVC 是否绑定kubectl get pvc -n skillhub再查节点资源镜像拉取失败私有镜像需创建docker-registry类型的拉取凭证 Secret数据迁移无感Flyway 在应用启动时自动执行 schema 迁移server/skillhub-app/ 是唯一 schema 变更入口升级无需手工动库 延伸阅读资料路径部署架构与运维总纲docs/09-deployment.mdK8s 部署指南含故障排查deploy/k8s/README.mdHelm Chart 完整配置参考charts/skillhub/README.mdRISC-V 多架构支持说明docs/RISCV64.md官方文档站点部署/治理/CLIdocs/skillhub/guide/开发工作流入口Make 命令大全Makefile三条路径一套镜像体系——从一台裸金属服务器到一个多副本 HA 集群SkillHub 都能以相同的心智模型完成部署。建议先用 Docker Compose 路径跑通全链路熟悉核心变量后再平滑迁移到 Helm 生产部署。【免费下载链接】skillhubSelf-hosted, open-source agent skill registry for enterprises. Publish version skill packages, govern with RBAC and audit logs, deploy on-premise with Docker or Kubernetes.项目地址: https://gitcode.com/gh_mirrors/sk/skillhub创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
RELATED

相关推荐

谨慎选择！并非所有 AI 都适合写论文，2026 教授认可工具推荐

谨慎选择！并非所有 AI 都适合写论文，2026 教授认可工具推荐

每年毕业季，无数同学深陷论文难题：开题毫无思路、搭建框架耗费数日、初稿逻辑松散、查重标红泛滥、AI检测超标、格式反复被导师驳回。现如今市面上通用型AI工具遍地开花，但绝大多数通用大模型存在编造虚假参考文献、学术语句口语化、AI生成痕…

📅 2026/9/11 12:30:20
如何快速上手 tinygrad：从零开始的最小深度学习框架完整指南

如何快速上手 tinygrad：从零开始的最小深度学习框架完整指南

如何快速上手 tinygrad：从零开始的最小深度学习框架完整指南 【免费下载链接】tinygrad You like pytorch? You like micrograd? You love tinygrad! ❤️ 项目地址: https://gitcode.com/GitHub_Trending/tiny/tinygrad tinygrad 是一个极简的端到端深度…

📅 2026/10/12 10:35:54
用 UVR5 把播客人声从背景噪音里捞出来：一份 AI 音频分离实操指南

用 UVR5 把播客人声从背景噪音里捞出来：一份 AI 音频分离实操指南

用 UVR5 把播客人声从背景噪音里捞出来&#xff1a;一份 AI 音频分离实操指南 【免费下载链接】Retrieval-based-Voice-Conversion-WebUI Easily train a good VC model with voice data < 10 mins! 项目地址: https://gitcode.com/GitHub_Trending/re/Retrieval-based-Vo…

📅 2026/10/15 8:34:29
MORE NEWS

更多资讯

📰

电工证被人使用如何查 郑州报考避坑指南

电工证被人使用如何查 郑州报考避坑指南 之前考的证在外省能不能转过来？这个问题，我们漯河某中小施工企业的老王就遇到了。他拿着在老家考的低压电工证，到了郑州干活，却被甲方一查，说证书信息不对，根本查不到。老王当时就懵了——这证怎么就“被使用”…
📰

电工证鄂托克旗实操考试考什么？官方报名入口你一定要知道

电工证鄂托克旗实操考试考什么？官方报名入口你一定要知道 怕考不过白交培训费？别急，电工证鄂托克旗实操考试到底考什么，我来给你说清楚，帮你避坑。很多人报了电工证鄂托克旗培训，结果考试没过，钱花了不说，还耽误工作。其实，只要方法对，准备充分，通…
📰

电工证的头像怎么更换？官方报名入口你必须知道

电工证的头像怎么更换？官方报名入口你必须知道 学历不高怕报不上名？其实你不是一个人在战斗，很多人都和你有同样的担忧。今天咱们就来聊聊， 电工证的头像怎么更换 ，以及你真正关心的—— 官方报名入口…
📰

高压电工证有什么补贴 怎么报名最稳妥

高压电工证有什么补贴 怎么报名最稳妥 你现在就缺一张高压电工证，找工作处处碰壁，连面试资格都没。别急，今天咱们就来聊聊高压电工证有什么补贴，怎么报名最稳妥，还能帮你省下不少冤枉钱。 高压电工证的补贴政策你知道多少？…
📰

电工证广告视频真实经历：工地太忙根本没时间复习考试怎么办

电工证广告视频真实经历：工地太忙根本没时间复习考试怎么办 工地太忙根本没时间复习考试，我跟你说，这事儿我真经历过。去年刚拿到电工证，那会儿在安阳公路工程干活，每天早上五点起床，晚上十点才收工，中间吃饭的时间都紧张得很，哪还有时间看书复习？结…
📰

宜阳县电工证丢了怎么补办保姆级教程：缺证就缺饭碗，这份教程帮你稳稳上岗

宜阳县电工证丢了怎么补办保姆级教程：缺证就缺饭碗，这份教程帮你稳稳上岗 你是不是正愁着手上没电工证，找工作处处碰壁？宜阳县电工证丢了补办流程复杂又耗时，但要是不补，工作机会可能就溜走了。别急，这是一份保姆级的补办教程，帮你快速恢复证件，重新…
TODAY

今日更新

🆕

安监局电工证分数查询怎么查才能知道含金量高不高

安监局电工证分数查询怎么查才能知道含金量高不高 不知道去哪报名怕被中介坑，这事儿你不是一个人。很多想考电工证的小伙伴都踩过坑，花了不少钱，结果证没拿到，或者拿到的证不被认可。今天咱们就来聊聊 安监局电工证分数查询…
🆕

新疆电工作业干活累吗 良心建议助你避开考不过的坑

新疆电工作业干活累吗 良心建议助你避开考不过的坑 怕考不过白交培训费？这是很多想报考新疆电工作业证书的朋友最担心的问题。其实，考个证没那么难，关键是找对方法、选对机构。今天就来给大家聊聊新疆电工作业到底累不累，工资怎么样，怎么考才不踩坑。…
🆕

中牟县电工证怎么报名外省证能转吗

中牟县电工证怎么报名外省证能转吗 之前考的证在外省能不能转过来，这个问题几乎是每个准备报名或者已经持证的电工都问过的，尤其是在中牟县，很多电工都是在外省考的证，现在回到本地工作，想知道怎么报名和转移手续。其实答案是肯定的，只要符合相关要求，…
THIS WEEK

本周精选

📌

安监局电工证分数查询怎么查才能知道含金量高不高

安监局电工证分数查询怎么查才能知道含金量高不高 不知道去哪报名怕被中介坑，这事儿你不是一个人。很多想考电工证的小伙伴都踩过坑，花了不少钱，结果证没拿到，或者拿到的证不被认可。今天咱们就来聊聊 安监局电工证分数查询…
📌

新疆电工作业干活累吗 良心建议助你避开考不过的坑

新疆电工作业干活累吗 良心建议助你避开考不过的坑 怕考不过白交培训费？这是很多想报考新疆电工作业证书的朋友最担心的问题。其实，考个证没那么难，关键是找对方法、选对机构。今天就来给大家聊聊新疆电工作业到底累不累，工资怎么样，怎么考才不踩坑。…
📌

中牟县电工证怎么报名外省证能转吗

中牟县电工证怎么报名外省证能转吗 之前考的证在外省能不能转过来，这个问题几乎是每个准备报名或者已经持证的电工都问过的，尤其是在中牟县，很多电工都是在外省考的证，现在回到本地工作，想知道怎么报名和转移手续。其实答案是肯定的，只要符合相关要求，…
THIS MONTH

本月热门

🔥

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代&#xff0c;基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而&#xff0c;与配合度高的人类不同&#xff0c;宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态&#xff0c;更无法控制光照环境。实际应用中&#xff0c;我们常…
🔥

基于DRV8818与STM32的双极步进电机驱动方案实战解析

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …
🔥

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

读完文章，想聊聊您的网站？

告诉我们您的行业与需求，资深顾问一对一梳理方案与报价，全程免费。

免费获取方案 400-888-6620
📞 💬