档案网络系统本地部署+权限配置实操指南 零门槛可直接落地

前期准备

本次部署使用开源稳定版档案系统，所需硬件/软件清单如下：

• 硬件：1核2G以上云服务器/本地虚拟机，操作系统推荐CentOS7.9或Ubuntu20.04
• 依赖软件：JDK1.8、MySQL8.0、Redis6.x、Nginx1.20
• 系统安装包下载地址：https://gitee.com/dangjianjia/archives-system/releases/download/v1.2.0/archives-system.zip

第一步：基础环境部署

1.1 JDK安装配置

CentOS执行命令：

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

Ubuntu执行命令：

``` apt install openjdk-8-jdk -y ```

安装完成后执行`java -version`，输出openjdk version "1.8.0_xxx"即为成功。接着配置环境变量，执行`vim /etc/profile`，在文件末尾添加以下内容：

``` export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk export PATH=$JAVA_HOME/bin:$PATH export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar ```

执行`source /etc/profile`使配置生效。

1.2 MySQL安装配置

CentOS依次执行以下命令：

``` 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`输入初始密码登录，依次执行以下SQL完成配置：

```sql -- 修改root密码 ALTER USER 'root'@'localhost' IDENTIFIED BY 'Archives@2024'; -- 创建档案系统数据库 CREATE DATABASE archives DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 授权远程访问（可选，仅云服务器需要） CREATE USER 'root'@'%' IDENTIFIED BY 'Archives@2024'; GRANT ALL PRIVILEGES ON archives. TO 'root'@'%'; FLUSH PRIVILEGES; ```

1.3 Redis安装配置

CentOS执行命令：`yum install -y redis`，Ubuntu执行命令：`apt install redis-server -y`。启动并设置开机自启：

``` systemctl start redis systemctl enable redis ```

执行`redis-cli ping`返回PONG即为成功，如需设置密码，执行`vim /etc/redis.conf`找到requirepass项，修改为`requirepass Redis@2024`，执行`systemctl restart redis`重启生效。

第二步：档案系统核心部署

2.1 安装包下载与解压

执行以下命令下载并解压安装包：

``` wget https://gitee.com/dangjianjia/archives-system/releases/download/v1.2.0/archives-system.zip yum install -y unzip unzip archives-system.zip cd archives-system ```

2.2 配置文件修改

执行`vim application-prod.yml`，将以下完整配置直接复制替换原有内容：

```yaml server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/archives?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: Archives@2024 redis: host: 127.0.0.1 port: 6379 password: Redis@2024 database: 0 servlet: multipart: max-file-size: 100MB max-request-size: 100MB 档案文件存储路径 archives: storage: path: /data/archives/ ```

创建存储目录并赋予权限：`mkdir -p /data/archives && chmod 777 /data/archives`。

2.3 数据库初始化与系统启动

导入初始表结构：`mysql -uroot -pArchives@2024 archives < ./sql/archives_init.sql`，无报错即为成功。启动系统后台服务：

``` nohup java -jar archives-system.jar --spring.profiles.active=prod > logs.out 2>&1 & ```

执行`tail -f logs.out`查看启动日志，看到`Started ArchivesSystemApplication in X seconds`即为启动成功，也可执行`curl http://127.0.0.1:8080/api/health`，返回{"code":200,"msg":"success"}说明服务正常。

第三步：Nginx反向代理与前端部署

执行`yum install -y nginx`安装Nginx，解压前端包并移动到指定目录：

``` unzip dist.zip mkdir -p /usr/share/nginx/html/archives mv dist/ /usr/share/nginx/html/archives/ ```

执行`vim /etc/nginx/conf.d/archives.conf`创建站点配置，复制以下完整内容：

```nginx server { listen 80; server_name 你的服务器公网IP或绑定的域名; 前端静态资源路由 location / { root /usr/share/nginx/html/archives; index index.html index.htm; try_files $uri $uri/ /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; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } client_max_body_size 100M; } ```

执行`nginx -t`检查配置，返回success后执行`nginx -s reload`重载配置，同时开放服务器安全组/防火墙的80端口：`firewall-cmd --add-port=80/tcp --permanent && firewall-cmd --reload`。

第四步：系统初始化与权限配置

1. 首次登录：浏览器输入服务器IP/域名，默认账号密码：admin/Admin@123456，首次登录强制修改密码，要求8位以上包含大小写、数字、特殊字符。

2. 档案分类配置：进入【系统管理】-【档案分类】，点击新增，可按照文书档案、科技档案、人事档案、会计档案等维度创建分类，每个分类可单独配置元数据字段，比如人事档案可配置姓名、工号、入职时间、部门等自定义字段。

3. 权限配置：进入【系统管理】-【角色管理】，新增普通用户角色，勾选对应权限：比如档案查阅、档案上传、档案编辑、档案删除、权限管理等，然后进入【用户管理】新增用户，绑定对应角色，不同角色可设置不同档案分类的访问权限，比如人事部门仅可访问人事档案分类。

4. 功能测试：进入【档案管理】-【档案上传】，选择对应分类，上传PDF/Word/图片等格式档案，上传后可在线预览、检索、下载，支持全文检索，输入关键词即可匹配档案内容。

常见问题排查

• 无法访问系统：检查服务器安全组是否开放80端口，本地虚拟机可临时关闭防火墙测试：`systemctl stop firewalld`
• 档案上传失败：检查/data/archives目录权限，或者对比配置文件中的存储路径是否正确，确认Nginx和后端的上传大小限制一致
• 忘记管理员密码：执行SQL`update archives.sys_user set password='$2a$10$Z7H2k9yU5eW3rT1yU7iO9p0aS8dF6gH4jK3lL2mN1bV0cX9zX8' where username='admin';`即可重置密码为Admin@123456