Files
appstore/apps/librechat

LibreChat

产品介绍

LibreChat 是一个开源多用户 AI 聊天平台,支持多模型供应商、智能体、文件上传、搜索、RAG 和自托管部署。

主要功能

  • 提供类似 ChatGPT 的多用户 Web 聊天界面
  • 支持 OpenAI、Anthropic、Google、OpenRouter、Groq 等模型供应商
  • 支持智能体、搜索、文件上传、RAG 和独立管理面板

访问说明

  • Web 入口:安装后通过 http://<服务器 IP>:18088 访问,实际端口以 PANEL_APP_PORT_HTTP 为准。
  • 管理面板:安装后通过 http://<服务器 IP>:18089 访问,实际端口以 PANEL_APP_PORT_ADMIN 为准。

Introduction

LibreChat is an open source multi-user AI chat platform with model provider integrations, agents, uploads, search, RAG and self-hosted deployment.

Features

  • Provides a ChatGPT-like multi-user web chat interface
  • Supports model providers such as OpenAI, Anthropic, Google, OpenRouter and Groq
  • Includes agents, search, uploads, RAG and a separate admin panel

部署说明

  • 本应用基于 LibreChat 官方 Docker Compose 拓扑适配,包含 LibreChat API/Web、Admin Panel、MongoDB、Meilisearch、pgvector PostgreSQL 和 RAG API。
  • 应用分类:AI。
  • 支持架构:amd64、arm64。
  • 可选版本:latest。本目录中的所有镜像保留各自现有标签但不固定 digest;其中 LibreChat 官方主镜像使用 moving latest,便于 Watchtower 等工具拉取上游更新。1Panel 的跨版本升级入口仍保持关闭。
  • 内部服务名使用 librechat-* 前缀,避免主服务和管理面板同时加入 1panel-network 时解析到其他应用的同名服务。
  • 本应用不会把供应商 API Key 作为安装必填项;安装完成后请在 LibreChat 内按需配置模型供应商。

端口

变量 说明 默认值 必填
PANEL_APP_PORT_HTTP LibreChat Web 访问端口 18088
PANEL_APP_PORT_ADMIN LibreChat Admin Panel 访问端口 18089

数据持久化

路径 说明
${APP_DATA_DIR}/images Web 静态图片
${APP_DATA_DIR}/uploads 用户上传文件
${APP_DATA_DIR}/logs LibreChat 日志
${APP_DATA_DIR}/skill Skills 目录
${APP_DATA_DIR}/mongodb MongoDB 数据
${APP_DATA_DIR}/meilisearch Meilisearch 数据
${APP_DATA_DIR}/pgvector RAG pgvector 数据

升级或迁移前,请先在 1Panel 中备份上述数据目录。

参数说明

变量 说明 默认值 必填
DOMAIN_CLIENT LibreChat 对外 Web 地址 http://127.0.0.1:18088
DOMAIN_SERVER LibreChat 对外 API 地址 http://127.0.0.1:18088
ADMIN_PANEL_URL 管理面板对外地址 http://127.0.0.1:18089
LIBRECHAT_APP_SECRET 用于派生 JWT、凭据加密和管理面板会话密钥 随机生成
MEILI_MASTER_KEY Meilisearch 主密钥 随机生成
VECTOR_DB_PASSWORD RAG 向量数据库密码 随机生成
ALLOW_REGISTRATION 是否允许新用户注册 true

使用说明

  • 首次公开部署时,请把 DOMAIN_CLIENTDOMAIN_SERVERADMIN_PANEL_URL 改为真实外部访问地址。
  • 如需关闭开放注册,请将 ALLOW_REGISTRATION 设置为 false
  • 模型供应商 Key、OAuth、SMTP、对象存储等高级配置请在应用内或后续自定义配置中维护,不建议在安装表单中暴露大量可选密钥。
  • 当前包不加入 Renovate 自动合并白名单:LibreChat 使用多个数据库/检索服务,官方主镜像来源仍是 moving tag,更新前需要查看上游变更并备份数据。

安全提示

  • LibreChat 包含 Web/API、管理面板、数据库、检索和 RAG 等多个联网服务,上游镜像及依赖可能存在镜像扫描器报告的 High 或 Critical 漏洞。移动标签更新后必须重新执行镜像扫描和默认工作流验证。
  • 请及时更新应用并在升级前备份数据,仅向可信网络开放端口,关闭不需要的公开注册,并通过 HTTPS、反向代理和访问控制保护 Web 与管理入口。

参考资料