那曲数字档案馆系统本地从零搭建部署完整实操落地指南

一、前置环境准备

1.1 所需软件及安装方式

根据你使用的操作系统，直接执行对应命令完成环境安装，所有版本适配当前系统的稳定版，无兼容性问题：

• CentOS7/9 系统执行以下命令： ``` 安装OpenJDK11 yum install -y java-11-openjdk-devel 安装MySQL8.0 yum install -y https://dev.mysql.com/get/mysql80-community-release-el9-1.noarch.rpm yum install -y mysql-community-server 安装Redis6.x yum install -y redis 安装Node16 curl -fsSL https://rpm.nodesource.com/setup_16.x | bash - yum install -y nodejs 安装Nginx yum install -y nginx ```
• Windows 系统直接下载对应安装包： OpenJDK11: https://download.java.net/openjdk/jdk11/ri/openjdk-11+28_windows-x64_bin.zip MySQL8.0: https://cdn.mysql.com/Downloads/MySQL-8.0/mysql-8.0.36-winx64.zip Nginx: http://nginx.org/download/nginx-1.24.0.zip

1.2 硬件配置要求

本地测试最低配置：4核CPU、8G内存、100G可用存储空间；生产部署建议配置：8核CPU、16G内存、200G SSD存储空间，满足百万级档案存储需求。

二、本地部署详细步骤

2.1 获取项目安装包

打开终端，执行以下命令直接克隆官方最新版本安装包，无法访问Git可直接访问地址下载压缩包： ``` git clone https://github.com/naqu-digital/archive-system.git ``` 项目直链下载地址：https://github.com/naqu-digital/archive-system/archive/refs/heads/main.zip

2.2 数据库初始化配置

启动MySQL服务后，登录MySQL执行以下SQL完成数据库和账号创建，直接复制全量内容执行即可： ``` CREATE DATABASE naqu_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'naqu_archive'@'%' IDENTIFIED BY 'NaQuArchive@2024'; GRANT ALL PRIVILEGES ON naqu_archive. TO 'naqu_archive'@'%'; FLUSH PRIVILEGES; ``` 执行完成后，导入项目自带的初始化SQL，终端执行命令： ``` cd archive-system mysql -u root -p naqu_archive < ./sql/init.sql ```

2.3 后端服务配置修改

进入后端配置目录，打开application-prod.yml文件，替换为以下完整可运行配置，根据你的本地环境修改对应项即可： ``` server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/naqu_archive?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&useSSL=false username: naqu_archive password: NaQuArchive@2024 redis: host: 127.0.0.1 port: 6379 password: Redis未设置密码则留空 database: 0 naqu: archive: storage-path: /data/naqu-archive/files Windows本地修改为 D:/naqu-archive/files upload-size-limit: 100MB ``` 关键注意事项：必须提前创建配置中填写的档案存储目录，否则后端启动会直接报错

2.4 打包启动后端服务

终端执行以下命令完成打包和启动，直接复制执行： ``` cd ./backend mvn clean package -DskipTests 测试启动 java -jar target/naqu-archive-backend-1.0.0.jar --spring.profiles.active=prod 生产后台启动（Linux） nohup java -jar target/naqu-archive-backend-1.0.0.jar --spring.profiles.active=prod > naqu.log 2>&1 & ``` 看到终端输出Started NaquArchiveApplication说明后端启动成功。

2.5 前端打包与Nginx配置

终端进入前端目录，执行打包命令，使用国内镜像避免安装依赖失败： ``` cd ../frontend npm install --registry=https://registry.npmmirror.com npm run build ``` 打包完成后，将生成的dist文件夹复制到Nginx的html目录，修改Nginx配置文件nginx.conf，添加以下server块： ``` server { listen 80; server_name 127.0.0.1; root /usr/local/nginx/html/dist; Windows修改为 D:/nginx-1.24.0/html/dist index index.html; location /api/ { proxy_pass http://127.0.0.1:8080/api/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } client_max_body_size 100m; } ``` 修改完成后执行nginx -s reload重启Nginx即可。

三、系统初始化与验证

3.1 管理员登录

打开浏览器访问http://127.0.0.1，进入登录页面，默认管理员账号为： 账号：admin，密码：admin@123，登录后系统会强制要求修改初始密码，修改完成后即可进入管理后台。

3.2 核心功能验证

• 档案录入：进入档案管理模块，新建档案目录，上传10M以内测试文件，确认保存成功，文件可正常下载
• 权限配置：新建普通查阅账号，分配单类目档案访问权限，使用新账号登录确认权限生效
• 档案检索：输入已录入档案的关键词，确认能准确命中对应档案，检索结果无错误

四、常见问题与日常维护

4.1 常见启动问题排查

后端连接数据库失败：检查MySQL是否启动，3306端口是否开放，配置文件中的账号密码是否正确，数据库编码是否为utf8mb4

前端打开显示404：检查Nginx配置中的root路径是否正确，server端口是否被占用，dist文件是否复制正确

大文件上传失败：检查Nginx配置中的client_max_body_size是否设置为100m，后端存储目录是否有读写权限

4.2 日常维护操作

配置每日自动备份数据库，Linux添加crontab定时任务，直接复制以下规则即可： ``` 0 2 /usr/bin/mysqldump -u naqu_archive -p'NaQuArchive@2024' naqu_archive > /data/backup/naqu_archive_$(date +\%Y\%m\%d).sql ``` 每三个月清理一次超过30天的临时上传文件，可配置定时任务自动清理，避免占用存储空间。