From 9ae553906dbeb8300f13eadca32ce5dcc8681800 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Thu, 30 Apr 2026 15:35:15 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/gateway/gateway-lock.md | 44 +++++++++++++++--------------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/zh-CN/gateway/gateway-lock.md b/docs/zh-CN/gateway/gateway-lock.md index bdc542a3d..378c93a5e 100644 --- a/docs/zh-CN/gateway/gateway-lock.md +++ b/docs/zh-CN/gateway/gateway-lock.md @@ -1,44 +1,44 @@ --- read_when: - 运行或调试 Gateway 网关进程 - - 调查单实例强制机制 + - 排查单实例强制执行机制 summary: 使用 WebSocket 监听器绑定的 Gateway 网关单例保护 title: Gateway 网关锁 x-i18n: - generated_at: "2026-04-27T21:49:13Z" - model: gpt-5.4 + generated_at: "2026-04-30T15:34:53Z" + model: gpt-5.5 provider: openai - source_hash: fe61ff81106554e98de1ca04c213b76d230265cdf3e81b70897d2de00f6a0179 + source_hash: 85a1cb55f08d47d36fde25900e4247ef01c9a6800bf017fbff44a337f299ce13 source_path: gateway/gateway-lock.md - workflow: 15 + workflow: 16 --- -## 原因 +## 为什么 -- 确保同一主机上每个基础端口仅运行一个 Gateway 网关实例；额外的 Gateway 网关必须使用隔离的配置档案和唯一端口。 -- 在崩溃或 `SIGKILL` 后仍能恢复，不留下陈旧的锁文件。 -- 当控制端口已被占用时，快速失败并给出清晰的错误信息。 +- 确保同一主机上每个基础端口只运行一个 Gateway 网关实例；额外的 Gateway 网关必须使用隔离的配置文件和唯一端口。 +- 在崩溃/SIGKILL 后也不会留下陈旧的锁文件。 +- 当控制端口已被占用时，快速失败并给出清晰错误。 ## 机制 -- Gateway 网关首先在状态锁目录下获取一个按配置划分的锁文件，并探测已配置端口上是否已有监听器存在。 -- 如果记录的锁持有者已不存在、端口空闲，或者锁已陈旧，启动过程会重新获取该锁并继续。 -- 然后，Gateway 网关使用独占的 TCP 监听器绑定 HTTP/WebSocket 监听器（默认 `ws://127.0.0.1:18789`）。 -- 如果绑定因 `EADDRINUSE` 失败，启动会抛出 `GatewayLockError("another gateway instance is already listening on ws://127.0.0.1:")`。 -- 在关闭时，Gateway 网关会关闭 HTTP/WebSocket 服务器并移除锁文件。 +- Gateway 网关首先在状态锁目录下获取每配置锁文件，并探测已配置端口是否已有监听器。 +- 如果记录的锁拥有者已消失、端口空闲，或锁已陈旧，启动过程会回收锁并继续。 +- 随后 Gateway 网关使用独占 TCP 监听器绑定 HTTP/WebSocket 监听器（默认 `ws://127.0.0.1:18789`）。 +- 如果绑定失败并返回 `EADDRINUSE`，启动会抛出 `GatewayLockError("another gateway instance is already listening on ws://127.0.0.1:")`。 +- 关闭时，Gateway 网关会关闭 HTTP/WebSocket 服务器并移除锁文件。 -## 错误表现 +## 错误表面 -- 如果另一个进程持有该端口，启动会抛出 `GatewayLockError("another gateway instance is already listening on ws://127.0.0.1:")`。 -- 其他绑定失败会表现为 `GatewayLockError("failed to bind gateway socket on ws://127.0.0.1:: …")`。 +- 如果另一个进程占用了该端口，启动会抛出 `GatewayLockError("another gateway instance is already listening on ws://127.0.0.1:")`。 +- 其他绑定失败会以 `GatewayLockError("failed to bind gateway socket on ws://127.0.0.1:: …")` 呈现。 -## 操作说明 +## 运维说明 -- 如果该端口被_另一个_进程占用，错误信息也是相同的；请释放该端口，或使用 `openclaw gateway --port ` 选择其他端口。 -- 在服务监管器下，新的 Gateway 网关进程如果发现现有的健康 `/healthz` 响应器，会成功退出并让该进程继续控制。如果现有进程始终未变为健康状态，重试次数会受到限制，并且启动会以清晰的锁错误失败，而不是无限循环。 -- macOS 应用在启动 Gateway 网关前仍会维护其自身的轻量级 PID 保护；运行时锁由锁文件加上 HTTP/WebSocket 绑定共同强制执行。 +- 如果端口被_另一个_进程占用，错误相同；释放该端口，或使用 `openclaw gateway --port ` 选择另一个端口。 +- 在服务监督器下，新的 Gateway 网关进程如果看到现有健康的 `/healthz` 响应方，会让该进程继续控制。在 systemd 上，重复启动器会以代码 78 退出，因此默认的 `RestartPreventExitStatus=78` 会阻止 `Restart=always` 因锁或 `EADDRINUSE` 冲突而循环。如果现有进程始终无法变为健康状态，重试会受限，启动会以清晰的锁错误失败，而不是无限循环。 +- macOS 应用在生成 Gateway 网关前仍会维护自己的轻量级 PID 防护；运行时锁由锁文件加 HTTP/WebSocket 绑定强制执行。 -## 相关内容 +## 相关 - [多个 Gateway 网关](/zh-CN/gateway/multiple-gateways) — 使用唯一端口运行多个实例 - [故障排除](/zh-CN/gateway/troubleshooting) — 诊断 `EADDRINUSE` 和端口冲突