云浮本地企事业单位档案管理系统从零搭建完整部署实操指南

一、前置准备

1.1 基础环境要求

准备1台运行CentOS 7.9系统的服务器，最低配置要求：2核CPU、4G内存、50G硬盘，可正常访问公网。本地电脑提前安装好远程连接工具，直接通过以下地址下载：

• WinSCP（文件传输工具）：https://winscp.net/download/WinSCP-5.21.7-Setup.exe
• PuTTY（远程命令工具）：https://the.earth.li/~sgtatham/putty/latest/w64/putty.exe

二、基础依赖部署

2.1 安装JDK 11

通过PuTTY连接服务器后，依次执行以下命令，完成JDK安装：

``` 创建安装目录 mkdir -p /usr/local/java 下载JDK压缩包 wget https://cdn.azul.com/zulu/bin/zulu11.68+17-ca-jdk11.0.21-linux_x64.tar.gz 解压到指定目录 tar -zxvf zulu11.68+17-ca-jdk11.0.21-linux_x64.tar.gz -C /usr/local/java/ 配置全局环境变量 echo 'export JAVA_HOME=/usr/local/java/zulu11.68-ca-jdk11.0.21-linux_x64 export PATH=$PATH:$JAVA_HOME/bin' >> /etc/profile 生效环境变量 source /etc/profile 验证安装，输出版本信息即为成功 java -version ```

2.2 安装MySQL 8.0

依次执行以下命令，完成数据库安装与初始化：

``` 下载MySQL官方yum源 wget https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm 安装yum源 rpm -ivh mysql80-community-release-el7-3.noarch.rpm 安装MySQL服务 yum install -y mysql-community-server 启动服务并设置开机自启 systemctl start mysqld systemctl enable mysqld ```

获取数据库初始密码：grep "temporary password" /var/log/mysqld.log，复制输出中的随机密码，然后执行mysql -uroot -p，粘贴密码登录后，执行以下SQL创建数据库并修改密码：

``` ALTER USER 'root'@'localhost' IDENTIFIED BY 'YunFu@Archive2024'; CREATE DATABASE archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; exit; ```

2.3 安装Nginx

依次执行以下命令完成安装：

``` yum install -y epel-release yum install -y nginx systemctl start nginx systemctl enable nginx 开放80端口，允许外部访问 firewall-cmd --add-port=80/tcp --permanent firewall-cmd --reload ```

三、系统核心部署

3.1 下载系统安装包

执行以下命令创建部署目录并下载适配云浮本地规范的安装包：

``` mkdir -p /opt/yunfu-archive/{config,files} cd /opt/yunfu-archive wget https://gitee.com/yunfu-open/archive-management/releases/download/v1.0/yunfu-archive.jar ```

3.2 配置系统参数

创建配置文件，执行vi /opt/yunfu-archive/config/application.yml，粘贴以下完整内容，不需要修改，直接保存退出即可：

``` server: port: 8081 spring: datasource: url: jdbc:mysql://localhost:3306/archive?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false username: root password: YunFu@Archive2024 driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 100MB max-request-size: 100MB 档案实体文件存储路径 archive: store-path: /opt/yunfu-archive/files ```

3.3 设置开机自启

创建systemd服务文件，执行vi /etc/systemd/system/yunfu-archive.service，粘贴以下内容后保存：

``` [Unit] Description=YunFu Archive Management System After=network.target mysqld.service [Service] Type=simple User=root WorkingDirectory=/opt/yunfu-archive ExecStart=/usr/local/java/zulu11.68-ca-jdk11.0.21-linux_x64/bin/java -jar /opt/yunfu-archive/yunfu-archive.jar --spring.config.location=/opt/yunfu-archive/config/application.yml Restart=always [Install] WantedBy=multi-user.target ```

执行以下命令启动系统并设置开机自启：

``` systemctl daemon-reload systemctl start yunfu-archive systemctl enable yunfu-archive ```

3.4 配置Nginx反向代理

创建Nginx配置文件，执行vi /etc/nginx/conf.d/yunfu-archive.conf，粘贴以下内容，将你的服务器IP替换为实际IP或绑定的域名后保存：

``` server { listen 80; server_name 你的服务器IP; client_max_body_size 100M; location / { proxy_pass http://127.0.0.1:8081; 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：

``` 验证配置，显示test is successful即为正确 nginx -t 重载配置生效 nginx -s reload ```

四、初始化系统

打开浏览器访问你的服务器IP，即可进入系统登录页，默认初始账号密码为：admin / 123456，登录后按以下步骤完成初始化：

1. 进入【个人中心】修改管理员初始密码，避免账号泄露
2. 进入【档案分类管理】，点击新增，按照单位需求添加文书、会计、人事、项目等档案分类
3. 进入【用户管理】，添加各部门工作人员账号，根据岗位分配档案查阅、上传、审核权限
4. 进入【系统设置】，按照云浮市档案局要求配置归档期限、元数据字段，适配本地档案审查规范

五、常见问题排查

无法打开系统首页

1. 执行systemctl status yunfu-archive查看服务状态，若服务未启动，执行journalctl -u yunfu-archive -n 50查看日志，90%的错误为数据库密码配置错误，核对配置文件即可修复；2. 执行firewall-cmd --list-ports确认80端口已开放。

上传大档案失败

确认Nginx配置中已添加client_max_body_size 100M，系统配置文件中已设置100MB最大上传限制，修改后重启Nginx和系统服务即可。