﻿宇珩安全管控系统 · 固定地址与换机说明
================================================================

【这份文档解决什么问题】

  你现在的情况：
    手机扫一个地址 → 能用
    电脑重启一次 → 地址变了 → 手机得重扫

  你要的效果：
    手机扫一次，以后再也不用扫。
    哪怕换了电脑、换了网络、换了 IP，手机端打开还是那套系统，
    权限和功能跟电脑端完全一样（回传照片视频、实时画面、改项目信息）。

  能做到，但要先花二十分钟做一次配置。做完就一劳永逸。

  ★ 一句话原理：
    让手机记住的不是"哪台电脑"，而是一个"门牌号"（域名）。
    门牌号不变，换电脑时只是把门牌号挂到新电脑上，手机毫无感知。


================================================================
【为什么非要用域名】

  两个硬约束，绕不开：

  1. 手机开摄像头、传文件，浏览器强制要求 HTTPS 安全地址。
     HTTPS 证书只签给域名，不签给 IP。

  2. IP 会变：换电脑就变，换路由器也变，光猫重启还可能变。
     域名不会。

  所以：固定地址 = 固定域名。


================================================================
【准备工作：三样东西】

  ① 一个域名         约 30-60 元/年
  ② Cloudflare 账号   免费注册
  ③ 二十分钟         一次搞定

  说明：Cloudflare 隧道免费，不限制流量，不需要公网 IP。

  ⚠ 关于备案：
    这套方案流量走 Cloudflare 海外节点，不经国内服务器，因此不需要 ICP 备案。
    但严格来说，面向公众提供信息服务仍应备案。
    你们是项目部内部使用、不对外宣传，属于低风险；
    如果将来要作为对客户交付的正式平台，建议走正规备案 + 国内服务器，
    那时候我给你们做另一套部署方案。


================================================================
【第一步：买域名】

  在哪买都行：
    阿里云    wanwang.aliyun.com
    腾讯云    cloud.tencent.com/product/domain
    华为云    huaweicloud.com/product/domain

  怎么选：
    · 后缀用 .com 或 .top，别用 .cn（.cn 备案要求更严，后面麻烦）
    · 名字随便起，比如 yh-power.com、yh-safety.com
    · 首年通常 9-30 元，续费 60-90 元/年
    · 不需要买任何附加服务（不要云服务器、不要虚机、不要 SSL 证书）

  ⚠ 买的时候会要求实名认证，个人或企业都行。
    用公司名义买，后面如果要备案更顺。

  买完先别动它，直接进第二步。


================================================================
【第二步：把域名托管到 Cloudflare（免费）】

  1. 打开 https://dash.cloudflare.com/sign-up 注册账号（邮箱即可，免费）

  2. 登录后点「Add a site」，输入你刚买的域名（不带 www），点 Continue

  3. 选 Free 套餐，Continue

  4. Cloudflare 会扫描你现有的解析记录，直接 Continue

  5. 最关键的一步：它会给你两个 NS 地址，形如
       xxx.ns.cloudflare.com
       yyy.ns.cloudflare.com

     回到你买域名的网站（阿里云/腾讯云），找到「域名解析设置」→
     「DNS 服务器 / 修改 DNS」，把原来的两条删掉，换成 Cloudflare 给的这两条。

  6. 回 Cloudflare 点「Check nameservers」，等生效。

     生效时间：通常 10 分钟到 2 小时，慢的 24 小时。
     Cloudflare 面板上该域名状态变成 Active 就表示好了。
     这期间可以去干别的，不用守着。


================================================================
【第三步：创建隧道，拿到令牌】

  域名状态变 Active 之后：

  1. 在 Cloudflare 面板左侧点「Zero Trust」
     （第一次进会让你起个团队名，随便填，比如 yh，选 Free 计划，不要绑卡）

  2. 左侧菜单：Networks → Tunnels → 点「Create a tunnel」

  3. 连接器类型选「Cloudflared」，Next

  4. 隧道名字填 yh-safety（随便），Save tunnel

  5. 这一步会显示安装命令，里面有一串很长的参数：
       --token eyJhIjoi........（很长，可能几百个字符）

     ★ 只复制 eyJ 开头到结尾那一整串，不要带引号、不要带 --token 这几个字。

     这个就是「隧道令牌」，等下要粘到系统里。
     它是这台电脑接管这个域名的唯一凭证，等于密码，别发到群里。

  6. 先别关页面，下一步要用。


================================================================
【第四步：给隧道绑一个网址】

  还在刚才那个隧道页面，点「Public Hostname」标签 → 「Add a public hostname」：

    Subdomain:   yh                （想叫什么填什么，就是 yh.你的域名.com）
    Domain:      选你刚托管过来的域名
    Path:        留空
    Type:        HTTP
    URL:         localhost:8080

  Save hostname。

  ⚠ URL 一定是 localhost:8080，不是 https，也不要加 /m。
    系统内部是 HTTP 8080，加密由 Cloudflare 那头负责。

  到这里，Cloudflare 这边就配完了，以后不用再进来。


================================================================
【第五步：填到系统里】

  1. 电脑上打开系统 → 首页右上角「手机接入」

  2. 最上面那张卡片「固定访问地址 · 扫一次永久有效」→ 点「配置固定地址」

  3. 两栏分别填：
       固定域名：  https://yh.你的域名.com
       隧道令牌：  刚才复制的 eyJ... 那一长串

  4. 点「保存并启用」

  5. 等 10～40 秒，状态变绿「已配置」，下面显示
       https://yh.你的域名.com/m

     如果报「隧道令牌无效」：回去重新复制一次，多半是漏了字符。
     如果报「单位网络禁止对外连接」：换手机热点试一次，能通就是网络策略问题。

  6. 手机扫这个码，或者直接在浏览器输入这个地址。

  7. 手机扫「② 扫码下载 App」装上 App，或者扫「③」用网页版。
     以后点图标或用 App 进，地址永远不变。

  ★ 从此这台电脑重启、断网重连、换 WiFi，地址都不变，手机不用重扫。


----------------------------------------------------------------
【手机端用哪种形式？】

  推荐：装安卓 App（扫「② 扫码下载 App」）
    扫码 → 下载安装包 → 允许安装 → 打开就是本系统
    地址已经编进安装包里，不用填、不用注册，以后点图标直接进。
    电脑换了、地址换了也不用重装：域名不变，App 自动连新机器。

  备选：不装 App 用网页版（苹果手机只能这样）
    扫「③ 不装 App · 网页版」→ 手机浏览器直接打开，功能一模一样
    填 https://yh.你的域名.com 即可，填一次就记住，以后不再问。

    ⚠ 这里一定要填固定域名，千万别填 192.168 开头的局域网地址。
      填了局域网地址，换网络、换电脑就打不开了 —— 这正是要避免的事。

  两种形式看到的是同一套数据、同一套权限，只是入口不同。


================================================================
【换电脑怎么做（重点）】

  假设项目部那台电脑坏了 / 换了新的：

  第一步：新电脑装好本系统
          把安装包解压到任意目录，照《安装说明.txt》装好，能正常启动。

  第二步：把旧电脑的数据拷过来
          关掉旧电脑上的系统（右下角黑窗口关掉，或在任务管理器结束 node.exe）。

          把旧电脑整个目录下的这几个文件夹拷到新电脑同一位置：
            data\        ← 必须：项目、台账、账号、配置都在里面
            photos\      ← 照片
            videos\      ← 录像

          ★ data\site.json 里存的就是域名和令牌，拷过去新电脑自动接管。
            如果旧电脑彻底坏了拿不到数据，就在新电脑上照第五步重填一次
            （域名和令牌在 Cloudflare 面板都还能查到），手机端同样不用动。

  第三步：启动新电脑上的系统
          黑窗口里出现「开机自动连接 https://yh.你的域名.com」就对了。
          十几秒后 Cloudflare 那边自动把域名指到新电脑。

  第四步：手机端什么都不用做
          还是原来的图标、原来的地址，打开就是新电脑上的数据。

  ⚠ 千万别两台电脑同时开着系统。
    Cloudflare 会在两台之间轮流分发请求，手机上一会儿是旧数据、
    一会儿是新数据，看着像"数据丢了"，实际是分流了。
    规矩：先关旧，再开新。


================================================================
【常见问题】

Q：电脑关机了还能用吗？
A：不能。这套系统的数据、AI 模型都在这台电脑上，电脑关了服务就停了。
   想做到"电脑不开机也能用"，只有一条路：把系统搬到云服务器上
   （月付约 80 元），那是另一套部署方式，需要时找我要。

Q：地址后面为什么带 /m？
A：/m 是手机版页面。你也可以只输域名，系统会自动跳转。
   电脑端用域名直接打开就是总控界面。

Q：手机端和电脑端权限一样吗？
A：用同一个账号登录，看到的就是同一套数据、同一套操作。
   手机端有：拍照/录像回传、实时画面推流、项目新建与编辑、
   人员管理、设备绑定、我的上传、台账查看。
   管理类配置（推送设置、账号管理、更新设置）在电脑端操作更顺手，
   手机上也能打开电脑版界面。

Q：地址会不会被别人扫到？
A：域名本身不公开就不会被搜到，但知道地址的人都能打开登录页。
   ★ 第一件事：进「账号与接入」把 admin 的默认密码 yh123456 改掉。
   再给每个人单独建账号，别共用 admin。

Q：令牌好像泄露了怎么办？
A：去 Cloudflare 面板把那个隧道删掉，重新建一个，把新令牌填进系统。
   域名不用换，手机端也不用动。

Q：换域名麻烦吗？
A：在系统里改「固定域名」+ 新令牌，保存即可。
   但手机端要重新扫一次——因为门牌号换了。

Q：能不能配两个域名？
A：可以，Cloudflare 同一个隧道能绑多个 hostname，
   系统里填主用的那个即可。

Q：这套方案稳定吗？
A：Cloudflare 是全球最大的 CDN 之一，隧道服务免费且长期可用。
   实测公网打开 1～2 秒，手机推流 1 秒 1 帧正常。
   唯一风险是单位网络封锁境外节点，遇到就换手机热点验证一次。


================================================================
【和"临时地址"的区别，一句话记住】

  不配固定地址：每次重启换地址，手机每次要重扫。适合临时演示。
  配了固定地址：地址永久不变，换电脑也不用重扫。适合正式使用。

  建议：只要这套系统要长期用，就花二十分钟配一次。

================================================================
宇珩智能 · 甘肃宇珩智能科技有限责任公司
