Files
ykxmz/docs/BEFORE-INSTALL.txt
T
xmz7891 5fc2f97be7 2.1.3:搬到 Lightsail 真服务器 + 支持"没有证书的中转"
用户买了 AWS Lightsail(2G 内存 / 2 vCPU / 60G SSD / 公网 IP
13.54.30.196),中转从随身 WiFi 那台小机器搬过去。

== 为什么这次搬迁解决了一堆老问题 ==

原机器(Debian aarch64、460MB、走 4G)一直有几件搞不定的:

  * 线路对 Cloudflare 隧道的 **7844 端口间歇性阻断**(443 通、7844 不通),
    隧道每 3~10 分钟掉一次、公网跟着 530 —— 查了很久才从
    cloudflared 自己的 precheck 里看清
  * 只有 460MB 内存
  * 会掉电硬挂(实测 2026-10-08 18:42 一次非正常关机)

新机器**有公网 IP**,中转直接监听,不经隧道、不过 7844。
实测公网延迟从 **1000~2000 ms 降到 1.1 ms**。

== 代码改动 ==

1. **relay.py 的 DATA_DIR 默认值不再写死**
   原来是 /root/lanremote-relay。新机器上服务以 admin 普通用户跑
   (它没理由要 root),而 /root 是 0700 —— 部署时直接
   PermissionError: '/root/lanremote-relay'。
   改成"本脚本所在目录下的 data/",搬到哪都跟着走。

2. **客户端支持"没有证书的中转"**
   新服务器是明文 HTTP(没签证书),而两个客户端原来都往 https 走:
     * 手表端:裸 IP 会被强制补 https:// -> 永远连不上,
       报的还是 SSL 错误,很容易让人白查半天证书
     * Android 9+ 默认禁止明文流量,没 usesCleartextTraffic
       请求会被系统直接掐掉
   Windows 端本来就是对的(正则里把任意纯 IP 都当"用明文")。
   现在手表端规则和它一致,并加了 usesCleartextTraffic。

3. 清掉电脑端一段函数内的重复代码(return 之后还有一份拷贝,
   缩进仍在函数体内所以不报错,但读起来很迷惑)。

== 新服务器上的部署 ==

    /opt/ykxmz-relay/            服务端(relay/admin/landing/showcase)
    ykxmz-relay.service          监听 0.0.0.0:13245
    ykxmz-monitor.service/.timer 每 60 秒查公网,连续 3 次不通就叫预案
    rescue-lightsail.sh          四级阶梯抢救(重启中转 / 强杀重拉 /
                                 查防火墙 / 重启整机[默认关])

  预案针对新架构重写过:原来围着隧道转(重启隧道、重施 MSS/MTU),
  现在没有隧道,改成重启中转 + 查端口/防火墙。

全量回归 46 个阶段全部通过。
2026-10-08 22:29:56 +08:00

170 lines
6.7 KiB
Plaintext
Raw 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.3
作者:小麦子
请你**在安装之前**花三分钟读完这一页。里面有几条很要紧的
提醒,尤其是第三节和第五节。
--------------------------------------------------------
一、这是什么
--------------------------------------------------------
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.1.3
继续安装,即表示你已阅读并同意《许可协议》。
--------------------------------------------------------