🚀 用花生壳发布到外网（支持手机扫码）
本系统所有数据保存在你电脑本地的 data.json 文件中，不上云、不外泄。配合花生壳内网穿透，既保留了数据本地存储的安全性，又能让手机扫码随时随地访问、数据实时汇总到管理员后台——这是环境/安全数据管理的理想组合。
本地服务器存储
多人扫码数据汇总
内网穿透免公网IP
HTTPS加密访问
二维码自动适配公网地址
⚡ 最快方式（已为本项目启用）：花生壳最新推出面向 AI 的 @aweray/hsk-cli 命令行工具，可免注册匿名创建内网穿透映射。本项目已用此方式发布，公网地址与认领步骤见对话回复。下方为传统花生壳客户端配置方式（适合长期稳定使用、需绑定自己账号管理）。
💡 关键优势：本系统的二维码链接是基于当前访问地址自动生成的。你只需用花生壳映射本地 8000 端口，然后通过花生壳分配的公网域名打开网站——所有风险点二维码、排查表单二维码、管理员登录二维码都会自动变成公网地址，无需改任何代码、无需重新生成下载。
1
下载并安装花生壳客户端
支持 Windows / macOS / Linux
访问花生壳官网下载最新版客户端：
https://hsk.oray.com/
下载 Windows 版安装包后，双击运行按提示完成安装。安装完成后桌面会出现"花生壳"图标。
花生壳是贝锐旗下正规内网穿透服务，深耕该领域 20 年，已通过等保三级、ISO27001 等认证，可放心用于企业管理场景。
2
注册账号并完成实名认证
免费版会分配一个壳域名（如 xxx.oray.net）
- 打开花生壳客户端，点击"注册账号"，按提示完成注册
- 登录后，进入花生壳管理后台（console.hsk.oray.com 或客户端内"映射"页）
- 完成实名认证（个人或企业实名）——这是国内 HTTP/HTTPS 映射的合规要求，认证后才能创建网站类映射
- 认证通过后，系统会分配一个免费壳域名，这就是你的外网访问地址前缀
关于备案：花生壳自带的壳域名（如 .oray.net）由花生壳统一备案，可直接使用；如果你想绑定自己的顶级域名走国内节点，需自行备案。免费版足以满足扫码访问需求。
3
创建内网映射（关键步骤）
把本地 8000 端口映射到公网
先确保本地服务器已启动（本机已在 http://localhost:8000 运行）。然后在花生壳后台点击"添加映射"，按以下参数填写：
| 参数 | 填写值 | 说明 |
|---|
| 应用名称 | 环境风险双重预防 | 自定义，便于识别 |
| 应用类型 | HTTP（推荐选 HTTPS） | 网站类应用选 HTTP/HTTPS |
| 外网端口 | 80（HTTPS 选 443） | 由系统分配，免费版可能为非标端口 |
| 内网主机 | 127.0.0.1 | 本机 |
| 内网端口 | 8000 | 本系统运行的端口 |
| 访问密码 | （可选） | 建议设置，防止地址泄露被随意访问 |
内网主机=127.0.0.1 内网端口=8000
强烈推荐用 HTTPS 映射：花生壳 HTTPS 映射会自动部署 SSL 证书，无需你在本地配置证书。内网虽然是 HTTP，外网访问却是 HTTPS 加密的，对隐患排查这类含现场照片的数据尤其重要。每个壳域名可创建一条 HTTPS 映射。
映射创建成功后，花生壳后台会显示一个外网访问地址，形如：
https://你的域名.oray.net:端口/
在手机或外网电脑浏览器中打开这个地址，应能看到本系统的首页。如果设置了访问密码，会先要求输入密码。
注意：花生壳客户端必须保持运行，映射才会生效。关闭客户端或电脑关机后外网将无法访问。建议把花生壳设为开机自启。
5
验证二维码自动更新（核心）
无需重新生成，直接可用
通过花生壳公网地址进入后台管理 → 二维码管理，你会看到：
- 管理员登录二维码的链接已自动变为
https://你的域名.oray.net/.../login.html?t=xxx
- 各风险点二维码链接已自动变为
https://你的域名.oray.net/.../risk.html?t=xxx
- 通用排查表单二维码链接已自动变为
https://你的域名.oray.net/.../inspect.html
直接下载这些二维码，打印张贴到风险点现场，巡检人员用手机扫码即可访问——无需任何额外配置。
原理：系统二维码是 JavaScript 读取 location.origin 动态生成的，所以从哪个地址打开网站，二维码就用哪个地址。换网络、换域名、从 HTTP 升 HTTPS 都能自动适配。
🔐 访问控制
设置访问密码、IP 白名单（如只允许公司 IP）、时间限制（如仅工作时间可访问）。建议至少设置访问密码，避免公网地址被随意打开。
📊 监控告警
服务异常、流量超限、客户端离线时推送通知到花生壳 APP，确保映射通道健康。
🛡️ 威胁情报
检测到恶意访问可自动关闭映射，保护内网安全。
⚡ 带宽加速
免费版带宽有限（约 1Mbps），照片较多的隐患上报可能较慢。多人高频使用建议升级带宽，夜间带宽自动翻倍。
- 花生壳客户端已登录且在线（图标显示绿色/在线）
- 本地服务器在运行（本机访问 localhost:8000 正常）
- 映射已创建，状态为"正常"
- 用手机 4G/5G 网络（断开 WiFi）打开花生壳外网地址，能看到首页
- 手机扫码一个风险点二维码，能打开风险点详情页
- 手机在排查页提交一条测试记录，后台能收到
- （如设置访问密码）外网访问时需输入密码
Q：手机扫码后打不开页面？
A：①检查花生壳客户端是否在线；②检查本地 8000 端口服务器是否在运行；③确认手机用的是外网流量或非同一局域网；④若设了访问密码，需在浏览器先访问一次输入密码。
Q：免费版够用吗？
A：对于中小型企业日常隐患排查完全够用。免费版带宽约 1Mbps，文字和压缩照片上传流畅；若现场照片多且并发高，建议升级带宽。功能上免费版已支持 HTTP/HTTPS 映射、访问密码。
Q：换电脑/换网络后还能用吗？
A：花生壳域名不变，只要在新电脑装好花生壳客户端、登录同一账号、启动本地服务器，外网地址依然有效。注意：本系统数据存在浏览器本地，换电脑需先在旧电脑"后台→导出数据"，再在新电脑"后台→设置→导入备份"。
Q：二维码链接带端口号怎么办？
A：免费版外网端口可能不是 80/443（如 https://xxx.oray.net:12345）。系统会自动把端口带进二维码，手机扫码照常访问，不影响使用。
Q：能不能不用花生壳，用别的方式？
A：可以。替代方案：①cpolar（类似花生壳，有免费版）；②局域网部署（手机连公司 WiFi，访问电脑内网 IP，无需公网）；③部署到云服务器（需购买服务器+域名备案）。花生壳的优势是数据仍在本地、配置简单。