环境变量

欢迎阅读使用 .env 文件配置应用程序环境的综合指南。本文档是您了解和自定义环境变量的一站式资源，这些变量将决定您的应用程序在不同环境下的行为方式。

虽然默认设置已为标准的 docker 安装提供了坚实的基础，但深入阅读本指南将揭示 LibreChat 的全部潜力。本指南旨在帮助您根据具体需求定制 LibreChat。了解如何调整语言模型的可用性、集成社交登录、管理自动审核系统等等。这一切都是为了让您能够掌控并微调 LibreChat，以获得最佳的用户体验。

提醒：请重启 LibreChat 以使配置更改生效

或者，您可以在 LibreChat 的主 docker-compose.yml 文件所在的目录下创建一个名为 docker-compose.override.yml 的新文件，在其中根据需要于 environment 下设置您的 .env 变量，或者修改主 docker-compose.yml 提供的默认配置，而无需直接编辑或复制整个文件。

更多信息请参阅：

• 我们的快速指南：

  • Docker Override

• 官方 Docker 文档：

  • docker docs - understanding-multiple-compose-files
  • docker docs - merge-compose-files
  • docker docs - specifying-multiple-compose-files

• 您也可以在您的 LibreChat 文件夹中以及 GitHub 上查看 LibreChat 的覆盖文件示例：

  • docker-compose.override.example

---

服务器配置

端口

• 服务器监听特定端口。
• PORT 环境变量用于设置服务器监听的端口。默认情况下，它被设置为 3080。

Trust proxy

使用距离 Express 应用程序最多 n 跳的地址。 req.socket.remoteAddress 是第一跳，其余地址从右到左在 X-Forwarded-For 标头中查找。 值为 0 表示第一个不受信任的地址将是 req.socket.remoteAddress，即没有反向代理。 TRUST_PROXY 环境变量的默认值设置为 1。

有关此内容的更多信息，请参阅 Express.js - trust proxy。

凭据配置

为了安全地存储凭据，您需要一个固定的密钥和 IV。您可以在此处为生产环境和开发环境设置它们。

静态文件处理

行为：

为静态文件设置 Cache-Control 响应头。这些配置仅在 NODE_ENV 设置为 production 时生效。

• 取消注释 STATIC_CACHE_MAX_AGE 以更改静态文件的本地 max-age。默认设置为 2 天（172800 秒）。
• 取消注释 STATIC_CACHE_S_MAX_AGE 以设置共享缓存（CDN 和代理）的 s-maxage。默认设置为 1 天（86400 秒）。
• 取消注释 DISABLE_COMPRESSION 以禁用静态文件的压缩。默认情况下，压缩是启用的。
• 取消注释 ENABLE_IMAGE_OUTPUT_GZIP_SCAN 以启用对已压缩图像的扫描和提供服务功能，前提是这些图像已在同一文件夹中预先压缩，且具有相同的文件名及 .gz 扩展名。默认情况下，上传图像的 gzip 扫描功能处于禁用状态。
• 取消注释 ENABLE_STATIC_ASSET_BROTLI 以在存在预压缩的 .br 版本时，提供静态应用资源的预压缩版本。启用后，对于 API 提供的静态文件，Brotli 的优先级高于 gzip。

Index HTML 缓存控制

行为：

专门为 index.html 响应控制缓存头。默认情况下，这些设置会禁止缓存，以确保用户始终获取应用程序的最新版本。

MongoDB 数据库

如果您的 MongoDB URI 不同，请将其更改为此处。您应该在 URI 中将 LibreChat 或您自己的 APP_TITLE 添加为数据库名称。

如果您正在使用在线数据库，URI 格式为 mongodb+srv://<username>:<password>@<host>/<database>?<options>。您的 MONGO_URI 应该如下所示：

• mongodb+srv://username:[email protected]/LibreChat?retryWrites=true（使用在线数据库时，retryWrites 是您唯一需要配置的选项。）

MongoDB 连接池配置

MongoDB Schema 配置

或者，您可以使用模拟 mongoDb 的 documentDb，但它：

• 不支持 retryWrites - 请使用 retryWrites=false
• 需要 TLS 连接，因此请使用参数 tls=true 来启用 TLS，并使用 tlsCAFile=/path-to-ca/bundle.pem 来指向 AWS 提供的 CA 证书包文件。

documentDb 的 URI 看起来如下：

• mongodb+srv://username:password@domain/dbname?retryWrites=false&tls=true&tlsCAFile=/path-to-ca/bundle.pem

另请参阅：

• MongoDB Atlas，了解如何创建在线 MongoDB Atlas 数据库（适用于不使用 Docker 的情况）
• MongoDB Community Server，了解如何创建本地 MongoDB 数据库（不使用 Docker）的说明
• MongoDB Authentication 若要在 Docker 中为 MongoDB 启用显式身份验证。
• 使用 Mongo Express 管理您的数据库，以便安全地访问您的 Docker MongoDB 数据库

应用领域

若要配置 LibreChat 以供本地使用或自定义域名部署，请设置以下环境变量：

当将 LibreChat 部署到自定义域名时，请将 http://localhost:3080 替换为您部署后的 URL。

• 例如 https://librechat.example.com。

防止公共搜索引擎索引

默认情况下，您的网站不会被公共搜索引擎（如 Google、Bing 等）索引。这意味着人们将无法通过这些搜索引擎找到您的网站。如果您希望提高网站的可见度和可搜索性，可以将以下设置更改为 false

❗注意： 此方法不能保证对所有搜索引擎都有效，且某些搜索引擎仍可能出于其他目的（例如缓存或归档）索引您的网站或网页。因此，您不应仅依赖此方法来保护网站或网页上的敏感或机密信息。

日志记录

LibreChat 具有内置的中央日志记录功能，更多信息请参阅 Logging System。

日志文件

• 调试日志默认处于启用状态，这对开发至关重要。
• 若要报告问题，请复现错误并提交 ./api/logs/debug-%DATE%.log 中的日志至：LibreChat GitHub Issues
• 错误日志存储在相同的位置。

环境变量

注意：

• DEBUG_LOGGING 可以与 DEBUG_CONSOLE 或 CONSOLE_JSON 中的任意一个配合使用，但不能同时使用两者。
• DEBUG_CONSOLE 和 CONSOLE_JSON 是互斥的。
• CONSOLE_JSON：在云部署（如 GCP 或 AWS）中处理控制台日志时，启用此项将以 JSON 格式输出带有 UTC 时间戳的日志。
  • 请参阅：feat: Add CONSOLE_JSON

注意：不建议使用 DEBUG_CONSOLE，因为其输出可能非常冗长，因此默认情况下它是禁用的。

权限

UID 和 GID 是 Linux 系统分配给每个用户和组的数字。如果您遇到权限问题，请在此处设置运行 Docker Compose 命令的用户的 UID 和 GID。容器中的应用程序将以这些 UID/GID 运行。

OpenTelemetry Tracing

LibreChat 可以为通用 API、HTTP、MongoDB、Mongoose、Redis 和出站请求的可视性发出后端 OpenTelemetry 追踪。Redis 命令级跨度（spans）为可选功能，因此默认追踪保持在高层级。使用 Langfuse 进行 GenAI 特定的提示词/模型可观测性。

真实用户监控 (浏览器)

LibreChat 可以将浏览器真实用户监控 (RUM) 遥测数据发布到兼容 HyperDX 的 OTLP 收集器。RUM 默认处于禁用状态。

在 publicToken 模式下，浏览器将遥测数据直接发送到带有 RUM_PUBLIC_TOKEN 的 RUM_URL。在 proxy 模式下，浏览器通过 LibreChat 发送遥测数据；后端会验证用户会话，剥离应用身份验证标头，并将遥测数据转发到 RUM_PROXY_TARGET_URL。无效或过期的会话将以 204 响应被丢弃，因此浏览器遥测失败不会显现出正常的 API 身份验证错误。代理结果会在 LibreChat API /metrics 端点上通过带有 endpoint 和 result 标签的 rum_proxy_requests_total 进行统计。

配置路径 - librechat.yaml

为 LibreChat 配置文件指定一个替代位置。

您可以指定绝对路径、相对路径或 URL。路径中的文件名非常灵活，不必非得是 librechat.yaml；任何有效的配置文件均可使用。

注意：如果您希望 LibreChat 在根目录中搜索配置文件（这是默认行为），只需将此选项保持注释状态即可。

部署技巧

Deployment Skills 在启动时以只读方式从文件系统加载，并向启用了 Skills 功能的用户公开。

更改此目录或其中的任何文件后，请重启 LibreChat。部署提供的 Skills 优先级高于同名的持久化 Skills。

配置验证

默认情况下，如果 librechat.yaml 配置文件包含验证错误，LibreChat 将会报错退出（退出代码 1）。这种快速失败（fail-fast）行为有助于在部署流水线中尽早发现配置问题，并防止在非预期的默认设置下运行。

未捕获异常处理

默认情况下，LibreChat 会在发生未捕获异常时退出进程，这是 Node.js 的标准行为。你可以覆盖此设置，以便在出现未捕获异常后保持应用运行。

Endpoints

在本节中，您可以配置 endpoint 和模型选择、它们的 API 密钥，以及支持该功能的 endpoint 的代理和反向代理设置。

通用配置

取消注释 ENDPOINTS 以自定义 LibreChat 中可用的 endpoint。

已知 endpoint - librechat.yaml

• 另请参阅：自定义 Endpoints 与配置

网络搜索

网页搜索功能可在 LibreChat 中启用互联网搜索能力。

重要提示：下方所示的确切环境变量名称均为默认参考，您可以通过 librechat.yaml 配置文件进行自定义，以使用您偏好的任何变量名称。

有关详细的配置和自定义选项，请参阅：Web Search Configuration

注意：这些变量名称可以在您的 librechat.yaml 配置文件中进行自定义。例如，您可以通过在网页搜索设置中进行配置，使用 CUSTOM_SERPER_KEY 来代替 SERPER_API_KEY。有关自定义变量名称的详细信息，请参阅 Web Search Configuration 文档。

Anthropic

请参阅：Anthropic Endpoint

• 您可以从 https://platform.claude.com/ 申请访问密钥。
• 将 ANTHROPIC_API_KEY= 留空以禁用此 endpoint
• 将 ANTHROPIC_API_KEY= 设置为 "user_provided"，以允许用户从 WebUI 提供他们自己的 API 密钥。
• 如果您有 Anthropic 的反向代理访问权限，可以通过 ANTHROPIC_REVERSE_PROXY= 进行设置。
  • 留空或注释掉以使用默认 base url

• ANTHROPIC_TITLE_MODEL 现已弃用，并将在未来版本中移除。请改用 librechat.yaml 配置文件中的 titleModel 端点设置。

注意： 必须与 Anthropic endpoint 兼容。此外，Claude 2 和 Claude 3 模型在此任务中表现最佳，其中 claude-3-haiku 模型最为经济实惠。

Claude Fable 5 已包含在默认的 Anthropic 模型列表中。Fable/Mythos 类模型在 LibreChat 中使用现代 Anthropic 行为：支持 1M 上下文、自适应思维（adaptive thinking）支持、提示词缓存（prompt caching）支持，以及针对摘要或省略推理输出的 thinkingDisplay 处理。

通过 Vertex AI 使用 Anthropic

您也可以通过 Google Cloud Vertex AI 使用 Anthropic Claude 模型。有关详细的 YAML 配置选项，请参阅：Anthropic Vertex AI Configuration

注意： 使用 Vertex AI 时，您还必须配置 GOOGLE_SERVICE_KEY_FILE（请参阅 Google 配置），并使用具有 Vertex AI User 角色的服务账号。

AWS Bedrock

请参阅：AWS Bedrock Setup

注意： 您可以省略访问密钥以使用默认的 AWS 凭证链（环境变量、SSO 凭证、共享凭证文件或 EC2/ECS 实例元数据服务）。有关更多详细信息，请参阅 AWS Bedrock Setup。

Bedrock 上的 Claude Fable/Mythos 类模型仅支持推理配置文件（inference-profile）。请使用诸如 us.anthropic.claude-fable-5 的配置文件 ID，并在调用它们之前在 Bedrock 控制台或数据保留 API（Data Retention API）中启用所需的 Anthropic 数据共享设置。

BingAI

Bing，也用于 Sydney、越狱以及 Bing Image Creator

注意：建议将其保留为 "user_provided" 并从 WebUI 提供令牌。

Google

请按照这些说明来设置 Google Endpoint

自定义可用模型，以逗号分隔，不要包含空格。第一个模型将作为默认模型。留空或注释掉该项以使用内部设置。

• GOOGLE_TITLE_MODEL 现已弃用，并将在未来版本中移除。请改用 librechat.yaml 配置文件中的 titleModel Endpoint Setting。

注意： 对于 Vertex AI 的 GOOGLE_SAFETY 变量，默认情况下您无法访问 BLOCK_NONE 设置。要使用此受限的 HarmBlockThreshold 设置，您需要执行以下任一操作：

• (a) 通过您的 Google 账户团队获取允许列表 (allowlist) 访问权限
• (b) 按照此说明将您的账户类型切换为月度发票结算： https://cloud.google.com/billing/docs/how-to/invoiced-billing

Gemini 图像生成

Gemini Image Generation 是一个适用于 Agents 的工具，同时支持 Gemini API 和 Vertex AI。请参阅：Gemini Image Generation

注意： 当未配置 API key 时，该工具会自动回退到使用来自 GOOGLE_SERVICE_KEY_FILE 的服务账号的 Vertex AI。该服务账号必须拥有 Vertex AI User 角色。

OpenAI

请参阅：OpenAI Setup

• OPENAI_TITLE_MODEL 现已弃用，并将在未来版本中移除。请改用 librechat.yaml 配置文件中的 titleModel 端点设置。
• OPENAI_REVERSE_PROXY 现已弃用，并将在未来版本中移除。请改用自定义 endpoint。

Assistants

请参阅：Assistants Setup

注意：您可以自定义可用模型，以逗号分隔，且不含空格。第一个模型将作为默认模型。留空或注释掉该项以使用内部设置。

Tavily

在此处获取您的 API key：https://tavily.com/#api

环境变量：

Traversaal

描述： LLM 增强型搜索工具。

在此处获取 API key：https://api.traversaal.ai/dashboard

环境变量：

WolframAlpha

详细说明请见此处：Wolfram Alpha

环境变量：

Zapier

描述： - 您需要一个 Zapier 账户。请从此处获取您的 API 密钥：Zapier

• 创建允许的操作 - 请遵循 Zapier 入门指南中的第 3 步

注意： Zapier 在执行某些操作时可能会比较挑剔。编写电子邮件草稿可能是它最适合的用途。

环境变量：

OpenWeather

查看详细说明请点击此处：OpenWeather

Code Interpreter

Code Interpreter API 提供了一个用于执行代码和管理文件的安全环境。请参阅：Code Interpreter API

Artifacts

Artifacts 利用 CodeSandbox 库来安全地渲染 HTML/JS 代码。默认情况下，使用由 CodeSandbox 托管的公共 CDN。

幸运的是，对于有内部网络需求的用户，您可以自托管打包器来编译前端代码，并为 Sandpack 指定自定义的打包器 URL。

有关更多信息，包括已移除指标请求的自托管预制容器镜像，请参阅：https://github.com/LibreChat-AI/codesandbox-client

搜索 (Meilisearch)

启用消息和对话搜索：

注意：如果您没有使用 Docker，则需要安装免费的自托管 Meilisearch 或付费的远程方案。

若要为 MeiliSearch 禁用匿名遥测分析以实现绝对隐私，请设置为 true：

为了让 API 服务器连接到搜索服务器。如果使用 docker-compose 部署 MeiliSearch，请将 '0.0.0.0' 替换为 'meilisearch'。

此主密钥必须至少为 16 字节，并由有效的 UTF-8 字符组成。如果未提供主密钥或密钥少于 16 字节，MeiliSearch 将抛出错误并拒绝启动。MeiliSearch 会建议一个自动生成的安全主密钥。这是一个为 docker-compose 准备好的安全密钥，你可以将其替换为你自己的密钥。

为了防止 LibreChat 尝试与 Meilisearch 进行数据库索引同步，您可以将以下环境变量设置为 true。这在节点集群或多节点设置中非常有用，因为在这种情况下，应该只有一个实例负责索引。

RAG API

配置检索增强生成 (RAG) 以进行文档索引和上下文感知响应。请参阅：RAG API Configuration

注意： 当使用默认的 Docker 设置时，.env 文件会在 LibreChat 和 RAG API 之间共享。有关完整的配置选项，请参阅 RAG API 文档。

语音转文字与文字转语音

配置语音转文字 (STT) 和文字转语音 (TTS) 服务。请参阅：语音设置

注意： STT 和 TTS 主要通过 librechat.yaml 中的 speech: 部分进行配置。这些环境变量在配置中被引用。有关完整的 YAML 配置选项，请参阅 Speech Settings。

共享链接

配置共享对话链接功能。

ALLOW_SHARED_LINKS 是功能范围内的总开关。角色权限现在可以控制谁能够创建共享链接、与已认证用户共享链接，或将其设置为对所有人可见；请参阅 interface.sharedLinks。ALLOW_SHARED_LINKS_PUBLIC 仅控制公开共享链接是否可以在无需认证的情况下被查看。SHARED_LINKS_SNAPSHOT_FILES 是共享链接文件快照的全局覆盖设置，当设置为 false 时，可以禁用所有链接的快照服务。

用户系统

本节包含以下内容的配置：

• 自动审核
• 余额/Token 使用量
• 注册与社交登录
• 电子邮件密码重置

内容审核

自动审核系统使用评分机制来跟踪用户的违规行为。当用户进行诸如频繁登录、注册或发送消息等操作时，他们会积累违规分数。一旦达到设定的阈值，该用户及其 IP 地址将被暂时封禁。该系统通过监控并惩罚快速或可疑的活动，确保了平台的安全性。

请参阅：自动化审核

基础审核设置

封禁设置

登录和注册速率限制

通过限制登录尝试和新账户注册，防止暴力破解攻击和垃圾注册。

每个违规项的评分

注意：非浏览器访问和非法模型请求几乎总是恶意的，这意味着第三方正在尝试通过自动化脚本访问服务器。

消息速率限制（按用户和 IP）

限制器

注意：您可以同时使用这两种限制器，但默认情况下仅按 IP 进行限制。

IP 限制器：

用户限制器：

导入对话速率限制

限制用户导入对话的频率，以防止滥用。

注意：您可以同时使用这两种限制器，但默认情况下仅按 IP 进行限制。

IP 限制器：

用户限制器：

会话分叉速率限制

限制用户分叉对话的频率，以防止滥用。

注意：您可以同时使用这两种限制器，但默认情况下仅按 IP 进行限制。

IP 限制器：

用户限制器：

文件上传速率限制

限制用户上传文件的频率，以防止滥用。

注意：这些也可以通过 librechat.yaml 中的 rateLimits.fileUploads 部分进行配置。

IP 限制器：

用户限制器：

TTS (Text-to-Speech) 速率限制

限制用户使用文本转语音（Text-to-Speech）的频率，以防止滥用。

注意：这些也可以通过 librechat.yaml 中的 rateLimits.tts 部分进行配置。

IP 限制器：

用户限制器：

STT (Speech-to-Text) 速率限制

限制用户使用语音转文字（Speech-to-Text）的频率，以防止滥用。

注意：这些也可以通过 librechat.yaml 中的 rateLimits.stt 部分进行配置。

IP 限制器：

用户限制器：

余额

以下功能允许管理系统 endpoint 内的用户余额。您可以选择手动添加余额，也可以选择实现一个为用户自动累积余额的系统。如果在配置中定义了特定的初始余额，当用户注册时，系统会自动将代币存入用户的余额中。

请参阅：Token Usage

管理余额

• 运行 npm run add-balance 以手动添加余额。
  • 您也可以指定要添加的邮箱和代币额度，例如：npm run add-balance [email protected] 1000
• 运行 npm run set-balance 以手动设置余额，用法类似于 add-balance。
• 运行 npm run list-balances 以列出每个用户的余额。

注意： 1000 credits = $0.001 (0.001 美元)

注册与登录

请参阅：Authentication System

• 常规设置：

快速提示： 即使禁用了注册功能，也可以使用 npm run create-user 直接将用户添加到数据库。

快速提示： 在禁用注册功能的情况下，您可以使用 npm run delete-user [email protected] 删除用户。

• 会话与刷新令牌设置：

• 更多信息请参考：Refresh Token

• JWT 设置：

您应该使用新的安全值。提供的示例是 32 字节的密钥（十六进制下为 64 个字符）。 使用此 replit 快速生成一些：JWT Keys

社交登录

更多详情请见：OAuth2-OIDC

Apple 身份验证

更多信息请参考：Apple Authentication

Discord 身份验证

更多信息：Discord

Facebook 身份验证

更多信息：Facebook 身份验证

GitHub 身份验证

更多信息请参阅：GitHub Authentication

Google 身份验证

更多信息请参阅：Google Authentication

OpenID Connect

更多信息：

• Auth0
• AWS Cognito
• Azure Entra/AD
• Keycloak

OpenID Connect 令牌重用

LibreChat 支持重用由您的 OpenID Connect 提供商（如 Azure Entra ID 或 Auth0）颁发的访问令牌和刷新令牌，以管理用户身份验证状态。当此功能启用时，作为 Cookie 传递给用户的刷新令牌将由您的 OpenID 提供商颁发，而不是由 LibreChat 颁发。

OPENID_REUSE_MAX_SESSION_AGE_MS 接受类似于 SESSION_EXPIRY 的算术表达式。当您的提供商在刷新时撤销之前的访问令牌时，请将其增加至接近 IdP 访问令牌的生命周期，以便下游消费者（例如 MCP 服务器）能够完成对仍然有效的持有者令牌（bearer token）的使用。

Microsoft Graph API / Entra ID 集成

当使用 Azure Entra ID（前身为 Azure AD）作为您的 OpenID 提供商时，您可以启用额外的 Microsoft Graph API 功能，以在权限和共享系统中实现增强的人员和群组搜索能力。

SharePoint 集成

LibreChat 支持与 SharePoint Online 和 OneDrive for Business 的直接集成，允许用户在对话中直接选择并附加来自其 SharePoint 库的文件。此企业级功能利用了现有的 Azure Entra ID 身份验证。

有关 SharePoint 配置的详细说明，请参阅：SharePoint 集成指南

SAML

更多信息：

• Auth0

LDAP/AD 身份验证

更多信息请参考：LDAP/AD Authentication

重置密码

电子邮件用于账户验证和密码重置。LibreChat 同时支持 Mailgun API 和传统的 SMTP 服务。请参阅：电子邮件设置

重要提示：您必须配置 Mailgun（推荐用于屏蔽 SMTP 的服务器）或 SMTP，以便电子邮件功能正常工作。

警告：如果未能为 Mailgun 或 SMTP 设置有效值，LibreChat 将使用不安全的密码重置方式！

Mailgun 配置（推荐）

对于在封锁 SMTP 端口的服务器上进行部署，Mailgun 特别有用。当同时设置了 MAILGUN_API_KEY 和 MAILGUN_DOMAIN 时，LibreChat 将使用 Mailgun 而非 SMTP。

SMTP 配置

如果未配置 Mailgun，LibreChat 将回退到 SMTP 设置。

警告：如果使用 EMAIL_SERVICE，请不要设置扩展连接参数： HOST, PORT, ENCRYPTION, ENCRYPTION_HOSTNAME, ALLOW_SELFSIGNED。

请参阅：nodemailer well-known-services

Firebase CDN

请参阅：Firebase CDN 配置

Amazon S3 和 CloudFront

请参阅：Amazon S3 配置 和 CloudFront 配合 S3 使用

注意： 对于 Kubernetes 部署（例如在 EKS 上），您可以使用 IRSA（IAM Roles for Service Accounts）来代替提供显式凭证。在这种情况下，仅需要 AWS_REGION 和 AWS_BUCKET_NAME。

Azure Blob Storage CDN

请参阅：Azure Blob Storage CDN Configuration

注意： 请使用 AZURE_STORAGE_CONNECTION_STRING（选项 A）或结合托管标识（Managed Identity）的 AZURE_STORAGE_ACCOUNT_NAME（选项 B），二者选其一，请勿同时使用。

UI

帮助与常见问题按钮

行为：

为静态文件设置 Cache-Control 响应头。这些配置仅在 NODE_ENV 设置为 production 时生效。

正确设置缓存头对于优化 Web 应用程序的性能和效率至关重要。通过控制浏览器和 CDN 存储静态文件副本的时长，您可以显著降低服务器负载、缩短页面加载时间并改善整体用户体验。

• 取消注释 STATIC_CACHE_MAX_AGE 以更改静态文件的 max-age。默认设置为 4 周。
• 取消注释 STATIC_CACHE_S_MAX_AGE 以更改静态文件的 s-maxage。默认情况下，此值设置为 1 周。
  • 这是针对 shared cache（共享缓存）的，它被 CDN 和代理服务器所使用。

应用标题与页脚

行为：

• 取消注释 CUSTOM_FOOTER 以添加自定义页脚。
• 取消注释并将 CUSTOM_FOOTER 留空以移除页脚。
• 现在，您可以在 CUSTOM_FOOTER 的值中使用以下格式添加一个或多个链接：[Anchor text](URL)。每个链接应使用竖线 (|) 进行分隔。

Markdown example: CUSTOM_FOOTER=[Link 1](http://example1.com) | [Link 2](http://example2.com)

生日帽

行为：

• 生日帽图标会在 2月11日（LibreChat 的生日）自动显示。
• 将 SHOW_BIRTHDAY_ICON 设置为 false 以禁用生日帽图标。
• 将 SHOW_BIRTHDAY_ICON 设置为 true 以始终启用生日帽图标。

分析

Google Tag Manager

LibreChat 支持使用 Google Tag Manager 进行分析。你需要在 LibreChat 中启用它，为此你需要一个 Google Tag Manager ID。请按照此指南生成 Google Tag Manager ID 并配置 Google Analytics。然后，将 ANALYTICS_GTM_ID 环境变量设置为你的 Google Tag Manager ID。

注意： 如果未设置 ANALYTICS_GTM_ID，则不会启用 Google Tag Manager。如果设置不正确，您将看到对 gtm.js 的请求失败。

会话导入

配置对话文件导入的限制，以防止内存问题。

内联文件预览

控制生成文件在跳过内联预览提取并仅保留为下载模式之前的大小限制。

MCP (Model Context Protocol)

配置 Model Context Protocol 设置以实现增强的服务器管理和 OAuth 支持。

MCP Server Configuration

其他

Redis

Redis 为 LibreChat 提供了显著的性能提升，并实现了水平扩展能力。

注意： Redis 支持目前处于实验阶段，使用时可能会遇到一些问题。

重要提示： 如果使用 Redis，在更改任何 LibreChat 设置后，您应该清除缓存。

有关详细配置和示例，请参阅：Redis 配置指南

注意：

• 当 USE_REDIS=true 时，你必须提供 REDIS_URI，否则应用程序将抛出错误。
• 对于 Redis Cluster 模式，请提供多个 URI：redis://node1:7001,redis://node2:7002,redis://node3:7003（集群模式会自动检测）。
• For single-endpoint managed Redis services that shard keys internally, keep USE_REDIS_CLUSTER=false and set REDIS_CLUSTER_SAFE_DELETE=true if cache clears fail with CROSSSLOT errors.
• 对于 TLS 连接，请使用 rediss:// 协议；如果您的 CA 不受公共信任，请设置 REDIS_CA。
• REDIS_KEY_PREFIX_VAR 和 REDIS_KEY_PREFIX 是互斥的。
• AWS Elasticache 与 TLS：Elasticache 在使用 TLS 连接时可能需要使用替代的 dnsLookup。如果在使用带有 TLS 的 Elasticache，请设置 REDIS_USE_ALTERNATIVE_DNS_LOOKUP=true。更多详细信息，请参阅 ioredis documentation。

领导者选举

为多实例部署配置基于 Redis 的分布式领导者选举。领导者选举可确保只有一个实例执行诸如定时任务之类的特定操作。

注意：

• 领导者选举需要启用 Redis (USE_REDIS=true)。
• 这些设置仅适用于多实例部署。
• 必须在过期前续订 leader lease 以维持领导地位。
• 如果租约续期在达到最大尝试次数后失败，该实例将放弃领导权。