【发布】本地化部署文档与FAQ
魔点科技本地化方案部署指导手册
一、引言
本系统为网络化方案，主要同步人脸门禁机可以通过有线网线或者WIFI接入到网络并和服务端进行通讯，以实现统一化管理。本方案要求客户自行部署服务端软硬件，可以充分确保人脸及业务数据的隐私性和安全性。客户可以服务端部署在局域网内部，也可以部署到云端ECS上，具体方案根据客户自身需求灵活选择。﻿﻿
﻿
﻿﻿
﻿
注：如果只是做小规模的测试和验证，客户不需要自行部署服务端，可以使用云端demo环境，具体请联系技术支持人员
二、 服务器配置要求
﻿﻿
●CPU内存要求：最低要求4C8G，推荐8C16G，必须支持avx2指令集 (查看方式：cat /proc/cpuinfo |grep avx2)﻿﻿
●部署目录空间（默认/home）要求：不低于500G，视机构内人数、每日识别量、记录存储周期而定
三、 服务端部署
1.工具软件准备
1.xshell、xft
2.centos7环境准备
2.1下载centos7
需安装Centos 7版本，下载链接：https://mirrors.aliyun.com/centos/7.9.2009/isos/x86_64/CentOS-7-x86_64-DVD-2009.iso﻿
﻿
备注：
1.安装系统尽量不要安装图像桌面（无图像桌面更稳定）
2.语言选择英文、时区选择中国上海
3.所以操作均使用root账号权限操作
2.2连接服务器
查看服务器ip
3
ifconfig

﻿﻿
﻿
打开xshell连接服务器﻿﻿
﻿
﻿﻿
3.安装包下载
离线部署包请联系销售人员获取
4.上传并解压安装包
使用xftp将安装包上传至/home 目录下﻿﻿
﻿
﻿﻿
﻿
上传成功后，进入home目录，解压安装包
4
cd /home
tar -xvf onpremise-1.5.8-offline.tar.gz

5.开始安装
4
cd onpremise-1.5.8
sh configure.sh

--------出现Congratulations, All installations have been completed 字样表示安装成功--------
6.安装结果确认
3
netstat -tlnp

﻿﻿
﻿
如果执行结果与上图一致，则大功告成！！！系统正常工作需要使用以下端口：8023、8022、19001、22，请确保这些端口开放。
四、服务端初始化
1. 登录管理后台
在浏览器（建议使用谷歌浏览器，点击下载取件码：68qhdz）里输入 http://服务端IP:8023（IP获取方式参考上文）, 进入管理后台的登录页面。初始登录用户名/密码为：admin/admin 。﻿﻿
2. 修改登录密码
为保证您的账户安全，首次登录后必须将登录密码修改为自己指定的密码﻿﻿
3. 导入授权
在管理后台的 [机构管理] >> [基础信息] 中找到 [机构码]，将 机构码 和 邮箱地址 发送给魔点售后人员，授权码生成后会发送至指定邮箱。﻿﻿
﻿
在 [机构管理] >> [授权导入]，把收到的授权码填写对应的输入框中，并点击 [导入] 。每个授权码包含了每个服务端能接入终端的最大数目，如需扩容，则需要增加授权。﻿﻿
五、设备激活/注册
1. 硬件安装
请先按《魔点人脸门禁机施工指导手册》 ，取件码：f7pdx9，正确安装好人脸门禁机，确保电源、网络、门禁控制线都已经被正确连接。
2. 上电
设备上电后即自动开机，并执行激活流程。
3. 配置向导
3.1 语言选择
﻿﻿
﻿
系统支持多语言，目前支持中、英、日、韩、繁五种语言，可以根据实际需要选择需要的语言。
3.2 时区选择
﻿﻿
﻿
可以根据使用地的时区选择正确的时区，设备端时钟默认会与服务端保持同步。
3.3 锁类型选择
﻿﻿
﻿
如果使用继电器信号控制门锁，可以随意选择。使用魔点门禁控制板C601来控制门锁则需要根据实际使用的门锁类型正确配置，以确保门锁能正常打开。
3.4 网络配置
﻿﻿
﻿
﻿﻿
﻿
根据现场实际网络环境配置正确好网络，通常支持有线和无线连接，也支持DHCP或者手动配置。
4. 激活/填写服务端IP
﻿﻿
﻿
填写好服务端地址，即1.5中查看到的地址（切记不需要带上端口号），如果相应的IP有分配域名，此处也支持域名方式填写。如果网络被正确配置且服务端地址无误，点击“下一步”就能完成激活。
5. 设备命名
设备激活成功后，为了方便后续的管理和使用，可以给每一台设备起一个独特的名字。您也可以在管理后台相应模块对设备重新命名（支持中文，切换输入法就能输入）。﻿﻿
六、管理后台操作简要说明
1. 导航栏介绍
﻿﻿
﻿
① 机构名称：默认为测试机构，可以在“机构管理”中自行修改。② 工作台：平台开发的功能业务模块的入口都统一放在这里③ 人员管理：用于管理机构的组织架构和人员信息，人脸录入也在这里。④ 机构管理：包括了部署相关的全局信息、子管理员、授权导入等功能。⑤ 设备管理：可查看设备列表和设备信息，终端设备版本推送升级入口也在这里。⑥ 管理员菜单：包含了修改密码、绑定成员、系统设置、退出登录等入口。其中系统设备中又包含了基础设置、数据备份、系统升级、更换皮肤等功能。⑦ 界面语言：可以随时切换管理后台界面的显示语言。﻿﻿
2. 设备管理
2.1 设备列表
如图，该模块可以通过权限组、设备类型、设备型号、网络状态方便地对列表内容进行过滤，也支持通过设备名称和设备SN进行查找，点击列头可以动态地按相应列做顺/逆向进行排序。﻿﻿
﻿
列表中的操作按钮的功能分别为：远程开门、设备重启、重置数据、设备配置、解绑设备。点击列表中的设备名称，可以查看到设备信息﻿﻿
﻿
点击上图中的“设备日志”就能下载到对应设备的最新的运行日志。点击列表中的“设备配置”按钮就能进入到配置界面﻿﻿
﻿
①设备名称：此处可以直接修改设备名称。②版本信息：信息展示项③设备型号：信息展示项④音量设置：可以根据实际场景的需要在三档音量中进行选择⑤识别类型：可以在单人和多人模式中进行切换，其中单人模式默认只会识别离设备最近的一张人脸，多人模式会依次识别完画面中所有人脸。⑥活检等级：系统支持红外活体检测，有效防止使用照片、视频进行代刷脸。严格模式发现有攻击情况会将攻击目标进行识别，如果识别成功就会将列入到黑名单中并冻结30秒，属于一种主动防御的策略。适合对安全级别要求较高的客户。普通模式检测到攻击行为就不进行下一步的识别动作，适合大部分场景。极速模式不进行活体检测，可以大幅度提升系统识别速度，适合于对识别速度高且有人值守的场景。⑦识别阈值：当前版本建议阈值为80，除非特殊需要，不建议修改。⑧补光阈值：设备端是以人脸检测来唤醒，为确保能正常检测到人脸，如果场景光明度不够时设备会自动亮起补光灯，该值就是用于设备这个光照度，设置得越高，补光会越早亮起。⑨开门时长：该参数可以设置第次刷脸成功后门锁开启的时长，最长支持10秒。⑩所在权限组：在这里可以方便地把设备加入到系统已经配置好的权限组。
2.2 设备升级
﻿﻿
﻿
设备升级步骤：选择升级包→查看升级信息→选择升级设备→选择升级时间→开始升级
3. 机构管理
① 基础信息
在这里可以查看到所在机构的基本情况，包括机构名称、机构人数、部门数量，同时也提供了管理员修改密码的操作，以及管理绑定成员的操作。﻿﻿
﻿
生成APPKey功能是提供给API调用时使用，每次生成后旧的appkey就会失效，慎点！点击二维码可以放大，方便局内网环境外发机构码。
④ 子管理员
可以创建并管理子管理员，目前可以将管理员的权限按部门、设备、操作模块等维度进行限制﻿﻿
﻿
﻿﻿
4. 人员管理
在这里可以管理部门和人员，也可以通过人员大头照实现人脸的录入，同时支持批量操作，可以批量导入成员信息，也可以批量导入人脸照片，导入之前请仔细阅读界面上的操作说明，以免误操作。﻿﻿
4.1 批量添加成员
点击批量操作→批量添加成员﻿﻿
﻿
请严格按照模板格式填写人员资料﻿﻿
﻿
其中工号不能重复，不能出现中文、空格及特殊字符，部门中的“-”、“,”均为半角字符。
4.2 批量导出成员
此操作可以将已经录入的成员批量导入为excel模版文件，此操作为批量导入的逆操作，该操作支持过滤，也就是在页面上如果有选定了部门和是否上传人脸等筛选条件，所导出的人员信息就是这些条件过滤后的结果。
4.3 人脸录入
本地化方案人脸算法只在设备上有，故在服务端录入人脸之前都会被要求选择指定提供算法的设备。目前在管理后台提供了三种方式录入人脸：① 批量录入人脸﻿
﻿
文件名中请注意不能有空格，连接符必须为半角② 上传单张照片录入﻿﻿
﻿
③ 通过设备直接录入该方法最为快捷，人员在场的情况下推荐优先使用﻿﻿
5. 门禁管理
5.1 权限设置
配置好设备和人员信息后，就可以开始进行门禁管理，打开 [工作台] >> [魔点门禁]﻿﻿
﻿
你可以根据出入权限的不同设置好不同的权限组，每个权限包含了如下信息﻿
﻿
可以给每一个权限组自定义识别成功后的界面文字提示以及语音播报。动态的提示内容可以使用特殊的通配符来指代，如[name]指代人员姓名，[dep]指代部门，[sex]指代性别，[day]指代星期几，[id]指代工号，[dp]指代早上|下午|晚上 ，[memo]指代人员备注信息（此项可以用于扩展任意自定义内容），相关配置可以点行尾的“？”按钮随时查看。可以灵活地定义指定人员在指定的时间范围内允许出入哪些门禁设备。﻿﻿
﻿
﻿﻿
﻿
每个员工可以同时隶属于多个权限组，具体做开门判断时，以放行优先的原则执行。
特殊权限组说明：①默认组，系统中有且只有一个默认组，当一个权限组被指定为默认组之后，新录入的成员都将默认属于该组。②全员组，这个权限组由系统预先生成，默认包含了机构中所有的成员，且为默认组。
5.2 识别记录
系统所有的人员出入信息都会被作为识别记录保存下来，在 [魔点门禁] → [识别记录] 中可以查找、查看、导出。﻿﻿
5.3 未匹配记录
陌生人或者识别故障的情况都会被记录到[魔点门禁] → [未匹配] 中﻿﻿
5.4 报警记录
目前系统支持的告警事件有：防拆报警、火灾报警、活体攻击报警。
6. 管理员菜单
点右上角 [admin] 下拉菜单这边重点介绍“绑定成员”和“系统设置”
6.1 绑定成员
选择右上角 [admin] 下拉菜单中的 [绑定成员] ，可以将管理员账号绑定到具体的某个成员上。﻿﻿
﻿
﻿﻿
﻿
完成绑定后可以很方便通过刷脸的方式完成设备端的管理员界面。
6.2 系统设置
﻿﻿
﻿
①基础设置﻿﻿
﻿
A.识别记录存储设定﻿﻿
﻿
记录存储周期可以在一天至半年内选择。超出该周期的识别记录会被自动清除，以释放存储空间。存储状态：虚拟机硬盘是以动态分配的方式进行存储，请确保虚拟机.vmdk 文件所在盘符有足够的剩余空间。存储的使用量主要和识别记录存储的数量，可以以 50K 一条识别数据×每日产生数据条数×设定的记录存储周期来大致计算需要多少硬盘空间。系统默认的存储周期为三个月，如果需调整，请及时修改配置或者手动导出。抓拍照片可以在“小图”和“大图”两者中进行选择，示例效果如下：﻿﻿
﻿
﻿﻿
﻿
前者只保存人脸部分图像，比较节省空间，后者会保存完成场景照片，并框出识别目标人脸，同时有时间水印，比较适合实证留底。B.陌生人刷脸配置对于未被分配权限或者机构外的人员刷脸的情况，可以自定义设备界面的提示语以及语音播报的内容﻿﻿
② 数据备份﻿﻿
﻿
数据备份功能会对系统中的静态数据进行备份，系统每周会进行备份，同时保留最近的四个备份数据，也可以手动备份， 备份的数据也可以手动导出以便更好地保存。为确保您的数据安全，在进行完大批量的信息录入工作之后建议备份数据并妥善保管。系统升级时，如果有数据库方面的调整，也可以通过在这里导入脚本并执行。③ 系统升级﻿﻿
﻿
后续重大问题的修复和新功能的发布都会通过 [系统升级] 来实现。④更换皮肤﻿﻿
﻿
此模块提供了客户自主定制化界面的能力，可以实现登录界面图片、工作台功能模块的图片以及名称的替换，管理后台所有界面文字也都可以通过：下载语言包文件→修改替换指定的文字→上传语言包文件来实现灵活的修改和替换。
七、设备端操作说明
1. 登录到设备端管理界面
step1. 长按屏幕左上角（时间显示处）2 秒，进入登录界面step2. 管理员登录﻿﻿
﻿
﻿﻿
﻿
目前支持管理员刷脸（建议使用，参考前文，先完成人员绑定）和使用管理账号密码两种方式登录，登录成功后会进入到如下界面﻿
2. 设备端人脸录入
step1. 点击 [录入人脸] 。﻿﻿
﻿
step2. 输入工号查询员工。﻿
﻿
如果所输入的工号查询不到，则会弹出提示“是否新建人员”，选择“是”之后可以在设备端完成人员的新建工作step3. 点击左则“录入人脸”。﻿
3. 修改网络配置
在配置主界面点击 [配置网络] 可以切换有线或无线以及IP地址的配置。
4. 查看设备信息
在配置主界面点击 [设备信息] 可以查看到设备的主要信息。﻿﻿
5. 设备解绑
如果需要更换服务端，需要对设备进行解绑操作。在设备信息界面下方，点击 [解绑并重置] ，此操作为应急功能，会单向强制清除激活信息。建议的解绑操作是在设备在线的情况下，到管理后台的设备列表中删除设备。
八、版本升级操作说明
1. 设备升级
[管理后台] >> [设备管理] >> [设备升级] >> [选择升级包]﻿﻿
﻿
版本信息﻿
﻿
选择需要升级的设备﻿﻿
﻿
选择升级时间﻿﻿
﻿
查看升级结果﻿﻿
﻿
升级过程中请确保设备不要断电断网，升级完成之后设备会重启。
2. 服务端升级
(1) 数据库升级
右上角 [admin] >> [系统设置]﻿﻿
﻿
点击上传升级包，选择升级使用的数据包。﻿﻿
﻿
上传之后执行即完成。
(2) 服务程序升级
切换到 [系统升级] >> [导入数据升级包]﻿﻿
﻿
点第一条数据包记录中的 [升级至该版本]﻿﻿
﻿
升级后服务端会重启，并要求重新登录，升级完成。
九、FAQ
9.1服务端部署完毕，web管理后台也能正常，但设备就是无法激活？
①在宿主机上执行ping指令尝试ping设备IP，查看是否能ping通，如果ping不通，请确保设备的网络已经被正确配置，并于宿主机处于同一局域网络，并确认路由及防火墙配置。②确保以下端口在宿主机上正常开放，且无端口占用：8022、19001。端口占用检查方法如下在windows命令行窗口下(运行→cmd)执行：A.查看所有的端口占用情况
20
C:\>netstat -ano

活动连接

  协议  本地地址          外部地址        状态           PID
  TCP    192.168.1.150:139      0.0.0.0:0              LISTENING       4
  TCP    192.168.1.150:8022     192.168.9.227:47970    ESTABLISHED     5996
  TCP    192.168.1.150:8023     192.168.1.235:60837    ESTABLISHED     5996
  TCP    192.168.1.150:19001    192.168.9.227:47965    ESTABLISHED     5996
  TCP    192.168.1.150:50028    203.119.204.187:443    ESTABLISHED     2736
  TCP    192.168.1.150:52870    42.156.235.98:443      ESTABLISHED     2736
  TCP    192.168.1.150:52925    42.156.235.98:443      ESTABLISHED     2736
  TCP    192.168.1.150:53388    52.139.250.253:443     ESTABLISHED     3736
  TCP    192.168.1.150:53517    103.252.250.50:8023    ESTABLISHED     5072
  TCP    192.168.1.150:54605    180.163.44.27:443      CLOSE_WAIT      2736
  TCP    192.168.1.150:54992    52.114.77.34:443       ESTABLISHED     3952
  TCP    192.168.1.150:55293    122.225.67.222:443     ESTABLISHED     5072


B. 查看指定端口的占用情况
6
C:\>netstat -ano|findstr "8022"
  TCP    0.0.0.0:8022           0.0.0.0:0              LISTENING       5996
  TCP    192.168.1.150:8022     192.168.9.227:47970    ESTABLISHED     5996


P: 看到了吗，端口被进程号为5996的进程占用，继续执行下面命令： （也可以去任务管理器中查看pid对应的进程）C. 查看PID对应的进程
5
C:\>tasklist|findstr "5996"
VBoxHeadless.exe              5996 Console                   10     96,840 K


P:如果对应端口使用的只有一个进程，且该进程对应的进程是VBoxHeadless.exe则配置是正确的。
9.2如何获取设备运行日志?
[管理后台] >> [设备管理] >> 点击列表中的设备名称 >> [设备日志]﻿﻿
﻿
﻿﻿
9.3如何获取系统运行日志?
在浏览器地址栏输入以下地址运行日志：http://server_ip:8023/onpremiselogs/on-premise.log错误日志：http://server_ip:8023/onpremiselogs/on-premise-error.logserver_ip为部署的服务端IP地址。
9.4如何重启前后端服务?
前端重启
2
pm2 restart /home/mdapp/onpremise-node/server/deploy/pro.json
注意：pm2和restart后面都有一个空格；
后端重启
2
/home/mdapp/onpremise-frontend/bin/server.sh restart
注意：server.sh后面都有一个空格；
9.5本地化部署的CenOS7虚拟机密码忘记怎么办？
故障现象：本地化后台无法登录，但是排查问题的CentOS7的虚拟机的密码又忘记了
解决方案：修改虚拟机的登录密码（根据系统的类型选择不同的方式），方式如下：
参考文档：
﻿Centos7重置root密码 - 龙骑科技 - 博客园 (cnblogs.com)﻿
﻿(301条消息) CentOS8重置root密码_junltianx79的博客-CSDN博客﻿
步骤如下：
Centos7重置root密码
1、启动Linux Centos7系统，当出现如下画面时，直接按“e”键继续。
﻿﻿
2、按向下箭头，一直下滑直至看到如下界面
﻿﻿
3、在如下截图的位置，添加“rw single init=/bin/bash”，添加后按“Ctrl + x”引导系统。
﻿﻿
4、在如下截图位置，即可输入“自定义新密码”来重置root密码了。
﻿﻿
5、运行命令“exec /sbin/init”来正常启动系统，需要输入修改后的root密码。
﻿﻿
6、进入系统后，输入命令“reboot”即可重启系统，重启之后输入用户名和修改以后的密码即可正常进入了。
﻿
9.6登录时出现“参数错误，登录时间超时”的错误提示如何处理？
﻿﻿
出现“参数错误，登录时间超时”的错误提示，请优先排查确认一下两个点：
1、服务器时间是否和北京时间一致；
2、电脑端的时间是否和北京时间一致；
相关的命令如下：
﻿﻿
﻿
9.7登录管理后台时提示“服务调用失败”的错误如何处理？
﻿﻿
出现如上的错误可能是服务启动异常，需要排查服务器的服务是否正常，虚拟机终端命令行中执行如下命令看是否可以恢复正常：
/home/mdapp/onpremise-frontend/bin/server.sh restart
注意：上面命令的server.sh和restart之间有个空格；
9.8提示“设备接入数量已达授权上限，无法继续接入”的提示如何处理？
﻿﻿
激活设备的时候如果提示：设备接入数量已达授权上限，无法继续接入（如上图）；
出现这样的情况的原因是本地化部署时，允许的授权的数量是有限制的，如果超过这个限制，再去激活设备就会弹出这个提示语；如需额外激活更多数量的设备，需要联系魔点的销售人员对接，购买额外的授权；
9.9提示“成员底库照片录入失败，请稍候重试”的错误如何处理？
﻿﻿
使用df -h命令，如果服务器空间满了，会出现照片无法录入的问题，解决方式如下：
释放空间第一步：
若/home 磁盘写满，需要清理磁盘空间，本地化相关的可以删除两个路径的文件如下：
cd /home/webroot/apk   
进入到/home/webroot/apk路径后，执行如下命令（注意一定确保是进入到这个目录，以免勿删系统文件导致本地化系统无法启动的故障）：
rm -rf * 
cd /home/webroot/onpremiselogs  
进入到/home/webroot/onpremiselogs  路径后，执行如下命令（注意一定确保是进入到这个目录，以免勿删系统文件导致本地化系统无法启动的故障）：
rm -rf * 
释放空间第二步（用于防止系统运行过程中未来占用过多的空间）：
尽量把记录存储周期缩短，特别是照片周期，照片占用空间较大，设置方式如下
﻿﻿
释放空间第三步（适用于第一步释放空间后还是不够多的情况）：
cd进入到home盘，通过命令du -h排查发现home盘里的mdapp目录占用是否非常大，如果大于5G，再输入如下的命令：du -h  /home/mdapp/onpremise-frontend/logs/server.out，如果查到server.out 的文件同样很大，则可以通过处理该文件进行空间释放；处理方式如下：
重启后端服务： /home/mdapp/onpremise-frontend/bin/server.sh restart
注意：不要直接reboot重启服务器，直接重启服务器可能会导致该文件重启后不生成，影响系统正常运行。
若清理后空间仍不足，则需要服务器进行扩容了，建议500G
9.10设备激活时候提示激活失败，提示“failed to connect to /XX.XX.XX.XX...”如何处理？
故障现象：设备激活时候提示激活失败，提示“failed to connect to /XX.XX.XX.XX...”
原因定位：设备激活的时候需要设备的网络和本地化虚拟机服务器的网络在一个网段中，否则激活的时候会出现此问题。
﻿﻿
解决方案：确保设备连接的网络和本地化虚拟机服务器的网络在一个网段中
﻿
9.11本地化后台显示的设备激活成功就离线的问题如何处理？
故障现象：本地化后台显示的设备激活成功就离线，其中一种可能是服务器开启了防火墙，外部访问19001端口被拦截
解决方案：放开防火墙对19001端口的限制后看问题是否解决
9.12如何查看本地化服务端版本号？
登录本地化后台后，admin处->系统设置->系统升级页面，查看右上角的服务端版本号即可；
﻿﻿
9.13同源私有化的本地化方案的删除日志目录和启动服务方式是什么？
删除日志目录：
cd  home/moredian/localcloud/logs
rm -rf *
启动服务方式：
systemctl start localcloud
﻿