基于开源档案管理系统的本地化部署实操全流程附真实落地案例

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

一、前置准备

1.1 硬件&环境要求

最低配置需求：2核4G云服务器/本地物理主机，操作系统为CentOS7.9/Ubuntu20.04及以上版本，提前开放服务器80、3306、9000端口，关闭SELINUX。

1.2 依赖资源安装

直接执行以下命令完成基础依赖安装，无需额外手动下载资源：

```bash CentOS系统执行 yum install -y wget unzip java-1.8.0-openjdk mariadb-server mariadb Ubuntu系统执行 apt update && apt install -y wget unzip openjdk-8-jdk mysql-server mysql-client ```

二、部署实操步骤

2.1 数据库配置

按顺序执行以下命令完成数据库初始化，所有命令可直接复制运行：

1. 启动数据库并设置开机自启：
CentOS：systemctl start mariadb && systemctl enable mariadb
Ubuntu：systemctl start mysql && systemctl enable mysql
2. 初始化数据库安全配置：执行mysql_secure_installation，首次输入密码直接回车，设置root密码为Oams@2024，后续所有提示项输入y回车确认
3. 创建档案系统专属数据库：
mysql -u root -pOams@2024 -e "CREATE DATABASE oams DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;"

2.2 档案系统部署

所有操作均无需手动修改参数，直接按顺序执行即可：

1. 下载开源档案系统OAMS稳定版安装包：
wget https://gitee.com/oams-team/oams/releases/download/v2.3.0/oams_v2.3.0.tar.gz
2. 解压安装包到指定目录：tar -zxvf oams_v2.3.0.tar.gz -C /opt/
3. 写入完整配置文件，直接执行以下命令覆盖默认配置： ```bash cat > /opt/oams/config/application.yml << EOF server: port: 9000 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/oams?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: Oams@2024 driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 100MB max-request-size: 200MB oams: file-storage-path: /opt/oams/files/ backup-path: /opt/oams/backup/ EOF ```
4. 创建文件存储目录并赋权：
mkdir -p /opt/oams/files /opt/oams/backup && chmod -R 755 /opt/oams/
5. 导入初始数据库表结构：
mysql -u root -pOams@2024 oams < /opt/oams/sql/init.sql
6. 后台启动系统：cd /opt/oams/ && nohup java -jar oams.jar > run.log 2>&1 &
7. 验证启动状态：执行tail -f run.log，看到Started OamsApplication字样即为启动成功

2.3 系统初始化配置

基于开源档案管理系统的本地化部署实操全流程附真实落地案例

启动成功后按以下步骤完成基础配置：

1. 访问地址：http://你的服务器IP:9000，默认管理员账号admin，密码123456
2. 首次登录必须先修改管理员密码，路径：右上角个人中心→密码修改，设置8位以上含大小写、数字、特殊字符的密码
3. 档案分类配置：左侧菜单→系统管理→分类管理，可按“文书档案/科技档案/人事档案/会计档案”创建一级分类，每个一级分类下可按需创建二级分类，比如人事档案下可分“在职人员/离职人员/退休人员”
4. 权限配置：左侧菜单→角色管理→编辑管理员角色，勾选“档案上传、档案审核、档案导出”权限，如需创建普通用户，可在用户管理中新增，绑定对应角色即可

三、中小企业人事档案落地案例实操

3.1 案例背景

100人规模互联网企业，之前人事档案均存储在HR本地电脑，存在丢失风险、查找效率低、借阅无留痕，本次用上述部署的系统实现全线上档案管理。

3.2 落地操作步骤

1. 批量导入存量档案：进入档案管理→档案导入→下载导入模板，按模板填写档案编号、姓名、部门、入职时间、对应附件，填写完成后先点击格式校验，确认无问题再提交导入，单次最大支持导入1000条档案，附件支持PDF、Word、JPG等常见格式
2. 借阅流程配置：左侧菜单→流程管理→新建流程，配置“员工提交借阅申请→部门负责人审批→人事审批→档案管理员授权访问”，可设置授权有效期，到期后自动收回访问权限，所有操作全程留痕可追溯
3. 自动备份配置：如需开启自动云备份，可在原有配置文件末尾追加以下内容，替换为你自己的阿里云OSS信息后重启系统即可，系统会自动每日凌晨备份全量数据到OSS： ```yaml 追加到application.yml末尾 oams: oss: enable: true endpoint: oss-cn-beijing.aliyuncs.com access-key-id: 你的阿里云AccessKey ID access-key-secret: 你的阿里云AccessKey Secret bucket-name: 你创建的OSS桶名称 ```

该案例落地后，企业档案查找效率提升90%，无丢失风险，借阅流程全程可追溯，完全满足企业档案管理合规要求。

四、常见问题排查

4.1 页面访问失败

1. 检查端口是否开放：执行firewall-cmd --list-ports，没有9000端口的话执行firewall-cmd --add-port=9000/tcp --permanent && firewall-cmd --reload
2. 检查服务是否运行：执行ps aux | grep oams，没有对应进程的话重新执行启动命令，查看run.log日志定位报错原因