配置 S3 存储服务
LobeHub 支持多模态的 AI 会话,包括将图片、文件等非结构化数据上传给大模型的功能。为了优化存储和性能,我们使用 S3 兼容的文件存储服务来存储图片文件和支持文件上传 / 知识库功能。
核心环境变量
S3_ACCESS_KEY_ID
- 类型:必填
- 描述:用于访问 S3 存储服务的访问密钥 ID
- 默认值:-
- 示例:
AKIAIOSFODNN7EXAMPLE
S3_SECRET_ACCESS_KEY
- 类型:必填
- 描述:用于访问 S3 存储服务的秘密访问密钥
- 默认值:-
- 示例:
wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
S3_ENDPOINT
- 类型:必填
- 描述:存储桶的请求端点,对于
virtual-host模式,不应包含前缀存储桶名称 - 默认值:-
- 示例:
https://cos.ap-chengdu.myqcloud.com
S3_INTERNAL_ENDPOINT
- 类型:可选
- 描述:LobeHub 服务端自身发起 S3 请求(上传、元数据校验、读取、创建存储桶)时使用的端点。当
S3_ENDPOINT只能被浏览器访问时配置,例如 Docker Compose 服务名。预签名 URL 仍使用S3_ENDPOINT。 - 默认值:
-(使用S3_ENDPOINT) - 示例:
http://rustfs:9000
S3_BUCKET
- 类型:必填
- 描述:存储桶的名称
- 默认值:-
- 示例:
my-bucket
S3_REGION
- 类型:可选
- 描述:存储桶的区域
- 默认值:-
- 示例:
ap-chengdu
S3_SET_ACL
- 类型:可选
- 描述:是否在上传文件时设置 ACL 为
public-read - 默认值:
-(默认关闭,仅显式设置为1时才会设置 public-read ACL) - 示例:
1
S3_ENABLE_PATH_STYLE
- 类型:可选
- 描述:是否启用 S3 的
path-style访问模式 - 默认值:
0 - 示例:
1
path-style 和 virtual-host 在 S3 中是访问 bucket 和 object 的不同方式,URL 的结构和域名解析不太一样
假设 S3 服务商的域名是 s3.example.net ,bucket 为 mybucket,object 为 config.env,具体区别如下:
- path-style :
s3.example.net/mybucket/config.env - virtual-host :
mybucket.s3.example.net/config.env
LLM_VISION_IMAGE_USE_BASE64
- 类型:可选
- 描述:设置为 1 则使用 base64 编码上传图片
- 默认值:undefined
- 示例:
1
当设置为 1 时,LobeHub 会将图片转换为 base64 编码后上传到 LLM 模型中,当遇到如下错误时请考虑配置该环境变量为 1
Plaintext
LLM_VISION_VIDEO_USE_BASE64
- 类型:可选
- 描述:设置为 1 则使用 base64 编码上传视频
- 默认值:undefined
- 示例:
1
当设置为 1 时,LobeHub 会将视频转换为 base64 编码后上传到 LLM 模型中。