nhost/hasura-storage

Hasura Storage

概述

Hasura Storage 是一款基于HTTP的存储服务，专为与Hasura GraphQL引擎集成设计，提供文件上传、下载、删除、签名URL生成等核心功能，支持JWT令牌授权和请求限流，可通过环境变量灵活配置。

核心功能与特性

API端点

授权机制

除 /healthz 和 /token 外，所有API端点均需在请求头中携带 Authorization: Bearer {token} 进行授权。

限流配置

上传端点（/upload）支持请求限流，限流参数可通过环境变量配置。

使用场景与适用范围

适用于需要文件存储功能且与Hasura GraphQL引擎集成的应用，可作为后端服务提供文件上传、下载等管理能力，尤其适合依赖GraphQL接口进行数据交互的项目。

使用方法与配置说明

Docker构建与运行

构建镜像

bash
docker build -t [镜像名称] .

运行镜像

方式一：直接指定环境变量

bash
docker run -p [宿主机端口]:[容器端口] \
  -e DATABASE_URL=[数据库连接URL] \
  -e S3_ACCESS_KEY=[存储桶访问密钥] \
  -e S3_SECRET_KEY=[存储桶密钥] \
  -e S3_ENDPOINT=[存储桶端点URL] \
  -e S3_BUCKET=[存储桶名称] \
  -e GRAPHQL_ENGINE_BASE_URL=[Hasura GraphQL引擎基础URL] \
  -e GRAPHQL_ENDPOINT=[GraphQL端点路径] \
  -e HASURA_GRAPHQL_ADMIN_SECRET=[Hasura GraphQL管理员密钥] \
  -e JWT_SECRET=[JWT令牌密钥] \
  -e KEY=[加密密钥] \
  -e SIGNED_URL_TTE=[签名URL过期时间（分钟）] \
  -e TOKEN_TTE=[访问令牌过期时间（分钟）] \
  -e REQ_PER_MIN=[每分钟请求数限制] \
  -e REQ_BURST=[突发请求允许数量] \
  [镜像名称]

方式二：使用.env文件

bash
docker run -p [宿主机端口]:[容器端口] --env-file [env文件路径] [镜像名称]

环境变量配置说明