﻿﻿================================================================
　　　　　宇珩安全管控系统 · 客户交付操作手册
　　　　　　　　　　　　v2.7
================================================================


【这份是给谁看的】
  给负责发货、上门安装、售后的人看。
  客户不需要看这份，客户只要会扫码。

  一句话原则：
  ★ 所有配置在交付前做完，客户拿到的必须是成品。
    客户开机只看到一个大二维码，看不见设置界面。



================================================================
一、先选接入方式（只在一开始做一次，按客户情况定）
================================================================

  两种客户，两种方式：

  ┌──────────────┬───────────────────────┬──────────────────┐
  │              │ IPv6 直连              │ 隧道中转          │
  ├──────────────┼───────────────────────┼──────────────────┤
  │ 什么客户     │ 能上门、能进光猫       │ 只发安装包、动不了 │
  │ 数据走向     │ 手机直达电脑，不出境   │ 经第三方转发      │
  │ 速度         │ 跑满宽带上行，不限速   │ 8~12 Mbps         │
  │ 流量         │ 不限                   │ 5 GiB / 月 上下   │
  │ 费用         │ 0                      │ 0（域名另算）     │
  │ 客户操作     │ 扫一次码               │ 扫一次码          │
  └──────────────┴───────────────────────┴──────────────────┘

  怎么判断：客户单位的网络能不能让我们进光猫后台改一次？
    能 → 用 IPv6（推荐，长期看最省心，也没有数据出境的合规问题）
    不能 → 用隧道（发安装包，客户自己双击装）

  还有一种 auto 模式：开机自动判断本机有没有公网 IPv6，
  有就直连、没有就退隧道。适合你不确定客户网络的情况，
  但建议还是明确指定，出了问题好排查。



================================================================
二、交付前要准备的三样东西
================================================================

  【1】一个域名（两种方式都建议有）
        · 阿里云 / 腾讯云买，.cn 或 .com 都行，一年几十块
        · 给每个客户分配一个子域名：
              c001.你的域名.cn
              c002.你的域名.cn
          （这样 10 个客户只需要一个域名，加记录就行）

  【2】IPv6 方式：一个免费动态域名服务（DDNS）
        · 推荐 dynv6.com，免费、不用实名、专门做 IPv6
        · 也可以用腾讯云 DNSPod（国内，免费套餐够用）
        · 作用只有一个：本机 IPv6 地址变了，自动把域名指过去

  【3】IPv6 方式：确认客户网络放行入站
        · 光猫后台 → 安全 → 防火墙 → 「IPv6 防火墙 / IPv6 Session 保护」
          → 取消勾选 → 保存 → 重启光猫
        · 多数型号用光猫背面的普通账号就能改；改不了找装维要超级密码
        · 现场用手机流量打开一次验证，别等走了才发现不通



================================================================
三、生成客户配置（一条命令）
================================================================

  打开命令行，进到程序目录，执行：

  IPv6 直连：
  ────────────────────────────────────────────────────────────
  node tools/provision.js --id C001 ^
       --name "××供电公司 220kV 线路工程" ^
       --mode ipv6 ^
       --url https://c001.你的域名.cn ^
       --ddns dynv6 --token 你的dynv6令牌 ^
       --support "售后 138-0000-0000"
  ────────────────────────────────────────────────────────────

  隧道中转：
  ────────────────────────────────────────────────────────────
  node tools/provision.js --id C002 ^
       --name "××项目部" ^
       --mode tunnel ^
       --url https://c002.你的域名.cn ^
       --tunnel-token eyJhIjoi......
  ────────────────────────────────────────────────────────────

  参数说明：
    --id            客户编号，写在页面上，售后靠它定位。建议 C001 起编
    --name          客户名称，会显示在客户屏幕最上方
    --mode          ipv6 / tunnel / auto
    --url           对外地址。不写协议头会自动补 https://
    --ddns          dynv6 / dnspod / custom
    --token         DDNS 密钥
    --record        要更新的域名，不填就用 --url 的域名
    --tunnel-token  隧道令牌，tunnel 模式必填
    --support       售后联系方式，显示在客户页面底部

  其他命令：
    node tools/provision.js --show     看当前配置
    node tools/provision.js --clear    撤掉配置，回到管理员手配模式

  配置写在哪：data\provision.json
  这个文件一存在，系统就进入"交付模式"：
    · 开机自动连，不需要任何人点按钮
    · 浏览器自动打开扫码页 /go
    · 界面上的设置入口对客户不可见



================================================================
四、现场验收（5 步，必须全部过）
================================================================

  第 1 步  重启系统
           关掉黑窗口，双击「① 检查并启动.cmd」

  第 2 步  看黑窗口里这三行
           【客户怎么用】... 对外地址：https://c001.xxx.cn/m
           【本机信息】客户名称 · 编号 C001
           [接入] IPv6 直连 · 域名 c001.xxx.cn 自动跟随本机地址
           地址不对或没出现"接入"这行，就别往下走

  第 3 步  用手机流量扫屏幕上的二维码
           ★ 必须关 WiFi、只用移动数据。连着客户 WiFi 测不出真问题
           ★ 用手机系统相机扫，不要用微信扫（微信会改地址）
           能出登录页 = 通过

  第 4 步  登录后点「实时画面」→ 开摄像头
           能看到自己画面 = HTTPS 和摄像头权限都正常

  第 5 步  手机扫码装 App
           扫「② 扫码下载 App」→ 装好打开直接进 = 客户体验达标

  全过之后，按 Ctrl+P 打印当前那一屏，作为交付卡片放进箱子。


================================================================
五、交给客户的东西（装箱清单）
================================================================

  □ 电脑主机（系统已装好、已配置、能正常启动）
  □ 打印好的扫码卡片（就是 /go 那一屏）
  □ 《客户使用说明》一页纸（见附录，可直接打印）
  □ 售后联系卡（写上电话、微信群二维码）
  □ 管理员账号密码（单独一张纸，别和卡片放一起）

  ★ 别把《客户交付操作手册》放进客户箱子，那是给实施人员的。



================================================================
六、10 个以上客户怎么管
================================================================

  建议建一张表，每交付一个客户记一行：

  ┌────────┬──────────┬──────┬────────────────┬──────┬────────┐
  │ 客户编号│ 客户名称 │ 模式 │ 对外地址       │ 交付 │ 备注   │
  ├────────┼──────────┼──────┼────────────────┼──────┼────────┤
  │ C001   │ ××供电   │ ipv6 │ c001.xxx.cn    │ 11-08│        │
  │ C002   │ ××项目   │ tun  │ c002.xxx.cn    │ 11-12│        │
  └────────┴──────────┴──────┴────────────────┴──────┴────────┘

  IPv6 客户还要额外记一行 DDNS 密钥，客户换机时要用。

  到期提醒：域名一年一续，掉了所有客户的地址同时失效。
  建议提前设个日历提醒，一次续三年更省事。



================================================================
七、客户换电脑怎么办
================================================================

  IPv6 方式：
    1. 新电脑装好系统
    2. 把旧电脑的 data\ 、photos\ 、videos\ 整个拷过去
       （data\provision.json 一定不能丢，这是出厂配置）
    3. 启动新电脑 → 自动连上 → 域名自动指向新机器
    4. 手机不用做任何操作

  ★ 换之前先把旧电脑的系统关掉，两台同时开会让手机上看到旧数据。

  隧道方式：
    同上。因为令牌是同一个，新电脑连上后自动接管，旧电脑记得关。



================================================================
八、常见问题
================================================================

  Q：客户屏幕上二维码出来了，但手机扫了打不开
  A：按顺序查
     1. 手机是不是还连着 WiFi？关掉用流量
     2. 电脑上能不能打开 https://你的域名/m ？（本机先确认）
     3. 光猫的 IPv6 防火墙关了没？（最常见的坑）
     4. Windows 防火墙放行了吗？运行「放行IPv6端口.bat」
     5. 域名解析对不对？dynv6 后台看记录有没有指向当前地址

  Q：黑窗口里显示"未取到公网地址"
  A：客户宽带没有 IPv6，或者光猫没开 IPv6。
     让装维开通，或者改发隧道版。

  Q：地址偶尔会变，手机打不开
  A：DDNS 没生效。看 data 里 net6 的日志，或者
     node -e "console.log(require('./net6.js').status())"
     多数是 token 填错，会明确报 401。

  Q：客户说"提示不安全"
  A：自签证书的正常提示，点"高级 → 继续前往"。
     证书里已经带了客户域名，不会报名称不匹配。
     只有首次需要点一次，之后不再提示。

  Q：能不能不用域名，直接给 IP？
  A：不能。IPv6 地址又长又会变，客户存不住。
     域名是"扫一次永久用"的前提。

  Q：数据会不会跑到国外？
  A：IPv6 直连不会 —— 手机直达客户电脑，中间只有运营商。
     隧道方式会经第三方服务器，选国内节点。
     对国企客户，这一点要提前讲清楚，是加分项。



================================================================
附录：客户使用说明（可直接打印，一页）
================================================================

  ┌────────────────────────────────────────────────────┐
  │                                                    │
  │    现 场 安 全 管 控 系 统                         │
  │                                                    │
  │    手机怎么用？                                    │
  │                                                    │
  │  1. 手机相机，对着电脑屏幕上的二维码扫一下         │
  │                                                    │
  │  2. 点「下载安装包」→ 允许安装 → 打开「宇珩智巡」  │
  │     地址已内置，不用填、不用注册，直接进系统       │
  │                                                    │
  │  3. 用 admin / yh123456 登录                       │
  │     以后点桌面图标直接进，不用再扫码               │
  │                                                    │
  │  --------------------------------------------      │
  │                                                    │
  │  遇到问题找：__________________（电话）            │
  │                                                    │
  └────────────────────────────────────────────────────┘


================================================================
　　　　　　　　　　　　　　　　　　　　　　　v2.7 · 2026-11
================================================================

────────────────────────────────────────────────
附录：量产交付用哪个文档？
────────────────────────────────────────────────

这份手册讲的是一家一家上门装的完整流程。

如果你一次要给很多家出包、并且希望客户以后自己弹窗升级，
直接看《上线与远程升级操作卡.txt》——一页纸，三条命令：

  node tools/dns.js      建客户子域名（一次性）
  node tools/factory.js  批量出客户安装包
  node tools/release.js  发新版，客户自己升级

机器怎么配（IPv6、防火墙、光猫）还是看这份手册。
