Appearance
配置指南
欢迎来到 AnythingLLM 配置指南！本指南将帮助您完成系统的各项配置，充分发挥 AI 知识库的强大功能。
🎯 配置概览
AnythingLLM 的配置主要分为以下几个核心部分：
核心配置
高级配置
🚀 快速配置向导
第一步：LLM 模型配置
选择并配置您的主要 AI 模型：
bash
# 设置 OpenAI API 密钥
export OPENAI_API_KEY="your-api-key-here"
# 或使用本地模型
export LLM_PROVIDER="ollama"
export OLLAMA_BASE_URL="http://localhost:11434"推荐模型：
- OpenAI GPT-4: 最强性能，适合生产环境
- Claude 3: 优秀的推理能力
- Ollama: 本地部署，数据隐私
第二步：嵌入模型配置
配置文档向量化模型：
bash
# OpenAI 嵌入模型
export EMBEDDING_ENGINE="openai"
export EMBEDDING_MODEL="text-embedding-3-large"
# 本地嵌入模型
export EMBEDDING_ENGINE="ollama"
export EMBEDDING_MODEL="nomic-embed-text"模型选择建议：
- text-embedding-3-large: 最佳质量
- text-embedding-3-small: 平衡性能和成本
- 本地模型: 数据隐私优先
第三步：向量数据库配置
选择向量存储方案：
bash
# 使用 Pinecone（推荐生产环境）
export VECTOR_DB="pinecone"
export PINECONE_API_KEY="your-pinecone-key"
export PINECONE_INDEX="anythingllm"
# 使用本地 Chroma（开发环境）
export VECTOR_DB="chroma"数据库选择：
- Pinecone: 云端托管，高性能
- Chroma: 本地存储，易于开发
- Weaviate: 开源，功能丰富
⚙️ 详细配置指南
LLM 模型配置
支持多种 LLM 提供商：
| 提供商 | 模型示例 | 特点 | 推荐场景 |
|---|---|---|---|
| OpenAI | GPT-4, GPT-3.5 | 性能强大 | 生产环境 |
| Anthropic | Claude 3 | 安全可靠 | 企业应用 |
| Ollama | Llama 2, Mistral | 本地部署 | 隐私优先 |
| Azure OpenAI | GPT-4 | 企业级 | 大型组织 |
配置示例：
javascript
{
"LLMProvider": "openai",
"OpenAiKey": "sk-...",
"OpenAiModelPref": "gpt-4",
"OpenAiTemperature": 0.7,
"OpenAiMaxTokens": 4000
}嵌入模型配置
性能对比：
- text-embedding-3-large: 3072 维度，最高质量
- text-embedding-3-small: 1536 维度，平衡选择
- text-embedding-ada-002: 1536 维度，经济实惠
配置示例：
javascript
{
"EmbeddingEngine": "openai",
"EmbeddingModelPref": "text-embedding-3-large",
"EmbeddingChunkSize": 1000,
"EmbeddingChunkOverlap": 200
}向量数据库配置
Pinecone 配置：
javascript
{
"VectorDB": "pinecone",
"PineconeApiKey": "your-api-key",
"PineconeIndex": "anythingllm",
"PineconeEnvironment": "us-west1-gcp"
}Chroma 配置：
javascript
{
"VectorDB": "chroma",
"ChromaEndpoint": "http://localhost:8000",
"ChromaApiHeader": "X-Chroma-Token",
"ChromaApiKey": "your-token"
}🔧 高级配置
系统提示词配置
自定义 AI 的行为和响应风格：
javascript
{
"SystemPrompt": "你是一个专业的AI助手，专门帮助用户分析和理解文档内容...",
"WorkspacePrompts": {
"技术文档": "专注于技术细节和实现方案...",
"客户服务": "以友好和专业的态度回答问题..."
}
}环境变量配置
系统级别的配置选项：
bash
# 服务器配置
export SERVER_PORT=3001
export JWT_SECRET="your-jwt-secret"
# 数据库配置
export DATABASE_URL="postgresql://user:pass@localhost:5432/anythingllm"
# 文件上传配置
export STORAGE_DIR="/app/storage"
export MAX_UPLOAD_SIZE="25MB"
# 安全配置
export DISABLE_TELEMETRY=true
export AUTH_TOKEN="your-auth-token"📊 性能优化配置
缓存配置
javascript
{
"CacheEnabled": true,
"CacheTTL": 3600,
"CacheMaxSize": "500MB"
}并发配置
javascript
{
"MaxConcurrentRequests": 10,
"RequestTimeout": 30000,
"RateLimitPerMinute": 60
}内存优化
javascript
{
"MaxMemoryUsage": "2GB",
"GarbageCollectionInterval": 300,
"DocumentBatchSize": 50
}🛡️ 安全配置
API 密钥管理
bash
# 使用环境变量存储敏感信息
export OPENAI_API_KEY="sk-..."
export PINECONE_API_KEY="..."
# 避免在代码中硬编码密钥访问控制
javascript
{
"AuthRequired": true,
"SessionTimeout": 3600,
"MaxLoginAttempts": 5,
"IPWhitelist": ["192.168.1.0/24"]
}数据加密
javascript
{
"EncryptionEnabled": true,
"EncryptionAlgorithm": "AES-256-GCM",
"BackupEncryption": true
}🔍 配置验证
配置检查命令
bash
# 检查配置文件语法
npm run config:validate
# 测试 LLM 连接
npm run test:llm
# 测试向量数据库连接
npm run test:vectordb
# 全面健康检查
npm run health:check常见配置错误
API 密钥错误：
bash
Error: Invalid OpenAI API key
Solution: 检查 OPENAI_API_KEY 环境变量向量数据库连接失败：
bash
Error: Cannot connect to Pinecone
Solution: 验证 API 密钥和索引名称内存不足：
bash
Error: Out of memory
Solution: 增加系统内存或调整批处理大小📚 配置模板
开发环境配置
bash
# .env.development
LLM_PROVIDER=ollama
OLLAMA_BASE_URL=http://localhost:11434
EMBEDDING_ENGINE=ollama
VECTOR_DB=chroma
DISABLE_TELEMETRY=true生产环境配置
bash
# .env.production
LLM_PROVIDER=openai
OPENAI_API_KEY=sk-...
EMBEDDING_ENGINE=openai
VECTOR_DB=pinecone
PINECONE_API_KEY=...
AUTH_TOKEN=...企业环境配置
bash
# .env.enterprise
LLM_PROVIDER=azure
AZURE_OPENAI_ENDPOINT=https://...
EMBEDDING_ENGINE=azure
VECTOR_DB=weaviate
DATABASE_URL=postgresql://...
REDIS_URL=redis://...🎯 下一步
配置完成后，您可以：
🆘 获取帮助
如果在配置过程中遇到问题：
- 常见问题解答 - 查看常见配置问题
- 常见问题 - 解决配置错误
- GitHub Issues - 报告配置问题
- 社区论坛 - 与社区交流
正确的配置是 AnythingLLM 发挥最佳性能的关键。按照本指南逐步配置，您将拥有一个强大而稳定的 AI 知识库系统！