Files
ykxmz/docs/AFTER-INSTALL.txt
T
xmz7891 8dc47d0f48 2.1.2:隧道稳定性加固(继续修「网站还是容易挂」)
2.1.1 修掉了 nettune 死锁之后,公网上到 200,但**过一阵又 530**。
这次抓到的是隧道自己:

cloudflared 的 precheck 输出(tunnel.log):

    | UDP Connectivity  region1.v2.argotunnel.com  FAIL  QUIC connection failed                      |
    | TCP Connectivity  region1.v2.argotunnel.com  FAIL  HTTP/2 connection is blocked or unreachable |
    | Cloudflare API    api.cloudflare.com:443     PASS  API is reachable                            |
    | ERROR: Allow outbound QUIC traffic on port 7844 or use HTTP2.                                  |

也就是 **443 通、7844 不通**,而且是**间歇性**的(过几分钟自己又好了,
然后再次断)。Cloudflare 隧道的边缘连接走 7844(QUIC 走 UDP 7844、
HTTP/2 走 TCP 7844)。这条线路对它是间歇性阻断 —— 属于运营商那一侧,
设备改不了,但可以让 cloudflared 自己去适应。

== 两个改动 ==

1. **协议从写死改成 auto**
       lanremote-tunnel      --protocol quic    -> --protocol auto
       lanremote-tunnel-h2   --protocol http2   -> --protocol auto
   原来两条实例各赌一个协议:那一刻 7844 的 UDP 和 TCP 都不通就一起死,
   没有退路(实测连接数掉到 1/0、公网 530)。改成 auto 之后
   cloudflared 自己在 QUIC / HTTP/2 之间挑当前能通的那条,
   10 条连接全都有自适应能力。

2. **--retries 5 -> 1000000**
   原来失败 5 次就退出、靠 systemd Restart=always 拉起来,
   每次退出到重启之间网站都是断的。而这条线路的抖动是分钟级的 ——
   实测隧道每 3~10 分钟就被重启一次(19:37 / 19:40 / 19:43 / 19:50 / 19:52),
   公网跟着一起断。拉大之后抖动期间连接自己恢复,整条隧道不退出。

3. 顺手加日志轮转(tunnel.log 已经 2.98 MB,这台机器硬盘不大)。

== 实测 ==

    改前:连接数 1/0,公网 530
    改后:连接数 7+2(接近满配 10),公网连测 5 次全部 200

== 同步 ==

relay/deploy.sh 里的 MAIN_PROTO / ALT_PROTO 也改成 auto、
TUNNEL_BASE 的 --retries 也拉到 1000000,新机器装出来就是加固过的。

全量回归 46 个阶段全部通过。
2026-10-08 20:04:35 +08:00

224 lines
7.5 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
========================================================
ykxmz 安装后须知(后信息文件)
========================================================
软件名称:ykxmz
版本:2.1.2
作者:小麦子
装好之后看这一页:怎么确认它在跑、怎么改设置、
怎么彻底卸载、出问题怎么查。
--------------------------------------------------------
一、确认它真的在运行
--------------------------------------------------------
被控端装好后**看不到任何窗口**,这是正常的。想确认它在跑:
方法一(最直观)
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.1.2
* 下载改走 Cloudflare 边缘缓存 —— 安装包和 APK 快了几十倍
* 跨网络更稳:隧道**两种协议同时跑**(QUIC + HTTP/2,
合计 10 条连接),一种协议犯病另一种还在服务
* 修网卡 MTU 和 QUIC 不匹配(QUIC 走 UDP,之前不受 MSS 钳制保护),
隧道建连明显加快
* 修偶发"已断开"误报:连续失败 3 次才判离线
* **中转地址默认为空** —— 需要跨网络时自己填
1.7.1
* 跨网络支持:Cloudflare 具名隧道,固定域名
* 中转服务器:单设备单配对码
* 手表端:自动判断局域网/中转并无缝切换
* 被控端:所有开关和画面功能支持回退/撤销
* 配对码被占用时弹通知提示
* 新增 --uninstall 一键卸载
* 针对 512MB 内存的小机器做了优化
--------------------------------------------------------
作者:小麦子
软件:ykxmz 2.1.2
许可条款见《许可协议》(LICENSE.txt)
--------------------------------------------------------