超详细从零搭建轻量岳阳数字档案馆本地演示实操指南

一、前期准备：准备零门槛的轻量开源底座

我们采用免费开源的DSpace 7 LTS（长期支持版）作为底座，仅需一台配置≥2核4G、系统为Ubuntu 20.04/22.04的电脑即可落地，岳阳本地元数据模板会在步骤中提供。

1.1 系统环境一键准备

打开Ubuntu终端，依次复制执行以下命令，自动安装JDK17、PostgreSQL14、Node.js18、Tomcat9（DSpace 7 LTS指定版本）：

```bash 更新源 sudo apt update && sudo apt upgrade -y 安装JDK17 sudo apt install openjdk-17-jdk-headless -y 验证JDK（输出openjdk version "17.0.x"即成功） java -version 安装PostgreSQL14 sudo apt install postgresql-14 postgresql-client-14 -y 安装Node.js18 curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt install nodejs -y 验证Node.js（输出v18.x.x即成功） node -v 安装pnpm（DSpace 7依赖） sudo npm install -g pnpm 验证pnpm（输出pnpm 8.x.x即成功） pnpm -v 安装Tomcat9 sudo apt install tomcat9 tomcat9-admin -y ```

1.2 PostgreSQL数据库配置

• 切换到postgres用户：执行sudo -u postgres psql，进入psql交互界面
• 创建DSpace专用数据库和用户：依次复制执行以下SQL语句，注意分号： ```sql CREATE USER dspace WITH PASSWORD 'dspace123'; CREATE DATABASE dspace OWNER dspace; \c dspace CREATE EXTENSION pgcrypto; \q ```
• 修改PostgreSQL访问权限：
  1. 打开配置文件：sudo nano /etc/postgresql/14/main/pg_hba.conf
  2. 找到最后一行local all all peer，将peer改为md5
  3. 按Ctrl+X，输入Y，回车保存
  4. 重启PostgreSQL生效：sudo systemctl restart postgresql

二、DSpace 7 LTS部署与岳阳元数据适配

2.1 DSpace 7 LTS下载与安装

• 创建DSpace用户目录：执行sudo mkdir -p /opt/dspace && sudo chown -R $USER:$USER /opt/dspace
• 下载压缩包：cd /opt/dspace && wget https://github.com/DSpace/DSpace/releases/download/dspace-7.6.1/dspace-7.6.1-release.tar.gz
• 解压并构建： ```bash tar -zxvf dspace-7.6.1-release.tar.gz cd dspace-7.6.1-release 跳过部分测试加速构建 mvnw clean package -DskipTests ```
• 安装到/opt/dspace目录：cd dspace/target/dspace-installer && ant fresh_install

2.2 岳阳元数据模板配置

我们使用符合《湖南省综合档案馆档案数字化实施细则》的岳阳基础元数据，仅需覆盖原元数据配置文件：

• 创建临时目录：mkdir -p ~/temp-yueyang-meta
• 新建岳阳元数据注册表：nano ~/temp-yueyang-meta/metadata-registry.xml，粘贴以下完整内容： ```xml ```
• 导入元数据： ```bash cd /opt/dspace/bin ./dspace metadata-import -f ~/temp-yueyang-meta/metadata-registry.xml ```

2.3 Tomcat配置与权限调整

• 复制DSpace Web应用到Tomcat：sudo cp -r /opt/dspace/webapps/ /var/lib/tomcat9/webapps/
• 调整Tomcat用户权限：sudo chown -R tomcat:tomcat /opt/dspace && sudo chown -R tomcat:tomcat /var/lib/tomcat9/webapps
• 创建DSpace管理员： ```bash cd /opt/dspace/bin 按照提示输入邮箱、密码、姓名 ./dspace create-administrator ```
• 重启Tomcat：sudo systemctl restart tomcat9

三、本地演示测试：模拟岳阳档案上传与检索

3.1 访问演示系统

打开本地浏览器，输入地址：http://localhost:8080/server（DSpace后端API，无需操作）或http://localhost:8080（DSpace前端界面），首次访问需等待约1分钟让系统初始化。

3.2 上传模拟岳阳档案

• 登录管理员账号：点击右上角“登录”，输入2.3步骤创建的邮箱和密码
• 创建馆藏社区：
  1. 点击左侧“管理”→“馆藏”→“新建社区”
  2. 填写社区名称：岳阳市档案馆2024年度接收档案
  3. 填写社区简介：用于本地测试的轻量数字档案
  4. 点击“保存”
• 创建馆藏集合：
  1. 进入刚创建的社区，点击“新建集合”
  2. 填写集合名称：市民政局民生档案
  3. 点击“保存”
• 上传单个测试档案：
  1. 进入刚创建的集合，点击“上传”
  2. 上传本地测试PDF文件（可随意找一个文件）
  3. 必填元数据（基础+岳阳）：
     • dc.title（文档标题）：2024年岳阳市最低生活保障公示
     • dc.contributor.author（作者）：岳阳市民政局
     • dc.date.issued（发布日期）：2024-05-20
     • yueyang.archival-number（岳阳档号）：YYMZ-MS-2024-0520-001
     • yueyang.classification-code（分类号）：MZ102-2024
  4. 点击“保存并完成”

3.3 验证岳阳特色检索

点击右上角搜索框，输入“YYMZ-MS-2024-0520-001”（岳阳档号）或“MZ102-2024”（分类号），点击搜索，应直接定位到刚上传的测试档案。

四、常见卡壳问题排查

• 问题1：构建DSpace时报错JDK版本不对

  解决：执行sudo update-alternatives --config java，选择JDK17对应的数字，回车确认

• 问题2：访问前端显示404

  解决：等待初始化完成（最多5分钟），或检查Tomcat是否正常启动：sudo systemctl status tomcat9，若失败查看日志：sudo tail -f /var/log/tomcat9/catalina.out

• 问题3：创建管理员时报错数据库连接失败

  解决：检查pg_hba.conf是否修改正确，或重启PostgreSQL：sudo systemctl restart postgresql