如何确保ArangoDB集群不加载默认配置，按指定参数运行并解决远程连接问题

环境信息 #

full-version-string: ArangoDB 3.11.0 [linux] 64bit, using jemalloc, build tags/v3.11.0-0-gd91ddf405d3, VPack 0.2.1, RocksDB 7.2.0, ICU 64.2, V8 7.9.317, OpenSSL 3.0.8 7 Feb 2023

集群组件预期配置 #

Agency节点启动命令 #

# 节点X.X.X.111
arangod --server.endpoint tcp://0.0.0.0:8531 \
  --agency.my-address tcp://X.X.X.111:8531 \
  --server.authentication false \
  --agency.activate true \
  --agency.size 3 \
  --agency.supervision true \
  --database.directory /arangodb/agency/agent111

# 节点X.X.X.222
arangod --server.endpoint tcp://0.0.0.0:8531 \
  --agency.my-address tcp://X.X.X.222:8531 \
  --server.authentication false \
  --agency.activate true \
  --agency.size 3 \
  --agency.supervision true \
  --database.directory /arangodb/agency/agent222

# 节点X.X.X.333
arangod --server.endpoint tcp://0.0.0.0:8531 \
  --agency.my-address tcp://X.X.X.333:8531 \
  --server.authentication false \
  --agency.activate true \
  --agency.size 3 \
  --agency.endpoint tcp://X.X.X.111:8531 \
  --agency.endpoint tcp://X.X.X.222:8531 \
  --agency.endpoint tcp://X.X.X.333:8531 \
  --agency.supervision true \
  --database.directory /arangodb/agency/agent333

DBServer节点启动命令 #

# 节点X.X.X.111
arangod --server.authentication=false \
  --server.endpoint tcp://0.0.0.0:8530 \
  --cluster.my-address tcp://X.X.X.111:8530 \
  --cluster.my-role DBSERVER \
  --agency.endpoint tcp://X.X.X.111:8531 \
  --agency.endpoint tcp://X.X.X.222:8531 \
  --agency.endpoint tcp://X.X.X.333:8531 \
  --database.directory /arangodb/database/dbserver111 &

# 节点X.X.X.222
arangod --server.authentication=false \
  --server.endpoint tcp://0.0.0.0:8530 \
  --cluster.my-address tcp://X.X.X.222:8530 \
  --cluster.my-role DBSERVER \
  --agency.endpoint tcp://X.X.X.111:8531 \
  --agency.endpoint tcp://X.X.X.222:8531 \
  --agency.endpoint tcp://X.X.X.333:8531 \
  --database.directory /arangodb/database/dbserver222 &

# 节点X.X.X.333
arangod --server.authentication=false \
  --server.endpoint tcp://0.0.0.0:8530 \
  --cluster.my-address tcp://X.X.X.333:8530 \
  --cluster.my-role DBSERVER \
  --agency.endpoint tcp://X.X.X.111:8531 \
  --agency.endpoint tcp://X.X.X.222:8531 \
  --agency.endpoint tcp://X.X.X.333:8531 \
  --database.directory /arangodb/database/dbserver333 &

Coordinator节点预期启动命令 #

# 节点X.X.X.111
arangod --server.authentication=false \
  --server.endpoint tcp://0.0.0.0:8555 \
  --cluster.my-address tcp://X.X.X.111:8555 \
  --cluster.my-role COORDINATOR \
  --agency.endpoint tcp://X.X.X.111:8531 \
  --agency.endpoint tcp://X.X.X.222:8531 \
  --agency.endpoint tcp://X.X.X.333:8531 \
  --database.directory /arangodb/coordinators/coordinator111 &

# 节点X.X.X.222
arangod --server.authentication=false \
  --server.endpoint tcp://0.0.0.0:8555 \
  --cluster.my-address tcp://X.X.X.222:8555 \
  --cluster.my-role COORDINATOR \
  --agency.endpoint tcp://X.X.X.111:8531 \
  --agency.endpoint tcp://X.X.X.222:8531 \
  --agency.endpoint tcp://X.X.X.333:8531 \
  --database.directory /arangodb/coordinators/coordinator222 &

# 节点X.X.X.333
arangod --server.authentication=false \
  --server.endpoint tcp://0.0.0.0:8555 \
  --cluster.my-address tcp://X.X.X.333:8555 \
  --cluster.my-role COORDINATOR \
  --agency.endpoint tcp://X.X.X.111:8531 \
  --agency.endpoint tcp://X.X.X.222:8531 \
  --agency.endpoint tcp://X.X.X.333:8531 \
  --database.directory /arangodb/coordinators/coordinator333 &

问题现象 #

启动X.X.X.333的Coordinator时，实际使用命令如下：

arangod --configuration none \
        --server.endpoint tcp://127.0.0.1:8529 \
        --server.authentication true \
        --javascript.startup-directory /arangodb/server/usr/share/arangodb3/js \
        --javascript.app-path /tmp/arangodb-app.egel \
        --server.authentication=false \
        --server.endpoint tcp://0.0.0.0:8555 \
        --cluster.my-address tcp://X.X.X.333:8555 \
        --cluster.my-role COORDINATOR \
        --agency.endpoint tcp://X.X.X.111:8531 \
        --agency.endpoint tcp://X.X.X.222:8531 \
        --agency.endpoint tcp://X.X.X.333:8531 \
        --database.directory /arangodb/coordinators/coordinator333

最终该Coordinator仅监听127.0.0.1，无法远程连接。

解决方案 #

1. 核心问题分析 #

ArangoDB命令行参数支持重复声明，部分参数（如--server.endpoint）会被追加而非覆盖，导致节点同时监听多个端口；若默认配置未彻底禁用，也可能出现参数冲突。你遇到的问题是重复声明了--server.endpoint，且冗余参数干扰了预期配置。

2. 确保无默认配置加载 #

• 必须将--configuration none放在命令行最开头，彻底禁用系统级、用户级的默认配置文件（如arangod.conf）。
• 删除所有重复、冗余的参数，每个配置项仅声明一次。

3. 修正后的Coordinator启动命令 #

arangod --configuration none \
        --server.endpoint tcp://0.0.0.0:8555 \
        --server.authentication=false \
        --javascript.startup-directory /arangodb/server/usr/share/arangodb3/js \
        --javascript.app-path /tmp/arangodb-app.egel \
        --cluster.my-address tcp://X.X.X.333:8555 \
        --cluster.my-role COORDINATOR \
        --agency.endpoint tcp://X.X.X.111:8531 \
        --agency.endpoint tcp://X.X.X.222:8531 \
        --agency.endpoint tcp://X.X.X.333:8531 \
        --database.directory /arangodb/coordinators/coordinator333

4. 全局验证与规范 #

• 所有集群节点（Agency、DBServer、Coordinator）统一以--configuration none开头启动，避免默认配置干扰。
• 启动后执行curl http://<节点IP>:<端口>/_api/version，确认节点可远程访问。
• 查看节点日志（数据库目录下的arangod.log），搜索endpoint关键字，验证实际监听地址与配置一致。
• 如需同时监听本地和远程端口，可多次声明--server.endpoint，例如：--server.endpoint tcp://127.0.0.1:8529 --server.endpoint tcp://0.0.0.0:8555。

内容的提问来源于stack exchange，提问作者Evgeny