环境变量参考

以下值以根目录和 deploy/.env.example、后端 Settings 为准。Compose 内部地址使用 api、db、redis 和 qdrant；源码开发通常使用 localhost。

应用与网络

变量	Compose 默认	说明
`POSTGRES_SERVER`	`db`	PostgreSQL 主机
`POSTGRES_PORT`	`5432`	PostgreSQL 端口
`POSTGRES_USER` / `POSTGRES_PASSWORD` / `POSTGRES_DB`	`postgres` / 空 / `clouisle`	数据库凭据
`DATABASE_URL`	自动拼接	非空时优先于分字段
`REDIS_HOST` / `REDIS_PORT`	`redis` / `6379`	Redis 连接
`REDIS_PASSWORD`	空	生产建议设置
`QDRANT_URL`	`http://qdrant:6333`	向量库地址
`QDRANT_API_KEY`	空	生产建议设置
`VECTOR_BACKEND`	`qdrant`	向量后端
`QDRANT_COLLECTION_PREFIX`	`kb_dim`	集合名前缀
`QDRANT_DISTANCE`	`Cosine`	距离函数

变量	默认	说明
`INTERNAL_API_TOKEN`	空	Worker 访问 API 文件网关，必须与 API 共享
`INTERNAL_API_TOKEN_FILE`	空	从文件读取内部 Token
`SANDBOX_ARTIFACT_UPLOAD_BASE_URL`	Compose `http://api:8000`	Sandbox 产物上传地址
`SANDBOX_ARTIFACT_UPLOAD_API_KEY`	空	可替代默认内部签名
`SANDBOX_RUNTIME_ENABLED`	`true`	启用沙箱
`SANDBOX_FILESYSTEM_ISOLATION_ENABLED`	Compose `true`	启用文件系统隔离
`SANDBOX_MAX_DISK_MB`	`8192`	沙箱最大磁盘
`SANDBOX_SESSION_TTL_HOURS`	`24`	会话保留
`SANDBOX_RESULT_TTL_SECONDS`	`86400`	结果保留
`SANDBOX_ARTIFACT_MAX_FILE_SIZE_MB`	`10`	单产物限制
`SANDBOX_ARTIFACT_MAX_TOTAL_SIZE_MB`	`10`	总产物限制

变量	默认	说明
`RETRIEVAL_HYBRID_KILL_SWITCH`	`false`	紧急强制向量检索
`RETRIEVAL_SHADOW_ENABLED`	`false`	混合检索影子运行
`TAVILY_API_KEY`	空	网页搜索内置工具

文档页底部的反馈表单会把同一页面的反馈聚合到 clouisle/clouisle-docs 的 GitHub Discussion。仓库必须启用 Discussions，并创建名称为 Docs Feedback 的 Discussion category。

变量	默认	说明
`GITHUB_APP_ID`	空	GitHub App 的 App ID。该 App 需要安装到 `clouisle/clouisle-docs`，并拥有 Discussions 的读写权限。
`GITHUB_APP_PRIVATE_KEY`	空	GitHub App 私钥。多行私钥可直接填写，或将换行写成 `\\n`。只在服务端配置，不能使用 `NEXT_PUBLIC_` 前缀。

反馈动作会校验页面来源、路径和消息长度；未配置 GitHub 凭据时提交会失败，不会静默丢弃反馈。

修改服务端环境变量后重启对应服务。NEXT_PUBLIC_* 在前端构建时注入，修改后必须重新构建前端。