e2fyi/minio-web

github.com/e2fyi/minio-web


一个适用于任何S3兼容存储的Web服务器代理。

快速开始

环境变量

bash
# 配置文件所在位置
CONFIG_FILE_PATH=configs/config.json

# minio-web监听的端口
SERVER_PORT=8080
# SSL证书和密钥文件的路径
SERVER_SSL_CERT=
SERVER_SLL_KEY=

# S3兼容存储的端点地址
MINIO_ENDPOINT=s3.amazonaws.com
# 访问密钥和秘密密钥
MINIO_ACCESSKEY=
MINIO_SECRETKEY=
# 调用端点时是否使用SSL
MINIO_SECURE=true
# AWS S3存储桶区域（可选）
MINIO_REGION=

# 扩展配置 #
# 若提供，则服务指定存储桶（http://minio-web/abc => endpoint/bucketname/abc）
# 若未提供，则路径中的第一段为存储桶（http://minio-web/abc/efg => endpoint/abc/efg）
EXT_BUCKETNAME=

# 添加到查询的前缀
# 例如 EXT_PREFIX=foo/，则查询endpoint/abc会转为查询EXT_BUCKETNAME/foo/abc
EXT_PREFIX=

# 若提供，返回默认索引文件列表
# 如 http://minio-web/abc/ => http://minio-web/abc/index.html
EXT_DEFAULTHTML=index.html,README.md

# 若提供，当后端无favicon时返回默认favicon
EXT_FAVICON=assets/favicon.ico

# 若设置为true，则列出文件夹内的内容
EXT_LISTFOLDER=true
# 匹配glob表达式的对象会被列出，例如markdown文件
EXT_LISTFOLDEROBJECTS=*.{md,html,jpg,jpeg,png,txt}

# 若提供，使用模板将markdown资源渲染为HTML
# 模板必须包含占位符 {{ .Content }}
EXT_MARKDOWNTEMPLATE=assets/md-template.html

配置文件

json
{
  "server": {
    "port": 8080,
    "ssl": {
      "cert": "",
      "key": ""
    }
  },
  "minio": {
    "endpoint": "s3.amazonaws.com",
    "accesskey": "",
    "secretkey": "",
    "secure": false,
    "region": ""
  },
  "ext": {
    "bucketname": "",
    "defaulthtml": "index.html,README.md",
    "favicon": "assets/favicon.ico",
    "markdowntemplate": "assets/md-template.html",
    "listfolder": true,
    "listfolderobjects": "*.{md,html,jpg,jpeg,png,txt}"
  }
}

本地运行演示

bash
# 启动minio服务器
./scripts/start-minio-server.sh

# 启动minio-web服务
go run .

或者使用docker compose：

bash
# 可通过localhost:9000访问minio存储，localhost:8080访问minio-web
docker-compose up -d

Docker镜像

由于Dockerhub的拉取限制，镜像现在同时在https://hub.docker.com/r/e2fyi/minio-web%E5%92%8CQuay.io%E6%8F%90%E4%BE%9B%E3%80%82

• e2fyi/minio-web:<tag>
• quay.io/e2fyi/minio-web:<tag>

bash
# 本地构建
docker build -t e2fyi/minio-web:latest .

# 从Dockerhub拉取
docker pull e2fyi/minio-web:latest

# 运行Docker容器
docker run --rm -ti \
    -p 8080:8080 \
    --env-file .envfile \
    e2fyi/minio-web:latest

Kubernetes部署（Kustomize）

minio-web的https://github.com/kubernetes-sigs/kustomize Kubernetes清单可在manifest/目录找到。

GoDoc

• https://godoc.org/github.com/e2fyi/minio-web/
• https://godoc.org/github.com/e2fyi/minio-web/pkg/app
• https://godoc.org/github.com/e2fyi/minio-web/pkg/core
• https://godoc.org/github.com/e2fyi/minio-web/pkg/minio
• https://godoc.org/github.com/e2fyi/minio-web/pkg/ext