Tailscale 专用组网与端点精准解析
现在
冻结 · 快照核对 10 月 11 日
截至 10 月 11 日

MeshClip Kit · 功能说明(项目已冻结)

通常不需要手工路由器端口映射,通过现有 Tailscale 网络连接批准对端,避免另建中继服务。

当前情况:这是双机剪贴板冻结前的一项功能。项目已列入冻结名单(停用留档),GitHub 仓库 10 月 21 日归档、本机副本已删,AI 不再用这套脚本配对端、查连通。冻结前的情况:10 月 11 日 13:33 主机这一端的网络检查通过,那次 ping 到了批准的对端电脑;这只证明能联系到那台电脑,不证明两台已配对,也不证明剪贴板或文件已经传到。Tailscale 本身是独立安装的软件,项目冻结不说明它已卸载或停用;它现在的状态这次没查。

项目快照核对于 2026-10-11(北京时间),运行情况依据当天 13:33 的主机自检;10 月 21 日归档后没有再查。具体测试保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库(已归档,只读)

Tailscale 专用组网与端点精准解析
现在
冻结 · 快照核对 10 月 11 日
截至 10 月 11 日

MeshClip Kit · 功能说明(项目已冻结)

通常不需要手工路由器端口映射,通过现有 Tailscale 网络连接批准对端,避免另建中继服务。

当前情况:这是双机剪贴板冻结前的一项功能。项目已列入冻结名单(停用留档),GitHub 仓库 10 月 21 日归档、本机副本已删,AI 不再用这套脚本配对端、查连通。冻结前的情况:10 月 11 日 13:33 主机这一端的网络检查通过,那次 ping 到了批准的对端电脑;这只证明能联系到那台电脑,不证明两台已配对,也不证明剪贴板或文件已经传到。Tailscale 本身是独立安装的软件,项目冻结不说明它已卸载或停用;它现在的状态这次没查。

项目快照核对于 2026-10-11(北京时间),运行情况依据当天 13:33 的主机自检;10 月 21 日归档后没有再查。具体测试保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库(已归档,只读)

这项功能怎样使用

用途与实际影响(冻结前)

为什么需要它

跨子网时 KDE 广播发现可能找不到另一台电脑。明确对端地址能让 KDE 主动探测;组网故障和应用配对仍要分开判断。

举个实际例子

冻结前可以说:“帮我确认这两台已登记的电脑能不能联系到,先不要传文件。”AI核对选中的两台设备和它们的连接地址,再检查指定连接;交回哪一端可达、哪一段失败和依据。能联系到电脑还不代表剪贴板或文件传输已成功。项目冻结后,AI 不再从这个项目的脚本做这件事。

最后我会得到什么

得到准确对端地址及连通性诊断,供后续配置使用;ping成功不是剪贴板和文件验收。

这项功能怎样使用

用途与实际影响(冻结前)

为什么需要它

跨子网时 KDE 广播发现可能找不到另一台电脑。明确对端地址能让 KDE 主动探测;组网故障和应用配对仍要分开判断。

举个实际例子

冻结前可以说:“帮我确认这两台已登记的电脑能不能联系到,先不要传文件。”AI核对选中的两台设备和它们的连接地址,再检查指定连接;交回哪一端可达、哪一段失败和依据。能联系到电脑还不代表剪贴板或文件传输已成功。项目冻结后,AI 不再从这个项目的脚本做这件事。

最后我会得到什么

得到准确对端地址及连通性诊断,供后续配置使用;ping成功不是剪贴板和文件验收。

结果怎么看
正常时

两台指定电脑都已加入同一 Tailscale 网络并在线,诊断确认能找到对方;文件传输和 KDE 配对仍另验。

发现问题时

有多台可能的电脑却没指定目标,或对端离线时停止自动选择,请本人确认要连哪台。

入口不可用或证据不足时

Tailscale 未运行或本人尚未通过官方网页登录时,先完成这一步,不尝试绕过身份。项目冻结、本机副本删掉后,这套诊断在这台电脑上已经没有可直接运行的入口。

结果怎么看
正常时

两台指定电脑都已加入同一 Tailscale 网络并在线,诊断确认能找到对方;文件传输和 KDE 配对仍另验。

发现问题时

有多台可能的电脑却没指定目标,或对端离线时停止自动选择,请本人确认要连哪台。

入口不可用或证据不足时

Tailscale 未运行或本人尚未通过官方网页登录时,先完成这一步,不尝试绕过身份。项目冻结、本机副本删掉后,这套诊断在这台电脑上已经没有可直接运行的入口。

从哪里开始

两台电脑开始的方式不一样。常开的主机运行 scripts/install-windows.ps1 做完整部署;按需打开的副机先用 scripts/recover.ps1 -AsJson 查有没有上次没收完尾的改动,再用 scripts/deploy-on-demand.ps1 按核准的提交号(Git 里标记某个版本的 40 位编号)部署,先加 -WhatIf(只预览、不真改)看一遍。两端都经官方浏览器登录 Tailscale,再各自运行 scripts/configure-peer.ps1 -Peer 指定准确对端,用 scripts/doctor.ps1 查可达性。(这是冻结前的入口;现在本机仓库副本已删,这些脚本只在 GitHub 归档仓库里留着,AI 不再从这里开始。)

需要准备什么
  • 要互连的两台 Windows 电脑:一台常开的主机,一台按需打开的副机
  • 本人通过官方浏览器完成 Tailnet 登录
从开始到拿到结果
1两端上线
主机核对 Tailscale 服务、本机在线和无人值守设置。副机按需部署时保留已有配对和精确放行,不装看门狗、不自动启动 KDE;发现旧看门狗或被外部改过的设置就先停下。脚本都不会替人登录。
2选准对端
两端各自输入准确设备名并检查它在线,避免把相似设备当目标;副机要和主机同步时,再手动打开 KDE。
3单独测网络
doctor 只做 1 次、最多等 5 秒的 ping,结果只有“通了”或“没通/超时”两种,不告诉你这次走的是直连还是中继;网络通过仍要另做 KDE 配对。
从哪里开始

两台电脑开始的方式不一样。常开的主机运行 scripts/install-windows.ps1 做完整部署;按需打开的副机先用 scripts/recover.ps1 -AsJson 查有没有上次没收完尾的改动,再用 scripts/deploy-on-demand.ps1 按核准的提交号(Git 里标记某个版本的 40 位编号)部署,先加 -WhatIf(只预览、不真改)看一遍。两端都经官方浏览器登录 Tailscale,再各自运行 scripts/configure-peer.ps1 -Peer 指定准确对端,用 scripts/doctor.ps1 查可达性。(这是冻结前的入口;现在本机仓库副本已删,这些脚本只在 GitHub 归档仓库里留着,AI 不再从这里开始。)

需要准备什么
  • 要互连的两台 Windows 电脑:一台常开的主机,一台按需打开的副机
  • 本人通过官方浏览器完成 Tailnet 登录
从开始到拿到结果
1两端上线
主机核对 Tailscale 服务、本机在线和无人值守设置。副机按需部署时保留已有配对和精确放行,不装看门狗、不自动启动 KDE;发现旧看门狗或被外部改过的设置就先停下。脚本都不会替人登录。
2选准对端
两端各自输入准确设备名并检查它在线,避免把相似设备当目标;副机要和主机同步时,再手动打开 KDE。
3单独测网络
doctor 只做 1 次、最多等 5 秒的 ping,结果只有“通了”或“没通/超时”两种,不告诉你这次走的是直连还是中继;网络通过仍要另做 KDE 配对。
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

10 月 11 日 13:33 主机网络层检查通过;同一次 KDE 应用状态读不出,另算

关键规则与设计选择
1
同一Tailnet中的批准设备才进入配置流程;直连失败可用Tailscale中继,不承诺零公共中继。
2
自动选择只有一个在线Windows对端时成立;显式名称必须精确匹配。
3
使用官方浏览器登录,不传递脚本内登录密钥;诊断里的对端地址只露出第一段,其余打码。
1
检查服务自动运行、BackendState=Running、本机在线。
当前怎样实现
  • Get-MeshClipTailscaleStatus 安全解析 tailscale status --json 输出。
  • Resolve-MeshClipApprovedWindowsPeer 校验对端状态、系统类型与唯一性。
  • ConvertTo-MeshClipRedactedAddress 给地址打码:IPv4 只留第一段、后面写成 x.x.x,IPv6 只留第一段,无效地址整段隐藏;这是固定截断,不是哈希(把内容换算成一串摘要码)。
执行流程
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

10 月 11 日 13:33 主机网络层检查通过;同一次 KDE 应用状态读不出,另算

关键规则与设计选择
1
同一Tailnet中的批准设备才进入配置流程;直连失败可用Tailscale中继,不承诺零公共中继。
2
自动选择只有一个在线Windows对端时成立;显式名称必须精确匹配。
3
使用官方浏览器登录,不传递脚本内登录密钥;诊断里的对端地址只露出第一段,其余打码。
1
检查服务自动运行、BackendState=Running、本机在线。
当前怎样实现
  • Get-MeshClipTailscaleStatus 安全解析 tailscale status --json 输出。
  • Resolve-MeshClipApprovedWindowsPeer 校验对端状态、系统类型与唯一性。
  • ConvertTo-MeshClipRedactedAddress 给地址打码:IPv4 只留第一段、后面写成 x.x.x,IPv6 只留第一段,无效地址整段隐藏;这是固定截断,不是哈希(把内容换算成一串摘要码)。
执行流程
技术实现与依据(二)
2
检查ForceDaemon与shields-up;不自行改动不符合条件的现状。
3
解析明确对端,确认在线且为Windows。
4
doctor执行一次有界tailscale ping(1 次、5 秒超时),只报通或不通,不回传直连还是中继;结果独立于KDE配对。
技术实现与依据(二)
2
检查ForceDaemon与shields-up;不自行改动不符合条件的现状。
3
解析明确对端,确认在线且为Windows。
4
doctor执行一次有界tailscale ping(1 次、5 秒超时),只报通或不通,不回传直连还是中继;结果独立于KDE配对。
名词和入口
本模块用到的名词
名词意思
Tailnet(Tailscale 虚拟网络)Tailscale 账户下的所有授权设备组成的专属点对点加密网状网络。
Run Unattended(无人值守)Tailscale 无人值守服务模式,无需用户手动打开客户端界面即可在后台自启保持在线。
专业定义

跨网络加密隧道与单对端安全发现

名词和入口
本模块用到的名词
名词意思
Tailnet(Tailscale 虚拟网络)
意思:
Tailscale 账户下的所有授权设备组成的专属点对点加密网状网络。
Run Unattended(无人值守)
意思:
Tailscale 无人值守服务模式,无需用户手动打开客户端界面即可在后台自启保持在线。
专业定义

跨网络加密隧道与单对端安全发现

出问题时

解决什么

若 Tailscale 未登录、处于 Shields Up 模式,或存在多个同名/离线设备导致无法安全辨别目标,脚本拒绝盲目猜测并终止执行。

边界
  • 仅负责底层 Tailnet 隧道的打通与对端 IP 的精准析取,不负责上层 KDE Connect 的配对确认。
  • 严格仅支持经过官方浏览器认证的个人 Tailnet,绝不在脚本中传递明文 auth-key。
失败与恢复
  • 对端设备关机或离线: Resolve-MeshClipApprovedWindowsPeer 抛出错误拒绝继续,提示开启对端电脑。
  • Tailscale 开启了 shields-up: doctor 诊断标记 FAIL 并提示关闭入站拦截以允许 KDE Connect 流量进入。
出问题时

解决什么

若 Tailscale 未登录、处于 Shields Up 模式,或存在多个同名/离线设备导致无法安全辨别目标,脚本拒绝盲目猜测并终止执行。

边界
  • 仅负责底层 Tailnet 隧道的打通与对端 IP 的精准析取,不负责上层 KDE Connect 的配对确认。
  • 严格仅支持经过官方浏览器认证的个人 Tailnet,绝不在脚本中传递明文 auth-key。
失败与恢复
  • 对端设备关机或离线: Resolve-MeshClipApprovedWindowsPeer 抛出错误拒绝继续,提示开启对端电脑。
  • Tailscale 开启了 shields-up: doctor 诊断标记 FAIL 并提示关闭入站拦截以允许 KDE Connect 流量进入。
依据与来源
真实入口
  • scripts\MeshClip.Common.psm1Tailscale 状态与对端解析核心逻辑
  • scripts\configure-peer.ps1对端配置入口脚本
  • tests\MeshClip.Common.Tests.ps1地址脱敏与对端解析单元测试
如何验证
  • 当前测试源码覆盖精确名称匹配、离线/非 Windows 拒绝、多对端歧义与地址打码;这次没有重新运行测试,9 月 8 日那次 66 项历史回归保留原日期。
  • 10 月 11 日 13:33 主机自检:Tailscale 1.104.1 服务自动运行、本机在线、无人值守开启、入站拦截(shields-up)关闭、唯一批准对端和 ping 当次通过;同一次读不出 KDE 应用状态(记为未知),不能据此说两台已配对或能传。
与其他模块的关系

为KDE对端配置提供明确的网络地址和可达证据,不替代应用层确认。

依据与来源
真实入口
  • scripts\MeshClip.Common.psm1Tailscale 状态与对端解析核心逻辑
  • scripts\configure-peer.ps1对端配置入口脚本
  • tests\MeshClip.Common.Tests.ps1地址脱敏与对端解析单元测试
如何验证
  • 当前测试源码覆盖精确名称匹配、离线/非 Windows 拒绝、多对端歧义与地址打码;这次没有重新运行测试,9 月 8 日那次 66 项历史回归保留原日期。
  • 10 月 11 日 13:33 主机自检:Tailscale 1.104.1 服务自动运行、本机在线、无人值守开启、入站拦截(shields-up)关闭、唯一批准对端和 ping 当次通过;同一次读不出 KDE 应用状态(记为未知),不能据此说两台已配对或能传。
与其他模块的关系

为KDE对端配置提供明确的网络地址和可达证据,不替代应用层确认。

复制 AI 续作说明

项目:Tailscale 专用组网与端点精准解析;仓库:wlyaaaaa/meshclip-kit;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

把“目标”换成这次要做的事,整段复制给 AI。