阿里地区数字档案馆系统从零开始本地部署全流程实操指南

发布时间: 2026年09月13日 06:15:01 来源: 安答联动浏览量: 0

前置准备

软硬件要求

部署前请确认你的设备满足以下最低要求：

服务器：2核CPU、4G内存、100GB以上可用存储，用于存储电子档案原文
操作系统：支持Ubuntu 18.04+/CentOS 7+/Windows Server 2016+，以下步骤以Linux服务器为例，Windows操作逻辑一致
网络：部署到政务外网/公网需配置可用IP或域名，内网部署无特殊要求

依赖环境安装

按顺序执行以下命令安装所有依赖，复制命令直接执行即可，无需额外修改：

安装JDK1.8：Ubuntu执行sudo apt install openjdk-8-jdk -y，CentOS执行sudo yum install java-1.8.0-openjdk-devel -y，执行java -version输出版本号即为成功
安装Maven3.6：Ubuntu执行sudo apt install maven -y，CentOS执行sudo yum install maven -y，执行mvn -v输出版本号即为成功
安装MySQL5.7：Ubuntu执行sudo apt install mysql-server-5.7 -y，CentOS执行sudo yum install https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm -y && sudo yum install mysql-community-server-5.7 -y，启动MySQL执行systemctl start mysqld
安装Node.js14：Ubuntu执行curl -fsSL https://deb.nodesource.com/setup_14.x | sudo -E bash - && sudo apt-get install -y nodejs，CentOS执行curl -fsSL https://rpm.nodesource.com/setup_14.x | sudo bash - && sudo yum install -y nodejs，执行node -v输出版本号即为成功
安装Nginx：执行sudo apt install nginx -y(Ubuntu)或sudo yum install nginx -y(CentOS)即可

项目部署步骤

获取项目代码并打包

执行以下命令拉取适配阿里地区规范的项目代码，进入项目目录：

``` git clone https://gitee.com/archive-admin/ali-tibet-digital-archive.git cd ali-tibet-digital-archive ```

先打包后端项目，执行以下命令：

``` cd backend mvn clean package ```

打包完成后，会生成target/alizdaj.jar文件，再打包前端项目：

``` cd ../frontend npm install && npm run build ```

打包完成后，会生成dist文件夹，后续Nginx会用到。

修改项目配置

后端配置文件为src/main/resources/application.yml，打包前修改为你自己的配置，完整可复制配置如下：

```yaml server: port: 8080 servlet: context-path: /alizdaj spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/alizdaj?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai username: root password: 你的数据库登录密码 servlet: multipart: max-file-size: 100MB max-request-size: 100MB archive: 阿里地区电子档案存储根目录，请勿随意修改 store-path: /data/archive/store 开启阿里地区政务规范适配，默认开启无需修改 enable-ali-gov-adapter: true ```

必须修改的内容：url中的数据库地址、用户名、密码，提前创建对应的数据库，执行SQLCREATE DATABASE IF NOT EXISTS alizdaj DEFAULT CHARACTER SET utf8mb4;即可完成创建

创建存储目录并配置权限，执行以下命令：

``` sudo mkdir -p /data/archive/store sudo chmod -R 755 /data/archive/store ```

启动项目并配置Nginx

阿里地区数字档案馆系统从零开始本地部署全流程实操指南

启动后端项目，执行以下命令（后台运行不占用终端）：

``` cd ../../backend/target nohup java -jar alizdaj.jar > /var/log/alizdaj.log 2>&1 & ```

把编译好的前端文件移动到Nginx默认目录，执行：

``` sudo mkdir -p /opt/alizdaj sudo cp -r ../../frontend/dist /opt/alizdaj/ ```

修改Nginx配置文件，路径为/etc/nginx/conf.d/default.conf（CentOS）或/etc/nginx/sites-available/default（Ubuntu），完整配置如下：

```nginx server { listen 80; server_name 你的服务器IP或域名; location /alizdaj/ { proxy_pass http://127.0.0.1:8080/alizdaj/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } location / { root /opt/alizdaj/dist; index index.html; try_files $uri $uri/ /index.html; } } ```

重启Nginx生效，执行：sudo systemctl restart nginx