这个品类的数据长什么样
身份证件KYC的数据主要来自用户上传的实体证件扫描件、移动端拍摄的证件照片，部分场景通过政务服务接口获取结构化核验数据。数据更新节奏分两类：用户主动提交的为单次静态更新，批量导入的按导入批次更新，政务接口同步数据按需触发。文档结构固定为正反面两部分，正面包含姓名、公民身份号码、签发机关、有效期限等字段，反面包含证件类型、签发次数等字段，字段单位多为纯文本或像素级的照片数据，大陆居民身份证的身份号码字段固定为18位数字格式。
这些特征在「部署与升级」这一环带来什么约束
身份证件的固定版式与双页面结构，要求部署时配置双页面对齐解析的流程，避免字段提取错位。OCR解析依赖GPU加速，部署时需预留对应算力资源，且需适配不同地区身份证件的版式差异。数据来源包含结构化接口与非结构化照片，部署时需同时配置结构化数据映射规则与非结构化OCR解析参数。升级时需兼容旧版证件解析模板，避免存量用户的核验流程失效，同时需同步更新合规性校验规则，适配监管要求的字段更新。另外，身份证件的强合规属性要求部署时配置数据脱敏与存储加密参数，升级时需保留该类配置项，确保数据处理符合监管要求。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
PARSE_FILE_TIMEOUT_SECONDS | 600 秒 | 身份证件OCR解析包含正反面对齐与字段关联校验，常规解析时长较长，600秒可覆盖多数高清扫描件的解析需求 |
UPLOAD_FILE_MAX_SIZE | 1000 MB | 高清身份证件扫描件分辨率可达300dpi以上，单文件大小可达数百MB，1000 MB可覆盖多数上传场景 |
KYC_DOC_VALIDATE_ENABLE | 开启 | 身份证件需校验姓名、身份号码等字段的格式合规性，开启后可自动拦截格式错误的提交数据，符合监管核验要求 |
OCR_MODEL_VERSION | v0.1.2 | 该版本适配2023版大陆居民身份证版式，升级时可按需切换到对应版本以适配不同地区证件 |
FETCH_INTERNAL_URL_WHITELIST | ["gov-api.xxx.com"] | 政务接口同步身份证件数据需配置可信域名白名单，避免内部接口调用被拦截 |
PARSE_FILE_ALLOW_EXT | ["jpg", "png", "pdf"] | 身份证件常见上传格式为JPG、PNG扫描件与PDF电子证件，配置该白名单可过滤无效上传文件 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 执行
docker run --gpus all -itd -p 7231:7231 marker_images:v0.1时出现GPU驱动不兼容报错。原因：未在部署前确认宿主机GPU驱动版本与OCR镜像的兼容要求，镜像依赖的CUDA版本与宿主机不匹配。 - 升级到4.9.0版本后，调用政务接口同步身份证件数据时，后台日志提示
cannot fetch internal url。原因：未配置FETCH_INTERNAL_URL_WHITELIST参数，新版本默认拦截未授信的内部接口请求。 - 在知识库配置页面无法找到身份证件核验的文件加工插件。原因：未在部署时启用OCR与KYC相关的插件包，或插件版本与当前FastGPT版本不匹配。
怎么确认配好了
- 上传一张高清身份证件正反面照片，查看解析结果是否完整提取核心字段，核对字段提取的准确性是否符合业务预期。
- 调用内部政务接口同步结构化身份证件数据，检查是否能正常获取并映射到知识库字段，确认接口调用无拦截报错。
- 调整解析超时参数后，上传大尺寸扫描件，验证解析流程是否在配置时长内完成，无超时异常。
- 检查插件管理页面，确认身份证件核验相关的OCR与校验插件已启用，版本与当前FastGPT实例匹配。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。