WingGate 的工作原理

WingGate 的结构可以用一句话概括：一个负责"谁能做什么"的服务，一个运行在你自己网络里的 wing-connector（连接器），以及你手上的各种客户端。 理解这三者的分工，其余细节都会变得直观。

一张图看懂

各组件的角色

组件	在哪里	它为你做什么
Web Console	浏览器	管理一切的总台：账号、组织与项目、资产、连接器、授权与审计。打开浏览器即可用，无需安装任何东西。
WingGate 服务	WingGate 云端	大脑：认证你的身份，决定谁能访问哪些资产，签发短期凭据，并把每一次访问记入审计。
wing-connector	你的网络	部署在资产旁边的轻量代理。它主动向服务发起加密连接，是唯一真正"触碰"你资产的组件。
Tool Runner（可选）	资产上	按需受控安装到资产上的执行器：git 查看、文件搜索（find/grep）、运行时快照在资产本地完成，只把结果传出来，而不是搬运整个文件。
浏览器扩展（可选）	你的浏览器	浏览器资产的执行端：把你的浏览器变成受管资产，让 AI 安全地操作它——读取页面快照、执行受控的点击与填写。
客户端	你的设备	Web 终端、你自己的 SSH 客户端、Claude Code 等 MCP 客户端——用你喜欢的方式接入。

wing-connector 为什么重要

wing-connector 决定了 WingGate 的安全边界长什么样。它主动向服务发起连接（仅出向、双向 TLS），所以：

• 目标机器不需要公网 IP，不需要任何入站防火墙规则——家里实验室、内网 VPC、办公室机器都能直接纳管。
• 连接器留在你的信任边界内，靠近它服务的资产；凭证和资产侧的访问不出你的网络。
• 服务侧不增加你资产的暴露面：即使 WingGate 云端不可用，你的机器也没有多开任何端口。

见 连接器部署 了解如何安装与运行。

Tool Runner：资产侧的执行器

• 是什么——按需受控安装到资产上的小型执行器（安装在所选连接配置的用户缓存目录，不使用 sudo）。它不是常驻服务，也不改变资产的安全边界。
• 做什么——git 查看、文件搜索（find/grep）、运行时快照这类操作在资产本地完成，只把结果传出来：不搬运整个文件，也不把代码复制出资产。
• 何时出现——默认不安装。首次使用 Runner-only 操作时自动创建安装 Job（控制台可见 installing，完成后原操作自动重试）；SSH / host 资产上的基础文件操作始终走零安装 SFTP，永不触发安装。Runner 只属于有主机可装的资产：SMB / WebDAV / S3 文件后端直接讲各自协议，没有这条安装路径。
• 授权与更新——安装需按项目 × 资产 × 连接配置显式授权；受管 channel 内可自动更新，安装路径或信任根变化需重新授权；撤销授权阻止后续安装与更新，不卸载已有二进制。

数据去了哪里，什么不经过服务

WingGate 把"决定"与"搬运"分开：

• 服务只做决定——认证、授权、签发凭据、记录审计。
• 数据直达——SSH 会话、文件字节、MCP 工具的 payload 在你的客户端与 wing-connector 之间直接流动，不绕经服务。这既带来更快的传输，也让服务的职责边界保持清晰。
• 两个例外：Web 终端 经服务的会话流桥接，换取随处可用的零安装体验；浏览器工具由你浏览器中的扩展执行——你的浏览器作为浏览器资产被纳管，这部分数据不经过你网络里的 wing-connector。

两个典型的访问旅程

用 SSH 连接一台主机

1. 首次连接前，在控制台确认资产的主机密钥指纹（防中间人，之后自动校验）。
2. 你的 SSH 客户端连到 WingGate 的 SSH 端点。
3. 服务验证你的公钥与项目授权，经反向通道把会话交给 wing-connector。
4. wing-connector 在本地连上目标主机，shell 建立。
5. 整个会话出现在审计记录里——谁、何时、从哪个入口、访问了什么。

让 AI 读取一个文件

1. 你在控制台创建一个项目级 MCP 凭据，配置到 Claude Code 等客户端。
2. AI 通过 MCP 请求读取文件；wing-connector 校验项目授权。
3. 读取在资产侧执行，内容经数据面返回；大文件分页返回，有明确的字节上限，绝不无界传输。
4. 审计记录这次访问；凭据随时可在控制台吊销。

接下来

• 从浏览器开始：使用 Web Console
• 安装连接器，接入第一批资产：连接器部署
• 深入连接与信任边界：连接模型
• 让 AI 安全地使用你的资产：MCP 接入