手把手搭建呼伦贝尔数字档案馆系统 可直接落地的实操技术指南

一、前期环境准备

本文基于Ubuntu 22.04 LTS系统部署，适配云服务器和本地物理机，所有命令可直接复制执行，无需手动调整。

1.1 安装基础依赖

先更新系统源，再依次安装所有依赖，执行以下命令：

``` sudo apt update && sudo apt upgrade -y sudo apt install openjdk-11-jdk maven mysql-server-8.0 tomcat9 nginx git -y ```

安装完成后验证各依赖版本，执行java -version、mvn -v都输出版本信息即为成功。

1.2 初始化数据库

先执行安全初始化命令，按提示操作：设置root密码、移除匿名用户、禁止远程root登录、删除测试库、重载权限表。

``` sudo mysql_secure_installation ```

完成后创建系统专用数据库和用户，执行以下命令，输入root密码后进入数据库控制台，复制以下SQL执行：

``` CREATE DATABASE hulunbeier_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'archive_user'@'localhost' IDENTIFIED BY 'Archive@Hulunbeier2024'; GRANT ALL PRIVILEGES ON hulunbeier_archive. TO 'archive_user'@'localhost'; FLUSH PRIVILEGES; EXIT; ```

1.3 创建文件存储目录

档案文件需要单独存储，提前创建目录并授权，执行：

``` sudo mkdir -p /data/archive/files /data/archive/thumbs sudo chmod -R 777 /data/archive ```

二、获取源码并配置部署

2.1 拉取适配源码

进入/opt目录拉取适配呼伦贝尔归档标准的系统源码，执行：

``` cd /opt sudo git clone https://gitee.com/open-arch/hulunbeier-digital-archive.git cd hulunbeier-digital-archive ```

2.2 修改数据库配置

打开配置文件src/main/resources/application.properties ``` 数据库配置 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver spring.datasource.url=jdbc:mysql://localhost:3306/hulunbeier_archive?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false spring.datasource.username=archive_user spring.datasource.password=Archive@Hulunbeier2024 服务端口 server.port=8080 文件存储路径 file.upload.path=/data/archive/files file.thumb.path=/data/archive/thumbs 开启档案水印功能 archive.watermark.enable=true ```

2.3 打包部署到Tomcat

执行maven打包，跳过测试加快打包速度：

``` sudo mvn clean package -DskipTests ```

打包完成后将war包复制到Tomcat部署目录，重启Tomcat：

``` sudo cp target/hulunbeier-archive-1.0.war /var/lib/tomcat9/webapps/ROOT.war sudo systemctl restart tomcat9 ```

三、配置Nginx与访问验证

3.1 添加Nginx反向代理配置

创建配置文件/etc/nginx/sites-available/hulunbeier-archive.conf，填入以下内容：

``` server { listen 80; server_name 你绑定的档案馆域名或服务器IP; client_max_body_size 100M; location / { proxy_pass http://localhost:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } } ```

启用配置并重启Nginx，执行：

``` sudo ln -s /etc/nginx/sites-available/hulunbeier-archive.conf /etc/nginx/sites-enabled/ sudo nginx -t sudo systemctl reload nginx ```

3.2 开放防火墙端口

Ubuntu默认开启ufw防火墙，执行以下命令开放80端口：

``` sudo ufw allow 80/tcp sudo ufw reload ```

四、系统初始化与首次使用

通过域名或服务器IP访问系统，即可进入登录页：

• 默认管理员账号：admin，默认密码：admin@2024，登录后第一时间修改密码

4.1 基础参数配置

• 进入系统设置 > 机构管理，添加呼伦贝尔市本级、区县、乡镇三级档案管理机构，适配呼伦贝尔行政架构
• 进入分类标准管理，点击「导入预设」，直接导入呼伦贝尔官方统一的档案分类标准，无需手动添加
• 进入存储设置，点击「测试存储」，提示成功即为配置正常

4.2 档案归档实操

• 点击档案管理 > 新增档案，选择对应档案分类，填写题名、责任者、归档时间等必填字段
• 上传档案电子原文，支持PDF、Word、JPG等12种常用格式，单文件最大支持100M
• 点击「提交归档」，系统自动生成符合标准的档号和索引，完成归档操作

五、常见问题排查

• Tomcat启动失败：查看日志/var/log/tomcat9/catalina.out，90%是数据库密码错误或权限不足，执行sudo chown -R tomcat9:tomcat9 /var/lib/tomcat9/webapps/可修复权限问题
• 文件上传失败：检查存储目录权限，执行sudo chmod -R 777 /data/archive，同时确认Nginx配置中client_max_body_size大于上传文件大小
• 无法访问系统：检查云服务器安全组是否开放80端口，本地部署检查防火墙规则

按照以上步骤操作，即可完成呼伦贝尔数字档案馆系统的完整部署，满足档案采集、归档、查询、调阅全流程需求，所有配置无需额外调整，可直接上线使用。