在电竞酒店和网咖里,“实名登记”四个字几乎人人都听过,但真正做到位的门店并不多。更常见的情况是:前台核对一下身份证、在本子上抄下姓名和证件号、客人上机。这套流程有两个天然漏洞——证件可能是别人的,人也可能根本不在现场。一旦遇到检查,台账和实际在线机位对不上,门店很难自证清白。
玩哈哈的客户机实名核验(活体检测 + 人证核验)不是给前台加一个登记表单,而是把“证是本人的、人是活的、人在这一台机器前”这三件事,变成客户机解锁前必须通过的技术条件。本文按实际产品界面与判定逻辑,完整拆解这套功能。
一、两条硬约束:实名登记与未成年人保护
《互联网上网服务营业场所管理条例》对上网服务营业场所提出了两项基础要求:一是上网消费者应当出示有效身份证件并进行登记,二是未成年人不得进入营业场所上网。这两条不是“建议”,而是门店经营资质的底线。
问题在于,传统人工登记只能证明“有人出示了一张证件”,无法证明三件事:
- 证件与本人一致——代刷、借用、冒用他人证件非常常见;
- 本人在现场——把身份证照片发给别人、由他人代刷,人工核验几乎无法识别;
- 人与机位对应——登记在 8306 房,人却坐在 8418 房,检查时无法对应。
所以电子实名核验要解决的问题可以浓缩成一句话:把“人、证、机位、时间”四个要素绑在一次会话上,并留下可校验的记录。
二、功能全景:四端协同,而不是一个弹窗
这套功能由四个界面协同完成,任何一端都不是孤立的:
- 客户机锁屏端:客人开机后先看到核验页,展示房间号、客户机编号、二维码与倒计时,未通过核验不解锁;
- 手机 H5 核验端:扫码后在手机上完成摄像头活体采集、填写姓名与证件号、提交核验;
- 管理台:核验策略配置、客户机绑定、会话查询、审计日志校验与导出、上网日志与行为日志查询;
- PMS 与内网回写:PMS 联动模式下校验在住客人;云端产生的核验日志可按可靠队列回写到内网服务端。

锁屏页把关键信息压缩在一屏内:客人扫二维码就走手机流程;手机不方便时,也可以点“本机摄像头核验”,在客户机上直接完成。页面右侧列出五步核验流程与法规依据,目的是让客人知道“为什么必须核验”,减少前台解释成本。
三、一次核验会话要过八道关卡
很多同类产品把核验做成“上传一张身份证照片 + 一次人脸比对”,中间缺少约束。这套功能的判定是串行的,任何一个环节不通过都会中断并记录原因,顺序如下。
第 1 关:证件格式与出生日期校验
18 位身份证号会做长度、字符、出生日期与校验位验证(GB 11643 的加权因子与校验码表)。格式不合法直接拒绝,不进入后续活体调用——这既保证数据质量,也避免为无效请求付费调用第三方接口。
第 2 关:未成年人拦截(先于活体)
年龄由身份证出生日期解析得出,与配置的年龄线(默认 18 周岁,可设 16~18)比较。低于年龄线时,会话状态直接置为“已拦截”,客户机保持锁定,同时写入一条 MinorBlock 审计事件。
把未成年人判定放在活体检测之前是有意设计:未成年人不允许上网,就没必要再采集人脸、调用比对接口,既省成本,也减少不必要的个人信息处理。
第 3 关:人机绑定
客户机首次启动会自动注册,生成客户机编号与设备令牌;管理员在管理台把它绑定到具体房间。没有绑定房间的机器,核验会被拒绝并提示“请联系前台”。这一关确保“核验通过的机器”就是“该房间的那台机器”。
第 4 关:住客证件匹配(仅 PMS 联动模式)
在电竞酒店场景,系统会检查该房间是否存在状态为“已入住”且证件号一致的预订记录。也就是说,客人不仅要是本人,还得确实是这个房间的在住客人。独立部署模式下这一关自动跳过,因为第三方无盘环境没有 PMS 登记数据。
第 5 关:一人一机
同一证件在 24 小时内若已在其他客户机核验通过且会话未结束,本次核验会被拒绝。这条规则堵住了“一个人核验完,换台机器继续上”的常见漏洞。
第 6 关:活体检测
手机端会依次提示“请正对镜头”“请缓慢眨眼”“请缓慢左右转头”“请保持不动”,用一段连续动作确认屏幕前是活人而不是一张照片。采集只允许摄像头现场拍摄,接口参数里的采集来源必须是 camera,任何本地上传都会被服务端拒绝并记一条 CaptureSource 拦截事件。

采集完成后,人脸照片单独存证,页面上出现“重新采集”入口,避免客人闭眼、逆光导致照片质量不佳时无法补救。
第 7 关:人证 1:1 比对
除了现场人脸,还需要用摄像头拍摄身份证人像面,两者做 1:1 比对。比对相似度阈值默认为 60 分(0~100),低于阈值判定不通过。之所以要求拍身份证人像面,是因为只比对“现场人脸与证件号”无法证明证件真伪,只有“现场人脸 ↔ 证件照片”的比对才构成人证合一。

提交前有几项前置校验:姓名不能为空、证件号必须是 18 位、必须已完成现场人脸采集、勾选协议。协议文本明确告知信息用途,并提示未成年人禁止进入营业场所上网,这一步对应个人信息处理中的“告知—同意”。
第 8 关:解锁并留痕
全部通过后,会话状态置为“核验通过”,客户机解除锁定;系统同时写入 Verified 与 Unlock 两条审计事件。客人在手机上看到的是一张结果页,包含姓名(脱敏)、证件号(脱敏)、年龄与核验渠道。

如果中途失败,会话不会立刻作废:同一会话最多允许 3 次尝试,失败时提示“剩余 N 次机会”;累计 3 次失败后状态转为“未通过”,需要前台介入重新发起。这个设计兼顾了体验(光线不好可以重试)与安全(不能无限试错)。
四、活体检测:判定标准与常见攻击面
正式环境推荐使用阿里云视觉智能开放平台的两项能力:DetectLivingFace 做人脸活体检测,CompareFace 做人证 1:1 比对。配置上只需填写接入点(默认 facebody.cn-shanghai.aliyuncs.com)、AccessKeyId 与 AccessKeySecret,并在平台侧开通对应能力。
活体结果的判定不是简单看分值:接口返回的 Suggestion 与 Label 中,只要建议为 block,或标签包含 spoof(攻击/翻拍),就判定为不通过。这样能覆盖打印照片、屏幕翻拍、面具等常见攻击方式。
需要强调的是,活体检测与密码学意义上的“身份认证”不同:它证明的是镜头前是一个真实活人,而不是证明“这个活人就是证件上的那个人”。后者由人证 1:1 比对完成,两者缺一不可。
五、人证比对阈值 60 分:分数只是必要条件
CompareFace 返回的 Confidence 是 0~100 的相似度,系统以 60 为通过线。阈值不宜盲目调高:光线、角度、证件照片清晰度都会影响分数,阈值过高会导致大量正常客人反复失败;也不宜调低,否则冒用风险上升。60 是一个在实测中兼顾通过率与安全性的起点。
更重要的是明白:比对通过不等于核验通过。一次核验最终是否放行,还取决于证件格式、未成年人拦截、人机绑定、住客匹配、一人一机这些关卡。反过来,任何一关失败都不需要用“分数很高”来抵消。
如果使用 Mock 渠道(仅用于内网联调),系统只校验证件格式并保存人脸照片,结果会明确标记为“模拟”并写入审计链。正式营业必须配置具备资质的实人认证服务,否则活体与人证比对不会产生真实结论——这一点在管理台说明里也做了醒目提示。
六、人机绑定与设备令牌:让“这台机器”可被识别
客户机首次启动时,客户端会采集机器指纹(MAC 地址、主机名与系统 MachineGuid 组合后哈希)向服务端注册,服务端返回客户机编号与设备令牌;后续所有客户端接口都通过请求头 X-Device-Token 鉴权。这一步让服务端能确认请求来自“某台已注册的机器”,而不是任意脚本。

绑定动作由前台或网管在管理台完成。PMS 联动模式下,绑定的房间必须真实存在于房态表;独立部署模式下,房间号只作为机位标识,允许自由填写。设备被停用后,该机无法完成核验解锁,适合处理维修机、待报废机。
“一人一机”规则依赖的正是这套设备标识:同一证件在其他设备上已有未结束的通过会话,就会被拒绝。它不需要额外的人脸库,也不会把不同门店的数据混在一起。
七、未成年人拦截:从“口头劝离”到“系统不放行”
未成年人保护的关键不是贴一张“未成年人禁止入内”的告示,而是让系统在技术上无法放行。这里的做法是:年龄由证件号解析,低于年龄线时立即拦截并保持锁屏,同时记录拦截原因(年龄、房间、设备、时间)。
管理台可以把年龄线设为 16~18 岁之间的值,用于适配不同地区更严格的属地要求。被拦截的会话会以红色标签出现在会话列表中,前台可以据此快速定位并处理。
需要提醒的是:拦截不等于“拒绝服务”。前台仍可以按当地规定进行劝离、联系监护人等线下处置,系统只负责把“不能上网”这件事变成不可绕过的技术条件。
八、两种部署模式:PMS 联动与独立部署
同一套核验能力,面向两类完全不同的环境:
- PMS 联动模式:用于本系统管理的电竞酒店,可校验房间是否存在、证件是否与在住客人一致,核验结果与房态、账单同源;
- 独立部署模式:用于第三方无盘系统(如网维大师等)或纯网咖环境,完全脱离本 PMS,客人身份由本机采集 + 活体核验确定,房间号仅作机位标识。两种模式的核验、日志、审计、导出能力完全一致。
两种模式下,手机扫码都需要一个公网可访问的域名(默认 https://led.wanhaha.com,可带端口)。这是因为二维码是在客户端生成的,手机必须能打开它;用内网 IP 生成的二维码,客人手机往往打不开。多门店场景还要配置酒店编码,核验请求会携带酒店编码与房间号,并与会话校验一致,不一致会被拦截并记录 HotelMismatch/RoomMismatch 事件。

如果采用“云端核验 + 内网留存”的架构,可以在配置里填写内网人证服务端地址与回写密钥。云端产生的登录人证日志(核验通过、未成年人拦截、暗码退出等)会进入可靠队列,投递到内网的 /api/realname/ingest/audit,失败自动退避重试,并按外部引用去重,避免重复入库。
九、管理台:五个页签覆盖日常运营
管理台采用独立的深色界面,登录需要管理密钥(请求头 X-Admin-Key,默认 admin123456,可用环境变量 REALNAME_ADMIN_KEY 覆盖)。五个页签分别对应五类日常工作。
核验配置
11 个策略开关覆盖总开关、活体检测、人证比对、人机绑定、住客证件校验、未成年人拦截、一人一机、电脑端核验、手机扫码、独立部署、公安上报;下方是年龄线、会话有效期(默认 10 分钟)、日志留存(不低于 180 天)、核验渠道与各类密钥。页签底部直接给出阿里云对接、云端二维码与内网回写的配置说明,减少“配了但不知道怎么配”的情况。
客户机绑定
列出全部已注册客户机,支持按需刷新、绑定房间与停用。未绑定房间的机器会带醒目标记,避免出现“机器注册了但没人管”的灰色地带。
核验会话
按状态、房间号、证件号检索每一次核验会话,展示会话号、房间、客户机、姓名、脱敏证件号、年龄、核验方式(电脑端/手机扫码)、状态与开始时间。

这张表是日常排查的第一入口:客人说“我明明核验了”,先看会话状态;前台说“这台机器老是过不了”,先看该设备的失败记录与失败原因。
审计日志与导出
审计日志采用哈希链结构:每条记录保存前一条的哈希,并以固定字段顺序计算 SHA256,形成只追加、不可修改的证据链。任何一条被改动,链校验都会在对应序号处报错。

页面提供“校验审计链”按钮,返回校验条数与断链位置;导出 CSV 为 UTF-8 BOM 编码,包含前序哈希与本条哈希两列,可直接用于公安检查或内部审计。导出动作本身也会写入一条 Export 审计事件,谁在什么时间导出了多少条,同样留痕。
上网日志与行为日志
上网日志由客户机读取本机 Edge、Chrome、360、QQ 浏览器与 Firefox 的历史库后上报,按房间、设备、姓名、证件、浏览器、网址与标题展示;行为日志基于前台应用与窗口使用片段,区分浏览器与应用。两类日志都与实名会话关联,回答“这个证件对应的机器,什么时候访问了什么”。

这类日志的价值不在于“监控”,而在于出问题时可追溯:比如某房间出现异常访问,能快速定位到具体时段与具体证件;比如检查要求提供某段时间的上网记录,可以直接按时间范围导出。
十、日志留存与隐私合规
实名核验天然涉及个人信息,因此这套功能在数据侧做了几件事:
- 最低留存 180 天:清理任务会把留存天数强制抬到不低于 180 天,低于该值的配置不会生效;
- 清理有边界:会话、过程记录与审计日志按保留期清理,而按天追加的文件日志(logs/realname/日期.jsonl)不自动删除,便于长期留档;
- 展示脱敏:列表与结果页只展示脱敏证件号(保留前 6 位与后 4 位),完整证件号仅用于核验判定与审计导出;
- 照片单独存证:现场人脸与身份证人像面分别保存,路径写入会话,便于核查时调取;
- 告知与同意:提交前必须勾选实名上网登记协议,明确信息用途与未成年人禁入规则。
这些措施对应《个人信息保护法》的最小必要、告知同意与留存期限要求。对门店来说,最实际的好处是:面对检查时,能拿出结构完整、可校验、可导出的记录,而不是一摞手写登记本。
十一、常见问题与排障
- 手机扫不开二维码:先检查“二维码公网域名”是否为公网可访问地址,内网 IP 或未备案域名在手机上都打不开;带非标准端口时要写全端口。
- 提示摄像头不可用:手机端必须使用 HTTPS 才能调用摄像头;电脑端要确认浏览器已授权摄像头权限,可点“重新启用摄像头”重试。
- 提示需要拍摄身份证人像面:启用了人证 1:1 比对时,必须用摄像头现场拍摄证件人像面,本地照片无法通过。
- 客人反复失败:先看会话详情里的失败原因。活体失败多为逆光、遮挡、戴帽子;比对失败多为证件照片磨损或拍摄角度过大。同一会话最多 3 次机会。
- 提示“该证件已在其他客户机登录”:触发了“一人一机”,需先让旧会话结束(下机或前台强制退出)再重试。
- 机器无法解锁且无法核验:检查该客户机是否已绑定房间、是否被停用;锁屏页右上角连点 5 下可触发管理员暗码退出,用于应急处理。
- 二维码过期:会话默认 10 分钟有效,超时后需在客户机上重新发起;有效期可在配置中调整(2~60 分钟)。
- Mock 渠道能通过但不算真实核验:Mock 仅用于联调,结果标记为模拟;正式营业请切换到阿里云或腾讯云渠道,并完成资质与密钥配置。
十二、上线检查清单
- 在管理台开启实名核验总开关,并按门店要求配置活体、人证比对、未成年人拦截等策略;
- 确认核验渠道为具备资质的实人认证服务,密钥可用、接口可通;
- 配置公网可访问的二维码域名,手机实测能打开核验页;
- 为全部客户机完成注册与房间绑定,清理长期未绑定的“孤儿机”;
- PMS 联动模式下确认房态与在住登记准确,避免“房间存在但客人未登记”导致误拦;
- 独立部署模式确认房间号命名规则,保证机位可辨识;
- 在前台张贴核验说明,培训员工处理失败重试、强制退出与未成年人拦截;
- 确认日志留存天数不低于 180 天,磁盘空间足够,定期执行审计链校验;
- 按需配置内网回写地址与密钥,验证回写队列无堆积;
- 上线首周每天抽查会话与审计记录,确认“会话—设备—房间—证件”四者一致。
实名核验做得好不好,标准不是“有没有这个功能”,而是能不能在关键时刻证明:这个人在这个时间、坐在这个房间的这台机器前,用的是他自己的证件。把八道关卡、设备绑定、审计哈希链和 180 天留存串起来,这套功能才算真正落地。