librechat/librechat-dev-api Docker 镜像 - 轩辕镜像

镜像概述

LibreChat开发环境API镜像是基于Dockerfile.multi多阶段构建流程创建的专用开发镜像，旨在提供LibreChat API服务的开发与测试环境。该镜像集成了LibreChat项目主分支（main branch）的最新提交代码，确保开发者可基于项目最新功能和代码修复进行开发工作。

核心功能与特性

• 最新代码集成：包含LibreChat主分支的最新提交，同步项目开发进度，支持测试前沿功能
• 多阶段构建优化：通过Dockerfile.multi实现多阶段构建，精简镜像体积并确保开发环境一致性
• 开发环境适配：预配置开发所需依赖和工具链，支持直接运行和调试API服务
• API服务基础：提供LibreChat API核心运行环境，包含接口开发、请求处理等基础能力

使用场景

• 开发者进行LibreChat API功能开发与调试
• 测试主分支最新代码修复或功能实现
• 本地开发环境快速搭建，减少环境配置成本
• 与前端开发环境联动，验证API接口兼容性

使用方法

前提条件

• 已安装Docker Engine（推荐20.10及以上版本）
• 网络环境可访问镜像仓库（如适用）

镜像拉取

bash
docker pull [镜像仓库地址]/librechat-dev-api:latest

注：请将[镜像仓库地址]替换为实际镜像存储位置（如Docker Hub、私有仓库等）

运行容器

bash
docker run -d \
  --name librechat-dev-api \
  -p 3000:3000 \
  [镜像仓库地址]/librechat-dev-api:latest

参数说明：

• -d：后台运行容器
• --name librechat-dev-api：指定容器名称，便于管理
• -p 3000:3000：端口映射（默认API服务端口，具体以项目配置为准）

自定义配置

如需调整开发环境配置，可通过以下方式实现：

1. 环境变量注入
   通过-e参数传递环境变量，覆盖默认配置：

   bash
   docker run -d \
     --name librechat-dev-api \
     -p 3000:3000 \
     -e NODE_ENV=development \
     -e API_PORT=4000 \
     [镜像仓库地址]/librechat-dev-api:latest
   

2. 配置文件挂载
   通过数据卷挂载本地配置文件，实现深度自定义：

   bash
   docker run -d \
     --name librechat-dev-api \
     -p 3000:3000 \
     -v ./local-dev-config:/app/config \
     [镜像仓库地址]/librechat-dev-api:latest
   

注意事项

• 本镜像为开发环境专用，不具备生产环境所需的安全加固和性能优化，禁止用于生产部署
• 由于基于主分支最新代码，可能存在未稳定功能或兼容性问题，建议结合项目提交日志评估使用风险
• 运行过程中如遇依赖冲突或配置问题，可参考LibreChat官方开发文档或提交issue反馈

版本更新

镜像会随主分支提交动态更新，建议定期拉取最新版本以获取最新代码：

bash
docker pull [镜像仓库地址]/librechat-dev-api:latest