Files
ykxmz/docs/BEFORE-INSTALL.txt
T
xmz7891 c5fa4eb517 2.1.1:修一个会让网站整个挂掉的死锁(「网站容易挂」的真因)
2.1.0 的服务端包里带着这个死锁,所以要单独发一版让部署的人拿到修好的包。

== 死锁 ==

    lanremote-nettune.service   Before=lanremote-tunnel.service
    net-tune.sh 第 4 步         systemctl restart lanremote-tunnel

  nettune 在**自己还没结束**的时候去 restart 一个"必须等自己结束
  才能启动"的服务 -> systemd 判定顺序冲突 -> restart 永不返回
  -> nettune 卡在 activating -> 隧道被 Before= 挡着起不来 -> 公网 530。

  设备上实测卡了 9 分半(CGroup 里能看到 net-tune.sh 下面挂着
  一个 etime 09:32 的 systemctl restart lanremote-tunnel)。
  journalctl 里只有 nettune 停在 activating、**一句报错都没有**;
  手动跑 net-tune.sh 却完全正常(那时没有 Before= 约束)。
  是靠这次新加的监测单元抓到的(fails=3 / last_code=530)。

== 改法 ==

  unit 加 Environment=NETTUNE_SERVICE_CALL=1,脚本据此跳过第 4 步。
  第 4 步只在人工重跑时才有意义(改完 MTU/MSS 让已建隧道用上新参数),
  开机时顺序就是调优先、隧道后,不需要它。

  三处都改了:net-tune.sh 认开关;deploy.sh / install.sh 生成的 unit 带上它。

  没选 systemctl restart --no-block:那只是把阻塞变异步,开机时仍然
  做一次无谓重启(隧道刚起来就被停掉),也没解决"不该在开机时重启"。

== 为什么以前没暴露 ==

  设备上那份旧 unit 的 ExecStart 里有 iptables ... || ...,
  systemd 不支持 ||,所以它在第 2 条 ExecStart 就报错退出,
  根本没走到会死锁的那一步。把 unit 换成正确形状之后才露出来。
2026-10-08 19:52:08 +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.1
作者:小麦子
请你**在安装之前**花三分钟读完这一页。里面有几条很要紧的
提醒,尤其是第三节和第五节。
--------------------------------------------------------
一、这是什么
--------------------------------------------------------
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.1
继续安装,即表示你已阅读并同意《许可协议》。
--------------------------------------------------------