配置说明

配置方式

Glean 通过环境变量进行配置。创建 .env 文件：

# 下载示例配置
curl -fsSL https://raw.githubusercontent.com/LeslieLeung/glean/main/.env.example -o .env

# 编辑配置
nano .env

核心配置

安全配置

变量	必填	默认值	说明
`SECRET_KEY`	是	-	JWT 签名密钥，至少 32 字符
`DEBUG`	否	`false`	调试模式，生产环境务必关闭

数据库配置

变量	必填	默认值	说明
`POSTGRES_DB`	否	`glean`	数据库名称
`POSTGRES_USER`	否	`glean`	数据库用户名
`POSTGRES_PASSWORD`	是	`glean`	数据库密码

端口配置

变量	默认值	说明
`WEB_PORT`	`80`	Web 应用端口
`ADMIN_PORT`	`3001`	管理后台端口

管理员配置

首次启动时自动创建管理员账户：

变量	默认值	说明
`CREATE_ADMIN`	`false`	是否自动创建管理员
`ADMIN_USERNAME`	`admin`	管理员用户名
`ADMIN_PASSWORD`	-	管理员密码（启用时必填）
`ADMIN_ROLE`	`super_admin`	管理员角色

示例配置：

CREATE_ADMIN=true
ADMIN_USERNAME=admin
ADMIN_PASSWORD=MySecurePass123!

日志配置

变量	默认值	说明
`LOG_LEVEL`	`INFO`	日志级别 (DEBUG/INFO/WARNING/ERROR)
`LOG_FILE`	`/app/logs/glean-api.log`	日志文件路径
`LOG_ROTATION`	`100 MB`	日志轮转大小
`LOG_RETENTION`	`30 days`	日志保留时间
`LOG_COMPRESSION`	`gz`	日志压缩格式

Milvus 配置（向量数据库）

完整部署模式下的 Milvus 配置：

变量	默认值	说明
`MILVUS_HOST`	`milvus`	Milvus 服务主机
`MILVUS_PORT`	`19530`	Milvus 服务端口
`MILVUS_USER`	-	Milvus 用户名（如启用认证）
`MILVUS_PASSWORD`	-	Milvus 密码（如启用认证）

Embedding 配置

用于智能推荐的向量嵌入配置：

变量	默认值	说明
`EMBEDDING_PROVIDER`	`sentence-transformers`	嵌入提供商
`EMBEDDING_MODEL`	`all-MiniLM-L6-v2`	模型名称
`EMBEDDING_DIMENSION`	`384`	向量维度（需与模型匹配）
`EMBEDDING_API_KEY`	-	API 密钥（OpenAI/Volcengine）
`EMBEDDING_BASE_URL`	-	自定义 API 端点
`EMBEDDING_BATCH_SIZE`	`20`	批量处理大小
`EMBEDDING_TIMEOUT`	`30`	请求超时（秒）

支持的 Embedding 提供商

sentence-transformers（本地，默认）：

EMBEDDING_PROVIDER=sentence-transformers
EMBEDDING_MODEL=all-MiniLM-L6-v2
EMBEDDING_DIMENSION=384

OpenAI：

EMBEDDING_PROVIDER=openai
EMBEDDING_MODEL=text-embedding-3-small
EMBEDDING_DIMENSION=1536
EMBEDDING_API_KEY=sk-xxx

Volcengine（火山引擎）：

EMBEDDING_PROVIDER=volc-engine
EMBEDDING_MODEL=doubao-embedding
EMBEDDING_DIMENSION=1024
EMBEDDING_API_KEY=your-api-key

完整配置示例

# 安全配置
SECRET_KEY=your-long-random-secret-key-at-least-32-chars
DEBUG=false

# 数据库
POSTGRES_PASSWORD=your-secure-database-password

# 端口
WEB_PORT=80
ADMIN_PORT=3001

# 管理员（首次启动）
CREATE_ADMIN=true
ADMIN_USERNAME=admin
ADMIN_PASSWORD=YourSecurePassword123!

# 日志
LOG_LEVEL=INFO

# Embedding（使用 OpenAI）
EMBEDDING_PROVIDER=openai
EMBEDDING_MODEL=text-embedding-3-small
EMBEDDING_DIMENSION=1536
EMBEDDING_API_KEY=sk-xxx

应用配置

修改配置后重启服务：

# 重启所有服务
docker compose down
docker compose up -d

# 或只重启特定服务
docker compose restart backend worker

验证配置

# 检查服务状态
docker compose ps

# 查看后端日志
docker compose logs backend

# 检查健康状态
curl http://localhost/api/health

下一步

HTTPS 配置 - 配置 SSL 证书
备份与恢复 - 数据备份策略