1. 为什么在 CentOS 上用 Docker 跑 LibreChat 值得折腾LibreChat 是一个开源的 ChatGPT 风格对话前端能同时挂多个模型端点支持多用户、会话历史、插件和自定义模型列表。它本身不生产模型能力只负责把请求转发到你配置的 API 通道上所以只要后端通道稳定前端体验就顺滑。适合谁适合想在自己服务器上搭一个私有对话入口的开发者尤其是手里已经有 CentOS 机器、又不想被单一厂商绑死的团队。我这次的目标很明确在 CentOS 7/8 上用 Docker Compose 从零把 LibreChat 拉起来并且把 API 通道统一接到 TaoToken 上让模型列表、Key、BaseURL 全部走一个入口后续换模型只改配置不改代码。整个过程分四块环境准备、TaoToken 前置、可复制的 compose 与 yaml、启动验证与排错。你跟着做半小时内能跑通第一次对话。需要提前说明的是LibreChat 的配置文件分两层.env管密钥和数据库连接librechat.yaml管模型端点。很多人卡住不是因为 Docker 装不上而是 yaml 里的baseURL和apiKey写错或者容器读不到挂载文件。下面每一步我都会给出可直接复制的片段并标注容易踩的坑。2. TaoToken 前置统一 Key 与 API 通道在动 Docker 之前先把后端通道准备好。TaoToken 的作用是提供一个统一的 API 入口你只需要一个 Key 和固定的 BaseURL就能在 LibreChat 里挂多个模型不用为每个厂商单独维护一套鉴权。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 。操作顺序是这样先登录控制台进入 API Keys 页面创建一个令牌复制出来形如sk-xxxx的字符串这个就是后面 yaml 里的apiKey。然后确认 BaseURLLibreChat 的 custom endpoint 需要的是带/v1的地址所以填https://taotoken.net/api/v1。模型名不要凭记忆写去文档页查当前支持的模型 ID填进models.default数组里。注意Key 只显示一次创建后立刻保存到密码管理器或本地.env不要直接提交到 Git 仓库。yaml 里如果硬编码 Key记得给仓库加.gitignore。如果你后面要做长期编码或 Agent 类任务可以顺带了解 Coding Plan它更适合高频调用场景只是验证模型连通性的话用模型对话页面手动发一条消息就能确认通道是否正常。接入细节以接入文档为准地址在 https://taotoken.net/doc 。3. 可复制的 Docker 与 LibreChat 配置3.1 CentOS 安装 Docker先更新系统并装依赖CentOS 7 和 8 命令基本一致sudo yum update -y sudo yum install -y yum-utils device-mapper-persistent-data lvm2 sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo sudo yum install -y docker-ce docker-ce-cli containerd.io sudo systemctl enable docker sudo systemctl start docker装完用docker version确认客户端和服务端都出来了。如果提示权限不足把当前用户加进 docker 组sudo usermod -aG docker $USER然后重新登录一次 shell。3.2 拉取 LibreChat 并准备文件git clone https://github.com/danny-avila/LibreChat.git cd LibreChat cp .env.example .env.env里至少要确认这几项HOST0.0.0.0、PORT3080以及数据库相关配置保持默认即可LibreChat 自带 MongoDB 服务。如果你要改端口记得同步改 compose 映射。3.3 挂载 librechat.yaml在项目根目录新建docker-compose.override.yml让容器能读到自定义 yamlservices: api: volumes: - type: bind source: ./librechat.yaml target: /app/librechat.yaml然后在根目录新建librechat.yaml把 TaoToken 作为 custom endpoint 挂进去version: 1.1.4 cache: true endpoints: custom: - name: TaoToken apiKey: sk-你的TaoToken密钥 baseURL: https://taotoken.net/api/v1 models: default: [gpt-4o-mini, claude-3-5-sonnet] fetch: true titleConvo: true titleModel: current_model summarize: false summaryModel: current_model forcePrompt: false modelDisplayLabel: TaoTokenfetch: true表示让 LibreChat 主动去拉模型列表如果通道支持/v1/models就能自动填充下拉框不支持的话就把default数组写全。titleModel用current_model表示用当前对话模型生成标题省一次额外调用。3.4 启动容器docker compose up -d docker compose logs -f api日志里看到Server listening on port 3080就说明起来了。首次启动会拉镜像和初始化 MongoDB耐心等一两分钟。4. 验证请求与成功结果浏览器访问http://你的服务器IP:3080注册一个账号登录。进入界面后点左上角模型选择器应该能看到TaoToken分组下的模型列表。选一个模型发一句「你好请用一句话介绍你自己」。如果返回正常文本说明整条链路通了LibreChat → TaoToken 通道 → 模型 → 原路返回。你也可以在服务器上用 curl 直接验证通道本身排除前端干扰curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d {model:gpt-4o-mini,messages:[{role:user,content:ping}]}返回 JSON 里带choices字段就说明 Key 和 BaseURL 都没问题。这一步能快速区分是前端配置错还是通道本身有问题。5. 本篇常见报错排查报错一模型列表为空。多半是fetch: true但通道不返回模型列表或者baseURL少了/v1。先把fetch改成false手动在default里写模型名再重启容器。报错二401 Unauthorized。Key 复制时带了空格或者 yaml 缩进不对导致apiKey没被解析。用docker compose exec api cat /app/librechat.yaml看容器内实际读到的内容。报错三容器启动后立刻退出。看docker compose logs api常见是 yaml 语法错误比如version和endpoints层级写错。yaml 对缩进敏感建议用编辑器校验一遍。报错四端口 3080 访问不了。CentOS 默认防火墙没放行执行sudo firewall-cmd --add-port3080/tcp --permanent sudo firewall-cmd --reload。云服务器还要检查安全组规则。报错五改了 yaml 不生效。因为挂载是 bind 模式改完宿主机文件后要docker compose restart api光 reload 不会重新读配置。6. 后续接入与长期使用建议跑通之后如果你要把它接到自动化脚本或 Agent 工作流里建议单独创建一个专用 Key方便按用途区分调用量。日常手动验证模型用模型对话页面最直观要做长期编码辅助或批量任务Coding Plan 的额度模型更划算。所有接入相关的字段说明和示例以接入文档为准遇到鉴权或路径问题先查文档再改配置。最后留一个实用习惯把librechat.yaml和.env都纳入版本管理时用.env.example存模板真实 Key 只放本地。这样换服务器或重装时克隆仓库、填 Key、docker compose up -d三步就能恢复不用重新回忆每个参数。