hausgold/neo4j

hausgold/neo4j Docker镜像文档

镜像概述和主要用途

该Docker镜像基于https://hub.docker.com/_/neo4j/%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%A2%9D%E5%A4%96%E9%9B%86%E6%88%90%E4%BA%86mDNS/ZeroConf%E5%8D%8F%E8%AE%AE%E6%A0%88%E3%80%82%E9%80%9A%E8%BF%87%E8%AF%A5%E9%95%9C%E5%83%8F%EF%BC%8C%E7%94%A8%E6%88%B7%E5%8F%AF%E4%BB%A5%E4%BE%BF%E6%8D%B7%E5%9C%B0%E8%AE%BF%E9%97%AENeo4j%E6%95%B0%E6%8D%AE%E5%BA%93%EF%BC%8C%E9%BB%98%E8%AE%A4%E6%83%85%E5%86%B5%E4%B8%8B%E5%8F%AF%E9%80%9A%E8%BF%87%60neo4j.local%60%E4%B8%BB%E6%9C%BA%E5%90%8D%EF%BC%88%E7%AB%AF%E5%8F%A380%EF%BC%89%E7%9B%B4%E6%8E%A5%E8%AE%BF%E9%97%AE%EF%BC%8C%E6%97%A0%E9%9C%80%E6%89%8B%E5%8A%A8%E9%85%8D%E7%BD%AEIP%E5%9C%B0%E5%9D%80%EF%BC%8C%E6%9E%81%E5%A4%A7%E7%AE%80%E5%8C%96%E4%BA%86%E6%9C%AC%E5%9C%B0%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B8%AD%E7%9A%84%E6%95%B0%E6%8D%AE%E5%BA%93%E8%AE%BF%E9%97%AE%E6%B5%81%E7%A8%8B%E3%80%82

核心功能和特性

• mDNS自动发现：集成mDNS/ZeroConf协议，支持通过主机名（默认neo4j.local）访问数据库
• 端口代理：通过haproxy将Neo4j默认端口7474代理至端口80，实现标准端口访问
• 自定义主机名：支持通过环境变量配置自定义mDNS主机名
• 多别名支持：可配置多个CNAME别名，实现多主机名访问
• 可选SSH服务：支持启用SSH服务器，便于通过编程方式访问Neo4j工具（默认禁用）

使用场景和适用范围

适用于本地开发环境，尤其适合需要快速搭建和访问Neo4j数据库的开发人员。无需记忆IP地址，通过直观的主机名即可访问数据库，简化开发流程。

详细使用方法和配置说明

前置要求

• 主机已启用Avahi守护进程（avahi-daemon）
• 主机已配置mDNS NSS查找

快速启动

通过以下命令即可启动一个默认配置的Neo4j容器：

bash
$ docker run --rm hausgold/neo4j

容器启动后，Neo4j数据库可通过neo4j.local（端口80）访问，原始端口7474保持不变。

Docker Compose配置示例

yaml
services:
  neo4j:
    image: hausgold/neo4j
    environment:
      # 注意需包含.local后缀
      MDNS_HOSTNAME: neo4j.test.local
      # 是否启用容器内SSH服务器（默认禁用），用于编程访问Neo4j工具
      SSHD_ENABLE: 'false'
      SSHD_ROOT_PASSWORD: root
      SSHD_CUSTOM_CONIFG: 'false'

主机配置

1. 安装nss-mdns包
2. 启用并启动avahi-daemon.service服务
3. 编辑/etc/nsswitch.conf文件，修改hosts行如下：

bash
hosts: ... mdns4_minimal [NOTFOUND=return] resolve [!UNAVAIL=return] dns ...

配置自定义mDNS主机名

通过MDNS_HOSTNAME环境变量配置自定义主机名：

bash
$ docker run --rm -e MDNS_HOSTNAME=something.else.local hausgold/neo4j

此命令将使数据库可通过something.else.local访问。

配置多别名（CNAME）

通过MDNS_CNAMES环境变量配置多个别名（逗号分隔）：

bash
$ docker run --rm \
  -e MDNS_HOSTNAME=something.else.local \
  -e MDNS_CNAMES=nothing.else.local,special.local \
  hausgold/neo4j

配置后，数据库可通过something.else.local、nothing.else.local和special.local访问。

其他顶级域名

默认使用.local作为mDNS顶级域名。若需使用其他域名，需配置主机Avahi服务以支持自定义顶级域名。

参考链接

• Docker/mDNS演示：https://github.com/Jack***/docker-mdns
• Archlinux配置指南：[***]
• Ubuntu/Debian配置指南：[***]