快速开始

从注册到第一台设备连通。整个过程的核心只有一句话:私钥在你手里,我们只负责告诉你「谁可以连」。

文档 / 快速开始适用:公测版最后更新:2026-10-08

一、开始之前

你需要准备好这四样东西,缺一样流程都走不完:

  • 一个邮箱。登录只用邮箱验证码,没有密码,也不需要手机号。
  • 一台常开的内网机器。Agent 装在这台机器上,它同时是你内网里的 WireGuard 服务端(下称 wg-server)。Linux 与 Windows 都支持,详见安装 Agent。
  • 远端设备上的官方 WireGuard 客户端。我们不做自研客户端,成员设备用官方客户端扫码导入配置即可。
  • 路由器上做一次端口转发(默认模式下需要):把公网 UDP 51820 转发到内网那台机器。公网 IP 不用固定。已有固定公网地址的可以直接选直连模式,跳过这步。
先说清楚做不到的事。如果出口是对称 NAT,或者你没有做端口映射,就没有任何设备能直达的端点,连接建立不起来——设备端会明确提示「当前网络环境暂不支持」。平台不提供流量转发兜底,这是刻意的设计取舍,不是功能缺失:一旦平台转发业务流量,我们就能看到你的数据了。

二、注册并创建组织

  1. 打开 console.sclink.dev/signup,填入邮箱,点「发送验证码」。
  2. 邮件里是一枚 6 位数字验证码,10 分钟内有效,且只能使用一次。
  3. 填入验证码,创建你的组织。创建者自动成为该组织的管理员。

完成后你会看到:控制台左侧有「仪表盘 / 设备 / 成员 / 密钥与信任 / 审计日志 / 组织设置」六个入口,并落在「开通引导」页上。

关于验证码,三条规则先知道,能少走弯路:① 同一邮箱任何时刻只有一枚有效验证码;② 冷却后重新发送,旧的那枚立刻作废——所以永远用最新那封邮件里的码;③ 验证码登录、注册共用。

首次进入控制台时,浏览器会本地生成一把授权私钥。它只存在你的浏览器里,我们服务器上只有对应的公钥,因此我们无法帮你找回。它不能导出或备份,丢了就只能重建授权——所以请在本浏览器上完成设备登记与批准,不要清除站点数据。

三、在内网机器安装 Agent

Agent 装在要接入的那台内网机器上(Linux)。整个过程三个动作:

  1. 装 Agent(一行命令)。在那台机器上执行,脚本自动下载、校验 SHA256、装到 /usr/local/bin:
    curl -fsSL https://install.sclink.dev/install.sh | sh
    不放心管道给 shell?安装 Agent 有手动版本:下载、校验、安装,每步一条命令。装完你会看到脚本打印的「下一步」提示。
  2. 拿注册令牌。在控制台「开通引导」页点「生成注册令牌」并复制。令牌 24 小时内有效、只能用一次、明文只显示这一次——关掉页面就点「重新生成令牌」拿新的。
  3. 注册并安装为系统服务。照安装 Agent 的「照抄就能用的完整步骤」:把令牌、组织标识、签名公钥各就各位,先 install --dry-run 预览,确认后 sudo -E securelink-agent install。这一步只需要做一次,之后 Agent 随机器自启。

完成后你会看到:控制台「仪表盘」上 Agent 状态变为在线。令牌过期或用过了都没关系,回开通引导页重新生成一枚即可,旧的自动失效。

四、添加并批准一台设备

先分清在哪台机器上操作:添加设备是在你自己的电脑浏览器里,不是在要接入的那台手机/电脑上。设备密钥在添加设备的浏览器里生成,只有公钥会上传;批准之后配置拼成二维码,给要接入的设备扫。

  1. 管理员在「设备」页点「添加设备」,填设备名、选系统,点「生成密钥」「提交申请」。(成员也可以自己在「我的设备」页提交,等管理员批。)
  2. 在设备列表点「批准」,和设备注册页显示的「本机指纹」核对一致后勾选确认,点「批准并签名」。批准由管理员浏览器的授权私钥签名——我们只验签名,没法替任何人签。
  3. 点「获取配置」,弹窗里是 WireGuard 配置二维码(也能复制配置文本发过去)。
  4. 在要接入的设备上装官方 WireGuard 客户端,「从二维码创建」扫码导入。

完成后你会看到:设备状态变为「在线」。注意:私钥只存在当初添加设备的那台浏览器里,换了浏览器就点不出配置了——这是设计如此,换电脑就要重新添加一次设备。

五、连上内网

  1. 在 WireGuard 客户端里启用刚导入的隧道,然后照常访问内网服务。到这一步就完成了。
  2. 连不通时按顺序查三件事:① 控制台里设备状态是不是「在线」;② 仪表盘上 Agent 是不是在线(Agent 离线,新批准的设备连不上);③ WireGuard 客户端里这条隧道有没有「最近握手」时间(没有多半是端口转发或对称 NAT 的问题)。更多见常见问题。
  3. 要收回谁的访问权,在控制台吊销该设备,Agent 30 秒内生效。

日常怎么用控制台——管理成员、看审计、冻结组织、更换或找回签名密钥——见控制台使用手册。

六、尚未提供的功能

下面这些还没有,我们宁可写清楚,也不在文档里假装它已经能用:

  • 公开的 API 参考——即将提供。
  • 自建端点发现服务的部署文档——即将提供。它在产品里是一个可选的单二进制组件,与官方端点发现服务同协议,但不承载任何业务流量。
  • 等保三级、密评、私有化部署——目前都没有。若你的场景强制要求这些,请先联系我们沟通,不要直接用在合规要求上。
← 返回首页 安装 Agent →