用docker部署neo4j需三步：拉取指定版本镜像（如5.21）、运行容器并配置端口映射与持久化、设置初始密码及安全调优；细节如认证、挂载、配置优先级等决定部署成败。
直接用 Docker 部署 Neo4j 是最轻量、最可控的方式，尤其适合开发测试和中小型生产环境。核心就三步：拉镜像、启容器、连数据库——但细节决定成败，比如端口映射、数据持久化、安全配置这些不注意，跑起来也容易出问题。
一、拉取官方镜像并启动单机实例
Neo4j 官方在 Docker Hub 提供了 neo4j 镜像（支持社区版和企业版），推荐从社区版起步：
- 执行 docker pull neo4j:5.21（建议指定明确版本，避免自动拉 latest 导致行为不一致）
- 运行容器时必须设置初始密码，并开放必要端口：
docker run -d \
--name neo4j-dev \
-p 7474:7474 -p 7687:7687 \
-e NEO4J_AUTH=neo4j/password123 \
-v $PWD/data:/data \
-v $PWD/plugins:/plugins \
neo4j:5.21
说明：
• 7474 是浏览器访问的 Web 管理界面（http://localhost:7474）
• 7687 是 Bolt 协议端口，客户端驱动默认连接这里
• NEO4J_AUTH 必须设置，否则容器会拒绝启动（5.x 起强制认证）
• 两个 -v 挂载确保数据和插件不随容器销毁而丢失
二、启用基础安全与配置调优
默认配置不适合直接暴露到公网，至少要调整这几项：
- 禁止远程未授权访问：加环境变量 -e NEO4J_dbms_connector_http_advertised__address=localhost:7474
- 限制内存（防 OOM）：-e NEO4J_dbms_memory_heap_max__size=2g（按宿主机资源调整）
- 开启慢查询日志（调试用）：-e NEO4J_dbms_logs_query_enabled=true
- 如需 HTTPS，挂载证书目录并设 -e NEO4J_dbms_ssl_policy_https_enabled=true
所有配置项名遵循 Neo4j 5.x 的 dbms.* 命名规则，可查 官方 Docker 配置文档。
三、连接与验证是否成功
容器启动后别急着写 Cypher，先确认服务就绪：
- 访问 http://localhost:7474，输入用户名 neo4j 和你设的密码（如 password123）
- 登录后执行 :play movies 加载示例图谱，再跑 MATCH (n) RETURN count(n) 看是否返回数字
- 命令行验证 Bolt 连通性：docker exec -it neo4j-dev cypher-shell -u neo4j -p password123 "RETURN 1"
如果报 “Connection refused” 或 “Authentication failed”，优先检查容器日志：docker logs neo4j-dev，常见原因是密码格式错误或端口被占。
四、进阶：挂载自定义配置文件
复杂场景（如集群、高可用、LDAP 集成）需覆盖默认 neo4j.conf：
- 先生成一份基础配置：docker run --rm neo4j:5.21 cat /etc/neo4j/neo4j.conf > neo4j.conf
- 编辑该文件，例如放开远程 Bolt 访问：dbms.connector.bolt.advertised_address=0.0.0.0:7687
- 启动时挂载：-v $(pwd)/neo4j.conf:/conf/neo4j.conf:ro
注意：挂载配置文件后，环境变量方式的配置（如 NEO4J_dbms_*）将被忽略，二者不可混用。
