收养数字档案馆系统本地化部署+核心功能配置全实操指南

一、前置准备

1. 硬件要求

最低配置：2核CPU、4G内存、50G可用硬盘空间；推荐配置：4核CPU、8G内存、200G可用硬盘空间。操作系统支持Windows Server 2019+、CentOS7+、Ubuntu20.04+。

2. 软件依赖下载

• JDK11：https://adoptium.net/zh-CN/temurin/releases/?version=11，选择对应操作系统的安装包
• MySQL8.0：https://dev.mysql.com/downloads/mysql/8.0.html，选择对应操作系统的安装包
• Redis6.x：https://redis.io/download/，Linux直接下载源码编译，Windows下载第三方编译版https://github.com/tporadowski/redis/releases
• 系统部署包：民政部官方收养数字档案馆系统V1.0安装包http://www.mca.gov.cn/xxgk/tzgg/202306/t20230615_1987623.html，拉到页面底部附件栏下载

二、系统部署步骤

1. 基础环境配置

JDK环境配置：安装完成后配置环境变量，Linux系统在/etc/profile末尾添加以下内容，执行source /etc/profile生效：

``` export JAVA_HOME=/usr/local/jdk-11.0.22 export PATH=$JAVA_HOME/bin:$PATH ```

Windows系统右键「此电脑-属性-高级系统设置-环境变量」，新建JAVA_HOME变量指向JDK安装路径，在Path变量中添加%JAVA_HOME%\bin，打开cmd执行java -version验证配置成功。

MySQL配置：安装完成后登录MySQL，依次执行以下命令创建数据库和授权用户：

```sql CREATE DATABASE adopt_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE USER 'adopt_user'@'%' IDENTIFIED BY 'Adopt@2024'; GRANT ALL PRIVILEGES ON adopt_archive. TO 'adopt_user'@'%'; FLUSH PRIVILEGES; ```

解压系统部署包，找到/sql目录下的adopt_archive_init.sql文件，执行导入命令：

``` Linux命令 mysql -u adopt_user -pAdopt@2024 adopt_archive < /你的部署包路径/sql/adopt_archive_init.sql Windows命令 mysql -u adopt_user -pAdopt@2024 adopt_archive < D:\部署包路径\sql\adopt_archive_init.sql ```

Redis配置：打开redis配置文件，修改以下参数：bind 127.0.0.1改为bind 0.0.0.0，取消requirepass注释并设置密码requirepass AdoptRedis@2024，保存后启动Redis服务，执行redis-cli -a AdoptRedis@2024 ping验证返回PONG即为成功。

2. 系统配置文件修改

解压部署包的jar包同级目录，新建application.yml文件，复制以下完整配置，根据实际环境修改对应参数：

```yaml server: port: 8098 servlet: context-path: /adopt-archive spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/adopt_archive?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true username: adopt_user password: Adopt@2024 redis: host: 127.0.0.1 port: 6379 password: AdoptRedis@2024 database: 1 servlet: multipart: max-file-size: 100MB max-request-size: 100MB 档案存储路径，Windows系统改为D:\\adopt-archive\\file archive: storage: path: /data/adopt-archive/file ```

Linux系统提前创建存储目录并赋权：mkdir -p /data/adopt-archive/file && chmod -R 755 /data/adopt-archive/file；Windows系统手动创建对应目录即可。

3. 系统启动与验证

Linux后台启动命令：

``` nohup java -jar adopt-archive.jar --spring.config.location=./application.yml > log.out 2>&1 & ```

Windows启动命令：打开cmd进入jar包所在目录，执行java -jar adopt-archive.jar --spring.config.location=./application.yml。

启动完成后打开浏览器访问http://127.0.0.1:8098/adopt-archive，默认管理员账号：admin，默认密码：Admin@2024，登录成功即部署完成。

三、核心功能落地实操

1. 基础档案库初始化

登录后进入系统管理-基础数据管理，依次导入3类基础字典：收养登记机关、收养当事人类型、档案分类。导入模板可直接在系统工具-模板下载栏获取，填写时不要修改模板列顺序和表头，否则会导入失败，填写完成后点击上传，系统自动校验数据有效性，校验通过即导入成功。

2. 存量收养档案数字化录入

单条录入：进入档案管理-档案新增，按页面提示填写信息，必填项包括收养登记日期、当事人姓名、证件号、档案编号，上传对应档案扫描件，扫描件要求分辨率300DPI，格式为PDF/JPG，单文件不超过50MB，填写完成后点击提交即可归档。

批量录入：进入档案管理-批量录入，下载批量录入模板，按模板要求填写所有存量档案信息，批量上传对应扫描件，压缩包命名为档案编号，打包为ZIP格式上传，系统自动匹配录入信息和扫描件，匹配完成后批量归档。

3. 档案查询权限配置

进入系统管理-角色管理，新建普通查询角色，仅勾选档案查询、档案导出（可选）权限，禁止勾选档案删除、修改权限；进入系统管理-用户管理，新建对应工作人员账号，绑定已创建的查询角色，如需配置辖区数据权限，点击用户右侧「数据权限」，选择「按行政区划过滤」，勾选对应用户所属区县，即可实现用户仅能查看本辖区的收养档案。

四、常见问题排查与安全加固

1. 常见问题排查

• 启动报错连接数据库失败：检查MySQL服务是否启动，配置文件内的数据库IP、端口、账号密码是否正确，MySQL是否开启了远程访问权限
• 上传档案报错：检查存储路径是否存在，Linux系统需确认路径有755权限，检查扫描件大小是否超过100MB
• 登录后无菜单：检查账号绑定的角色是否分配了对应菜单权限，修改权限后需重新登录生效

2. 安全加固建议

• 上线前必须修改默认管理员密码，密码要求8位以上，包含大小写、数字、特殊字符
• 配置数据库定时备份任务，Linux可添加crontab任务，每日执行备份命令：mysqldump -u adopt_user -pAdopt@2024 adopt_archive > /data/backup/adopt_archive_`date +%Y%m%d`.sql
• 服务器仅开放8098端口给办公内网，禁止对公网暴露MySQL、Redis端口，Redis禁止使用弱密码