arztz/aws-js-s3-explorer

S3 Web应用镜像

镜像概述

本镜像为分叉自awslabs/aws-js-s3-explorer的S3 Web应用，专为通过服务账户认证设计。它通过环境变量自动完成S3连接配置，绕过传统设置菜单，简化S3桶的访问与管理流程，提供便捷的Web界面操作体验。

核心功能与特性

• 服务账户集成：采用服务账户认证机制，无需手动输入AWS访问凭证
• 自动连接配置：通过环境变量参数自动完成S3连接，启动后直接可用，无需手动配置
• 多桶支持：允许通过环境变量指定多个S3桶（使用逗号分隔），实现多桶集中管理
• 简化部署流程：减少手动配置步骤，降低使用门槛，提升部署效率

使用场景与适用范围

适用于需要快速部署S3管理界面的场景，特别适合容器化环境（如Kubernetes）中通过服务账户实现安全认证的场景。可用于开发、测试及生产环境中S3桶的日常管理与文件操作。

使用方法与配置说明

环境变量配置

Docker部署示例

基本运行命令

bash
docker run -d \
  -p 80:80 \
  -e S3_BUCKET="my-first-bucket,my-second-bucket" \
  -e AWS_REGION="us-east-1" \
  -e AWS_ROLE_ARN="arn:aws:iam::123456789012:role/s3-access-role" \
  -e AWS_WEB_IDENTITY_TOKEN_FILE="/var/run/secrets/kubernetes.io/serviceaccount/token" \
  --name s3-web-explorer \
  [镜像名称]

Kubernetes部署示例

在Kubernetes环境中，服务账户会自动注入AWS_REGION、AWS_ROLE_ARN和AWS_WEB_IDENTITY_TOKEN_FILE环境变量，仅需配置S3_BUCKET：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: s3-explorer
spec:
  replicas: 1
  selector:
    matchLabels:
      app: s3-explorer
  template:
    metadata:
      labels:
        app: s3-explorer
    spec:
      serviceAccountName: s3-service-account  # 需预先创建具有S3访问权限的服务账户
      containers:
      - name: s3-explorer
        image: [镜像名称]
        ports:
        - containerPort: 80
        env:
        - name: S3_BUCKET
          value: "production-bucket,backup-bucket"

访问方式

容器启动后，通过访问http://<容器IP>:80或绑定的宿主机端口即可打开S3 Web管理界面，系统将自动连接并展示指定的S3桶内容。