从零搭建行政征收数字档案馆系统：本地部署落地实操全指南

一、前置环境准备

1.1 所需软件及获取地址

• JDK 1.8（64位）：Windows下载地址：https://cdn.azul.com/zulu/bin/zulu8.68.0.21-ca-jdk8.0.362-win_x64.zip；Linux下载地址：https://cdn.azul.com/zulu/bin/zulu8.68.0.21-ca-jdk8.0.362-linux_x64.tar.gz
• MySQL 8.0：Windows下载地址：https://cdn.mysql.com/Downloads/MySQL-8.0/mysql-8.0.36-winx64.zip；Linux下载命令：wget https://cdn.mysql.com/Downloads/MySQL-8.0/mysql-8.0.36-linux-glibc2.12-x86_64.tar.xz
• Nginx 1.24：下载地址：http://nginx.org/download/nginx-1.24.0.tar.gz
• 项目安装包：后端包、前端包、初始化SQL下载地址：https://gitee.com/itboiler/simple-archive/releases/download/v1.0/archive-admin-project.zip

下载完成后，所有压缩包必须解压到纯英文路径，避免中文路径导致启动失败。

1.2 基础环境配置

JDK配置验证：

• Windows：解压后复制JDK根目录路径，打开「系统属性-高级-环境变量」，新建系统变量JAVA_HOME，值为刚才复制的JDK路径，编辑系统变量Path，追加%JAVA_HOME%\bin，打开cmd输入java -version，输出版本号即配置成功。
• Linux：解压到/usr/local/目录后，打开/etc/profile文件，末尾追加以下内容： ``` export JAVA_HOME=/usr/local/zulu8.68.0.21-ca-jdk8.0.362-linux_x64 export PATH=$JAVA_HOME/bin:$PATH ``` 执行source /etc/profile，输入java -version验证成功即可。

MySQL数据库初始化：

解压启动MySQL后，用root账号登录，执行以下命令创建专属数据库：

``` CREATE DATABASE IF NOT EXISTS admin_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; ```

然后执行导入命令，将安装包内的init.sql导入数据库，Windows命令示例：mysql -u root -p admin_archive < C:\archive\init.sql，Linux命令示例：mysql -u root -p admin_archive < /root/init.sql，完成后即初始化完成。

二、后端服务配置启动

将安装包内的archive-admin.jar放到单独目录，同级目录新建application-prod.yml配置文件，复制以下完整内容，仅修改标注部分即可：

``` server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/admin_archive?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false username: root password: 此处替换为你的MySQL root密码 servlet: multipart: max-file-size: 100MB max-request-size: 100MB file: upload-path: /data/admin-archive/files Windows改为 D:/admin-archive/files access-prefix: /archive-files/ ```

修改完成后保存，打开终端进入jar包所在目录，执行启动命令：

• Windows：java -jar archive-admin.jar --spring.profiles.active=prod
• Linux：nohup java -jar archive-admin.jar --spring.profiles.active=prod > out.log 2>&1 &

等待30秒后，访问http://localhost:8080/api/health返回success即后端启动成功。

三、前端界面部署配置

先提前创建好所需目录：Windows创建D:/admin-archive/front和D:/admin-archive/files；Linux执行命令mkdir -p /data/admin-archive/front /data/admin-archive/files。将安装包解压出来的前端静态文件，全部复制到front目录。

然后修改Nginx配置文件nginx.conf，在http块内添加以下完整server配置：

``` server { listen 80; server_name _; 绑定域名可替换为你的域名，本地部署直接保留_ location / { root /data/admin-archive/front; Windows改为 D:/admin-archive/front index index.html; try_files $uri $uri/ /index.html; } location /api { proxy_pass http://localhost:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } location /archive-files { alias /data/admin-archive/files; 对应后端配置的存储路径，Windows同步修改 } } ```

配置保存后，执行重启Nginx命令：Windows启动直接双击Nginx目录下nginx.exe，Linux执行./nginx -s reload。

四、系统初始化与功能使用

打开浏览器，输入服务器IP或http://localhost，即可进入系统登录页，默认管理员账号：admin，密码：123456，登录后按以下顺序完成业务初始化，即可投入使用：

• 进入「系统管理-档案分类」，新建行政征收专属分类，例如国有土地房屋征收、集体用地征收、行政事业性收费征收等。
• 进入「系统管理-组织架构」，添加单位内部使用人员，按角色分配权限：档案管理员可上传修改档案，业务人员仅可查询，实现权限隔离。
• 进入「征收档案管理-档案上传」，支持单份上传和批量导入：单份上传直接选择对应分类、上传PDF格式的征收档案原件，填写征收项目名称、被征收人、征收时间、金额等元数据；批量导入可下载系统提供的Excel模板，批量填写元数据后一次性导入。
• 日常使用可进入「档案查询」模块，按征收项目、被征收人、时间、金额等多维度检索，支持在线预览和原件下载。

五、常见问题排查

• 后端启动失败提示端口占用：修改application-prod.yml中server.port为其他未占用端口，同时同步修改Nginx配置中proxy_pass的对应端口。
• 文件上传失败：检查文件存储目录是否存在，Linux需要给目录添加读写权限，执行命令chmod -R 777 /data/admin-archive/files；Windows检查目录是否被杀毒软件锁定。
• 前端打开后显示404：检查Nginx配置中root路径是否正确，确认所有前端静态文件都放在root对应的目录下。