mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 13:40:45 +00:00
xmz7891
4295b482a1
按用户定的版本规矩，这一轮既有新内容又有重构，所以升第二位： 1.9.0 -> 2.0.0（最后一位清 0）。 == 一、安装时就能设中转服务器（用户要求）== 安装向导那一页现在是两个输入框：配对码 + 中转服务器。 装的时候是"第一次设置"，最该一次把地址填好，不然装完还得去 双击 exe 找设置窗口，很容易漏。 只填域名就行（自动补 https://），留空 = 只走局域网。 批量静默部署同样支持： ykxmz-setup-2.0.0.exe /VERYSILENT /CODE=246810 /RELAY=relay.你的域名 为此新增了一个 --relay-url 参数： --relay 连接一次、打印状态、然后退出（人工排查用） --relay-url 只写进配置，不连接、不退出（安装流程用） 用错那个的话，安装包的命令链会在中间就 return，后面的 --silent 根本跑不到 —— 所以必须分开。 == 二、手表端新增「设置」页（用户要求）== 用户原话："安卓端加一个设置，各种设置就在这里面调"。 以前设置散在首页（只有一个"中转设置"按钮），现在统一收进设置页： * 中转服务器（填写 / 一键清空） * 记住的配对码（显示 / 清除） * 已配对的电脑（看数量 / 清空，带二次确认） * 关于（版本号从 APK 读，不会和代码对不上） == 三、中转地址默认留空 + 一次性迁移（用户报的问题）== 用户原话："安卓端为什么还是默认填的我的中转站，以后改成手动填"。 代码里的默认值早就是空的了，但用户看到的还是那个地址 —— 因为**老版本 1.5.0 把作者的域名硬编码成了默认值**，第一次运行就 存进了 SharedPreferences。装新 APK 不会清偏好，所以那个值一直留着。 用户其实从来没"选"过这个地址，是程序硬塞的。 所以加了 migrateLegacyRelay()：存的值如果正好等于当时内置的域名， 就当成没设过、清掉。只清完全相等的，用户手填的不会动。 == 四、两个测试自身的毛病 == * test_lan_optimize 那条"没有把旧公网域名当默认值"太粗 —— 它查的是源码里任何位置，于是迁移注释里引用那行老代码就把它判红了。 改成先剥掉注释再查（断言要测的是"有没有把它当默认值"）。 * test_image_modes 偶发红：它开真实 Tk 全屏窗口，在全量套件里跑 偶尔起不来（单独跑 19/19 全过）。加了有界重试。 偶发红的测试会让"全量通过"失去意义。 == 五、新增防复发断言 == _tests/test_relay_default_blank.py（15 项，回归阶段 3a3b）： * 默认值必须是空串 * 除了迁移清单，源码里不许有写死的中转域名 * 迁移必须真的被调用（不是只定义） * 迁移必须是 remove，不能换成另一个硬编码值 * Windows 端的默认也得是空 理由：用户说过"这个中转站我就自己用，不对外" —— 值得用断言钉死。 == 六、顺手修的 == * release_all.py 崩在 Gitee 那一步：Gitee 的 GET /releases/tags/{tag} 在"标签存在、但还没发行版"时返回的是 **HTTP 200 + JSON null**（不是 404），于是 .get("id") 直接 AttributeError。发 1.9.0 时踩到，已改成容忍 None。 * installer/build_installer.py 里 license-combined.txt 是从 docs/ 三份文档重新生成的，所以光改生成物没用（下次构建又变回去）。 改成在 build_license() 里统一注入当前版本。 * ExE 文件属性里的版本（version_info.txt）从 1.7.1 起就一直没跟上。 全量回归 43 个阶段全部通过。
224 lines
7.5 KiB
Plaintext
224 lines
7.5 KiB
Plaintext
========================================================
|
||
ykxmz 安装后须知（后信息文件）
|
||
========================================================
|
||
|
||
软件名称：ykxmz
|
||
版本：2.0.0
|
||
作者：小麦子
|
||
|
||
装好之后看这一页：怎么确认它在跑、怎么改设置、
|
||
怎么彻底卸载、出问题怎么查。
|
||
|
||
|
||
--------------------------------------------------------
|
||
一、确认它真的在运行
|
||
--------------------------------------------------------
|
||
|
||
被控端装好后**看不到任何窗口**，这是正常的。想确认它在跑：
|
||
|
||
方法一（最直观）
|
||
Ctrl+Shift+Esc 打开任务管理器
|
||
-> "详细信息"标签 -> 找 ykxmz.exe
|
||
有，就是在跑
|
||
|
||
方法二（看端口）
|
||
命令行执行： netstat -ano | findstr 8765
|
||
有 LISTENING，就是正常
|
||
|
||
方法三（问程序自己）
|
||
命令行执行： ykxmz.exe --status
|
||
会打印：配对码、端口、中转连接状态、已配对设备数
|
||
|
||
方法四（从手表看）
|
||
手表上点"自动连接"，能连上就说明在跑
|
||
|
||
|
||
--------------------------------------------------------
|
||
二、常用操作
|
||
--------------------------------------------------------
|
||
|
||
重新打开设置窗口
|
||
ykxmz.exe --setup
|
||
|
||
换一个配对码
|
||
在设置窗口里改，或者：
|
||
ykxmz.exe --new-code （随机生成一个）
|
||
换完之后，手表那边要用新码重连
|
||
|
||
看看当前状态
|
||
ykxmz.exe --status
|
||
|
||
临时允许新设备配对（默认关着）
|
||
ykxmz.exe --add-device 10 （开放 10 分钟）
|
||
过了时间自动关回去
|
||
|
||
关掉/打开开机自启
|
||
ykxmz.exe --autostart off
|
||
ykxmz.exe --autostart on
|
||
|
||
网络自检（连不上时先跑这个）
|
||
双击 wlzj.bat
|
||
或 ykxmz.exe --netcheck 90
|
||
|
||
修复防火墙（要管理员）
|
||
右键 xffhq.bat -> 以管理员身份运行
|
||
或 ykxmz.exe --fix-firewall
|
||
|
||
|
||
--------------------------------------------------------
|
||
三、彻底卸载
|
||
--------------------------------------------------------
|
||
|
||
一条命令清干净：
|
||
|
||
ykxmz.exe --uninstall
|
||
|
||
它会依次：
|
||
1. 停掉正在跑的进程
|
||
2. 删掉开机自启项
|
||
3. 删掉数据目录（配对码、已配对手表全没了）
|
||
4. 安排删除程序目录本身（退出后几秒自动删）
|
||
|
||
**想保留数据**（比如以后还要用，只是换个位置装）：
|
||
先手动把 data 目录复制出来，再卸载。
|
||
|
||
**手动卸载也可以**（如果程序已经删了）：
|
||
1. 任务管理器结束 ykxmz.exe
|
||
2. 删除注册表项
|
||
HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run
|
||
下的 ykxmz
|
||
3. 删除整个程序目录
|
||
4. （可选）删除防火墙规则：netsh advfirewall firewall
|
||
delete rule name="LAN Remote TCP"
|
||
|
||
|
||
--------------------------------------------------------
|
||
四、连不上怎么查
|
||
--------------------------------------------------------
|
||
|
||
按顺序排查，绝大多数问题在前三步就解决了：
|
||
|
||
第 1 步 被控端在跑吗？
|
||
任务管理器里有没有 ykxmz.exe
|
||
没有 -> ykxmz.exe --setup
|
||
|
||
第 2 步 防火墙放行了吗？
|
||
右键 xffhq.bat -> 以管理员身份运行
|
||
|
||
第 3 步 网络通不通？
|
||
双击 wlzj.bat 做自检
|
||
它会生成一份《网络自检结果.txt》
|
||
|
||
第 4 步 跨网络的话，中转通不通？
|
||
浏览器打开 http://<随身WiFi的IP>:8080/url
|
||
看它有没有返回公网地址
|
||
|
||
第 5 步 手表上点"连不上？点这里诊断"
|
||
|
||
常见现象对照：
|
||
|
||
"连接失败，配对码错误"
|
||
-> 手表上的码和电脑上的不一样，对一下
|
||
|
||
"该配对码已被使用，请换一个配对码"
|
||
-> 这个码被另一台电脑占了。换一个，
|
||
或者去中转管理页把占用它的那台设备删掉
|
||
|
||
"设备不在线"
|
||
-> 电脑上的程序没跑，或者网络断了
|
||
|
||
"连不上中转服务器"
|
||
-> 随身 WiFi 那台机器上的中转没起来，
|
||
或者隧道挂了。SSH 上去执行 lanremote-status 看看
|
||
|
||
|
||
--------------------------------------------------------
|
||
五、服务器端（随身 WiFi）日常维护
|
||
--------------------------------------------------------
|
||
|
||
三个服务都是开机自启，正常情况下不用管：
|
||
|
||
lanremote-relay 中转服务
|
||
lanremote-tunnel Cloudflare 隧道
|
||
lanremote-watchdog.timer 每 30 秒检查一次隧道连接
|
||
|
||
想一眼看清状态：
|
||
lanremote-status
|
||
|
||
常用命令：
|
||
lanremote-url 打印当前公网地址
|
||
lanremote-key 打印管理页钥匙
|
||
systemctl restart lanremote-tunnel 手动换个地址
|
||
journalctl -u lanremote-relay -f 看实时日志
|
||
|
||
管理页：
|
||
浏览器打开 <公网地址>，用管理密码登录（默认 120830）
|
||
能看：设备列表、在线状态、配对码、流量、会话数
|
||
能做：删除设备（连配对码一起清）、踢会话、查看当前地址
|
||
|
||
忘了公网地址？
|
||
打开 http://<随身WiFi的IP>:8080/url —— 直接返回当前地址，
|
||
不用登录。
|
||
|
||
|
||
--------------------------------------------------------
|
||
六、已知限制
|
||
--------------------------------------------------------
|
||
|
||
1. 一条隧道同时只服务一台手表
|
||
新连上来的会顶掉旧的，旧的那台会提示"已被另一台手表接管"。
|
||
|
||
2. 跨网络时的延迟
|
||
经 Cloudflare 隧道走一圈，一来一回约 0.6 秒；
|
||
局域网直连只有几十毫秒。**程序和手表会自动判断**：
|
||
发现两边在同一个网络就切直连，断了自动切回中转。
|
||
|
||
3. 网络环境的影响
|
||
如果随身 WiFi 用的 4G 卡对 UDP 有限制，隧道可能偶尔抖。
|
||
程序里有看门狗会自动重启隧道，通常 1 分钟内恢复。
|
||
|
||
4. 杀毒软件误报
|
||
见《安装前必读》第六节。作者不提供绕过杀软的功能。
|
||
|
||
|
||
--------------------------------------------------------
|
||
七、出问题时怎么反馈
|
||
--------------------------------------------------------
|
||
|
||
请带上这几样，作者才能定位：
|
||
|
||
1. ykxmz.exe --status 的输出
|
||
2. wlzj.bat 生成的《网络自检结果.txt》
|
||
3. 手表上的诊断结果（手表首页"连不上？点这里诊断"）
|
||
4. 问题什么时候开始的、之前做过什么
|
||
|
||
|
||
--------------------------------------------------------
|
||
八、版本记录
|
||
--------------------------------------------------------
|
||
|
||
2.0.0
|
||
* 下载改走 Cloudflare 边缘缓存 —— 安装包和 APK 快了几十倍
|
||
* 跨网络更稳：隧道**两种协议同时跑**（QUIC + HTTP/2，
|
||
合计 10 条连接），一种协议犯病另一种还在服务
|
||
* 修网卡 MTU 和 QUIC 不匹配（QUIC 走 UDP，之前不受 MSS 钳制保护），
|
||
隧道建连明显加快
|
||
* 修偶发"已断开"误报：连续失败 3 次才判离线
|
||
* **中转地址默认为空** —— 需要跨网络时自己填
|
||
|
||
1.7.1
|
||
* 跨网络支持：Cloudflare 具名隧道，固定域名
|
||
* 中转服务器：单设备单配对码
|
||
* 手表端：自动判断局域网/中转并无缝切换
|
||
* 被控端：所有开关和画面功能支持回退/撤销
|
||
* 配对码被占用时弹通知提示
|
||
* 新增 --uninstall 一键卸载
|
||
* 针对 512MB 内存的小机器做了优化
|
||
|
||
|
||
--------------------------------------------------------
|
||
作者：小麦子
|
||
软件：ykxmz 2.0.0
|
||
许可条款见《许可协议》（LICENSE.txt）
|
||
--------------------------------------------------------
|