⚙️ 核心环境变量

Ollama 连接配置

环境变量
# Ollama 服务地址
OLLAMA_BASE_URL=http://localhost:11434

# Docker 中连接宿主机 Ollama
OLLAMA_BASE_URL=http://host.docker.internal:11434

OpenAI API 配置

环境变量
# OpenAI API Key
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx

# API Base URL(可选,用于代理或兼容 API)
OPENAI_API_BASE_URL=https://api.openai.com/v1

🔐 认证配置

基础认证

环境变量
# 禁用注册(只允许管理员创建用户)
ENABLE_SIGNUP=false

# 管理员邮箱
ADMIN_EMAIL=admin@example.com

# 管理员密码(首次启动)
ADMIN_PASSWORD=your_password

OAuth 集成

环境变量
# Google OAuth
GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret

# GitHub OAuth
GITHUB_CLIENT_ID=your_client_id
GITHUB_CLIENT_SECRET=your_client_secret

# OIDC(通用)
OAUTH_CLIENT_ID=your_client_id
OAUTH_CLIENT_SECRET=your_client_secret
OPENID_PROVIDER_URL=https://your-provider/.well-known/openid-configuration

🌐 网络配置

环境变量
# 监听端口
PORT=8080

# 监听地址(0.0.0.0 允许外部访问)
HOST=0.0.0.0

# 允许的域名(CORS)
CORS_ALLOW_ORIGINS=https://yourdomain.com

# Trusted Header(反向代理)
TRUSTED_HEADER=X-Forwarded-For

📁 数据配置

环境变量
# 数据目录
DATA_DIR=/app/backend/data

# 上传文件大小限制(MB)
FILE_SIZE_LIMIT=100

# 允许的文件类型
ALLOWED_FILE_TYPES=pdf,docx,txt,md

# RAG 嵌入模型
RAG_EMBEDDING_MODEL=all-MiniLM-L6-v2

🎨 界面定制

环境变量
# 默认主题(light/dark)
DEFAULT_THEME=dark

# 品牌名称
BRAND_NAME=我的 AI 助手

# Logo URL
BRAND_LOGO_URL=https://example.com/logo.png

# 自定义 CSS
CUSTOM_CSS=/path/to/custom.css

# 欢迎消息
DEFAULT_USER_ROLE=user

🤖 模型配置

模型别名

为模型设置友好的显示名称:

JSON
{
  "llama3.2:3b": "Llama 3.2 (3B)",
  "qwen2.5:7b": "Qwen 2.5 (7B)",
  "deepseek-r1:7b": "DeepSeek R1 (7B)"
}

默认模型参数

参数说明默认值
temperature创造性程度0.7
top_p核采样0.9
max_tokens最大输出长度2048
frequency_penalty频率惩罚0
presence_penalty存在惩罚0