除了配置文件,Chroma 还支持通过环境变量来进行设置,如果使用容器 Docker 进行部署,这种方式很友好。
命名规则:
前缀固定 CHROMA_
yaml 嵌套层级用 双下划线 __ 分隔
优先级:环境变量 > yaml 配置文件 > 默认值
| 环境变量 | 作用 | 默认值 |
| CHROMA_PERSIST_PATH | 数据目录 | ./chroma |
| CHROMA_PORT | HTTP 端口 | 8000 |
| CHROMA_LISTEN_ADDRESS | 监听地址 | 0.0.0.0 |
| CHROMA_ALLOW_RESET | 是否允许 reset | false |
| CHROMA_MAX_PAYLOAD_SIZE_BYTES | 最大请求体 | 41943040(40 MiB) |
| CHROMA_CORS_ALLOW_ORIGINS | CORS 允许的来源 | [] |
| CHROMA_SQLITE_FILENAME | SQLite 文件名 | chroma.sqlite3 |
| CHROMA_SQLITEDB__MIGRATION_MODE | 迁移模式 apply / validate | apply |
| CHROMA_SQLITEDB__HASH_TYPE | 迁移哈希算法 md5 / sha256 | md5 |
| 环境变量 | 作用 |
| CHROMA_OPEN_TELEMETRY__ENDPOINT | OTLP 端点 |
| CHROMA_OPEN_TELEMETRY__SERVICE_NAME | 服务名,默认 chromadb |
| OTEL_EXPORTER_OTLP_HEADERS | 导出 traces 时的认证头 |
这一条必须单独说,因为网上大量教程还在用:
CHROMA_SERVER_AUTHN_PROVIDER
CHROMA_SERVER_AUTHN_CREDENTIALS
CHROMA_SERVER_AUTHN_CREDENTIALS_FILE
CHROMA_SERVER_AUTHZ_PROVIDER
CHROMA_SERVER_AUTHZ_CONFIG
CHROMA_SERVER_AUTHZ_CONFIG_FILE
CHROMA_AUTH_TOKEN_TRANSPORT_HEADERChroma 1.0.0 之后不再内置认证实现,这些变量全部失效。 看到就当历史遗迹。要鉴权只能在反向代理层做,见后续章节。