门禁标品配置项文档（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 | "欢迎光临"    | 问候语内容   |
| `face.recheck` | Int | 0    | 重检开关 1 开 0 关，打开后重检时间为8s   |

## MQTT配置（mqtt）

| 配置项                  | 类型   | 默认值                        | 说明                  |
| ----------------------- | ------ | ----------------------------- | --------------------- |
| `mqtt.addr`     | String | "mqtt://192.168.10.202:1883" | mqtt地址 (格式为 mqtt://192.168.1.1:1883)   |
| `mqtt.clientId`     | String | 设备sn号    | 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"  | 遗嘱 设备断开连接自动发送    |
| `mqtt.cleanSession`    | Int | 0  | 清除会话开关， 1 开 0 关    |

[回到顶部](#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 地址，例：192.168.1.123       |
| `net.gateway`              | String | ""     | 网关地址，例：192.168.1.1                                |
| `net.mask`           | String | ""     | 子网掩码，例：255.255.255.0                                |
| `net.dns`                  | String | ""     | DNS 服务器 ，例：114.114.114.114                             |
| `net.mac`               | String | ""     | 网络 MAC 地址，例：D6:18:6C:CE:B4:60                           |
| `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      | 时区，参考[附表 1 时区配置]-时区键名列    |

## 通行配置（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 关      |
| `access.uploadToCloud`  | 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   |
| `base.nirBrightness` | Int | 80   |红外补光灯：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   |
| `sys.time` | Int |    | 系统时间，时间戳s   |

[回到顶部](#category)

---

## 配置说明

### 配置方式

1. **MQTT 远程配置**: 通过 MQTT 协议远程修改配置

### 配置验证

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

### 配置备份

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

### 注意事项

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

## 附表 1 时区配置
1、亚洲时区
| 时区键名     | UTC偏移     | 时区名称     | 主要城市     |
| -------- | ------ | ------- | -------------------------- |
| Asia/Dubai	  | +04:00   | Gulf Standard Time      | 迪拜（阿联酋）|
| 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/Midway	| -11:00	| Smoa Standard Time	| 中途岛（美国）| 
| Pacific/Honolulu	| -10:00	| Hawaii Standard Time	| 檀香山（美国）| 
## 版本信息

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