两台机器,装上就能互控和调试
不需要公网 IP,也不需要 Tailscale
U-Link Core 是一套自己托管的远程执行层:每台机器主动向外连你自己的 relay,运维或 AI agent 就能跑命令、传文件、看屏幕并留下审计。带 macOS 菜单栏和 Windows 托盘常驻程序,一个状态点就知道在不在线。
公开版是 alpha:发布二进制未做代码签名,Windows SmartScreen / macOS Gatekeeper 可能提示;用 Release 里的 SHA256SUMS 校验后再打开,或直接 make link 自己编译。没有官方托管 relay,需要你自己部署。详见安全说明。
它解决什么
开发者在 Mac 上写代码,需要在家里或办公室那台 Windows 上编译、看日志、抓一屏;或者内部 IT 要在员工明确同意的机器上做一次可审计的维修。目标机器一般在 NAT 后面、没有公网 IP、也没开 SSH。
目标机只出站
agent 主动 wss 连你的 relay,不用开入站端口、不用改路由器、不依赖组网产品。把 relay 放在一台能访问的 Linux 上即可。
CLI / JSON / MCP
命令、文件、截图、审计都有命令与结构化输出;ulink mcp 让 Claude Code、Codex 等 AI agent 直接调用同一套操作。
桌面常驻
macOS 菜单栏 / Windows 托盘的状态点 + 本地控制台:设备列表、流式终端、设置、一键自检、添加设备命令,都在浏览器里。
配对才上线
每台机器一把 Ed25519 密钥,首次注册显示 6 位码,需运维审批;同一设备 ID 换公钥直接拒绝,可随时吊销。
每次操作留痕
远程命令写本地 JSONL 审计;日志里疑似凭据会打码。文件传输限制在允许的目录内。
自己掌控数据
relay 是 Go 单二进制、无状态、Docker 一条命令起。没有账号、没有云依赖、没有遥测;TLS 证书 pin 由你自己分发。
架构
桌面程序把「被控端 agent」和「控制端 controller」合在一个进程里,所以两台都装上就能互控。
10 分钟搭起来
完整方法写在仓库的 relay 部署 Skill 里(AI agent 也能直接读)。简版如下。
- 1. 起 relay:
git clone后进入deploy/relay,cp .env.example .env,填两个随机长 token,保持REQUIRE_DEVICE_KEYS=1。 - 2. 签证书:
openssl req -x509 ...,subjectAltName必须覆盖客户端实际用的域名或 IP;记下openssl x509 -fingerprint -sha256的指纹。 - 3. 启动:
docker compose up -d --build,curl -k https://127.0.0.1:8900/health返回 ok。 - 4. 两台机器装好:桌面端「设置」里填 relay、两个 token、TLS 指纹;或用「添加设备」生成命令在另一台执行。
- 5. 审批配对:新设备显示 6 位码,运维
ulink pair approve <码>;「一键自检」全绿即完成。
常见坑:证书 SAN 与拨号地址不符(尤其 IP 变了)、自签证书没填 TLS pin、把两个 token 填反、代理挡住 wss。控制台的自检会逐项给出原因和下一步。
实测过什么
以下均为 2026-11-06 在两台自有机器(Mac + Windows)上,用 公开版 Release 成品自建 relay 跑出的结果,不是内部私有版。
| 项目 | 结果 |
|---|---|
| Mac → Windows 命令执行 | hostname / whoami / echo 三条通过 |
| Windows → Mac 命令执行 | uname -s / uname -m / printf 三条通过 |
| 文件推拉往返 | SHA-256 一致,临时文件已清理 |
| 登记、审批、吊销、审计 | 设备密钥配对与本地审计记录齐全 |
| 首次配置引导 / 一键自检 / 添加设备 | 发布成品端到端 6/6 通过 |
| CI | Linux / macOS / Windows 三平台构建与 E2E 全绿 |
还没做:代码签名与公证、大规模生产验证、第三方用户从零安装的公开反馈。项目处于 alpha,欢迎提 Issue 和 PR。
边界:它不是什么
不是远程桌面
不提供完整 GUI 远控,那是 MeshCentral / RustDesk 的领域。这里主打命令、文件、截图和 AI 工作流。
不是完整企业 RMM
没有 RBAC / SSO / 多租户 / 补丁管理 / 批量部署。控制器目前是单一全局 token,relay 到客户端之间没有 payload 端到端加密。
不是给客户装的远控后门
只用于自己拥有的机器,或员工明确同意的设备;配对需要人审批,连接状态在桌面端可见可停。
安全模型、令牌权限边界、未签名构建的说明都在仓库 SECURITY.md。
常见问题
有官方 relay 可以直接连吗?
没有。这是自托管项目,每套安装都要自己部署 relay;好处是数据、证书、token 都在你手里。仓库里给了 Docker 部署方法。
和 Tailscale 是什么关系?
不用 Tailscale,也能和它共存。U-Link 是应用层中继:两端主动连同一个 relay,不建立虚拟网卡。自建 relay 是唯一额外要准备的东西。
为什么下载后被系统拦截?
发布二进制未签名(开源项目,没有采购代码签名证书)。请用 Release 的 SHA256SUMS 校验;macOS 可执行 xattr -dr com.apple.quarantine /Applications/U-Link.app,Windows 在确认哈希后选择仍要运行。最稳妥是从源码 make link 自己编译。
内网 IP 变了就连不上?
会。pin 模式会校验证书对拨号地址是否有效:用 IP 访问时证书必须有对应 IP SAN,IP 变化要重签证书并更新客户端的 pin。用固定域名 + 受信任 CA 证书可避开这一类问题。
IT 给员工电脑配对方便吗?
小团队(几台到十几台)够用:员工端运行后显示 6 位码,微信发回,IT 审批一次即可,之后重连不用再配。但 20–200 台的批量装机体验还不行:目前没有 MSI 安装包、没有域策略批量下发、没有按人分权与会话时长控制。这部分属于后续企业版,不在当前开源核里。
可以商用吗?
Apache-2.0,可以。但请自行评估是否适合你的合规要求:当前是 alpha,未签名、无第三方审计、控制端为单 token。