﻿========================================
  宇珩智能 · 手机外网访问说明
  （人在外地、手机用流量，也能看现场）
========================================


【一句话】
  电脑上点一下「一键开启外网访问」，系统给出一个 https 地址，
  手机浏览器打开就能用。
  手机不用装 App、不用注册、不用改路由器、不用拉网线。


========================================
  一、这个功能解决什么问题
========================================

  本系统把数据存在项目部这台电脑里。手机要连的，就是这台电脑。

  手机和电脑在同一个 WiFi 里，扫码就能用，一直没问题。
  难的是人在外地：手机用 4G/5G，和电脑不在一个网里，
  外面的人进不来——这是所有本地系统的通病。

  这个功能就是给这台电脑开一条「对外的门」：

    手机 ──4G/5G──→ 云端中转 ──→ 项目部这台电脑

  中转用的是 Cloudflare 的免费通道，不花钱、不用备案、
  不用申请公网 IP。地址是 https 开头，走加密传输。


========================================
  二、三步开启（只做一次）
========================================

  第 1 步：电脑上打开「手机接入」

    系统首页右上角 → 点「手机扫一扫」按钮。

    弹窗最上面就是「外网访问 · 手机在任何地方都能用」，
    点蓝色按钮「一键开启外网访问」。

    等 10~30 秒。你会看到状态从「正在建立…」变成「已开启」，
    下面出现一个大二维码和一串地址。

    ★ 状态显示「验证中…」时先别扫。系统正在确认这个地址
      真的能打开，等它变成绿色的「已开启」再扫，一次就成。


  第 2 步：手机扫码

    手机打开相机或微信「扫一扫」，对准那个大二维码。
    点弹出的链接，用账号登录（默认 admin / yh123456）。

    ★ 这时手机上已经有「实时画面」权限了。
      这个地址是 https，浏览器认为安全，
      开摄像头不会像局域网那样提示「证书不安全」。


  第 3 步：装成 App（强烈建议）

    安卓：电脑「手机接入」里扫「② 扫码下载 App」→ 下载 → 允许安装 →
    打开就是本系统（地址已内置，不用填）。
    苹果：扫「③ 不装 App · 网页版」，底部分享按钮 →「添加到主屏幕」。
    以后点图标直接进，不用再找地址、不用再扫码。

    ★ 这一步不影响功能，但每天都用的话，省事很多。


========================================
  三、手机在外地能做什么
========================================

  ✅ 现场拍照回传
     拍完自动回到电脑 photos 目录，电脑端「图像回传」立刻出现。

  ✅ 现场录像回传
     录完回到电脑 videos 目录，电脑端「录像库」能直接播放、下载。

  ✅ 实时画面（手机当摄像头）
     「直播」页 → 选通道 → 点「开启摄像头」。
     画面每 1 秒回传一帧，电脑端「视频监控」里能看到，
     通道状态显示「在线」+ 最后画面时间。

     现场发现问题，直接点「抓拍违章」，照片连同通道、时间
     一起进电脑端「违章台账」。

  ✅ 填报隐患、整改
     和在同一 WiFi 里完全一样。

  ✅ 电脑端看录像
     手机传回来的录像都存在电脑上，电脑端「录像库」随时回看，
     不受手机在不在线影响。

  ⚠ 不支持：手机看电脑上已有的录像。
     手机端只能看自己刚传上去的那几条。
     要调阅历史录像，还是在电脑上看。


========================================
  四、地址为什么会变，变了怎么办
========================================

  这个免费通道每次重启都会分配一个新地址，这是它的机制。

  什么情况会变：
    · 电脑重启、或重新双击「① 检查并启动.cmd」
    · 在弹窗里点了「重新生成」
    · 电脑断网重连后通道自动重建

  变了怎么办：
    · 电脑端弹窗会自动显示新地址和新二维码，
      手机上重新扫一次就行（10 秒的事）。
    · 手机桌面上那个图标存的是旧地址，点开会打不开，
      这时重新扫一次码，图标会自动更新，不用删了重装。

  地址没变的情况：
    · 电脑一直开着、系统一直跑着，地址就一直有效，可以用很多天。

  ★ 所以：电脑尽量别关，那个黑窗口别关。
    真要每天关机，就每天上班时重扫一次码，这是这套免费方案的代价。


========================================
  五、流量和速度
========================================

  拍照回传：一张 1~3 MB，用手机流量也就几秒钟。

  实时画面：
    · 每 1 秒 1 帧，一帧约 60~120 KB
    · 开 10 分钟 ≈ 40~70 MB
    · 开 1 小时 ≈ 250~400 MB

    ★ 建议：需要盯现场的时候再开直播，看完就点「停止」。
      不要挂着开一整天，流量吃不消。

  速度取决于两端：
    · 电脑那边的宽带上行（家用一般 20~50 Mbps，够用）
    · 手机那边的信号（4G 一般够，地下室/山里会卡）

  实测：从公网打开页面约 2 秒，推流延迟约 1~2 秒。


========================================
  六、必须知道的几条
========================================

  1. 电脑必须开机、黑窗口必须开着。
     电脑一关，手机上什么都打不开。

  2. 这个地址任何拿到的人都能打开登录页。
     ★ 第一件事：把默认密码改掉！
       电脑端「账号与接入」→ 找到 admin → 改密码。
       密码别用 123456、别用项目名。

  3. 不用的时候可以关掉：
     弹窗里点「关闭」，地址立即失效，外人再也进不来。
     下次要用再点开启（会分配新地址）。

  4. 只有管理员能开这个功能。
     安全员、飞手账号点不开，会提示「只有系统管理员能开启」。

  5. 通道需要访问境外节点。
     少数单位网络会限制，表现是一直停在「正在建立…」，
     等 45 秒后提示失败。这时换手机热点给电脑联网试一次；
     如果热点能开、单位网不能开，就是单位网络策略的问题，
     找 IT 放行 cloudflared 相关域名即可。


========================================
  七、常见问题
========================================

  Q: 手机扫了码，显示「无法访问此网站」？
  A: 三种可能——
     1) 状态还是「验证中…」，地址没生效。等 30 秒再扫。
     2) 电脑上的黑窗口被关了。重新双击「① 检查并启动.cmd」。
     3) 地址变了（电脑重启过）。回电脑端看一眼新码，重扫。

  Q: 电脑上自己能打开，手机打不开？
  A: 大概率是手机所在网络的问题（单位 WiFi 做了限制）。
     换成手机流量试试。流量能开、WiFi 不能开，就是那个 WiFi 的限制。

  Q: 打开后很慢，转圈半天？
  A: 中转节点在境外，比局域网慢是正常的。
     打开页面约 2 秒，可以接受；
     如果超过 15 秒，基本是网络被限速了，换网络试。

  Q: 实时画面卡、画面不动？
  A: 看两处——
     · 手机端「直播」页右上角是不是还在累加帧数；
     · 电脑端通道状态是不是「在线」、时间是不是在更新。
     手机信号弱（比如塔基下面、山沟里）时帧率会掉，
     这是网络问题，换个位置会好。

  Q: 能不能固定一个地址，永远不变？
  A: 能，但要花钱或有条件，三选一：
     · Cloudflare 命名通道：需要一个自己的域名（约 30~60 元/年），
       配好后地址固定，仍然免费；
     · 买台云服务器把整套系统搬上去（约 100~300 元/年），
       电脑不用一直开着，多人同时用更稳；
     · 用 Tailscale（免费，但手机和电脑都要装、都要登同一账号）。
     现在这个方案是「零成本、零安装、5 秒能用」，
     代价就是地址会变。要固定就走上面第一条。

  Q: 会不会把公司数据传到 Cloudflare 上？
  A: 不会。数据始终在你这台电脑的硬盘上。
     Cloudflare 只做「转发」——把手机的请求转给电脑，
     把电脑的回复转给手机，像快递中转站，不拆包、不存件。
     传输过程是加密的。


========================================
  八、和另外两种办法的区别
========================================

  外网访问（本功能）
    手机装什么：什么都不用装
    电脑装什么：系统自带，点一下
    花钱：0
    地址：会变
    实时画面：直接能用

  Tailscale
    手机装什么：装 App + 注册 + 登录
    电脑装什么：装 App + 注册 + 登录
    花钱：0
    地址：固定（100.x.x.x）
    实时画面：要处理证书警告
    适合：天天用、不介意装软件的人

  云服务器
    手机装什么：什么都不用装
    电脑装什么：不用开
    花钱：100~300 元/年
    地址：固定、好记
    实时画面：要配 https 证书
    适合：多人同时用、要长期稳定


========================================
  需要协助
========================================

  打不开时，把这两样发过来：
    1. 「运行日志.txt」（电脑端系统目录里）
    2. 手机上的报错截图

  日志里会记录通道建立过程和失败原因，能直接定位问题。
