mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 11:20:43 +00:00
2.1.4：修 URL 协议头 bug + 清理对外材料里泄漏的服务器信息
用户报了三件事，一起处理。
== 一、发行版介绍里泄漏了服务器公网 IP ==
_build/CHANGELOG.md 的 2.1.3 那节写了服务器公网 IP，而发布脚本
把这个文件当"更新说明"传给 Gitee，于是发行版介绍里就带出去了。
为什么 IP 不该公开：直接打 IP 就绕过 Cloudflare 了 ——
没有 CDN、没有防护、没有速率限制。源站本来就不该被人知道是谁
（这也是为什么 nginx 那层只认域名、中转只绑 127.0.0.1）。
处理：
* 已发的 v2.1.3 发行版介绍用 API 改掉（扫了全部 11 个发行版，只它一个）
* 仓库里 16 个文件里的 IP 全部换成域名或占位符
* 运维脚本改成从环境变量读，公开仓库里不留具体地址
顺手发现**更严重的一处**：旧管理员密码硬编码在
docs/AFTER-INSTALL.txt（会打进服务端 zip）和
installer/license-combined.txt（**安装包的许可页，每个装的人都能看到**）里。
而用户当前密码就含这个串，等于公开了一半。一并清掉，
公开材料里改成"密码在你服务器上"的说明。
== 二、手表端填了地址却连不上 ==
用户截图：填域名（没写协议头）-> 点「检查服务器」报
MalformedURLException: no protocol: <域名>/v1/health
根因：补协议头的逻辑只写在连接那条路（RelayTransport 的构造函数）上，
checkServer() 直接拿原始字符串拼 URL —— 同一个地址，连接能用、检查却崩。
修法：把规范化收到 relayUrl() 这**唯一一个入口**，所有调用方都从那里取。
规则和电脑端一致：IP / localhost / *.local -> http，域名 -> https。
顺带补了 _tests/test_relay_url_normalize.py 盯住它（含 9 个用例实算）。
== 三、Gitee 的 README 被判"可能含有违规信息" ==
Gitee 挂的是软性公告（可自行修改或申诉），但确实挂在那。
逐项看了 README，改掉几处**不准确**且容易误判的表述：
* 原文写"看看学生机是不是在打游戏" —— 这是**错的**：
被控端只装在一台电脑上（讲台那台），根本看不到别的机器。
既不准确又像监控软件，改成"作用于被控端那一台"
* 课堂那几项功能如实说明：改的是本机 hosts、结束的是本机进程，
都可逆，下课点「一键恢复全部」就还原
* "免杀对抗""伪装成系统进程"这类词（虽然是在说"我们不做这些"）
本身就在审核词库里，换成正面的说法
* 成品文件名从 1.8.2 更新到当前版本，并且以后发版自动跟着改
（把 README 加进了 bump 脚本；以前一直停在 1.8.2，
用户照着 README 去 releases 根本找不到那个文件）
== 四、做这件事时自己踩的坑（都写进注释了）==
* 批量替换时**没排除 gitignore 的文件**，把本地密码文件也改了
* 替换时往字典字面量中间塞注释，**弄坏了 5 个文件的语法**
* 修的时候手写"坏文件列表"，漏了 2 个 ——
改成全仓库扫模式（列表是观察到的，不是穷尽的）
* 清理工具自己又成了泄漏点（脚本里写了要匹配的 IP/密码），
加了 _build/precommit_leak_gate.py 当闸门才抓到
教训：批量替换要先排除不该碰的文件，而且不能往表达式中间塞东西。
== 按用户要求：测完再提交 ==
全量回归 41 个阶段全 PASS（2 项因锁屏 SKIP）
601 个 Python 文件语法通过
pyflakes 干净
安装包完整周期 20/20
对外材料清洁度 15/15
提交前泄漏闸门通过
（这条信息是补写的：上一个提交因为 heredoc 把提交说明打到屏幕而不是
文件，信息变成空的 "remove temp" 了，内容本身是对的。）
This commit is contained in:
xmz7891
@@ -3,7 +3,7 @@
|
||||
========================================================
|
||||
|
||||
软件名称：ykxmz
|
||||
版本：2.1.3
|
||||
版本：2.1.4
|
||||
作者：小麦子
|
||||
|
||||
装好之后看这一页：怎么确认它在跑、怎么改设置、
|
||||
@@ -152,7 +152,7 @@
|
||||
journalctl -u lanremote-relay -f 看实时日志
|
||||
|
||||
管理页：
|
||||
浏览器打开 <公网地址>，用管理密码登录（默认 120830）
|
||||
浏览器打开 <公网地址>，用管理密码登录（密码在你服务器上的 data/admin_password.txt 里，或你自己设的）
|
||||
能看：设备列表、在线状态、配对码、流量、会话数
|
||||
能做：删除设备（连配对码一起清）、踢会话、查看当前地址
|
||||
|
||||
@@ -197,7 +197,7 @@
|
||||
八、版本记录
|
||||
--------------------------------------------------------
|
||||
|
||||
2.1.3
|
||||
2.1.4
|
||||
* 下载改走 Cloudflare 边缘缓存 —— 安装包和 APK 快了几十倍
|
||||
* 跨网络更稳：隧道**两种协议同时跑**（QUIC + HTTP/2，
|
||||
合计 10 条连接），一种协议犯病另一种还在服务
|
||||
@@ -218,6 +218,6 @@
|
||||
|
||||
--------------------------------------------------------
|
||||
作者：小麦子
|
||||
软件：ykxmz 2.1.3
|
||||
软件：ykxmz 2.1.4
|
||||
许可条款见《许可协议》（LICENSE.txt）
|
||||
--------------------------------------------------------
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
========================================================
|
||||
|
||||
软件名称：ykxmz
|
||||
版本：2.1.3
|
||||
版本：2.1.4
|
||||
作者：小麦子
|
||||
|
||||
请你**在安装之前**花三分钟读完这一页。里面有几条很要紧的
|
||||
@@ -164,6 +164,6 @@ ykxmz 是一套自己搭建的远程管理工具，由三部分组成：
|
||||
|
||||
--------------------------------------------------------
|
||||
作者：小麦子
|
||||
软件：ykxmz 2.1.3
|
||||
软件：ykxmz 2.1.4
|
||||
继续安装，即表示你已阅读并同意《许可协议》。
|
||||
--------------------------------------------------------
|
||||
|
||||
+3
-3
@@ -3,7 +3,7 @@
|
||||
========================================================
|
||||
|
||||
软件名称：ykxmz（远程管理工具）
|
||||
版本：2.1.3
|
||||
版本：2.1.4
|
||||
作者：小麦子
|
||||
生效日期：2026 年 10 月 5 日
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
> 都不许拿去做下面第三条那些事。**
|
||||
>
|
||||
> （早先这版文件写的是"软件许可协议"，里面有一条"不得修改"——
|
||||
> 那和 AGPL 冲突，所以 2.1.3 起拆开了：代码授权归 LICENSE，
|
||||
> 那和 AGPL 冲突，所以 2.1.4 起拆开了：代码授权归 LICENSE，
|
||||
> 使用约束归这份文件。）
|
||||
|
||||
|
||||
@@ -160,7 +160,7 @@
|
||||
|
||||
--------------------------------------------------------
|
||||
作者：小麦子
|
||||
软件：ykxmz 2.1.3
|
||||
软件：ykxmz 2.1.4
|
||||
|
||||
如果你不同意本条款的任何一条，请不要安装或使用本软件。
|
||||
代码授权条款见仓库根目录 LICENSE（GNU AGPL-3.0）。
|
||||
|
||||
Reference in New Issue
Block a user