统信UOS环境下综合档案管理系统部署配置与实操落地全指南

一、前置准备

1. 硬件与系统要求

硬件最低配置：4核CPU、8G内存、100G可用存储，适配x86_64/ARM64架构；系统要求：统信UOS桌面专业版1050+ / 服务器版1060+，已配置官方apt源。

2. 安装包获取

两种获取方式二选一：

• 桌面端直接打开统信应用商店，搜索「综合档案管理系统统信版」一键获取安装包
• 服务器端执行命令下载官方deb包：wget https://update.uniontech.com/apppool/comprehensive-archives-system-uos_2.1.0_amd64.deb（ARM架构包地址为https://update.uniontech.com/apppool/comprehensive-archives-system-uos_2.1.0_arm64.deb）

二、安装部署实操

1. 系统依赖安装

执行以下命令一键安装所有依赖组件： ```bash sudo apt update && sudo apt install openjdk-11-jdk mariadb-server nginx libfreetype6 libpng16-16 -y ```

必须执行MariaDB安全初始化，执行命令：sudo mysql_secure_installation，按以下步骤操作：

• 初始root密码为空，直接按回车
• 输入新的数据库root密码，建议包含大小写、数字、特殊字符
• 后续所有配置项全部输入Y回车确认

2. 核心程序安装

执行deb包安装命令：sudo dpkg -i ./comprehensive-archives-system-uos_2.1.0_.deb，若提示依赖缺失，执行sudo apt install -f修复后重新执行安装命令即可。

3. 数据库初始化

执行命令登录数据库：sudo mysql -u root -p，输入刚才设置的数据库root密码后，依次执行以下SQL语句： ```sql -- 创建档案系统数据库 CREATE DATABASE archives_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 创建数据库专用用户 CREATE USER 'archives_user'@'localhost' IDENTIFIED BY 'YourPassword@2024'; -- 授权 GRANT ALL PRIVILEGES ON archives_db. TO 'archives_user'@'localhost'; FLUSH PRIVILEGES; -- 导入初始表结构 USE archives_db; source /opt/archives-system/sql/init.sql; exit; ``` 注意将SQL中的`YourPassword@2024`替换为你自定义的数据库用户密码

三、核心配置调整

1. 数据库连接配置

打开配置文件/opt/archives-system/config/application-prod.yml，替换为以下完整配置，仅需修改密码字段即可直接使用： ```yaml server: port: 8080 servlet: context-path: / spring: datasource: driver-class-name: org.mariadb.jdbc.Driver url: jdbc:mariadb://127.0.0.1:3306/archives_db?useUnicode=true&characterEncoding=utf8&useSSL=false username: archives_user password: 替换为刚才设置的archives_user密码 servlet: multipart: max-file-size: 1GB max-request-size: 1GB archives: storage-path: /opt/archives-system/storage backup-path: /opt/archives-system/backup ```

2. 存储路径权限配置

必须配置存储路径权限，否则会出现附件上传失败问题，执行命令： ```bash sudo chown -R www-data:www-data /opt/archives-system/storage /opt/archives-system/backup sudo chmod -R 755 /opt/archives-system/storage /opt/archives-system/backup ```

3. Nginx反向代理配置

新建配置文件/etc/nginx/sites-available/archives.conf，写入以下内容，替换`your_server_ip`为你服务器的实际IP地址： ```nginx server { listen 80; server_name your_server_ip; client_max_body_size 1024M; location / { proxy_pass http://127.0.0.1:8080; 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： ```bash sudo ln -s /etc/nginx/sites-available/archives.conf /etc/nginx/sites-enabled/ sudo nginx -t 提示test is successful后执行重启 sudo systemctl restart nginx ```

四、功能验证与常用操作

1. 系统启动与状态检查

执行以下命令启动系统并设置开机自启： ```bash sudo systemctl start archives-system sudo systemctl enable archives-system ```

执行sudo systemctl status archives-system，显示`active (running)`即为启动成功，若启动失败可查看日志文件/opt/archives-system/logs/error.log定位问题。

2. 初始登录与权限配置

打开浏览器访问`http://你的服务器IP`，默认管理员账号：`admin`，默认密码：`Admin@123456`，登录后第一时间进入个人中心修改管理员密码。

权限配置步骤：

• 进入「系统管理-角色管理」，新建档案录入员、审核员、普通用户三个角色，分别绑定对应操作权限
• 进入「系统管理-用户管理」，新建业务用户，绑定对应角色即可完成权限分配

3. 核心功能实操

• 档案录入：进入「档案管理-新增档案」，填写档号、题名、责任者、保管期限等必填项，上传电子附件，提交后自动入库存档
• 档案借阅：进入「借阅管理-申请借阅」，选择目标档案，填写借阅期限、用途，提交后由管理员审核通过即可查看
• 档案备份：进入「系统管理-备份管理」，点击「立即备份」即可生成全量备份包，支持一键导出、恢复

五、常见问题排查

• 无法访问系统：首先检查防火墙配置，桌面版执行sudo ufw allow 80/tcp，服务器版执行sudo firewall-cmd --add-port=80/tcp --permanent && sudo firewall-cmd --reload开放80端口
• 附件上传失败：检查存储路径权限是否正确，确认Nginx配置中`client_max_body_size`参数已设置为1024M
• 登录提示数据库连接失败：检查`application-prod.yml`中的数据库密码是否与实际设置的`archives_user`密码一致，确认MariaDB服务处于运行状态