mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 11:20:43 +00:00
xmz7891
1d368979aa
== 用户要求 ==
"安卓那个逻辑也要改一下，就是你输入配对码后，进入一个页面，
页面有两个按钮，第一个按钮是远控，第二个按钮是静默更新被控端"
== 做成什么样 ==
新增 choicePanel，连接成功后先进这一页：
已连接「电脑名」
电脑端 2.1.5 → 可更新到 2.2.0
[ 远控 ] <- 第一个按钮
[ 静默更新被控端 ] <- 第二个按钮
按钮顺序按用户说的来（远控在前）。
页面顶上显示电脑名和**电脑端当前版本** —— 用户之前要求
"手表端连接那个电脑端也可以查看电脑端目前所处的版本"，
这里是最自然的展示位置（不弹框，只显示一行）。
为什么不让它直接进控制页：老版本的被控端可能缺功能或有 bug，
"先更新再远控"是更合理的顺序 —— 但不强制，给用户自己选。
== 一个刻意不改的地方 ==
自动切到中转服务器**恢复**时的 `showControlPanel()` **没动** ——
用户本来就在远控页，中途弹一层选择页会打断他。
测试里专门断言了这一点，免得以后有人"顺手统一一下"改坏。
== 顺手修的几个问题 ==
1. **忘了定义 lastDeviceName** —— 写选择页时凭直觉用了这个变量，
编译报"找不到符号"。补上字段并在连接回调里赋值。
（教训：写代码时要用的变量，先确认它存在。）
2. **泄漏闸门拦下我自己** —— 这两天写的一批服务器诊断/配置脚本里
硬编码了服务器 IP（26 处，5 个文件）。规则是 IP 不能进任何
被跟踪的文件。已全部改成占位符，真实值仍从
_build/.lightsail_host（已 gitignore）读。
3. **verify_all.ps1 删掉「锁屏时记 SKIP」的逻辑** ——
用户明确要求删。那个好意带来一个更糟的后果：锁屏时几关根本不跑，
回归"全绿"了但关键测试其实一跳而过。
**"因为环境不满足所以不测"比"测了发现失败"更危险。**
删掉之后果然暴露出 3 个 FAIL —— 屏幕解锁后重跑全部通过，
确认是环境问题而不是代码问题。
== 服务器这边（不在这份提交里，但同一天做的）==
* nginx 按用户要求重排：
IP(80) 任何路径 -> 404（没东西）
域名 / -> 官网；/zhongzhuanzhan -> 中转站设置
9100 -> 同样的内容（等 AWS 开防火墙）
* 删掉早年 Cloudflare Tunnel 的 systemd 残留
* **补上 ACME 挑战例外** —— 这是最要紧的一条：
80 端口原来把所有请求都 301 到 https，包括
/.well-known/acme-challenge/，**续期时会失败**。
而且它是延迟爆发的（最长 90 天后证书到期才暴露）。
* 清理 1Panel 安装包残留（223MB）
== 验证 ==
全量回归 21 关全部 PASS（零 FAIL，桌面可用状态）
Java 编译通过（android-34, --release 8）
623+ Python 文件语法通过
泄漏闸门通过
全部产物重建，Win7 兼容校验通过
170 lines
6.7 KiB
Plaintext
170 lines
6.7 KiB
Plaintext
========================================================
|
||
ykxmz 安装前必读（前信息文件）
|
||
========================================================
|
||
|
||
软件名称：ykxmz
|
||
版本：2.2.0
|
||
作者：小麦子
|
||
|
||
请你**在安装之前**花三分钟读完这一页。里面有几条很要紧的
|
||
提醒，尤其是第三节和第五节。
|
||
|
||
|
||
--------------------------------------------------------
|
||
一、这是什么
|
||
--------------------------------------------------------
|
||
|
||
ykxmz 是一套自己搭建的远程管理工具，由三部分组成：
|
||
|
||
1-agent（被控端） 装在你**要管理**的电脑上（Windows）
|
||
2-server（服务器端）装在一台能上外网的 Linux 小机器上
|
||
（随身 WiFi、树莓派、VPS 都行）
|
||
3-watch（控制端） 装在你的安卓手表上
|
||
|
||
装好之后，你在手表上就能看到并操作那台电脑：屏幕、文件、
|
||
音量、电源、剪贴板……共两百多个功能。
|
||
|
||
**关键点：所有数据都走你自己搭的那台服务器，
|
||
作者碰不到你的任何内容。** 详见《许可协议》第五条。
|
||
|
||
**再强调一次：软件里不带任何中转地址，作者也不对外提供中转服务。**
|
||
只在同一个 WiFi 下用的话，压根不需要中转站，装完就能连；
|
||
要跨网络就必须自己部署一台（看下面第四节的第 1 步）。
|
||
|
||
|
||
--------------------------------------------------------
|
||
二、装机前对照检查
|
||
--------------------------------------------------------
|
||
|
||
请先确认：
|
||
|
||
[ ] 这台电脑是**你自己的**，或者设备主人明确同意你远程管理
|
||
[ ] 电脑是 Windows 10 / 11（64 位）
|
||
[ ] 手表是安卓 7.0（API 24）或更高版本
|
||
[ ] 服务器端那台机器是 Linux（Debian 12 实测通过），
|
||
能上外网，内存 512MB 够用
|
||
[ ] 你有一个 Cloudflare 账号和一个域名（跨网络才需要）
|
||
|
||
**不需要**装 Python、不需要 root、不需要 ADB。
|
||
|
||
|
||
--------------------------------------------------------
|
||
三、【重要】三条必须知道的事
|
||
--------------------------------------------------------
|
||
|
||
① 被控端默认是"静默"运行的
|
||
|
||
装完之后**没有窗口、没有托盘图标、没有终端**，
|
||
任务管理器里能看到一个叫 ykxmz.exe 的进程，
|
||
开机自启项里也显示 ykxmz。
|
||
|
||
这么做是为了不打扰用电脑的人，**不是**为了藏起来。
|
||
如果你要在这台电脑上装给别人用，你有义务告诉对方：
|
||
|
||
怎么查看（任务管理器 -> 详细信息 -> ykxmz.exe）
|
||
怎么关闭（任务管理器 -> 结束任务）
|
||
怎么卸载（ykxmz.exe --uninstall）
|
||
|
||
② 配对码是唯一的口令，请设一个别人猜不到的
|
||
|
||
配对码是 6 位数字，**它就是你电脑的钥匙**。
|
||
不要用 123456、000000、生日、手机号后六位这类。
|
||
|
||
一个配对码同时只能绑定一台电脑。如果别人先用了你想要的码，
|
||
后装的这台会被拒绝，并在屏幕上弹出提示：
|
||
「该配对码已被使用，请换一个配对码」
|
||
换个没人用的码就行。
|
||
|
||
③ 连接时屏幕上有提示
|
||
|
||
只要手表或控制端连上来，被控端会在屏幕右下角弹一个提示。
|
||
这是**故意保留**的功能，请不要关掉它——
|
||
它保证了设备使用者知道"现在有人在看这台电脑"。
|
||
|
||
|
||
--------------------------------------------------------
|
||
四、安装顺序
|
||
--------------------------------------------------------
|
||
|
||
按这个顺序来，别跳：
|
||
|
||
第 1 步 架服务器端（只做一次，**跨网络才需要**）
|
||
如果只在同一个 WiFi 下用（手表和电脑连同一个路由器），
|
||
这一步可以跳过。
|
||
要跨网络的话，把 2-server 整个目录拷到那台 Linux 小机器上：
|
||
bash deploy.sh
|
||
它会把中转服务、网络调优、Cloudflare 隧道一次装好，
|
||
最后打印一个**属于你自己的公网地址**。记住它。
|
||
|
||
第 2 步 装被控端（每台要管理的电脑做一次）
|
||
双击安装包 -> 输 6 位配对码 -> 勾上开机自启和
|
||
放行防火墙 -> 确定。会弹一次管理员确认。
|
||
|
||
第 3 步 装控制端
|
||
把 3-watch 里的 APK 装到手表上。
|
||
|
||
第 4 步 跨网络的话，把中转地址填上
|
||
**注意：软件里没有内置任何中转地址。**
|
||
同一个 WiFi 下用不用填；跨网络的话必须填你自己第 1 步
|
||
装出来的那个地址：
|
||
电脑： ykxmz.exe --relay https://你的域名
|
||
手表： 首页点「中转设置」，填同一个地址
|
||
|
||
|
||
--------------------------------------------------------
|
||
五、会改你系统的哪些东西
|
||
--------------------------------------------------------
|
||
|
||
安装和使用过程中，被控端会做这些改动，**请你知情**：
|
||
|
||
1. 写一条开机自启项
|
||
位置：HKEY_CURRENT_USER\...\CurrentVersion\Run
|
||
名称：ykxmz
|
||
内容："...\ykxmz.exe" --silent
|
||
|
||
2. 添加 Windows 防火墙放行规则
|
||
规则名：LAN Remote TCP / LAN Remote UDP / LAN Remote App TCP
|
||
/ LAN Remote App UDP
|
||
作用：允许 8765（TCP）和 8766（UDP）端口通信
|
||
|
||
3. 在程序目录下建一个 data 子目录
|
||
里面存：配对码、已配对设备、设置
|
||
卸载时会一并删除
|
||
|
||
4. 说明：部分功能（关机、改注册表、隐藏任务栏等）
|
||
需要管理员权限，会弹 UAC 确认，**不会**偷偷提权。
|
||
|
||
**以上全部可撤销**：卸载时自启项和防火墙规则会一起清掉。
|
||
|
||
|
||
--------------------------------------------------------
|
||
六、杀毒软件可能报警
|
||
--------------------------------------------------------
|
||
|
||
本软件没有购买代码签名证书（那是要花钱的），
|
||
加上它确实具备"远程控制 + 开机自启"这类能力，
|
||
所以**部分杀毒软件可能会报可疑**。
|
||
|
||
这是误报。你可以：
|
||
1. 在杀毒软件里把 ykxmz 整个目录加入信任/排除项；
|
||
2. 或者先看完《许可协议》，确认用途正当后再决定是否放行。
|
||
|
||
**作者不会、也没有办法让本软件绕过杀毒软件。**
|
||
如果你需要"绝对不被杀软发现"，那本软件不适合你。
|
||
|
||
|
||
--------------------------------------------------------
|
||
七、接下来看什么
|
||
--------------------------------------------------------
|
||
|
||
装完之后请看《安装后须知》（AFTER-INSTALL.txt），
|
||
里面有：怎么确认它在正常运行、怎么换配对码、
|
||
怎么彻底卸载、连不上怎么排查。
|
||
|
||
|
||
--------------------------------------------------------
|
||
作者：小麦子
|
||
软件：ykxmz 2.2.0
|
||
继续安装，即表示你已阅读并同意《许可协议》。
|
||
--------------------------------------------------------
|