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
2026-10-08 23:51:17 +08:00
parent a53a3eee21
commit 9bdd36cf56
190 changed files with 1480 additions and 111 deletions
+2 -2
View File
@@ -2,11 +2,11 @@
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.lanremote.watch"
android:versionCode="5"
android:versionName="2.1.3">
android:versionName="2.1.4">
<!-- ⚠ 允许明文 HTTP。
中转可以是"自己搭的、没有证书"的服务:局域网那台,或者
2026-10-08 之后那台有公网 IP 的服务器(http://13.54.30.196:13245)。
2026-10-08 之后那台有公网 IP 的服务器(http://yk.xxmxxs.top:13245)。
Android 9+ 默认**禁止明文流量**,不加这一条的话请求会被系统
直接掐掉,日志里只有一句含糊的
"Cleartext HTTP traffic to ... not permitted"。
+2 -2
View File
@@ -27,7 +27,7 @@ $d8 = Join-Path $bt "d8.bat"
$work = Join-Path $android "build"
$outDir = Join-Path $root "dist"
$apkName = "ykxmz-watch-2.1.3.apk"
$apkName = "ykxmz-watch-2.1.4.apk"
function Step($text) { Write-Host "`n=== $text ===" -ForegroundColor Cyan }
@@ -65,7 +65,7 @@ $unsigned = Join-Path $work "app-unsigned.apk"
--min-sdk-version 24 `
--target-sdk-version 34 `
--version-code 5 `
--version-name "2.1.3" `
--version-name "2.1.4" `
--auto-add-overlay
if ($LASTEXITCODE -ne 0) { throw "aapt2 link 失败" }
@@ -128,14 +128,65 @@ public class MainActivity extends Activity implements RemoteClient.Listener {
}
}
/**
* 给中转地址补上协议头。没写 http/https 时猜一个。
*
* <p>规则和 Windows 端一致(windows/lanremote/relay.py 的
* _guess_scheme)、也和 {@link RelayTransport} 里那段一致:
* <pre>
* IP / localhost / *.local -> http://
* 域名 -> https://
* </pre>
*
* <p>⚠ 这个函数修的是一个**真实报障**:
* 用户填了 {@code yk.xxmxxs.top}(没写协议头),
* 点「检查服务器」报
* {@code MalformedURLException: no protocol: yk.xxmxxs.top/v1/health}。
*
* <p>原因是{@code checkServer()} 直接拿 {@code relayUrl()} 的原始字符串
* 拼 URL,**没经过 RelayTransport 的规范化** —— 那边补了协议头,
* 这边没有,于是同一个地址在"连接"时能用、在"检查服务器"时崩。
*
* <p>修法:把规范化收到 {@link #relayUrl()} 这一个入口里
* (所有调用方都从那里取),而不是在每个调用点各补一遍 ——
* 否则以后再加一个入口又会漏。
*/
static String normalizeRelay(String raw) {
String url = raw == null ? "" : raw.trim();
while (url.endsWith("/")) {
url = url.substring(0, url.length() - 1);
}
if (url.isEmpty()
|| url.startsWith("http://") || url.startsWith("https://")) {
return url;
}
String hostOnly = url;
int slash = hostOnly.indexOf('/');
if (slash > 0) {
hostOnly = hostOnly.substring(0, slash);
}
int colon = hostOnly.indexOf(':');
if (colon > 0) {
hostOnly = hostOnly.substring(0, colon);
}
boolean plain = hostOnly.equalsIgnoreCase("localhost")
|| hostOnly.toLowerCase().endsWith(".local")
|| hostOnly.matches("\\d{1,3}(\\.\\d{1,3}){3}");
return (plain ? "http://" : "https://") + url;
}
private String relayUrl() {
String saved = getSharedPreferences("lanremote", MODE_PRIVATE)
.getString("relay_url", DEFAULT_RELAY_URL);
// 用户没填过就返回内置默认值(现在是空字符串 = 只走局域网)。
// 注意:这里返回空是**正常状态**,不是错误 ——
// 调用方都用 isEmpty() 判断要不要走中转,空了就老老实实走局域网。
return (saved == null || saved.trim().isEmpty())
? DEFAULT_RELAY_URL : saved.trim();
if (saved == null || saved.trim().isEmpty()) {
return DEFAULT_RELAY_URL;
}
// ⚠ 统一在这里补协议头,不在各个调用点各补一遍。
// checkServer() 就是漏补的那个(见 normalizeRelay 的注释)。
return normalizeRelay(saved);
}
private void setRelayUrl(String url) {
@@ -113,7 +113,7 @@ public class RelayTransport implements Transport {
// 而且报的是 SSL 错误,会把人带去查证书查半天。
//
// ⚠ 纯 IP 判断包含**公网 IP** —— 2026-10-08 换到 Lightsail
// 之后中转就是 http://13.54.30.196:13245,
// 之后中转就是 http://yk.xxmxxs.top:13245,
// 只把 192.168/10./172.16 当私有的话这里会走错。
String hostOnly = url;
int slash = hostOnly.indexOf('/');