﻿========================================
  宇珩智能 · 异地访问设置说明
  （手机不在同一个 WiFi 时怎么用）
========================================


【先看这条】
  ★ 手机在外地，现在有一键方案了：
    电脑端点「手机接入」→「一键开启外网访问」，
    手机浏览器直接打开，不用装任何东西。
    详见《手机外网访问说明.txt》——先看那个，本文可以跳过。

  下面这份是 Tailscale 备用方案，只在两种情况才需要：
    · 单位网络限制了境外节点，一键方案一直建立不起来；
    · 你希望地址固定不变，而且不介意手机装一个 App。


【一句话结论】
  同一个 WiFi 内，什么都不用装，扫码就能用。
  手机在外地、用自己流量，装了 Tailscale 也能用，
  相当于给电脑和手机拉一条专用隧道。


========================================
  一、先弄清楚：为什么异地默认用不了
========================================

  系统是把数据存在【这台电脑】上的，手机要连的
  就是这台电脑。电脑在路由器后面，家里/公司宽带
  没有对外地址，外面的人进不来。

  所以要让手机从外面连回来，必须有一根"隧道"。
  Tailscale 就是这根隧道：装完以后，手机会拿到一个
  100 开头的虚拟地址，访问它就像在同一个 WiFi 里。

  好处：不用申请公网 IP、不用买服务器、不用配路由器，
        流量走加密隧道，外人扫不到你的系统。
  费用：个人/小团队 100 台设备以内免费，够用。


========================================
  二、三步搞定（每台设备只需做一次）
========================================

  第 1 步：电脑上装 Tailscale

    1) 浏览器打开  https://tailscale.com/download/windows
       下载 Windows 版，双击安装，一路下一步。
    2) 装完右下角托盘会出现 Tailscale 图标，
       点它 → Log in，用邮箱/谷歌/微软账号登录。
       （推荐直接用邮箱，比如你们公司的邮箱）
    3) 登录成功后图标变成正常状态，就通了。

    ★ 记下你用的这个账号，后面手机要用同一个。


  第 2 步：手机上装 Tailscale

    安卓：应用商店搜 "Tailscale"（或官网下载 APK）
    苹果：App Store 搜 "Tailscale"

    安装后打开 → Log in → 【用和第 1 步完全相同的账号】
    登录后点一下开关，状态显示 Connected（已连接）。


  第 3 步：重启本系统，拿异地地址

    1) 关掉那个黑窗口，重新双击「① 检查并启动.cmd」
    2) 启动信息里会多出一行：
         【手机上 - 异地 / 用流量】 Tailscale 已就绪
         http://100.x.x.x:8080/m
    3) 电脑端首页 → 右上角「手机接入」，
       弹窗里会多出第三个二维码：
         ③ 异地 / 手机流量
       手机扫这个码，或者手动输入那个 100 开头的地址。


  第 4 步：手机 App 填地址

    打开「宇珩智巡」App，如果是首次会要求填地址：
    把 100.x.x.x 那串填进去就行，不用带 http:// 和端口。
    App 会自己补全。

    （同一 WiFi 时填 192.168.x.x，异地填 100.x.x.x，
      两个都记不住也没关系，电脑屏幕上都写着。）


========================================
  三、用起来是什么样
========================================

  ✅ 手机拍照 —— 照片直接回到电脑的 photos 目录
  ✅ 手机录像 —— 视频直接回到电脑的 videos 目录
  ✅ 现场填报 —— 项目、隐患、整改，实时进电脑数据库
  ✅ 电脑端看板 —— 同步刷新，和在同一 WiFi 里完全一样

  ⚠ 手机上的「实时画面直播」需要 HTTPS 才行（浏览器规定）。
    两个办法：
      · 直接用「宇珩智巡」App —— App 会自动放行自签证书，
        填 100 地址就能直播；
      · 或者打开启动页点「安全模式进入」，提示证书时点继续。
    只拍照、录像、回传的话，普通模式就够，还更快。

  速度取决于【电脑那边的上行带宽】，不是手机流量。
  家用宽带一般上行 20~50Mbps：
    · 传几张 3MB 的照片：1 秒内
    · 传 10 秒的短视频：几秒
    · 1080P 长时间实时推流：会卡，建议只在 WiFi 下用


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

  1. 电脑必须开机、黑窗口必须开着。
     电脑一关，手机上什么也连不上——这是本系统的
     设计前提（数据就在这台电脑里）。

  2. 手机上的 Tailscale 要保持在"已连接"状态。
     有些手机会自动清理后台，把 Tailscale 加到
     「电池优化白名单 / 允许后台运行」里更稳。

  3. 首次用 100 地址访问，浏览器可能提示"不安全"，
     点"继续访问"即可（自签证书，正常现象）。

  4. 异地地址和局域网地址是两个，不用来回切换：
     手机版启动文件会自动先试局域网，不通再试异地。

  5. 如果哪天电脑换了网络、或者 Tailscale 重新登录
     导致 100 地址变了：重启一次本程序，地址会重新
     显示，证书也会自动重签。


========================================
  五、常见问题
========================================

  Q: 电脑上能打开 tailscale.com，但登录转圈？
  A: 换个网络试试（手机热点），或改用邮箱验证码登录。
     国内访问控制面偶尔慢，登录成功后日常使用不再依赖它。

  Q: 装完 Tailscale，启动信息里还是"未开启"？
  A: 两个原因——
     · Tailscale 没登录 / 没连接（看托盘图标状态）
     · 装了但没重启本程序（本程序只在启动时读网卡）
     先确认托盘显示正常，再重启「① 检查并启动.cmd」。

  Q: 手机显示已连接，但打不开 100 地址？
  A: 在手机浏览器直接输 http://100.x.x.x:8080/api/health
     能看到 {"ok":true} 就说明隧道通了，问题在本程序没启动；
     打不开就说明隧道没通，检查两边是不是同一个账号。

  Q: 公司电脑装不了软件 / 被安全软件拦？
  A: Tailscale 需要管理员权限安装。找 IT 放开，或者
     换成"把系统部署到云服务器"的方案（另说）。

  Q: 能不能不用 Tailscale，直接给个公网网址？
  A: 可以，但要买云服务器（约 100~300 元/年），
     把整套系统搬上去。好处是电脑不用一直开，
     多人同时用更稳。需要的话找我们改。


========================================
  需要协助
========================================
  把「运行日志.txt」发过来，里面记录了启动时识别到的
  所有地址，能直接看出 Tailscale 有没有被认到。
