[Question] 启动hugegraph-store后，curl http://192.168.207.54:8620/v1/stores返回error

[saladin101]

Problem Type (问题类型)

configs (配置项 / 文档相关)

Before submit

• 我已经确认现有的 Issues 与 FAQ 中没有相同 / 重复问题 (I have confirmed and searched that there are no similar problems in the historical issue and documents)

Environment (环境信息)

• Server Version: 1.7.0 (Apache Release Version)
• Backend: hstore
• OS: 2 CPUs, 16 G RAM, openeuler 24.04

Your Question (问题描述)

单机部署hugegraph，首先部署了pd，启动正常，然后运行了store，启动是正常的，但是curl http://192.168.207.54:8620/v1/stores 返回到内容是：{"error":"Unauthorized!","status":-1}，而不是官方文档中的节点信息。
store的配置文件内容如下：

pdserver:
  # PD service address, multiple PD addresses separated by commas
  address: 192.168.207.54:8686

management:
  metrics:
    export:
      prometheus:
        enabled: true
  endpoints:
    web:
      exposure:
        include: "*"

grpc:
  # grpc service address
  host: 192.168.207.54
  port: 8500
  netty-server:
    max-inbound-message-size: 1000MB
raft:
  # raft cache queue size
  disruptorBufferSize: 1024
  address: 192.168.207.54:8510
  max-log-file-size: 600000000000
  # Snapshot generation interval, in seconds
  snapshotInterval: 1800
server:
  # rest service address
  port: 8520

app:
  # Storage path, support multiple paths, separated by commas
  data-path: ./storage
  #raft-path: ./storage

spring:
  application:
    name: store-node-grpc-server
  profiles:
    active: default
    include: pd

logging:
  config: 'file:./conf/log4j2.xml'
  level:
    root: info

请问可能是什么原因？

Vertex/Edge example (问题点 / 边数据举例)

Schema [VertexLabel, EdgeLabel, IndexLabel] (元数据结构)

[dosubot]

Hi @saladin101! I'm Dosu and I’m helping the incubator-hugegraph team.

你的配置文件里 server.port 设置的是 8520，但你用 curl 访问的是 8620 端口，这通常会导致无法访问到 store 的 REST API。请确认 store 实际监听的端口（应该是 8520），然后用如下命令重试：

curl http://192.168.207.54:8520/v1/stores

如果依然返回 Unauthorized，请检查是否有设置了 PASSWORD 环境变量或相关鉴权配置（如 auth.admin_pa），因为 HugeGraph 1.7.0 支持开启鉴权模式，一旦开启，所有 REST API 都需要带上正确的 Basic Auth 认证头，否则会返回 Unauthorized。例如：

curl -H "Authorization: Basic $(echo -n admin:你的密码 | base64)" http://192.168.207.54:8520/v1/stores

如果你本意是不需要鉴权，确保启动 store 时没有设置 PASSWORD 环境变量，并检查相关配置项未启用鉴权，重启服务即可。

如果你需要开启鉴权，且用的是 hstore 后端，首次初始化时需要先手动创建 ~user 相关 schema，否则鉴权初始化会失败，导致所有 API 都返回 Unauthorized。具体可以参考官方文档说明。

相关参考：1 2 3

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

   

[saladin101]

您好，谢谢您的回复，我这里的配置和验证方式是按照官方文档里的内容写的，地址是https://hugegraph.apache.org/cn/docs/quickstart/hugegraph/hugegraph-hstore/，在该文档中写道：可以通过 PD 的 API 查看集群中的 Store 节点状态，如下图，

[saladin101]

补充一下，使用curl http://localhost:8520/actuator/health验证时，可以返回 {"status":"UP"}，

使用curl http://192.168.207.54:8620/v1/stores进行验证则返回 {"error":"Unauthorized!","status":-1}

使用curl http://192.168.207.54:8520/v1/stores进行验证则返回 {"timestamp":"2026-01-30T08:47:52.524+00:00","status":404,"error":"Not Found","path":"/v1/stores"}

[dosubot]

你的现象完全符合 HugeGraph 分布式架构的设计：

1. /v1/stores 这个接口只在 PD 服务（8620 端口）上开放，用于查看集群 Store 节点状态。Store 服务（8520 端口）本身没有这个接口，所以访问会返回 404，这是正常的官方文档说明。

2. 你在 PD 服务（8620 端口）访问 /v1/stores 返回 Unauthorized，说明 PD 开启了鉴权，必须带上正确的认证信息。HugeGraph 1.7.0 之后，鉴权方式有变化，默认用 admin 用户和 auth.admin_pa 配置的密码（或启动时 PASSWORD 环境变量）作为认证。你需要这样访问：

   curl -u admin:你的密码 http://192.168.207.54:8620/v1/stores

   或

   curl -H "Authorization: Basic $(echo -n admin:你的密码 | base64)" http://192.168.207.54:8620/v1/stores

   如果你不确定密码，可以检查 PD 的配置文件（如 application.yml 或环境变量），查找 auth.admin_pa 或 PASSWORD 的值相关变更说明。

3. Store 服务（8520 端口）只用于健康检查（如 /actuator/health 或 /v1/health），不会有 /v1/stores 这个接口官方文档。

排查建议：

• 只在 PD 端口（8620）访问 /v1/stores。
• 必须带上正确的 admin 认证信息。
• 如果认证信息忘记了，需查找 PD 配置或重置密码。
• Store 节点健康只需看 /actuator/health 或 /v1/health。

如还有疑问，欢迎补充具体配置或日志。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

   

[JisoLya]

谢谢你的反馈！在1.7.0中我们为PD加入了Auth机制，/v1/stores这个接口目前只提供给内部组件使用。如果需要，可以使用内部组件id来访问:
curl -H "Authorization: Basic c3RvcmU6c3RvcmU=" http://{ip}:{port}/v1/stores

[saladin101]

谢谢二位的回复，那么如果想要在pd的配置文件里禁用鉴权机制，应该怎么配置呢？目前我在pd的conf文件里没有看到任何有关auth的配置，所以我只能理解为默认开启

[JisoLya]

谢谢二位的回复，那么如果想要在pd的配置文件里禁用鉴权机制，应该怎么配置呢？目前我在pd的conf文件里没有看到任何有关auth的配置，所以我只能理解为默认开启

yes，现在默认是开启的，目前还不支持手动配置

[saladin101]

谢谢各位