kubesealwebgui/api

kubeseal-webgui API镜像文档

镜像概述

本镜像为https://github.com/Jaydee94/kubeseal-webgui%E9%A1%B9%E7%9B%AE%E7%9A%84%E5%90%8E%E7%AB%AFAPI%E7%BB%84%E4%BB%B6%EF%BC%8C%E6%8F%90%E4%BE%9BWeb%E7%95%8C%E9%9D%A2%E6%89%80%E9%9C%80%E7%9A%84%E6%A0%B8%E5%BF%83API%E6%9C%8D%E5%8A%A1%E3%80%82%E5%9F%BA%E4%BA%8Ekubeseal%E5%B7%A5%E5%85%B7%E9%93%BE%E6%9E%84%E5%BB%BA%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%9C%A8Kubernetes%E9%9B%86%E7%BE%A4%E4%B8%AD%E5%AE%89%E5%85%A8%E7%AE%A1%E7%90%86%E3%80%81%E5%8A%A0%E5%AF%86%E5%92%8C%E8%A7%A3%E5%AF%86Secrets%E8%B5%84%E6%BA%90%EF%BC%8C%E6%98%AF%E5%AE%8C%E6%95%B4Web%E7%AE%A1%E7%90%86%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E7%9A%84%E5%90%8E%E7%AB%AF%E6%94%AF%E6%92%91%E7%BB%84%E4%BB%B6%E3%80%82

核心功能与特性

核心功能

• 与kubeseal工具深度集成，支持Secrets资源的加密、解密及管理操作
• 提供RESTful API接口，供前端Web界面调用以实现交互功能
• 支持Kubernetes集群连接配置，通过kubeconfig或集群内服务账户访问集群资源

关键特性

• 安全合规：遵循kubeseal加密标准，确保Secrets以加密形式存储
• 可配置性：支持通过环境变量自定义端口、日志级别、认证策略等
• 兼容性：兼容主流Kubernetes版本及kubeseal工具版本
• 可观测性：内置日志记录功能，支持集成外部监控系统

使用场景与适用范围

典型使用场景

• 配合kubeseal-webgui前端镜像部署，构建完整的Kubernetes Secrets Web管理平台
• 为Kubernetes管理员提供图形化界面，简化Secrets创建、加密、更新及删除流程
• 适用于多团队协作环境，实现Secrets资源的集中化管理与权限控制

适用范围

• Kubernetes集群管理员及运维团队
• 需要安全管理集群敏感信息（如数据库凭证、API密钥）的场景
• 采用GitOps工作流，需对Secrets进行版本化管理的环境

使用方法与配置说明

前置条件

• 已部署Kubernetes集群（v1.19+推荐）
• 集群内已安装kubeseal控制器（参考https://github.com/bitnami-labs/sealed-secrets%EF%BC%89
• 如需外部访问集群，需准备有效的kubeconfig文件

环境变量配置

Docker运行示例

集群内部署（使用服务账户）

bash
docker run -d \
  --name kubeseal-webgui-api \
  -p 3000:3000 \
  -e LOG_LEVEL=info \
  -e AUTH_ENABLED=true \
  -e JWT_SECRET=your-secure-jwt-secret \
  --mount type=secret,source=kube-api-access-xxxx,target=/var/run/secrets/kubernetes.io/serviceaccount \
  jaydee94/kubeseal-webgui-api:latest

集群外部署（使用kubeconfig）

bash
docker run -d \
  --name kubeseal-webgui-api \
  -p 3000:3000 \
  -e KUBECONFIG=/app/kubeconfig \
  -e LOG_LEVEL=debug \
  -v /path/to/your/kubeconfig:/app/kubeconfig \
  jaydee94/kubeseal-webgui-api:latest

Docker Compose配置示例（配合前端）

yaml
version: '3.8'

services:
  api:
    image: jaydee94/kubeseal-webgui-api:latest
    container_name: kubeseal-webgui-api
    ports:
      - "3000:3000"
    environment:
      - LOG_LEVEL=info
      - AUTH_ENABLED=true
      - JWT_SECRET=your-jwt-secret-here
      - KUBECONFIG=/app/kubeconfig
    volumes:
      - ./kubeconfig:/app/kubeconfig
    restart: unless-stopped

  frontend:
    image: jaydee94/kubeseal-webgui:latest
    container_name: kubeseal-webgui-frontend
    ports:
      - "80:80"
    environment:
      - API_URL=http://api:3000
    depends_on:
      - api
    restart: unless-stopped

注意事项

• 生产环境中必须启用AUTH_ENABLED并配置强JWT_SECRET，避免未授权访问
• 确保kubeconfig文件权限设置正确（仅运行用户可读取），避免敏感信息泄露
• 镜像版本应与kubeseal-webgui前端镜像版本保持一致，避免API兼容性问题
• 集群内部署时，建议通过Kubernetes Deployment而非直接docker run部署，以利用集群自愈能力

参考链接

• 项目主页：https://github.com/Jaydee94/kubeseal-webgui
• kubeseal官方文档：https://github.com/bitnami-labs/sealed-secrets