当前位置：首页 > article >正文

lobechat环境变量汇总（docker版）

article 2025/3/1 5:53:28

LobeChat 环境变量配置指南 · LobeChat Docs · LobeHub

上述是官方环境变量的配置指南，我并不会总结所有的环境变量用法，只会根据自行使用时，遇到的问题总结

s3存储变量

S3_ENABLE_PATH_STYLE

类型：可选

描述：是否启用 S3 的 path-style 访问模式

默认值：0

示例：1

问题描述：当遇到域名和桶名组合出现问题时，请务必注意修改相关变量以解决文件上传至知识库时的域名拼接问题。在尝试上传文件时，你可能会遇到域名和存储桶名称拼接错误的情况。正确的格式应该是 https://s3域名：端口/桶/XXXX目录，但你可能错误地拼接成了 https://桶.s3域名：端口/XXXX目录。请仔细检查并修正你的域名和存储桶名称的拼接方式，修改对应的参数

模型变量

API_KEY_SELECT_MODE 多个API KEY轮询变量

类型：可选
描述：用于控制多个 API Keys 时，选择 Key 的模式，当前支持 random 和 turn
默认值：random
示例：random 或 turn

使用 random 模式下，将在多个 API Keys 中随机获取一个 API Key。

使用 turn 模式下，将按照填写的顺序，轮询获取得到 API Key。

ENABLED_XXX=1/0

类型：可选
描述：默认启用 XXX 作为模型供应商，当设为 0 时关闭 XXX模型服务
默认值：1
示例：0

XXXX_MODEL_LIST

类型：可选
描述：用来控制模型列表，使用 + 增加一个模型，使用 - 来隐藏一个模型，使用 模型名=展示名<扩展配置> 来自定义模型的展示名，用英文逗号隔开。模型定义语法规则见
默认值：-
示例：-all,+qwen2.5-coder:14b,+qwen2.5:14b,+phi3:14,+deepseek-r1:14b

DEFAULT_AGENT_CONFIG

类型：可选
描述：用于配置 LobeChat 默认助理的默认配置。它支持多种数据类型和结构，包括键值对、嵌套字段、数组值等。
默认值：-
示例：DEFAULT_AGENT_CONFIG="model=gemini-2.0-flash-thinking-exp-1219;provider=google;chatConfig.enableReasoningEffort=true;params.reasoning_effort=high;"

如果你要指定默认助手的模型时，最少要拥有两个参数DEFAULT_AGENT_CONFIG="model=gemini-2.0-flash-thinking-exp-1219;provider=google;"

一个是模型另一个是厂商，