给家庭用户
看清连接状态、AID、出口 IP 与运营商。启动自动连接，也能随时暂停。
RUST DESKTOP v0.1.5 /测试版现已可下载让家庭网络，
让家庭网络，
连接更多可能.
把家中的网络，带到你的应用里。
家庭用户轻松连接，开发者通过 API、WebSocket
或 SOCKS5，使用每一条获授权的家庭网络。
macOS / WindowsLinux / ARM
THE NETWORK, CONNECTED 架构示意
你的家庭网络YOUR HOME NETWORK
SockWSGATEWAY
你的应用YOUR APPLICATION
WSS 加密连接经授权的设备路由 ROUTE AUTHORIZED
AID
012345ACCESS
API · WSS · SOCKS5示例路由 · 不代表实时设备数据
01 / HOME → CLOUD → APP
ONE NETWORK.
MORE POSSIBILITIES.
MORE POSSIBILITIES.
AID API程序化集成
WebSocket双向 TCP 隧道
SOCKS5标准代理接入
统一授权
每次访问，都有边界
每次访问，都有边界
01 / A BRIDGE TO HOMELOCAL NETWORK
GLOBAL CONNECTION
GLOBAL CONNECTION
网络留在家中。
能力，延伸到你的应用。
家庭客户端主动连接 SockWS 网关，成为应用可以授权使用的网络出口。无需给家里的设备开放入站端口，也无需让家庭用户理解代理协议。
给应用开发者
在控制台创建应用、选择设备路由、生成凭证，用熟悉的方式完成接入。
02 / SIMPLE BY DESIGN
- 01
安装客户端
在电脑或受支持的设备上安装对应版本。
- 02
完成设备授权
首次将八位绑定码交给管理员确认，设备获得自己的 AID。
- 03
保持连接
完成配置与授权后，启动自动连接；需要时随时暂停。
03 / BUILT FOR BUILDERS
三种入口。同一个家庭出口。
让用户安心连接，让开发者专注应用。
集成、授权和监控，都在网关控制台完成。
01 / HTTP / HTTPS
一个 AID，把家庭网络接入应用。
使用服务端 API Key 和已授权的 AID 发起 HTTP 请求，获得目标状态码、响应头及 Base64 响应正文。
- 独立认证与设备授权
- 目标白名单与并发限制
- 统一连接监控与流量记录
API Key 保存在你的应用服务器，AID 只用于查找设备，不能代替身份认证。
// 在你的应用服务器上运行（Node.js 18+）
// GATEWAY_URL：已部署网关的 HTTPS 地址
const response = await fetch(
process.env.GATEWAY_URL + "/v1/proxy", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.DEVELOPER_API_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({
aid: process.env.AID,
method: "GET",
url: "https://example.com/"
})
}
);
if (!response.ok) throw new Error("Gateway " + response.status);
const result = await response.json();
console.log(result.status_code);
console.log(Buffer.from(result.body, "base64").toString("utf8")); 你的应用鉴权与设备路由SockWS 网关家庭客户端目标服务
04 / TRUST IS THE FOUNDATION网络属于你。
网络属于你。
授权，也由你掌握。
从设备绑定到每一次目标连接，
访问都在明确的授权范围内发生。
AID 是标识，密钥才是凭证
知道 AID 或代理链接无法直接使用网络。三种入口分别认证，凭证可过期、轮换和撤销。
只访问被允许的目标
网关校验目标白名单与解析后的 IP，默认限制私网和敏感地址；家庭客户端同时执行本机策略。
停止授权，停止连接
客户端可暂停共享；管理者可停用设备、路由或应用，拒绝新连接并终止对应活动流。
看见用量，不记录业务正文
控制台记录连接结果、流量、时长和关闭原因，监控记录不包含代理正文、密码或敏感 Token。
05 / YOUR NETWORK STARTS HERE给你的设备，
给你的设备，
一个新的连接方式。
选择适合你的客户端。
家庭用户使用桌面版，服务器选择命令行版。
DESKTOP APP
macOS
Apple Silicon · 桌面版
已在 macOS 实机验证；本地签名，尚未公证。
下载 ZIP5.0 MB · v0.1.5SHA-256 校验值
d4ee7f5cb976a2a66ec58867c14e59c6537804918994f9fcda53f90d45eb306bDESKTOP APP
Windows
x64 · 桌面版
已交叉构建，待 Windows 实机验证；需要 WebView2。
下载 ZIP8.8 MB · v0.1.5SHA-256 校验值
7cd08d9ff5a2ff8d74102b103aa4e9d266ab12dcc71e7e53fa25d86eb5cf3c1d 安装包不含设备身份与代理凭证，首次运行仍需服务配置和设备授权。
iOS / Android 新 Rust 客户端尚未发布；macOS Intel 桌面包暂未提供。Windows / Linux / ARM 包已交叉构建，仍需对应设备验证。
下载全部校验值 ↗06 / A FEW GOOD QUESTIONS连接之前，
连接之前，
你可能想了解。
不需要。家庭用户使用客户端查看网络状态、AID、公网 IP 和运营商，并控制连接或暂停。首次服务地址与目标策略由维护人员配置，设备经管理员批准后，后续启动会自动连接。应用集成由开发者在网关网站完成。
不需要按家庭数量建立租户。同一业务或组织可以使用一个租户，绑定多台家庭设备；每台设备保留独立身份与授权。不同客户需要隔离管理时，再按实际业务划分租户。一个应用也可以关联同租户内多台设备的路由。
连接目标服务器的 TCP 由家庭客户端发起，因此目标看到的是家庭网络实际使用的公网出口。设备若位于运营商共享地址、路由器上游隧道或其他网络环境下，公网出口取决于真实网络。客户端会检测并展示出口 IP，不伪装成固定的住宅 IP。
不能。AID 和 route_id 都是查找标识；API、WSS、SOCKS5 分别需要有效的独立凭证，并通过租户、设备、路由、应用及目标策略校验。WSS 的短期 Ticket 默认一次性消费，不能当作永久分享密码。
不能。它使用 SockWS 现有的 zos.tcp.v1 专用子协议，需要客户端支持 HELLO / OPEN / OPEN_OK 与二进制 TCP 数据。只支持标准 SOCKS5 的工具，应使用独立的 SOCKS5 地址、用户名和密码。
家庭客户端离线会结束该设备的活动流。客户端可在恢复网络后自动重连，但不会恢复旧的 TCP 连接或重放之前的业务请求；调用方需要根据请求性质自行重试。
不会创建 TUN 或系统 VPN。新 Rust 客户端默认尝试绑定物理 IPv4 网卡处理自身流量，绑定失败不会偷偷回退；但不能保证绕过所有 VPN 的强制封锁或路由器上游隧道，也不会关闭其他应用的 VPN。
当前是项目测试阶段：Rust 网关与管理后台已完成本地联调，官网提供实际测试包。sockws.com 的公网控制台、正式网关、开发者自助注册与计费尚未上线。请不要将文档中的规划域名当作已经可用的生产服务。
YOUR HOME. YOUR NETWORK.下一次连接，
获取测试客户端下一次连接，
从家里出发。
为家庭用户而简单，为开发者而构建。