⚙️ 核心环境变量
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 |