sloopstash/chroma

Chroma 容器镜像文档

镜像概述

本镜像为OCI（开放容器倡议）标准容器镜像，集成了Linux操作系统、Chroma向量数据库以及Supervisor进程管理工具。旨在提供开箱即用的Chroma部署环境，简化向量数据库的安装配置流程，并通过Supervisor实现服务的稳定运行与进程监控。

核心功能与特性

• 完整运行环境：内置Linux操作系统，无需额外配置基础依赖
• Chroma向量数据库：预安装并配置Chroma，支持向量数据的存储、检索与管理
• Supervisor进程管理：集成Supervisor工具，自动监控并重启Chroma服务，保障服务持续可用
• 容器化部署：支持快速启动、资源隔离与跨环境一致运行

使用场景与适用范围

• AI应用开发：为大语言模型（LLM）应用提供向量存储支持
• 向量数据服务：部署独立的Chroma向量数据库服务
• 开发测试环境：快速搭建Chroma测试环境，简化配置流程
• 生产环境部署：结合Supervisor的进程管理能力，适用于对服务稳定性有要求的生产场景

使用方法与配置说明

基本启动命令（docker run）

通过以下命令快速启动Chroma服务：

bash
docker run -d -p 8000:8000 --name chroma-service chroma-image

参数说明：

• -d：后台运行容器
• -p 8000:8000：映射容器内Chroma默认端口（8000）到主机
• --name chroma-service：指定容器名称
• chroma-image：镜像名称（需替换为实际镜像标签）

数据持久化配置

为避免容器重启导致数据丢失，建议挂载数据卷：

bash
docker run -d -p 8000:8000 -v /host/data/path:/app/chroma/data --name chroma-service chroma-image

其中/host/data/path为宿主机数据目录，/app/chroma/data为容器内Chroma数据存储路径（具体路径可能因镜像配置略有差异）。

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  chroma:
    image: chroma-image
    ports:
      - "8000:8000"
    volumes:
      - ./chroma-data:/app/chroma/data
    restart: unless-stopped
    environment:
      - CHROMA_SERVER_HOST=0.0.0.0
      - CHROMA_SERVER_PORT=8000
      - CHROMA_LOG_LEVEL=INFO

通过docker-compose up -d启动服务，docker-compose down停止服务。

环境变量配置

支持通过环境变量调整Chroma服务参数（具体变量请参考Chroma官方文档）：

• CHROMA_SERVER_HOST：服务绑定地址，默认0.0.0.0
• CHROMA_SERVER_PORT：服务端口，默认8000
• CHROMA_LOG_LEVEL：日志级别，可选DEBUG、INFO、WARNING、ERROR

注意事项

• 确保宿主机端口（如8000）未被占用
• 生产环境建议配置数据持久化与定期备份策略
• 如需自定义Supervisor配置，可挂载配置文件至容器内/etc/supervisor/conf.d/目录