Overview

Full name
docker.io/gravityle/hyperms
Registry
docker.io
Namespace
gravityle
Repository
hyperms
Cached tags
2
Last synced
07/06/2026, 07:03 PM

Introduction

HyperMS 轻量微服务管理平台镜像,集中注册、路由与健康检查后端实例,提供 Web 控制台与 REST API,适合中小团队拆分单体后的服务治理。

Details

gravityle/hyperms 将服务注册发现、网关路由与基础监控整合为单体部署包,管理员通过浏览器维护 upstream、权重与熔断策略,业务服务以 HTTP 注册即可被统一入口转发。与 Consul+Envoy 全栈相比组件更少、上手更快,但高可用与多数据中心能力需自行扩展。生产应固定管理端口鉴权、持久化注册表数据,并将 TLS 终结放在前置反向代理。

快速启动

docker run -d --name hyperms \
  -p 8080:8080 \
  docker.io/gravityle/hyperms:latest

推荐实践

docker run -d --name hyperms \
  --restart unless-stopped \
  -p 8080:8080 -p 9090:9090 \
  -v hyperms-data:/data \
  -e HYPERMS_ADMIN_USER=admin \
  -e HYPERMS_ADMIN_PASS=change-me \
  -e HYPERMS_DB_PATH=/data/registry.db \
  docker.io/gravityle/hyperms:1.2.0

核心参数说明

  • -p 8080:8080 — Web 控制台与注册 API
  • -p 9090:9090 — 网关转发入口
  • -v hyperms-data:/data — 服务注册表与配置持久化
  • -e HYPERMS_ADMIN_USER/PASS — 管理面登录凭证
  • -e HYPERMS_DB_PATH — SQLite/元数据存储路径
  • --restart unless-stopped — 控制面异常自动恢复

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: hyperms
spec:
  replicas: 2
  selector:
    matchLabels:
      app: hyperms
  template:
    metadata:
      labels:
        app: hyperms
    spec:
      containers:
        - name: hyperms
          image: docker.io/gravityle/hyperms:1.2.0
          ports:
            - containerPort: 8080
            - containerPort: 9090
          env:
            - name: HYPERMS_ADMIN_PASS
              valueFrom:
                secretKeyRef:
                  name: hyperms-secrets
                  key: admin-pass
          volumeMounts:
            - name: data
              mountPath: /data
      volumes:
        - name: data
          persistentVolumeClaim:
            claimName: hyperms-data
---
apiVersion: v1
kind: Service
metadata:
  name: hyperms
spec:
  selector:
    app: hyperms
  ports:
    - name: admin
      port: 8080
      targetPort: 8080
    - name: gateway
      port: 9090
      targetPort: 9090

管理端口经 Ingress 限制内网访问;注册数据 PVC 需 ReadWriteOnce,网关 9090 可单独 Service 供业务 Pod 调用。

Latest tags (20)

View all 2 tags →
TagArchPushed AtSizeDigestSyncWishAction
docker.io/gravityle/hyperms
:latest
linux/amd64linux/arm64
2026/05/20 23:13153.4 MBsha256:dfdb5d90f655
docker.io/gravityle/hyperms
:beta
linux/amd64linux/arm64
2026/05/19 22:52153.2 MBsha256:ca476662446e