数字档案馆系统档案归档服务从零落地实操完整步骤指南

一、前置准备

你需要提前准备以下资源，所有地址可直接访问下载，无需额外找资源：

• JDK 1.8运行环境：Windows下载地址：https://adoptium.net/temurin/openjdk-8?os=windows&architecture=x64，选择.msi安装包，一路点击下一步即可自动配置环境变量；Linux直接执行命令apt install openjdk-8-jdk（Debian/Ubuntu）或yum install java-1.8.0-openjdk（CentOS）
• MySQL 5.7数据库：下载地址：https://dev.mysql.com/downloads/mysql/5.7.html，默认安装端口为3306，记住设置的root密码即可
• 归档服务程序包：直接下载地址：https://gitee.com/whvse/DArchive/raw/master/release/darchive-archive-service.war

二、数据库初始化配置

登录MySQL后，执行以下完整SQL创建数据库和授权用户，可直接复制运行：

```sql CREATE DATABASE IF NOT EXISTS darchive DEFAULT CHARACTER SET utf8mb4; CREATE USER 'darchive'@'%' IDENTIFIED BY 'Darchive@2024'; GRANT ALL PRIVILEGES ON darchive. TO 'darchive'@'%'; FLUSH PRIVILEGES; ```

接着下载初始化表结构SQL：https://gitee.com/whvse/DArchive/raw/master/sql/init.sql，下载完成后在刚创建的darchive数据库中执行该SQL，即可完成所有表结构初始化，无需手动建表。

三、归档服务核心配置修改

将下载好的darchive-archive-service.war解压到任意无中文、无空格的路径，例如Windows下解压到D:\darchive\service\，进入解压后的WEB-INF/classes/目录，用记事本打开application.properties文件，替换为以下完整配置，仅需要修改2处自定义内容，其他保持默认即可：

```properties 服务访问端口 server.port=8080 数据库连接配置 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver spring.datasource.url=jdbc:mysql://[你的数据库IP地址]:3306/darchive?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai spring.datasource.username=darchive spring.datasource.password=Darchive@2024 档案文件存储路径，必须修改为你本地已存在的路径，例如D:/darchive/archive-files/ archive.storage.path=[你的档案存储路径] 开启归档MD5校验，保障文件完整性 archive.check.enable=true 接口调用授权密钥，默认即可，可自行修改 archive.auth.secret=archive_secret_2024 最大支持上传文件大小 spring.servlet.multipart.max-file-size=1000M spring.servlet.multipart.max-request-size=1000M ```

修改完成后保存文件即可，配置环节完成。

四、启动服务并完成首次归档测试

4.1 启动服务

Windows系统：进入解压后的根目录，找到bin/startup.bat，右键选择以管理员身份运行，等待1-2分钟，控制台输出Started ArchiveServiceApplication即说明启动成功。

Linux系统：进入服务根目录，执行以下命令即可后台启动：

```bash chmod +x ./bin/startup.sh nohup ./bin/startup.sh & ```

4.2 首次归档实操步骤

打开浏览器访问：http://你的服务器IP:8080/archive/admin，默认登录账号：admin，密码：admin123，登录后按以下步骤操作即可完成归档：

1. 点击左侧菜单栏归档管理>新建归档任务，填写任务名称，选择对应的档案分类
2. 点击上传档案文件，选择需要归档的PDF、Word、JPG等格式文件，单次最多支持100个文件，单文件最大支持1G
3. 填写档案元信息：包括档案编号、形成日期、责任人、归档部门，档案编号必须唯一，系统会自动校验重复
4. 勾选默认开启的MD5校验选项，点击右下角提交归档，系统自动完成文件存储、元信息入库、完整性校验，页面提示「归档成功」即完成本次归档。

五、常见卡壳问题排查

• 启动提示数据库连接失败：检查数据库IP是否正确，3306端口是否开放防火墙权限，SQL中的用户授权是否执行成功，数据库连接URL参数是否复制完整
• 提交归档提示存储路径错误：检查填写的存储路径是否已经手动创建，路径不要包含中文和空格，Windows系统路径使用正斜杠/，不要用反斜杠\
• 上传超过500M文件报错：检查配置文件中是否已经添加spring.servlet.multipart.max-file-size=1000M参数，添加后重启服务即可
• 归档后无法下载文件：检查存储路径的读写权限，Linux执行命令chmod -R 755 [你的存储路径]，Windows右键路径属性取消「只读」勾选即可

如果需要对接内部OA、业务系统实现自动归档，可直接调用系统提供的开放接口，调用示例如下，可直接复制修改参数使用：

```json POST http://你的服务地址:8080/archive/api/v1/auto-archive Headers: Authorization: Bearer archive_secret_2024 Content-Type: application/json Body: { "task_name": "2024年合同自动归档", "catalog_id": 2, "file_url": "https://你的文件存储地址/xxx合同.pdf", "meta_info": { "archive_no": "HT20240001", "create_date": "2024-05-20", "duty_user": "李四", "department": "法务部" } } ```

调用成功后会返回全局唯一归档ID，后续可通过该ID完成档案查询、下载、修改操作，整个数字档案馆档案归档服务即可零门槛落地完成。