使用Podman配置多Neo4j容器端口及启用APOC插件的问题

一、先搞定第二个Neo4j容器的端口异常问题 #

你之前启动测试容器的命令有两个核心错误，导致Neo4j还是用默认端口启动：

1. 端口映射方向搞反了：Podman的-p参数格式是宿主机端口:容器内部端口，Neo4j容器内部默认依然用7687（Bolt协议）和7474（HTTP），你应该把宿主机的7688映射到容器内的7687，而不是写成7688:7688。
2. 环境变量传递格式不对：Podman不支持-e [key=val,...]这种数组写法，每个环境变量要么单独用-e指定，要么用引号包裹正确的键值对字符串。

给你修正后的启动命令：

podman run --name neo4j-testing \
  -p 7688:7687 \
  -p 7475:7474 \
  -e NEO4J_AUTH=none \
  -e NEO4J_SERVER_BOLT_ADVERTISED_ADDRESS=localhost:7688 \
  -e NEO4J_SERVER_HTTP_ADVERTISED_ADDRESS=localhost:7475 \
  docker.io/library/neo4j

简单解释下：

• -p 7688:7687：把宿主机的7688端口转发到容器内的Bolt默认端口7687，外部客户端通过7688就能连到容器里的Neo4j
• 那两个ADVERTISED_ADDRESS环境变量是告诉Neo4j对外暴露的地址（也就是宿主机端口），这样客户端获取连接地址时会拿到正确的端口，容器内部还是保持默认端口运行。

二、再解决APOC插件启用失败的问题 #

你现在的Podman命令里有好几个明显的错误，导致APOC没装上：

1. 环境变量名称写错了：用来安装实验室插件（比如APOC）的官方变量是NEO4JLABS_PLUGINS，不是你写的NEO4J_PLUGINS
2. 引号转义错误：在Shell里要正确转义双引号，'["apoc"]'的写法没问题，但你之前的命令里引号没闭合，导致语法错误
3. -e参数传递方式错误：还是不能用数组形式，每个环境变量要单独用-e指定
4. 配置变量的命名规范：Neo4j 5.x的环境变量需要把原配置里的点换成下划线，并且全部大写（比如dbms.security.procedures.unrestricted对应NEO4J_DBMS_SECURITY_PROCEDURES_UNRESTRICTED）

修正后的启用APOC的完整命令：

podman run --name neo4j-testing \
  -p 7688:7687 \
  -p 7475:7474 \
  -e NEO4J_AUTH=none \
  -e NEO4J_DBMS_SECURITY_PROCEDURES_UNRESTRICTED=apoc.* \
  -e NEO4J_APOC_EXPORT_FILE_ENABLED=true \
  -e NEO4J_APOC_IMPORT_FILE_ENABLED=true \
  -e NEO4J_APOC_IMPORT_FILE_USE_NEO4J_CONFIG=true \
  -e NEO4JLABS_PLUGINS='["apoc"]' \
  docker.io/library/neo4j:5.5.0

额外提醒两点：

• 最好指定和你Github workflow里一致的镜像版本5.5.0，避免版本差异导致的兼容问题
• 原配置里的apoc.import.file.use_neo4j_config转换成环境变量是NEO4J_APOC_IMPORT_FILE_USE_NEO4J_CONFIG，不用加双下划线

启动后可以这样验证APOC是否生效：

# 进入容器查看plugins目录的jar包
podman exec -it neo4j-testing bash
ls plugins/
# 或者在Neo4j浏览器里执行查询
RETURN apoc.version();

备注：内容来源于stack exchange，提问作者knirirr