前面使用 chroma run 启动服务时,使用 --path 指定存放路径,每次都要输出地址,麻烦还容易输错。
其实,Chroma 支持通过配置文件来配置 Chroma 服务,配置文件采用 YAML 文件,下面是一个简单的配置文件:
# config.yaml
allow_reset: false
persist_path: /data/chroma
# 服务端监听
server:
host: 0.0.0.0
port: 8000
cors_allow_origins: ["*"]
# SQLite
sqlitedb:
migration_mode: apply
hash_type: md5将上面配置文件创建在当前目录,名称为 config.yml,然后使用如下命令启动服务:
chroma run ./config.yml运行效果如下图:

注意,官方有个完整示例可以参考,字段很全:rust/frontend/sample_configs/single_node_full.yaml(在 GitHub 仓库里 https://github.com/chroma-core/chroma/blob/main/rust/frontend/sample_configs/single_node_full.yaml),内容如下:
########################
# HTTP server settings #
########################
# OpenTelemetry 可观测性链路追踪配置
open_telemetry:
# 上报服务名称,在追踪平台用于区分 Chroma 服务
service_name: "chroma"
# OTel Collector GRPC 上报地址
endpoint: "http://otel-collector:4317"
# 日志/追踪过滤规则列表
filters:
# 按 Rust crate 名称过滤
- crate_name: "chroma_frontend"
# 采集级别:trace 采集全链路追踪数据
filter_level: "trace"
# HTTP 服务监听端口
port: 8000
# 监听网卡地址,0.0.0.0 允许外部访问
listen_address: "0.0.0.0"
# HTTP 请求最大 body 上限,单位字节,当前 40MB
max_payload_size_bytes: 41943040
# CORS 跨域允许来源,["*"] 允许全部跨域(开发环境使用,生产不要用*)
cors_allow_origins: ["*"]
####################
# General settings #
####################
# Chroma 向量库持久化数据目录
persist_path: "./chroma"
# 是否允许调用 reset 清空全部数据接口,默认 false(生产建议保持关闭)
allow_reset: false # defaults to false
# SQLite 数据库相关配置
sqlitedb:
# ID 哈希算法,可选 md5 / sha256
hash_type: "md5" # or "sha256"
# 数据库迁移策略:apply 自动执行迁移;validate 仅校验不自动执行
migration_mode: "apply" # or "validate"
# 系统元数据库配置
sysdb:
sqlite:
# WAL 日志主题命名空间
log_topic_namespace: "default"
# WAL 日志租户标识
log_tenant: "default"