安全

Seawork 采用类似 Docker 的客户端-服务器架构。守护进程在你的机器上运行并管理你的编程智能体。客户端（移动应用、CLI 或网页界面）连接到守护进程来监控和控制这些智能体。

你的代码永远不会离开你的机器。Seawork 是一个本地优先的工具，直接连接到你的开发环境。

架构

Seawork 守护进程可以在任何你想执行智能体的地方运行：你的笔记本、Mac Mini、VPS 或 Docker 容器。守护进程监听连接并管理智能体生命周期。

客户端通过 WebSocket 连接到守护进程。建立连接有两种方式：

中继是从手机连接的最简单方式。无需 VPN 配置、端口转发或防火墙配置。守护进程可以保持绑定到 localhost 或 socket 文件——它向外连接到中继，你的手机在那里与它会合。

中继的设计目标是不可信任的。你的手机和守护进程之间的所有流量都是端对端加密的。中继服务器无法读取你的消息、查看你的代码或在不被发现的情况下修改流量。即使中继被攻陷，你的数据仍然受到保护。

中继只能看到：IP 地址、时序、消息大小和会话 ID。它无法读取消息内容、伪造消息或通过观察握手推导加密密钥。

守护进程在处理任何命令之前需要有效的加密握手。被攻陷的中继无法：

二维码或配对链接是信任锚点。它包含守护进程的公钥，这是建立加密连接所必需的。像对待密码一样对待它——不要公开分享。

如果你认为配对提供已被泄露，重启守护进程以生成新的会话 ID 并轮换中继配对。

默认情况下，守护进程监听 127.0.0.1:6767 （仅限本地）。这对本地 CLI 使用是安全的，但无法从你的手机或其他设备访问。

为了最大隔离，你可以将守护进程配置为监听 Unix socket 文件而不是 TCP 端口。这完全阻止了网络访问——只有同一机器上的进程才能连接。CLI 支持此模式，但移动应用和网页界面需要网络连接。

如果你更喜欢通过中继进行直接连接，可以使用 Tailscale等 VPN。Tailscale 在你的设备之间创建私有网络，让你无需将守护进程暴露在公共互联网即可访问它。

设置步骤：

警告： 绑定到 0.0.0.0 会使守护进程在所有网络接口上可达，包括公共 Wi-Fi 和本地网络。这可能将你的守护进程暴露给未授权访问。如果必须绑定到所有接口，请确保有适当的防火墙规则并检查你的 allowedHosts 配置。

CORS CORS 不是完整的安全边界。它控制哪些浏览器来源可以发出请求，但不能阻止恶意网站将其域名解析到你的本地机器（DNS 重绑定）。

Seawork 使用主机白名单来验证传入请求的 Host 头。带有未识别主机的请求会被拒绝。

通过 daemon.allowedHosts 中的 config.json:

Seawork 包装智能体 CLI（Claude Code 和 Codex），但不管理它们的认证。每个智能体提供商处理自己的凭证：

Seawork 从不存储或传输提供商 API 密钥。智能体在你的用户上下文中使用你现有的凭证运行。