数字档案馆系统延伸服务：面向公众查询的零门槛落地实操指南

前期准备清单

需提前准备的资源与信息

• 原有数字档案馆系统的开放档案查询接口地址，若原系统部署在内网，需提前为延伸服务服务器开通接口访问白名单
• 1台1核2G/1M带宽的云服务器（CentOS 7.9系统，直接在云厂商后台选择对应镜像即可），1个已完成ICP备案的域名
• 提前向原系统管理员申请接口调用权限与凭证，获取接口appKey

环境一键搭建实操

使用预封装的延伸服务模板，无需从零开发，登录服务器后依次执行以下命令即可完成基础环境搭建：

``` 安装依赖环境 yum install -y git nodejs npm 拉取延伸服务模板代码 git clone https://gitee.com/open-arch/archive-public-service.git 进入项目目录安装依赖 cd archive-public-service npm install --production ```

修改核心对接配置

打开项目根目录下的config/index.js，替换为你自己的配置信息，完整可复制配置如下：

``` module.exports = { // 原有数字档案馆系统对接配置 originArchive: { baseUrl: 'http://原档案馆系统IP:端口/openapi', appKey: '提前申请的接口凭证appKey', // 允许对公众开放查询的档案类型，按需调整 allowTypes: ['文书档案', '科技档案', '照片档案'] }, // 本地服务端口，被占用时再修改 port: 8080 } ```

核心接口适配步骤

目前国内主流数字档案馆系统都遵循《档案信息系统互联互通规范》，仅需3步即可完成对接：

1. 开通原系统接口权限

登录原有数字档案馆管理后台，进入系统管理-对外接口-新增接入应用，填写应用名称为「公众查询延伸服务」，复制系统生成的appKey到上述配置文件，勾选开放「档案列表查询」「档案全文预览」两个接口，将延伸服务服务器的公网IP添加到白名单后保存配置。

2. 调整字段映射规则

如果原系统接口返回的字段名和模板预定义的不一致，只需修改项目中src/utils/mapping.js文件，完整映射代码如下，仅需修改冒号右侧的字段名即可：

``` // 左侧为模板要求字段，右侧修改为原系统实际返回的字段名 export default { id: 'archive_id', // 档案唯一ID title: 'title', // 档案题名 year: 'fonds_year', // 档案年度 unit: 'keep_org', // 保管单位 previewUrl: 'fulltext_url' // 全文预览地址 } ```

3. 核心功能调试

配置完成后执行启动命令：npm run start，然后配置nginx反向代理，完整可复制nginx配置如下：

``` server { listen 80; server_name 你的已备案域名; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; } } ```

执行systemctl reload nginx重载配置后，访问你的域名，测试三个核心功能：

• 多条件模糊查询：输入关键词后1秒内返回结果即为正常
• 档案全文预览：点击档案条目能正常打开PDF/图片文件即为正常
• 分页加载：超过10条结果能正常翻页即为正常

后台管理配置

模板自带轻量管理后台，无需额外开发，登录地址为：你的域名/admin，默认账号密码为admin / 123456，登录后按以下步骤完成基础配置：

• 进入「系统设置-修改密码」，设置新的8位以上复杂密码保存
• 进入「查询设置」，可直接开启/关闭不需要对公众开放的档案类型，修改后实时生效，无需重启服务
• 进入「访问统计」，可查看每日查询量、访问来源等数据，满足延伸服务的统计需求

上线前安全加固

• 修改默认服务端口：在config/index.js中将port修改为其他非默认端口，同步修改nginx的反向代理地址
• 配置云服务器安全组：仅开放80、443端口，关闭其他所有端口的对外访问权限
• 配置HTTPS：在云厂商免费申请SSL证书，更新nginx配置开启HTTPS，保障访问安全

全部配置完成后，再次验证所有功能即可正式上线，整个过程无需复杂开发，仅需1小时即可完成数字档案馆延伸服务的落地，满足对公众开放档案查询的核心需求。