门禁标品配置项文档（DejaOS版本）

<span id=category></span>
## 人脸配置（face）

| 配置项               | 类型   | 默认值                   | 说明                                |
| -------------------- | ------ | ------------------------ | ----------------------------------- |
| `face.similarity`        | Int | 0.5    | 人脸识别相似度 （范围0-1）            |
| `face.livenessOff`       | Int | 1  | 活体检测 1 开 0 关       |
| `face.livenessVal`         | Int | 5  | 活体检测阈值 （范围0-10）    |
| `face.showNir` | Int | 0  | 红外框 1 开 0 关 默认关     |
| `face.stranger` | Int | 1 | 未注册人脸提示 0:"无语音", 1:"播放请先注册", 2:"播放陌生人你好"       |
| `face.voiceMode` | Int | 1   | 识别成功后播放语音 0:"无语音",1:"播放名字", 2:"播放问候语"  |
| `face.voiceModeDate` | String | "欢迎光临"    | 问候语内容   |

## MQTT配置（mqtt）

| 配置项                  | 类型   | 默认值                        | 说明                  |
| ----------------------- | ------ | ----------------------------- | --------------------- |
| `mqtt.addr`     | String | "mqtt://192.168.10.202:1883" | mqtt地址 (格式为 mqtt://192.168.1.1:1883)   |
| `mqtt.clientId`     | String | ""                            | MQTT 客户端 ID，默认为设备序列号，传空```""``` 将恢复默认        |
| `mqtt.clientIdSuffix`     | Int | 0 | clientId后是否要加三位随机数  (0:否, 1:是)       |
| `mqtt.qos`          | Int | 1      | QoS0，At most once，至多一次 QoS1，At least once，至少一次 QoS2，Exactly once，确保只有一次 (可选 0, 1, 2)    |
| `mqtt.username`    | String | ""  | mqtt 账号     |
| `mqtt.password`     | String | ""  | mqtt 密码    |
| `mqtt.prefix`    | String | ""     | MQTT 订阅主题的前缀    |
| `mqtt.onlinecheck`    | Int | 0    | 在线验证开关 1 先走离线，失败再走在线验证 0 只走离线    |
| `mqtt.timeout`    | Int | 5   | 在线验证超时时间，单位 s    |
| `mqtt.willTopic`    | String | "access_device/v2/event/offline"  | 遗嘱 设备断开连接自动发送    |

[回到顶部](#category)

## 网络配置（net）

| 配置项                         | 类型   | 默认值 | 说明                                    |
| ------------------------------ | ------ | ------ | --------------------------------------- |
| `net.type`                 | Int | 1      | 网络类型 (1:以太网, 2:WiFi)       |
| `net.dhcp`                 | Int | 2     | dhcp为1：自定义网络配置，即手动设置静态IP，ip、gateway、subnetMask、dns必须传入且不可为空；dhcp为2：设备配置为 DHCP 模式，自动获取动态 IP，无须传入其余参数         |
| `net.ip`                   | String | ""     | IP 地址        |
| `net.gateway`              | String | ""     | 网关地址                                |
| `net.mask`           | String | ""     | 子网掩码                                |
| `net.dns`                  | String | ""     | DNS 服务器                              |
| `net.mac`               | String | ""     | 网络 MAC 地址                           |
| `net.ssid` | String | ""    | type传入2：设备使用WiFi连接，ssid、pwd参数必须传入且不可为空 |
| `net.psk`  | String | "" | type传入2：设备使用WiFi连接，ssid、pwd参数必须传入且不可为空 |

[回到顶部](#category)

## 时钟配置（ntp）

| 配置项                 | 类型   | 默认值         | 说明                              |
| ---------------------- | ------ | -------------- | --------------------------------- |
| `ntp.ntp`          | Int | 1   | 0固定时间间隔同步，1定时同步 |
| `ntp.server`      | String | "182.92.12.11" | ntp对时服务器ip      |
| `ntp.hour`      | Int | 3    | 定时同步，24小时制    |
| `ntp.gmt` | Int | 8              | 时区 中国为 8        |
| `ntp.timeZone` | String | Asia/Shanghai      | 时区    |

## 通行配置（access）
 
 | 配置项                  | 类型   | 默认值 | 说明                               |
| ----------------------- | ------ | ------ | ---------------------------------- |
| `access.offlineAccessNum`  | Int | 2000     | 通行记录存储最大数量   |
| `access.relayTime`   | Int | 3    | 继电器打开时长，单位s  |
| `access.fire`  | Int | 0    | 火警开关 1:开 0:关   |
| `access.fireStatus` | Int | 0     | 火警状态 1:预警 0:正常|
| `access.tamper`  | Int | 0 | 防拆报警开关 1开 0 关      |

## 基础配置（base）

| 配置项                      | 类型   | 默认值 | 说明                                      |
| --------------------------- | ------ | ------ | ----------------------------------------- |
| `base.language`         | String | "CN"   | 语言 EN英文CN中文 |
| `base.password`         | String | "password"   | 进入后台密码     |
| `base.firstLogin`      | Int | 0    | 是否第一次登录后台 0 未登录 1 已登录（不可修改）   |
| `base.screenOff`      | Int | 0      | 熄屏时间，单位分钟，0从不    |
| `base.screensaver` | Int | 0   | 屏幕保护，单位分钟，0从不   |
| `base.brightness` | Int | 70   |白色补光灯亮度 ： 0-100  |
| `base.volume` | Int | 10   | 喇叭音量：0-10  |
| `base.showIp` | Int | 1   | 是否显示 ip 1显示 0 隐藏  |
| `base.showSn` | Int | 1   | 是否显示 sn 1显示 0 隐藏   |
| `base.showProgramCode` | Int | 1   | 小程序码 显示 1 显示 0 隐藏  |
| `base.appMode` | Int | 1   | 0: 标准模式 1: 简约模式  |
| `base.backlight` | Int | 70   |屏幕背光：0-100   |

## 系统配置（sys）

| 配置项                      | 类型   | 默认值 | 说明                                      |
| --------------------------- | ------ | ------ | ----------------------------------------- |
| `sys.mac`         | String | ""   | mac地址，不可修改 |
| `sys.uuid`         | String | ""   | UUID，不可修改     |
| `sys.sn`      | String | ""    | 设备sn，不可修改   |
| `sys.model`      | String | ""  | 设备型号，不可修改    |
| `sys.version` | String | ""    | 版本号，不可修改   |
| `sys.appVersion` | String | ""    |固件版本号，不可修改  |
| `sys.releaseTime` | String | ""    | 更新时间，不可修改  |
| `sys.heart_en` | Int | 1   | 心跳1开 0 关  |
| `sys.heart_time` | Int | 30   | 心跳间隔，单位s   |
| `sys.nfc` | Int | 1   |刷卡开关 1开 0 关   |
| `sys.pwd` | Int | 1   |密码开门开关 1开 0 关   |
| `sys.strangerImage` | Int | 1   |陌生人保存图片开关 1开 0 关   |
| `sys.nfcIdentityCardEnable` | Int | 1   |云证开关 3:云证获取 1:物理卡号   |
| `sys.scanInterval` | Int | 1   | 扫码间隔，单位s   |

## 扫码配置项映射表

### 人脸配置
| 扫码配置项                 | 系统配置项                         | 说明            |
| -------------------------- | ---------------------------------- | --------------- |
| `similarity`      | `face.similarity`    | 人脸识别相似度 （范围0-1）        |
| `livenessOff`   | `face.livenessOff`    | 活体检测 1 开 0 关        |
| `livenessVal`      | `face.livenessVal`  | 活体检测阈值 （范围0-10）        |
| `showNir`     | `face.showNir`   | 红外框 1 开 0 关 默认关     |
| `stranger`       | `face.stranger`    | 未注册人脸提示 0:"无语音", 1:"播放请先注册", 2:"播放陌生人你好"        |
| `voiceMode`   | `face.voiceMode`                 | 识别成功后播放语音 0:"无语音",1:"播放名字", 2:"播放问候语"    |
| `voiceModeDate`      | `face.voiceModeDate`               | 问候语内容      |

[回到顶部](#category)

### MQTT配置
| 扫码配置项                 | 系统配置项                         | 说明            |
| -------------------------- | ---------------------------------- | --------------- |
| `addr`  | `mqtt.addr`      | mqtt地址 (格式为 mqtt://192.168.1.1:1883) |
| `clientId`     | `mqtt.clientId`     | MQTT 客户端 ID，默认为设备序列号，传空"" 将恢复默认      |
| `clientIdSuffix`   | `mqtt.clientIdSuffix`    | clientId后是否要加三位随机数 (0:否, 1:是)      |
| `mqttqos`   | `mqtt.qos`   | QoS0，At most once，至多一次 QoS1，At least once，至少一次 QoS2，Exactly once，确保只有一次 (可选 0, 1, 2)   |
| `mqttusername`   | `mqtt.username`  | mqtt 账号      |
| `mqttpassword`    | `mqtt.password`   | mqtt 密码    |
| `mqttprefix`  | `mqtt.prefix`  | MQTT 订阅主题的前缀    |
| `onlinecheck`    | `mqtt.onlinecheck`   | 在线验证开关 1 先走离线，失败再走在线验证 0 只走离线     |
| `timeout`    | `mqtt.timeout`                   | 在线验证超时时间，单位 s     |
| `willTopic`  | `mqtt.willTopic`     | 遗嘱 设备断开连接自动发送  |

### 网络配置
| 扫码配置项                 | 系统配置项                         | 说明            |
| -------------------------- | ---------------------------------- | --------------- |
| `type` | `net.type` | 网络类型 (1:以太网, 2:WiFi) |
| `dhcp`  | `net.dhcp` | dhcp为1：自定义网络配置，即手动设置静态IP，ip、gateway、subnetMask、dns必须传入且不可为空；dhcp为2：设备配置为 DHCP 模式，自动获取动态 IP，无须传入其余参数  |
| `ip`  | `net.ip`      | IP 地址       |
| `gateway`  | `net.gateway`   | 网关地址   |
| `mask`   | `net.mask`     | 子网掩码   |
| `dns`  | `net.dns`   | DNS 服务器  |
| `mac`    | `net.mac`    | 网络 MAC 地址  |
| `ssid`    | `net.ssid`  | type传入2：设备使用WiFi连接，ssid、pwd参数必须传入且不可为空        |
| `psk`   | `net.psk`  | type传入2：设备使用WiFi连接，ssid、pwd参数必须传入且不可为空       |

### 时钟配置
| 扫码配置项                 | 系统配置项                         | 说明            |
| -------------------------- | ---------------------------------- | --------------- |
| `ntp`                  | `ntp.ntp`                   | 0固定时间间隔同步，1定时同步     |
| `server`                  | `ntp.server`                   | ntp对时服务器ip    |
| `hour`               | `ntp.hour`                | 定时同步，24小时制   |
| `gmt`           | `ntp.gmt`            | 时区 中国为 8   |
| `timeZone`           | `ntp.timeZone`            | 时区   |

[回到顶部](#category)

### 通行配置
| 扫码配置项                 | 系统配置项                         | 说明            |
| -------------------------- | ---------------------------------- | --------------- |
| `offlineAccessNum`                 | `access.offlineAccessNum`                | 通行记录存储最大数量      |
| `relayTime`                 | `access.relayTime`                | 继电器打开时长，单位s   |
| `fire`              | `access.fire`             | 火警开关 1:开 0:关     |
| `fireStatus`              | `access.fireStatus`             | 火警状态 1:预警 0:正常        |
| `tamper`            | `access.tamper`                 | 防拆报警开关 1开 0 关   |

### 基础配置
| 扫码配置项                 | 系统配置项                         | 说明            |
| -------------------------- | ---------------------------------- | --------------- |
| `language`                  | `base.language`                 | 语言 EN英文CN中文       |
| `password`                   | `base.password`                   | 进入后台密码      |
| `screenOff`                 | `base.screenOff`                | 熄屏时间，单位分钟，0从不       |
| `screensaver`                 | `base.screensaver`                | 屏幕保护，单位分钟，0从不   |
| `brightness`                 | `base.brightness`                | 白色补光灯亮度 ： 0-100       |
| `volume`                 | `base.volume`                | 喇叭音量：0-10    |
| `showIp`                 | `base.showIp`                | 是否显示 ip 1显示 0 隐藏       |
| `showSn`                 | `base.showSn`                | 是否显示 sn 1显示 0 隐藏       |
| `showProgramCode`                 | `base.showProgramCode`                | 小程序码 显示 1 显示 0 隐藏       |
| `appMode`                 | `base.appMode`                | 0: 标准模式 1: 简约模式       |
| `backlight`                 | `base.backlight`                | 屏幕背光：0-100   |

### 系统配置
| 扫码配置项                 | 系统配置项                         | 说明            |
| -------------------------- | ---------------------------------- | --------------- |
| `heart_en`                      | `sys.heart_en`                      | 心跳1开 0 关      |
| `heart_time`                  | `sys.heart_time`                  | 心跳间隔，单位s   |
| `nfc`             | `sys.nfc`             | 刷卡开关 1开 0 关     |
| `pwd`              | `sys.pwd`              | 密码开门开关 1开 0 关      |
| `strangerImage`            | `sys.strangerImage`            | 陌生人保存图片开关 1开 0 关     |
| `nfcIdentityCardEnable`  | `sys.nfcIdentityCardEnable`    | 云证开关 3:云证获取 1:物理卡号     |
| `scanInterval`  | `sys.scanInterval`    | 扫码间隔，单位s     |

[回到顶部](#category)

---

## 配置说明

### 配置方式

1. **MQTT 远程配置**: 通过 MQTT 协议远程修改配置
2. **扫码配置**: 通过二维码扫描进行配置

### 配置验证

- 所有配置项在保存前都会进行格式验证
- MQTT 配置会进行连接测试
- 扫码配置会校验配置码格式
- 无效配置会被拒绝并回滚到默认值

### 配置备份

- 配置文件会自动备份到 `/app/data/config/` 目录
- 设备重置时会恢复默认配置

### 注意事项

1. NTP 开关（`ntp.ntp`）、ntp对时服务器ip（`ntp.server`）、时区（`ntp.gmt`，`ntp.timeZone`）、语言（`base.language`）后会自动重启设备生效

---
1、亚洲时区
时区键名	UTC偏移	时区名称	主要城市
Asia/Dubai	+04:00	Gulf Standard Time	迪拜（阿联酋）
Asia/Karachi	+05:00	Pakistan Standard Time	卡拉奇（巴基斯坦）
Asia/Kolkata	+05:30	India Standard Time	加尔各答（印度）
Asia/Dhaka	+06:00	Bangladesh Standard Time	达卡（孟加拉国）
Asia/Bangkok	+07:00	Indochina Time	曼谷（泰国）
Asia/Jakarta	+07:00	Western Indonesia Time	雅加达（印度尼西亚）
Asia/Shanghai	+08:00	China Standard Time	北京（中国）
Asia/Hong_Kong	+08:00	Hong Kong Time	香港（中国）
Asia/Taipei	+08:00	Taiwan Standard Time	台北（中国）
Asia/Singapore	+08:00	Singapore Standard Time	新加坡
Asia/Seoul	+09:00	Korea Standard Time	首尔（韩国）
Asia/Tokyo	+09:00	Japan Standard Time	东京（日本）
Australia/Perth	+08:00	Australian Western Standard Time(Perth)	珀斯（澳大利亚）
Australia/Sydney	+10:00	Australian Western Standard Time(Sydney)	悉尼（澳大利亚）

2、美洲时间
时区键名	UTC偏移	时区名称	主要城市
America/Adak	-10:00	Hawaii-Aleutian Standard Time	阿达克（美国）
America/Anchorage	-09:00	Alaska Standard Time	安克雷奇（美国）
America/Los_Angeles	-08:00	Pacific Standard Time	洛杉矶（美国）
America/Denver	-07:00	Mountain Standard Time	丹佛（美国）
America/Chicago	-06:00	Central Standard Time	芝加哥（美国）
America/Mexico_City	-06:00	Central Time	墨西哥城（墨西哥）
America/New_York	-05:00	Eastern Standard Time	纽约（美国）
America/Toronto	-05:00	Eastern Standard Time	多伦多（加拿大）
America/Bogota	-05:00	Colombia Time	波哥大（哥伦比亚）
America/Lima	-05:00	Peru Time	利马（秘鲁）
America/Santiago	-04:00	Chile Time	圣地亚哥（智利）
America/Sao_Paulo	-03:00	Brazil Time	圣保罗（巴西）
America/Argentina/Buenos_Aires	-03:00	Argentina Time	布宜诺斯艾利斯（阿根廷）

3、欧洲时区
时区键名	UTC偏移	时区名称	主要城市
Europe/Lisbon	+00:00	Portugal Time	里斯本（葡萄牙）
Europe/London	+00:00	Greenwich Mean Time	伦敦（英国）
Europe/Amsterdam	+01:00	Central European Time	阿姆斯特丹（荷兰）
Europe/Berlin	+01:00	Central European Time	柏林（德国）
Europe/Paris	+01:00	Central European Time	巴黎（法国）
Europe/Madrid	+01:00	Central European Time	马德里（西班牙）
Europe/Rome	+01:00	Central European Time	罗马（意大利）
Europe/Stockholm	+01:00	Central European Time	斯德哥尔摩（瑞典）
Europe/Athens	+02:00	Eastern European Time	雅典（希腊）
Europe/Istanbul	+03:00	Turkey Time	伊斯坦布尔（土耳其）

4、大洋洲时区
时区键名	UTC偏移	时区名称	主要城市
Atlantic/Azores	-01:00	Azores Time	亚速尔群岛

5、太平洋时区
时区键名	UTC偏移	时区名称	主要城市
Pacific/Guam	+10:00	Guam Time	关岛（美国）
Pacific/Noumea	+11:00	New Caledonia Time	努美阿（新喀里多尼亚）
Pacific/Auckland	+12:00	New Zealand Standard Time	奥克兰（新西兰）
Pacific/Fiji	+12:00	Fiji Time	斐济
Pacific/Tongatapu	+13:00	Tonga Time	努库阿洛法（汤加）
Pacific/Midway	-11:00	Smoa Standard Time	中途岛（美国）
Pacific/Honolulu	-10:00	Hawaii Standard Time	檀香山（美国）
## 版本信息

- 文档版本: 1.0
- 最后更新: 2025-09-19
  
[回到顶部](#category)