Linko Connect 操作手册

Linko Connect 支持 VNC、RDP、SSH 远程连接和虚拟网络。不同平台的按钮位置可能略有差别；以下步骤以当前客户端功能为准。

远程连接

1. 在目标设备上启用对应的 VNC、RDP 或 SSH 服务，确认账户有远程访问权限。
2. 打开“远程连接”，从右上角“⋯”菜单新增连接；选择协议，填写连接名称、地址、端口和远端账户。VNC、RDP、SSH 的常用端口分别为 5900、3389、22。
3. 可以先在“连接测试”检查目标设备的 Ping 与协议端口，测试成功后从对应结果添加连接。保存后从列表打开连接。
4. 目标可直接访问时选“直连”；需要通过已配置的服务访问时使用网关或虚拟网络。远端系统账户与 Linko 用户中心账户可能不同。

虚拟网络

1. 在“我的”登录用户中心，再到“虚拟网络”创建或加入网络。
2. 选择网络并连接。首次连接时按系统提示授权 VPN 配置；本机连接状态和虚拟地址会显示在网络页面。
3. 在网络详情查看成员与设备；设备“⋯”菜单中的“连接测试”可从本机测试 Ping、端口、DNS 与出口通路。
4. 需要指定出口时在设备的“出口设置”配置规则，并用相同网址执行出口测试，核对公网地址及数据包路径。
5. 要主动停用网络，点击“断开”。设备进入后台或网络切换后，系统可按当前 VPN 配置自动恢复连接。

各平台客户端安装

从下载页选择对应系统和 CPU 架构，核对版本及 SHA256。正式包、测试包和历史版本分别标注；安装完成后再核对客户端“我的”底部的版本号（点按可打开“关于”），下载成功不代表设备已更新。

• Windows：使用安装程序部署，按安装器提示准备 WebView2 等依赖；安装完成后打开 Linko Connect 并登录用户中心。
• macOS：按 Apple 芯片 ARM64 或 Intel x64 选择包，将应用安装到应用目录，按系统提示授权。网络服务的安装、启停需管理员权限，现有 MAUI Mac 包仍需匹配架构的 .NET 10 与 ASP.NET Core 10 运行时；详见Mac 安装与验证说明。
• Android：下载正式签名 APK 后安装，按系统提示允许本次安装来源；标为 Debug 的包仅用于测试。安装并登录后核对应用版本。
• iPhone / iPad：通过已有 TestFlight 测试组安装或更新，确认最新构建可见；上传到 Apple、Apple 处理中与实际可安装是不同阶段。模拟器包不能安装到真机。
• Web：打开 Web 版即可使用，登录与网关权限由用户中心管理；无需下载客户端。

Linux 无桌面服务器安装入网

这是虚拟网络客户端，用于取得虚拟地址并与网络内设备通信。它与 DERP/STUN 中继服务用途不同。主机不需要桌面或 Atlas 客户端；安装包包含运行时。

1. 准备 Ubuntu 24.04+、x64 或 ARM64 CPU、sudo、systemd 和可用的 /dev/net/tun，先安装 curl、python3 和 ca-certificates。VPS 或容器的 TUN 权限需要宿主机提供。
2. 登录用户中心，在虚拟网络创建网络或接受邀请，选中目标网络。
3. 打开“设备注册”，选择 Linux，生成服务器入网命令，复制完整命令，在目标服务器终端执行。
4. 命令自动选择架构、校验正式包，在主机本地生成密钥、安装系统服务并加入指定网络。命令有效期 15 分钟，只限一台设备，可在生成窗口撤销；不要转发或公开。
5. 等待终端显示虚拟 IP 和 direct/relay 状态，核对设备列表，再用虚拟 IP 测试 SSH 等实际服务。安装网络客户端不会自动启用 SSH 或开放防火墙。

安装中断可在原主机重试同一命令，已有身份会保留。注册响应丢失时，应核对设备列表和主机私有回执，按提示移除对应设备后重新生成；不要盲目删除身份或反复注册。发现其他已有安装时会停止，避免覆盖配置。

程序位于 /opt/myvnc-network，身份和连接标记位于 /var/lib/myvnc-network，服务开机自动运行并恢复连接。状态目录包含私钥，不能公开。桌面手动安装及包校验见Linux 高级安装说明，正式包见下载页。

部署共享 DERP/STUN 节点

DERP 转发端到端加密数据，STUN 帮助设备发现公网地址、尝试直连。服务器无需加入虚拟网络；一套服务可供多个网络共用，共用服务不会合并网络权限。DERP 不是屏幕共享 WebRTC 所需的 TURN 服务。

1. 准备公网 Ubuntu 24.04+ x64 或 ARM64 主机、sudo、systemd、curl、python3 和 CA 证书，无需 TUN。将域名的 A/AAAA 记录直接解析到该主机，关闭 CDN 代理；所有发布的地址都必须可达。
2. 在云安全组和主机防火墙开放空闲的 TCP 80、TCP 443 和所选 STUN UDP 端口（默认 3478）。TCP 80 用于证书验证，443 用于 DERP TLS；同号 TCP 不能代替 STUN UDP。服务会自动申请和续期证书，请先确认符合证书机构条款。
3. 管理员进入共享 DERP/STUN 节点，填写名称、公网域名和 STUN 端口，生成一次性命令，在主机执行。首次执行有效期 15 分钟，绑定一台主机；不要分享。
4. 命令校验 Atlas 制品，安装或复用该主机的 Atlas Updater。网页显示授权码后，打开用户中心正式终端授权页，由管理员核对应用和对应终端并确认。服务凭据仅保存在目标主机，不应复制进命令或日志。
5. 等待 Atlas 完成服务安装、运行版本和监控验证，以及 TLS 证书、STUN 本机检查。网页显示等待执行、等待授权、安装中、主机报告完成或失败；主机回报不等于外网验收。
6. 选择一个或多个自己拥有的网络，点击“添加到所选网络”。操作保留其他节点；原先使用系统列表的网络会复制当前系统节点，再添加新节点，此后使用自定义列表。未选网络保持原样，后续可继续引用。
7. 从外部客户端验证真实 STUN 回应、DERP 中继传输和跨网络权限隔离。DERP 准入只允许已引用网络的已注册设备；STUN 仍提供公开的地址发现服务。

脚本不覆盖已有 DERP，不停止或替换其他 Atlas 服务。现有生产 DERP 接入托管前，须单独核对服务定义、证书、密钥、备份及停机窗口，再走正式接管。撤销部署命令不会卸载已安装服务，也不代替 Atlas 停止服务。

升级与维护

Windows、Mac、Android 非商店版：打开“我的 → 版本升级”，点击“下载并升级”，在应用内查看下载进度；校验通过后进入安装；桌面版完成后重新打开应用。可以取消下载；安装失败时保留已校验包以便重试。Android 须按系统提示允许本应用安装更新并确认安装，完成后点系统窗口的“打开”返回新版；桌面版需要权限时会显示系统授权。升级会关闭远程会话，可能短暂断网，请先保存工作。安装完成后核对当前版本和构建号。仍会跳转浏览器的旧版，请先从下载页安装一次新版，以后即可使用应用内升级。商店版继续通过对应商店更新。

MAUI 屏幕共享入口位于“远程连接”的左上角导航菜单及右上角“…”菜单；未登录时会先进入用户中心登录。共享和观看均在屏幕共享页完成。

• phi 等已接入 Atlas 的客户端：从 Atlas 对应安装的升级入口操作，先核对实际安装和版本；保留设备身份、网络配置和虚拟地址，无需重新入网。
• 独立安装的 Linux 客户端：从下载页取得匹配架构的新正式包，按高级说明校验并运行安装器，保留状态目录、连接标记和自定义 systemd 设置。不能假定所有旧包都支持本地 update 命令，也不要用入网命令覆盖已有安装。
• 本手册部署的共享 DERP/STUN：从 Atlas 对应 myvnc-relay 安装升级，保留 DERP 密钥、证书、终端身份、持久配置和各网络引用。
• 原先独立部署的 derper：接管前沿用原维护流程；不能把客户端已托管等同于 DERP 已托管。

发布版本和节点实际升级是不同状态；是否自动升级取决于对应安装的 Atlas 监控配置。升级会短暂重启服务：客户端重启影响该设备，DERP 重启影响使用此中继的多个网络。完成后核对运行版本、服务状态和实际通信；失败通过 Atlas 正式恢复或回滚。不要通过删除设备、重新注册来升级。

安装部署故障排查

网络客户端：运行 sudo systemctl status myvnc-network --no-pager、sudo journalctl -u myvnc-network -n 100 --no-pager，以及 /opt/myvnc-network/MyVnc.Network.Service status。

共享中继：运行 sudo systemctl status myvnc-relay --no-pager、sudo journalctl -u myvnc-relay -n 100 --no-pager；同时核对 sudo systemctl status atlas-updater --no-pager。

• 过期或撤销：未领取时重新生成；已领取时保留原主机回执，按提示恢复，不在其他主机重放。
• 等待授权：在共享节点页核对授权码，到用户中心完成管理员终端授权。交换已尝试但响应丢失时，先核对私有回执和用户中心审计，不自动重复签发凭据。
• 证书或连接失败：核对全部 A/AAAA 记录、CDN、TCP 80/443、云安全组、主机防火墙和端口占用，不关闭证书验证来掩盖问题。
• STUN 无回应：核对所选 UDP 端口和返回流量，用匹配事务 ID 的真实 STUN 请求验证，不能用网页可打开代替。
• 中继拒绝设备：确认网络已引用节点，设备仍在网络中。移除网络内的节点配置也会撤销该网络经此节点的准入。
• 安装中断：保留 /etc/atlas/installations/myvnc-relay-… 的私有回执和凭据，以及 /var/lib/myvnc-relay 的密钥和证书。原命令恢复期为首次领取后 7 天，过期后核对 Atlas 安装，不盲目重装。

排查连接问题

• “超时”：核对地址、端口、设备在线状态和当前网络路径。
• “认证失败”：核对远端系统账户、密码或密钥及该账户的访问权限。
• Ping 不通但端口可连接：目标可能屏蔽 ICMP，以实际协议连接结果为准。
• 出口结果不符合预期：核对本机已连接的网络、规则匹配目标与所选出口，再使用同一网址复测。

分享截图或诊断日志前，请遮盖设备地址、密码、验证码、私钥和远程桌面中的私人内容。需要协助可通过应用内“意见反馈”或帮助与支持联系。