Neo4j LLM Graph Builder 本地数据库连接配置指南

项目背景

Neo4j LLM Graph Builder 是一个强大的工具，能够将非结构化数据转换为知识图谱。该项目提供了多种部署方式，包括使用Docker容器快速启动。但在实际使用中，许多开发者希望将其与本地运行的Neo4j Desktop数据库连接，这就需要特殊的配置方法。

连接本地Neo4j Desktop数据库的关键配置

1. 网络连接配置

当使用Docker容器运行LLM Graph Builder时，要连接到主机上的Neo4j Desktop数据库，必须正确配置连接URI。关键点在于：

• 使用host.docker.internal作为主机地址
• 必须包含Neo4j服务端口号
• 完整格式应为：bolt://host.docker.internal:7687

2. 环境变量设置

在项目的.env配置文件中，需要确保以下关键参数正确：

NEO4J_URI="bolt://host.docker.internal:7687"
NEO4J_USERNAME="neo4j"
NEO4J_PASSWORD="your_password"

3. Neo4j Desktop配置要点

在Neo4j Desktop中需要确保：

• 数据库已启动并运行
• 网络设置允许外部连接
• 认证信息与.env文件中的配置匹配

常见问题解决方案

连接失败问题

如果遇到连接问题，检查以下方面：

1. 确认端口号是否正确添加到URI中
2. 验证Neo4j Desktop是否允许远程连接
3. 检查防火墙设置，确保端口未被阻止

模型选择问题

当配置Azure AI模型时，需要注意：

• 确保VITE_LLM_MODELS和VITE_LLM_MODELS_PROD变量正确设置
• 模型配置格式应符合要求
• 开发环境与生产环境的模型配置可能不同

最佳实践建议

1. 分阶段测试：先确保基础连接正常，再添加复杂配置
2. 环境隔离：开发环境与生产环境的配置应分开管理
3. 日志检查：遇到问题时，首先查看容器日志获取详细错误信息
4. 版本兼容：确保Neo4j Desktop版本与LLM Graph Builder兼容

总结

通过正确配置网络连接和环境变量，可以顺利实现Neo4j LLM Graph Builder与本地Neo4j Desktop数据库的连接。关键在于理解Docker容器与主机间的网络通信机制，以及Neo4j的安全认证要求。遵循本文提供的配置方法和问题解决思路，开发者可以快速搭建起完整的开发环境。