跳转至

仅端点的 Doclib 发现

背景

默认 DoclibClient 解析器会读取当前 MINERU_HOME 下的端点文件,但当该文件缺失或无效时,目前会从启动配置推导 UDS 或 TCP 传输方式。推导出的 TCP 端点可能连接到属于另一个 home 的服务器。

决策

默认发现机制将 $MINERU_HOME/doclib.endpoint.json 视为运行时传输方式的唯一来源。如果文件缺失、无效或没有可用的传输方式,客户端将没有连接候选项,并在发起请求时报告服务器未运行。

有效端点文件中记录的传输方式仍保持顺序,UDS 在 TCP 之前。显式的 socket_path 和 base_url 构造参数仍然是直接的端点覆盖,并且不会读取发现文件。

服务器身份验证

每个 Doclib Server 进程会生成一个随机的 server_id。端点版本 2 会将该标识符与 PID 和传输方式一起存储,并且 GET /server/status 会返回相同的值。默认发现客户端会在首次业务请求之前惰性探测每个候选传输方式,并且只使用其报告的 server_id 与端点匹配的候选项。

这将通过 MINERU_HOME 选择的端点文件绑定到写入该文件的精确服务器进程,而无需比较运行时特定的路径字符串。如果过期端点的 TCP 端口或 UDS 路径已被复用,则会以 server_instance_mismatch 拒绝。版本 1 端点和格式错误的版本 2 端点均无效,并且不提供连接候选项。

显式的 socket_path 和 base_url 值表示调用方选择的服务器,并绕过端点发现和实例验证。PID 和 mineru_home 仍然是诊断字段,不是身份检查。

验证

单元测试覆盖端点 schema 往返、有效端点顺序、缺失和无效的端点文件、显式 UDS/TCP 覆盖、匹配的身份、不匹配的身份,以及身份不匹配后回退到另一种传输方式。现有的 doclib 和 CLI 服务器测试必须保持通过。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 mi/MinerU