websocket connect error

[ZhangSanMo]

What version of HAPI is running?

hapi version: 0.16.2

What platform is your computer?

windows x64

What issue are you seeing?

index-CPLffQ_y.js:217 WebSocket connection to 'ws://localhost:3006/socket.io/?EIO=4&transport=websocket&sid=rD-wSPraHzZeQkm24pLj' failed: WebSocket is closed before the connection is established.

What steps can reproduce the bug?

config:

{
  "cliApiToken": "xxx-xxx",
  "vapidKeys": {
    "publicKey": "xxx",
    "privateKey": "xx-xx-xx"
  },
  "machineId": "xx-4706-4874-b45e-xx",
  "apiUrl": "http://localhost:3006",
  "listenHost": "localhost",
  "publicUrl": "https://localhost:3006",
  "corsOrigins": [
    "publicUrl",
    "localhost"
  ]
}

What is the expected behavior?

能正常使用terminal

Additional information

No response

[github-actions]

从当前代码看，这更像是 hub 配置里的 origin/CORS 不匹配，不是 terminal 功能本身已经明确损坏。

terminal 页面会直接用当前 web 的 baseUrl 去连 ${baseUrl}/terminal，Socket.IO 路径固定是 /socket.io/。所以浏览器实际发起的连接 origin，必须被 hub 允许。你这里的 corsOrigins 配成了 "publicUrl" 和 "localhost"，按当前实现它们会被当成字面量字符串使用，不会自动展开成 http://localhost:3006 或 https://localhost:3006，因此很容易被 hub 拒掉。

另外，当前文档里 hub 默认监听的是 http://localhost:3006；publicUrl 是“external/public access”用途。我在当前 hub server 代码里也没有找到原生 HTTPS/TLS 监听配置。所以如果你不是走反向代理/隧道，publicUrl 直接写成 https://localhost:3006 也不太对。

如果你是在本机直接打开 HAPI，建议先改成最小配置再试一次：

{
  "cliApiToken": "xxx-xxx",
  "machineId": "xx-4706-4874-b45e-xx",
  "apiUrl": "http://localhost:3006",
  "listenHost": "127.0.0.1",
  "publicUrl": "http://localhost:3006"
}

先删除 corsOrigins，因为当前代码在未显式配置时，会直接用 publicUrl 推导默认 CORS origin。

如果你确实是通过 HTTPS 反代访问 web，那么 publicUrl 和 corsOrigins 都要写成真实 origin，例如 https://localhost:3006，而不是 "publicUrl" / "localhost" 这种占位值。

Relevant code:

• web/src/hooks/useTerminalSocket.ts:119 - terminal 页面通过 ${baseUrl}/terminal 建立 Socket.IO 连接
• hub/src/socket/server.ts:49 - Socket.IO CORS 白名单来自 corsOrigins
• hub/src/socket/server.ts:65 - hub 会校验请求 Origin，不在白名单就拒绝
• hub/src/config/serverSettings.ts:190 - 未显式配置 corsOrigins 时，默认从 publicUrl 推导
• docs/guide/installation.md:153 - 文档说明 hub 默认监听 http://localhost:3006
• docs/guide/installation.md:182 - publicUrl 用于 external/public access
• hub/src/web/server.ts:233 - 当前 server 只看到 hostname/port 配置，未发现原生 HTTPS/TLS 监听配置

Need more info:

• 你现在打开 web 的地址，实际是 http://localhost:3006，还是经过了 HTTPS 反代/隧道？
• 修改完上面的配置后，hub 启动日志里是否有 Origin not allowed 或 Invalid token？

---

HAPI Bot