东信智能身份证阅读器国产化操作系统WEB网页读卡服务安装使用指南

版本：V2.0.0.2

广东东信智能科技有限公司

2026 年 9 月 4 日

一、综述

1. 适用范围

本文档适用于广东东信智能科技有限公司 DONSEE® 系列多功能智能卡读写器/身份证阅读器，在银河麒麟、统信 UOS、方德等国产操作系统WEB网页浏览器，搭配谷歌 Chrome、火狐 Firefox 等浏览器场景下的部署使用。

读卡服务基于 WebSocket 实现，支持识读：居民身份证、外国人永久居留身份证、港澳台居民居住证、二代 / 三代社保卡、银行卡、IC 卡、CPU 卡、M1 卡、15693 卡、二维码扫码等业务。

2. 支持设备型号

EST‑100、EST‑100GS、EST‑100 (M50)、EST‑J13X、EST‑100 (M20)、EST‑100 (M533) 等系列设备。

3. 支持操作系统与 CPU 架构

• 操作系统：银河麒麟、统信 UOS、方德等国产操作系统

• CPU 架构：amd64、arm64、loong64、mips64、sw_64

• 获取最新 SDK 驱动：http://www.eastcoms.com/service/downdrive/

• 在线功能测试页面：http://www.eastcoms.com/chrometest.html

二、安装方式

1. 确认系统版本与 CPU 构架

进入系统「设置 → 系统 → 关于」，查看操作系统版本、CPU 硬件信息。

国产系统根据 CPU 不同分为飞腾、兆芯 / 海光、龙芯、Intel 等版本，不同 CPU 架构必须匹配对应 deb 安装包。

2. 安装包命名说明

示例包名：cn.donsee.eserver‑2.0.0.2‑kylinV10sp1‑amd64‑i7‑20251209.deb

• cn.donsee.eserver：软件包前缀

• 2.0.0.2：服务版本号

• kylinV10sp1：适配操作系统版本

• amd64：CPU 架构

• i7：处理器标识

• 20251209：程序编译日期

• 务必根据本机系统版本、CPU 架构选择对应安装包。

3.deb 软件包安装操作

以麒麟V10 SP1 Intel i7 CPU为例，找到cn.donsee.eserver-2.0.0.2-kylinV10sp1-amd64-i7-20251209.deb

1. 找到匹配本机环境的 deb 安装包，双击文件启动安装器；

2. 点击「一键安装」，输入系统管理员密码完成授权；

   

   

3. 
   

   

   等待进度执行，页面提示安装成功即完成部署。

终端命令安装

打开终端，执行命令：

sudo dpkg -i cn.donsee.eserver‑2.0.0.2‑kylinV10sp1‑amd64‑i7‑20251209.deb

安装后验证

1. 
   

   

   打开系统开始菜单，找到「东信智能卡读卡器快捷方式」并打开；

2. 
   

   

   页面出现版本号信息，代表 WEB 控件安装成功；

3. 使用 USB 数据线连接读写器设备到电脑 USB 口，读卡器发出 “滴” 提示音代表硬件初始化完成；

4. 
   

   

   点击测试页面「读身份证」按钮，放置身份证进行读卡验证。

5. 
   

   

   异常提示：页面返回读卡服务已经断开，代表安装失败，请核对 deb 包是否匹配本机系统与 CPU 架构。

三、卸载方式

图形卸载

打开开始菜单，找到「东信智能卡读卡器快捷方式」，右键选择「卸载」，弹窗确认卸载即可。

终端命令卸载

sudo dpkg -r cn.donsee.eserver-2.0.0.2-amd64.deb

四、业务平台正式使用

1. 保持服务运行正式读卡业务过程，需要保证东信读卡服务持续运行；可在电脑右下角通知区域找到服务图标，右键查看服务运行状态。

2. 选择设备并读卡登录业务操作平台，在身份证读卡器型号下拉选项，选择东信智能，点击「身份证读取」按钮，将证件放置读卡器上完成识读。

3. 信息核对保存读卡完成后系统自动回填姓名、证件号码等信息，核对信息无误后，按照业务流程完成保存、提交操作。

4. 信息安全提醒身份证属于个人敏感隐私信息，仅允许在授权业务场景读取处理，禁止截图、转发、留存完整证件信息的测试数据。

五、故障排查

1. 并发访问限制全部接口不支持并发访问；一个接口执行过程中，新请求会等待上一次调用返回后再执行。

2. 谷歌浏览器 CORS 跨域报错报错示例：

plaintext

Access to XMLHttpRequest at 'http://localhost:xxxx/donsee' from origin 'http://xxx.xxx.com:xxxx' has been blocked by CORS policy: The request client is not a secure context and the resource is in more‑private address space `local`.

方案 1：关闭 Chrome PNA 拦截（推荐）浏览器地址栏输入 chrome://flags/，搜索Block insecure private network requests，设置为Disabled，重启浏览器生效。

方案 2：标记 HTTP 源为安全地址（备选）地址栏输入：chrome://flags/#unsafely‑treat‑insecure‑origin‑as‑secure输入业务前端访问地址，选项设置为Enabled，重启浏览器。

3. ERR_BLOCKED_BY_LOCAL_NETWORK_ACCESS_CHECKS（Chrome147+、Edge 浏览器）

• Chrome：输入 chrome://flags/#local‑network‑access‑check 设置为Disabled，重启浏览器

• Edge：输入 edge://flags/#local‑network‑access‑check 设置为Disabled，重启浏览器

• 提交问题反馈时，请一并提供：操作系统名称及版本、CPU 架构、deb 安装包完整文件名、服务状态输出、问题截图。

六、开发接口说明

1. 浏览器前置要求

• 浏览器 WebSocket 功能不可禁用；

• http、https 页面均可访问本地地址 ws://127.0.0.1:33666；

• 读卡服务未启动时，WebSocket 会直接触发 onerror、onclose 事件。

2. 整体交互架构

Web 前端页面（Chrome/Firefox 浏览器）↓WebSocket（ws://127.0.0.1:33666）Linux 本地东信读卡后台服务程序↓USB 通信EST‑100 系列读卡器硬件

连接 WebSocket 后直接下发指令字符串，返回数据为 JSON 格式。WebSocket 连接地址：ws://127.0.0.1:33666/

3. 通用返回 JSON 字段

json

{
  "fun": "指令",
  "rCode": "0",
  "errMsg": "结果/错误信息"
}

• fun：下发的指令名称，用于区分回调数据

• rCode：返回码，0 代表成功，非 0 代表业务失败

• errMsg：错误或者结果描述，成功时一般为空字符串

4. 指令命令列表

开发参考示例文件：DonseeTestWeb.htm

l版权所有 © 广东东信智能科技有限公司