预售许可证数字档案馆系统从零部署到上线实操全流程指南

一、前期环境准备

1.1 服务器基础要求

推荐使用2核4G、40G系统盘的云服务器，操作系统选择CentOS7.9 64位，提前在安全组开放80（Web访问）、3306（MySQL）、9200（ElasticSearch）、9000（MinIO）端口，来源设置为你的办公IP段，避免公网暴露高危端口。

1.2 依赖软件安装

执行以下命令安装JDK1.8：

``` yum install -y java-1.8.0-openjdk-devel java -version ```

返回openjdk version "1.8.0_xxx"即为安装成功。

执行以下命令安装MySQL8.0：

``` rpm -ivh https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm yum install -y mysql-community-server systemctl start mysqld systemctl enable mysqld 获取初始密码 grep 'temporary password' /var/log/mysqld.log 登录修改密码，将下方的新密码替换为自己的复杂密码 mysql -uroot -p初始密码 ALTER USER 'root'@'localhost' IDENTIFIED BY '你的新密码'; 创建系统库 CREATE DATABASE pre_sale_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; exit ```

执行以下命令安装ElasticSearch7.10：

``` rpm -ivh https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.10.2-x86_64.rpm 修改配置文件 echo 'network.host: 0.0.0.0' >> /etc/elasticsearch/elasticsearch.yml echo 'discovery.type: single-node' >> /etc/elasticsearch/elasticsearch.yml systemctl start elasticsearch systemctl enable elasticsearch 验证，返回json数据即为成功 curl http://localhost:9200 ```

执行以下命令安装MinIO对象存储：

``` wget https://dl.min.io/server/minio/release/linux-amd64/minio -P /usr/local/bin/ chmod +x /usr/local/bin/minio mkdir -p /data/minio 启动命令，将MINIO_ROOT_PASSWORD修改为你的自定义密码 nohup minio server /data/minio --console-address ":9001" & echo 'export MINIO_ROOT_USER=admin' >> /etc/profile echo 'export MINIO_ROOT_PASSWORD=你的MinIO密码' >> /etc/profile source /etc/profile ```

二、系统部署实操

2.1 程序包下载

执行以下命令下载编译好的可执行jar包：

``` wget https://github.com/opensource-pre-sale/pre-sale-archive/releases/download/v1.0.0/pre-sale-archive.jar -P /opt/pre-sale/ ```

2.2 配置文件编写

在/opt/pre-sale目录下新建application.yml文件，内容如下，所有标“替换为你自己的”的字段修改为你的实际配置：

```yaml server: port: 80 spring: datasource: url: jdbc:mysql://localhost:3306/pre_sale_archive?useUnicode=true&characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai username: root password: 替换为你的MySQL密码 driver-class-name: com.mysql.cj.jdbc.Driver elasticsearch: uris: http://localhost:9200 servlet: multipart: max-file-size: 100MB max-request-size: 100MB minio: endpoint: http://替换为你的服务器IP:9000 accessKey: admin secretKey: 替换为你的MinIO密码 bucketName: pre-sale-archive ocr: lang: chi_sim ```

2.3 启动与验证

执行以下命令启动系统：

``` cd /opt/pre-sale nohup java -jar pre-sale-archive.jar --spring.config.location=./application.yml & ```

等待30秒后执行curl http://localhost/health，返回{"code":200,"msg":"success"}即为启动成功，浏览器访问你的服务器IP，默认账号为admin，默认密码为123456，即可进入系统后台。

三、核心功能配置实操

3.1 元数据模板配置

按照以下步骤配置预售许可证的录入字段：

• 登录后台→进入【系统管理】→【元数据管理】→点击【新建模板】
• 依次添加以下字段：预售证号（字符串类型）、项目名称（字符串类型）、开发企业（字符串类型）、预售面积（数字类型）、许可日期（日期类型）、附件（文件类型）
• 必须将“预售证号”字段设置为唯一主键，避免重复录入同一预售证档案
• 保存模板后设为默认启用模板

3.2 归档流程配置

先安装OCR中文语言包，执行命令：

``` yum install -y tesseract tesseract-langpack-chi_sim ```

再按照以下步骤配置归档流程：

• 进入【业务配置】→【归档流程】→点击【新增流程】
• 节点依次设置为：录入员上传→初审员核验→复审员终审→自动归档入库
• 进入【系统管理】→【角色管理】，新建录入员、初审员、复审员三个角色，分别绑定对应流程节点的操作权限
• 开启流程配置页的“自动OCR识别”开关，系统会自动提取上传的预售证PDF/扫描件中的核心字段，减少人工录入量

3.3 全文检索配置

按照以下步骤配置检索能力：

• 进入【检索配置】→【全文检索配置】→勾选所有元数据字段作为检索维度
• 开启“模糊匹配+精确检索”双模式，预售证号字段默认设置为精确匹配，其余字段支持模糊检索
• 点击【重建索引】按钮，等待1-2分钟索引重建完成即可使用全文检索功能

四、上线前必做检查与常见问题排查

4.1 上线前必做检查项

• 修改默认admin密码，复杂度要求8位以上，包含数字、字母、特殊符号
• 配置HTTPS证书，可通过Let's Encrypt免费申请，执行命令：yum install -y certbot && certbot certonly --webroot -w /var/www/html -d 你的域名，然后在配置文件中添加SSL配置即可
• 开启定时备份，将以下命令加入crontab，实现每天凌晨1点自动备份数据库：0 1 mysqldump -u root -p你的MySQL密码 pre_sale_archive > /backup/$(date +%Y%m%d).sql
• MinIO开启多副本备份，避免档案文件丢失

4.2 常见问题排查

• 大文件上传失败：检查application.yml中spring.servlet.multipart的两个配置是否都设置为100MB，若使用Nginx反向代理，需在Nginx配置中添加client_max_body_size 100M;
• 检索不到最新上传的档案：执行curl http://localhost:9200/_cat/indices 检查pre_sale_archive索引是否存在，若不存在则在后台手动触发重建索引即可
• OCR识别准确率低：确认已安装tesseract中文语言包，上传的预售证扫描件分辨率建议在300DPI以上，避免出现遮挡、模糊的情况