Local Deep Research终极环境变量配置指南：快速部署AI研究助手

【免费下载链接】local-deep-research~95% on SimpleQA (e.g. Qwen3.6-27B on a 3090). Supports all local and cloud LLMs (llama.cpp, Ollama, Google, ...). 10+ search engines - arXiv, PubMed, your private documents. Everything Local & Encrypted.项目地址: https://gitcode.com/GitHub_Trending/lo/local-deep-research

想要快速部署功能强大的AI研究助手吗？Local Deep Research（本地深度研究）项目通过环境变量配置，让你在几分钟内就能搭建属于自己的智能研究系统。这个开源工具能够将复杂问题转化为全面的研究报告，使用多种大语言模型和搜索引擎进行迭代分析，涵盖学术数据库、科学知识库、网络内容和私人文档集合。

🚀 为什么选择环境变量配置？

环境变量配置是Local Deep Research项目的核心部署方式，特别适合：

• Docker部署- 云端和容器化环境
• CI/CD流水线- 自动化配置管理
• 服务器配置- 无Web UI访问权限的启动场景
• 多环境设置- 开发、测试、生产环境的快速切换
• 敏感信息保护- 安全存储API密钥等机密数据

📁 环境变量格式详解

Local Deep Research使用Dynaconf管理配置，环境变量格式为：

LDR_SECTION__SETTING=value

关键点：注意双下划线（__）在分区和设置名称之间的使用。


🔧 配置目录中的.env文件使用

最简单的配置方式是在配置目录中创建.env文件：

配置目录位置：

• Windows:%USERPROFILE%\Documents\LearningCircuit\local-deep-research\config\.env
• Linux/Mac:~/.config/local_deep_research/config/.env

只需在此目录中创建名为.env的文本文件并添加设置：

# 示例.env文件内容 LDR_WEB__PORT=8080 LDR_SEARCH__TOOL=wikipedia LDR_GENERAL__ENABLE_FACT_CHECKING=true # API密钥（见下方重要说明） OPENAI_API_KEY=your-key-here LDR_OPENAI_API_KEY=your-key-here

⚠️ API密钥重要说明

已知问题：目前，为了使搜索引擎正常工作，API密钥必须同时使用带和不带LDR_前缀：

# 每个API密钥都需要这两个版本 export OPENAI_API_KEY=your-key-here export LDR_OPENAI_API_KEY=your-key-here

这适用于所有搜索相关的API密钥，包括：

• OPENAI_API_KEY
• ANTHROPIC_API_KEY
• SERP_API_KEY
• BRAVE_API_KEY
• GOOGLE_PSE_API_KEY
• GOOGLE_PSE_ENGINE_ID
• GUARDIAN_API_KEY

此问题将在未来更新中修复。

🐳 Docker部署环境变量配置

对于Docker部署，可以在启动容器时传递环境变量：

docker run -p 8080:8080 \ -e LDR_WEB__PORT=8080 \ -e LDR_SEARCH__TOOL=wikipedia \ -e OPENAI_API_KEY=your-key-here \ -e LDR_OPENAI_API_KEY=your-key-here \ local-deep-research

🛠️ 常见操作配置示例

更改Web端口

export LDR_WEB__PORT=8080 # Linux/Mac set LDR_WEB__PORT=8080 # Windows

设置API密钥（当前双重要求）

# Linux/Mac export ANTHROPIC_API_KEY=your-key-here export LDR_ANTHROPIC_API_KEY=your-key-here # Windows set ANTHROPIC_API_KEY=your-key-here set LDR_ANTHROPIC_API_KEY=your-key-here

更改搜索引擎

export LDR_SEARCH__TOOL=wikipedia # Linux/Mac set LDR_SEARCH__TOOL=wikipedia # Windows

数据目录位置配置

默认情况下，Local Deep Research将所有数据存储在平台特定的用户目录中。你可以使用LDR_DATA_DIR环境变量覆盖此位置：

# Linux/Mac export LDR_DATA_DIR=/path/to/your/data/directory # Windows set LDR_DATA_DIR=C:\path\to\your\data\directory

所有应用程序数据将在此目录下组织：

• $LDR_DATA_DIR/ldr.db- 应用程序数据库
• $LDR_DATA_DIR/research_outputs/- 研究报告
• $LDR_DATA_DIR/cache/- 缓存数据
• $LDR_DATA_DIR/logs/- 应用程序日志

💡 最佳实践建议

1. 安全性优先- 始终通过环境变量传递敏感信息
2. 版本控制- 将.env文件添加到.gitignore中
3. 环境隔离- 为不同环境使用不同的配置文件
4. 文档同步- 更新env_configuration.md以反映配置更改

通过掌握这些环境变量配置技巧，你就能快速部署属于自己的AI研究助手，享受本地深度研究的便利与安全！🎯

【免费下载链接】local-deep-research~95% on SimpleQA (e.g. Qwen3.6-27B on a 3090). Supports all local and cloud LLMs (llama.cpp, Ollama, Google, ...). 10+ search engines - arXiv, PubMed, your private documents. Everything Local & Encrypted.项目地址: https://gitcode.com/GitHub_Trending/lo/local-deep-research