LibreChat部署、配置

部署

本次LibreChat部署下平台是Windows。

部署LibreChat本身是非常简单的，总共分为三步：一、克隆项目；二、配置文件；三、启动项目。

一、克隆项目

git clone https://github.com/danny-avila/LibreChat.git

二、配置文件

将根目录中的.env.example文件复制一份，并重命名为.env。

三、启动项目

使用命令

docker compose up -d

如果出现如下图中的问题，原因是没有启动Docker Desktop，需要先启动Docker Desktop。

配置

LibreChat对大模型的接口配置有两种方式：一、.env文件配置；二、.yaml文件配置，选择其中一个即可。但是.env文件是必须的，请不要删除。

一、.env文件配置

进入到前文中复制得到的.env文件中按需修改即可，这个就是普通的.env文件。由于..env文件没有层级关系，并且过于杂乱，所以更推荐使用.yaml文件配置。

二、.yaml文件配置

2.1、进入项目根目录，复制文件librechat.example.yaml并重命名为librechat.yaml，注意不要随便命名，因为后面会引用。

2.2、进入项目根目录，复制文件docker-compose.override.yml.example并重命名为docker-compose.override.yml，注意不要随便命名。

2.3、将图中所示的配置取消注释。意思是调用刚才重命名得到的librechat.yaml文件。

当然，如果不想使用compose.override.yml，也可以直接修改docker-compose.yml文件。

2.4、修改librechat.yaml文件，librechat.yaml中有很多注释，大部分都可以删除，真实的配置大约在文件中的216行左右开始。如图，此图中已经删除大部分注释。

以下配置就是一个模型接口的配置示例。

# Qwen3-max Example - name: 'qwen3-max' apiKey: '' baseURL: '' models: default: - 'qwen3-max' fetch: false titleConvo: true titleModel: 'qwen3-max' modelDisplayLabel: 'qwen3-max'

其中的apiKey为服务商提供的key，baseURL为接口访问地址，default下可以写多个模型名，表示可以选择的模型。

fetch表示是否启动查询可用模型，例如为false时，就只显示default中写的模型，如果为true，系统会自动从baseURL指向的模型提供商那里获取可用的模型。