mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 16:00:43 +00:00
用户报了三件事,一起处理。
== 一、发行版介绍里泄漏了服务器公网 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" 了,内容本身是对的。)
166 lines
6.6 KiB
Python
166 lines
6.6 KiB
Python
# -*- coding: utf-8 -*-
|
||
r'''修监测单元:它现在查错了地址,在**误报网站挂了**。
|
||
|
||
== 怎么发现的 ==
|
||
|
||
把中转改成只监听 127.0.0.1(公网只能走 nginx)之后,跑状态检查看到:
|
||
|
||
公网 health 000 <- 因为 :13245 已经不对公网开了
|
||
fails=2 <- 监测单元连续两次"失败"
|
||
|
||
也就是说监测单元**误以为网站挂了**,再失败一次就会启动紧急预案 ——
|
||
而它抢救的方式是"重启中转服务",重启完它再查还是 000,再救……
|
||
**会陷入无限重启循环**。
|
||
|
||
这是我自己改监听地址时没想到的连带影响。教训:改一个服务的
|
||
暴露方式时,必须把所有"探测它"的地方一起看一遍。
|
||
|
||
== 改法 ==
|
||
|
||
监测的地址应该以"**用户实际怎么访问**"为准,现在应该是:
|
||
|
||
http://yk.xxmxxs.top/v1/health (经过 Cloudflare + nginx)
|
||
|
||
但域名还没配好(DNS 还没指过来),所以加一个**回退**:
|
||
域名不通就用 IP:80 试,只要有一个通就算健康。
|
||
|
||
这样:
|
||
* 域名配好之前 -> 走 IP:80,正常监控
|
||
* 域名配好之后 -> 走域名,监控的是用户真实路径
|
||
* 两个都不通 -> 才是真挂了
|
||
|
||
== 顺带 ==
|
||
|
||
monitor.log 的属主问题:monitor.service 以 admin 跑,
|
||
而 relay.log 之类的之前是 root 建的。已经 chown 过一次,
|
||
但 monitor.log 是后来新生成的(仍是 root)—— 这次一并修掉,
|
||
并且在 unit 里加一行让 systemd 自己保证目录属主。
|
||
'''
|
||
from __future__ import annotations
|
||
|
||
import sys
|
||
from pathlib import Path
|
||
|
||
ROOT = Path(__file__).resolve().parent.parent
|
||
sys.path.insert(0, str(ROOT / "_build"))
|
||
from lssh import run # noqa: E402
|
||
|
||
RELAY_DIR = "/opt/ykxmz-relay"
|
||
DOMAIN = "yk.xxmxxs.top"
|
||
FALLBACK = "http://<源站IP>:80"
|
||
|
||
|
||
def main() -> int:
|
||
print("=" * 62)
|
||
print(" 修监测单元:改探测地址 + 修日志属主")
|
||
print("=" * 62)
|
||
|
||
print()
|
||
print(" ── 1. 改 monitor.sh 的健康检查(域名优先,IP 兜底)──")
|
||
# 把 PUBLIC_URL 的默认值换掉,并把 is_healthy 改成"两个都试"
|
||
old_url = 'PUBLIC_URL="${PUBLIC_URL:-http://<源站IP>:13245}"'
|
||
new_url = (
|
||
'# 探测地址:域名优先(用户实际走的路),IP:80 兜底\n'
|
||
'# (域名 DNS 还没指过来时用它,否则监测会一直误报)\n'
|
||
'PUBLIC_URL="${PUBLIC_URL:-http://%s}"\n'
|
||
'FALLBACK_URL="${FALLBACK_URL:-%s}"' % (DOMAIN, FALLBACK))
|
||
|
||
out = run(
|
||
"grep -n 'PUBLIC_URL=' %s/monitor.sh | head -3" % RELAY_DIR,
|
||
timeout=60, quiet=True)
|
||
print(" 改前:")
|
||
for ln in out[1].strip().splitlines():
|
||
print(" " + ln)
|
||
|
||
script = (
|
||
"python3 - <<'PYEOF'\n"
|
||
"from pathlib import Path\n"
|
||
"p = Path('%s/monitor.sh')\n"
|
||
"t = p.read_text(encoding='utf-8')\n"
|
||
"old = [l for l in t.splitlines() if l.startswith('PUBLIC_URL=')]\n"
|
||
"if not old:\n"
|
||
" print(' x 找不到 PUBLIC_URL 行')\n"
|
||
"else:\n"
|
||
" t = t.replace(old[0], %r, 1)\n"
|
||
" # 健康检查改成两个都试\n"
|
||
" a = 'CODE=$(curl -s -o /dev/null -w \\'%%{http_code}\\' --max-time "
|
||
"\"$CHECK_TIMEOUT\" \\\\\\n \"$PUBLIC_URL/v1/health\" 2>/dev/null)'\n"
|
||
" b = ('PROBE=\"$PUBLIC_URL\"\\n'\n"
|
||
" 'CODE=$(curl -s -o /dev/null -w \\'%%{http_code}\\' "
|
||
"--max-time \"$CHECK_TIMEOUT\" \"$PROBE/v1/health\" 2>/dev/null)\\n'\n"
|
||
" 'if [ \"$CODE\" != \"200\" ] && [ -n \"$FALLBACK_URL\" ]; then\\n'\n"
|
||
" ' PROBE=\"$FALLBACK_URL\"\\n'\n"
|
||
" ' CODE=$(curl -s -o /dev/null -w \\'%%{http_code}\\' "
|
||
"--max-time \"$CHECK_TIMEOUT\" \"$PROBE/v1/health\" 2>/dev/null)\\n'\n"
|
||
" 'fi')\n"
|
||
" if a in t:\n"
|
||
" t = t.replace(a, b, 1)\n"
|
||
" print(' ok 健康检查改成域名优先 + IP 兜底')\n"
|
||
" else:\n"
|
||
" print(' ! 健康检查那段没匹配上,手工看')\n"
|
||
" p.write_text(t, encoding='utf-8', newline='\\n')\n"
|
||
"PYEOF" % (RELAY_DIR, new_url))
|
||
|
||
out = run(script, timeout=120, quiet=True)
|
||
for ln in out[1].strip().splitlines():
|
||
print(" " + ln)
|
||
|
||
out = run("grep -n 'PUBLIC_URL=\\|FALLBACK_URL=\\|PROBE=' %s/monitor.sh "
|
||
"| head -8" % RELAY_DIR, timeout=60, quiet=True)
|
||
print(" 改后:")
|
||
for ln in out[1].strip().splitlines():
|
||
print(" " + ln)
|
||
|
||
print()
|
||
print(" ── 2. 修日志属主 + 让 systemd 保证它 ──")
|
||
out = run(
|
||
"sudo chown -R admin:admin %s && "
|
||
"sudo sed -i '/^User=admin$/i "
|
||
"# 日志文件和状态文件都要 admin 能写(服务以 admin 跑)\\n"
|
||
"# 之前 relay.log / monitor.log 是 root 建的,导致 "
|
||
"monitor.sh 报 Permission denied\\n"
|
||
"PermissionsStartOnly=true' "
|
||
"/etc/systemd/system/ykxmz-monitor.service 2>/dev/null; "
|
||
"sudo touch %s/monitor.log %s/monitor_state.txt && "
|
||
"sudo chown admin:admin %s/*.log %s/*.txt %s/*.md 2>/dev/null; "
|
||
"ls -la %s/*.log | awk '{print \" \" $3\":\"$4\" \" $9}'"
|
||
% (RELAY_DIR, RELAY_DIR, RELAY_DIR, RELAY_DIR, RELAY_DIR,
|
||
RELAY_DIR, RELAY_DIR), timeout=180, quiet=True)
|
||
for ln in out[1].strip().splitlines():
|
||
print(ln)
|
||
|
||
print()
|
||
print(" ── 3. 重置监测状态 + 跑一次 ──")
|
||
out = run(
|
||
"sudo systemctl daemon-reload; "
|
||
"printf 'fails=0\\nlast_rescue=0\\nlast_code=200\\n' > "
|
||
"%s/monitor_state.txt; "
|
||
"bash %s/monitor.sh; echo '--- 状态 ---'; "
|
||
"cat %s/monitor_state.txt; echo '--- 日志尾 ---'; "
|
||
"tail -3 %s/monitor.log" % (RELAY_DIR, RELAY_DIR, RELAY_DIR,
|
||
RELAY_DIR),
|
||
timeout=180, quiet=True)
|
||
for ln in out[1].strip().splitlines():
|
||
print(" " + ln)
|
||
|
||
print()
|
||
print(" ── 4. 验证探测链路 ──")
|
||
out = run(
|
||
'printf " %-28s %s\\n" "域名(还没配)" '
|
||
'"$(curl -s -o /dev/null -w \'%{http_code}\' --max-time 8 '
|
||
'http://%s/v1/health)"; '
|
||
'printf " %-28s %s\\n" "IP:80 (兜底)" '
|
||
'"$(curl -s -o /dev/null -w \'%{http_code}\' --max-time 8 '
|
||
'http://<源站IP>:80/v1/health)"; '
|
||
'printf " %-28s %s\\n" "IP:13245 (已关闭)" '
|
||
'"$(curl -s -o /dev/null -w \'%{http_code}\' --max-time 8 '
|
||
'http://<源站IP>:13245/v1/health)"' % DOMAIN,
|
||
timeout=120, quiet=True)
|
||
for ln in out[1].strip().splitlines():
|
||
print(ln)
|
||
return 0
|
||
|
||
|
||
if __name__ == "__main__":
|
||
sys.exit(main())
|