Appearance
常见问题
本页面收集了 AnythingLLM 使用过程中的常见问题和解答。
安装和部署
Q: 支持哪些操作系统？
A: AnythingLLM 支持以下操作系统：
- Windows 10 及以上版本
- macOS 10.15 (Catalina) 及以上版本
- Linux (Ubuntu 18.04+, CentOS 7+, Debian 10+)
Q: 最低系统要求是什么？
A:
- RAM: 最低 2GB，推荐 4GB 以上
- 存储: 至少 10GB 可用空间
- CPU: 双核处理器，推荐四核
- 网络: 稳定的互联网连接（使用云端 LLM 时）
Q: 可以离线使用吗？
A: 部分功能可以离线使用：
- ✅ 使用本地 LLM 模型 (如 Ollama)
- ✅ 本地文档处理和向量化
- ✅ 基本的聊天功能
- ❌ 云端 LLM 服务 (OpenAI, Anthropic 等)
- ❌ 在线文档获取
Q: Docker 部署时遇到权限问题怎么办？
A: 尝试以下解决方案：
bash
# 1. 确保 Docker 有足够权限
sudo usermod -aG docker $USER
# 2. 重新登录或重启终端
# 3. 检查存储目录权限
sudo chown -R $USER:$USER ./storage
# 4. 使用正确的用户 ID 运行容器
docker run --user $(id -u):$(id -g) ...配置和设置
Q: 如何更换 LLM 提供商？
A:
- 进入 设置 → LLM 配置
- 选择新的提供商
- 输入相应的 API 密钥
- 测试连接
- 保存设置
Q: API 密钥安全吗？
A: AnythingLLM 采用多重安全措施：
- 🔒 API 密钥加密存储
- 🔒 本地数据库保存
- 🔒 不会上传到外部服务器
- 🔒 支持环境变量配置
Q: 如何配置代理服务器？
A: 在环境变量中设置：
bash
HTTP_PROXY=http://proxy.company.com:8080
HTTPS_PROXY=http://proxy.company.com:8080
NO_PROXY=localhost,127.0.0.1Q: 支持 SSO 单点登录吗？
A: 目前 AnythingLLM 支持：
- ✅ 本地用户账户
- ✅ LDAP 集成 (企业版)
- 🔄 OAuth2/SAML (开发中)
文档管理
Q: 支持哪些文档格式？
A: 当前支持的格式：
- PDF: .pdf
- Word: .docx, .doc
- 文本: .txt, .md, .rtf
- 表格: .xlsx, .csv
- 代码: .js, .py, .java, .cpp 等
- 网页: URL 链接
- 视频: YouTube 字幕
Q: 单个文档大小限制是多少？
A:
- 默认限制: 25MB
- 可在设置中调整: 最大 100MB
- 大文档会自动分块处理
Q: 文档处理失败怎么办？
A: 常见解决方案：
- 检查文件格式: 确保是支持的格式
- 文件大小: 确认未超过限制
- 文件损坏: 尝试重新生成文档
- 权限问题: 确保文件可读
- 重新上传: 删除后重新上传
Q: 如何提高文档搜索准确性？
A: 优化建议：
- 📝 使用清晰的文档标题
- 📝 添加文档摘要和关键词
- 📝 保持文档结构清晰
- 📝 定期更新过时内容
- 📝 使用具体的问题描述
Q: 可以批量上传文档吗？
A: 支持多种批量上传方式：
- 🔄 拖拽多个文件
- 🔄 选择多个文件上传
- 🔄 文件夹批量导入
- 🔄 API 批量上传
对话和问答
Q: AI 回答不准确怎么办？
A: 改进建议：
- 优化问题: 提供更多上下文信息
- 检查文档: 确认相关信息在文档中
- 调整参数: 修改温度和最大令牌数
- 更换模型: 尝试不同的 LLM 模型
- 重新训练: 更新文档内容
Q: 如何提出更好的问题？
A: 提问技巧：
- ❓ 具体明确: "如何配置 HTTPS？" 而不是 "怎么设置？"
- ❓ 提供背景: "在 Docker 环境下如何..."
- ❓ 分步询问: 复杂问题分解为多个简单问题
- ❓ 引用文档: "根据用户手册，..."
Q: 聊天记录会保存多久？
A:
- 默认永久保存
- 可在设置中配置自动清理
- 支持手动删除单条或批量删除
- 管理员可设置全局保留策略
Q: 支持多语言对话吗？
A:
- ✅ 支持多种语言输入
- ✅ 可配置回答语言偏好
- ✅ 自动检测问题语言
- ✅ 支持中英文混合对话
性能和优化
Q: 系统运行缓慢怎么办？
A: 性能优化建议：
- 增加内存: 推荐 8GB+ RAM
- 使用 SSD: 提高文件读写速度
- 清理缓存: 定期清理临时文件
- 优化文档: 删除不必要的大文档
- 调整并发: 减少同时处理的请求数
Q: 如何监控系统性能？
A: 监控方法：
- 📊 内置性能监控面板
- 📊 系统资源使用情况
- 📊 API 响应时间统计
- 📊 错误日志分析
Q: 数据库过大怎么处理？
A: 数据库优化：
bash
# 1. 清理聊天记录
DELETE FROM chats WHERE created_at < date('now', '-30 days');
# 2. 清理临时文件
rm -rf ./storage/tmp/*
# 3. 压缩数据库
VACUUM;
# 4. 重建索引
REINDEX;安全和隐私
Q: 数据存储在哪里？
A:
- 🏠 本地存储: 所有数据存储在本地
- 🏠 数据库: SQLite 本地数据库
- 🏠 文档: 本地文件系统
- 🏠 向量: 本地向量数据库
Q: 会向外部发送数据吗？
A: 数据传输情况：
- ✅ LLM API: 仅发送问题和上下文
- ✅ 不发送: 完整文档内容
- ✅ 不发送: 用户个人信息
- ✅ 可关闭: 遥测数据收集
Q: 如何备份数据？
A: 备份建议：
bash
# 1. 备份整个存储目录
tar -czf backup-$(date +%Y%m%d).tar.gz ./storage/
# 2. 备份数据库
cp ./storage/anythingllm.db ./backup/
# 3. 备份配置文件
cp .env ./backup/
# 4. 自动备份脚本
crontab -e
0 2 * * * /path/to/backup-script.sh故障排除
Q: 无法启动服务怎么办？
A: 故障排除步骤：
- 检查端口: 确认 3001 端口未被占用
- 查看日志: 检查错误日志信息
- 权限检查: 确认文件读写权限
- 依赖检查: 确认 Node.js 版本正确
- 重新安装: 清理后重新安装
Q: 文档上传失败？
A: 检查清单：
- ✅ 文件格式是否支持
- ✅ 文件大小是否超限
- ✅ 磁盘空间是否充足
- ✅ 网络连接是否稳定
- ✅ 权限设置是否正确
Q: API 调用失败？
A: 常见原因：
- API 密钥错误: 检查密钥是否正确
- 网络问题: 检查网络连接
- 配额限制: 检查 API 使用配额
- 服务状态: 检查 LLM 服务状态
- 代理设置: 检查代理配置
获取帮助
Q: 在哪里可以获得更多帮助？
A: 支持渠道：
- 📖 官方文档
- 💬 GitHub Issues
- 💬 Discord 社区
- 📧 邮件支持
Q: 如何报告 Bug？
A: 报告步骤：
- 在 GitHub 上创建 Issue
- 提供详细的错误描述
- 包含系统环境信息
- 附上错误日志
- 提供复现步骤
Q: 如何贡献代码？
A: 贡献指南：
- Fork 项目仓库
- 创建功能分支
- 编写代码和测试
- 提交 Pull Request
- 等待代码审查
持续更新
本 FAQ 会根据用户反馈持续更新，如果您有好的建议或发现遗漏的问题，欢迎提出。