企业级开源HR档案管理软件部署 全流程实操落地无坑指南

一、前期准备 软硬件环境要求

1.1 硬件最低配置

云服务器部署选2核4G、带宽1M以上实例，操作系统优先选CentOS7.9或Ubuntu22.04；本地测试部署可选Windows10及以上系统，配置8G以上内存即可。

1.2 软件依赖安装（CentOS环境为例）

所有依赖均为开源免费版本，执行以下命令逐一安装：

• 安装JDK1.8：yum install -y java-1.8.0-openjdk-devel，安装完成执行java -version验证，返回版本信息即为成功
• 安装MySQL5.7：yum install -y mysql-server，启动服务systemctl start mysqld，执行mysql_secure_installation设置root密码，按需开启远程访问权限
• 安装Node.js14.x：执行curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash，重载环境变量source ~/.bashrc，再执行nvm install 14.21.3，完成后node -v验证版本
• 安装Redis5.x：yum install -y redis，启动服务systemctl start redis，设置开机自启systemctl enable redis
• 安装Git、Maven：yum install -y git maven

二、软件获取与基础配置

2.1 源码下载

执行以下命令拉取开源HR档案管理系统源码：
git clone https://gitee.com/erui/hr_archives.git

2.2 后端配置

第一步创建业务数据库：登录MySQL执行create database ry_hr character set utf8mb4 collate utf8mb4_general_ci;，切换到该数据库use ry_hr;，导入初始数据source /root/hr_archives/sql/ry_hr.sql;（路径替换为你自己的源码存放路径）。

第二步修改数据库配置：进入后端配置目录cd hr_archives/ruoyi-admin/src/main/resources，编辑application-druid.yml，替换为以下内容，仅需修改MySQL密码即可：

```yaml spring: datasource: druid: master: url: jdbc:mysql://localhost:3306/ry_hr?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8 username: root password: 替换为你的MySQL root密码 driver-class-name: com.mysql.cj.jdbc.Driver ```

第三步修改Redis配置：编辑同目录下application.yml，找到redis配置块，若本地Redis无密码直接删除password行即可。

2.3 前端配置

进入前端目录cd hr_archives/ruoyi-ui，执行npm install --registry=https://registry.npmmirror.com安装前端依赖。编辑vue.config.js，找到proxy配置块，修改后端接口地址：

```javascript proxy: { '/dev-api': { target: `http://替换为你的服务器IP:8080`, changeOrigin: true, pathRewrite: { '^/dev-api': '' } } } ```

三、服务启动与登录验证

3.1 后端启动

回到项目根目录cd /root/hr_archives，执行打包命令mvn clean package -Dmaven.test.skip=true，打包完成后进入jar包目录cd ruoyi-admin/target，后台启动服务nohup java -jar ruoyi-admin.jar &，执行tail -f nohup.out查看日志，出现“启动成功”提示即为后端运行正常。

3.2 前端部署（生产环境）

安装Nginx：yum install -y nginx，进入前端目录执行npm run build:prod打包，将生成的dist目录移动到Nginx静态资源目录mv dist /usr/share/nginx/html/。编辑Nginx配置文件/etc/nginx/conf.d/hr.conf，写入以下内容：

```nginx server { listen 80; server_name 替换为你的服务器IP或绑定的域名; location / { root /usr/share/nginx/html/dist; index index.html index.htm; try_files $uri $uri/ /index.html; } location /prod-api/ { proxy_set_header Host $http_host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header REMOTE-HOST $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_pass http://localhost:8080/; } } ```

执行nginx -t验证配置无误后，systemctl restart nginx重启Nginx生效。

3.3 登录验证

浏览器访问你的服务器IP或域名，默认账号：admin，默认密码：admin123，登录后即可看到员工档案管理模块，支持录入、查询、批量导入导出、异动记录等核心功能。

四、核心功能自定义配置

4.1 档案字段自定义

操作路径：登录后进入系统管理-字典管理-新增字典，字典类型固定填hr_archives_field，字典键值填你需要新增的字段名，比如“紧急联系人电话”“社保缴纳地”，排序值按需填写，保存后刷新员工档案编辑页即可看到新增字段。

4.2 档案权限隔离

操作路径：系统管理-角色管理-新增角色，角色名称填“HR档案专员”，权限仅勾选「员工档案-查询、新增、编辑」，不勾选删除、导出、查看敏感字段权限，保存后给对应HR账号绑定该角色，即可实现普通员工无法查看档案、HR专员无删除权限的分级管控。

4.3 自动备份配置

编辑后端application.yml，在底部新增以下配置，即可实现每天凌晨2点自动备份全量档案数据，备份文件保留30天：

```yaml hr: backup: enable: true cron: 0 0 2 ? path: /opt/hr_backup keep-days: 30 ```

配置完成后执行ps -ef | grep ruoyi-admin | grep -v grep | awk '{print $2}' | xargs kill -9重启后端服务生效。

五、常见问题排查

• 前端访问404：检查Nginx配置中root路径是否与dist目录存放路径一致，确认try_files配置是否正确
• 后端接口报错500：查看后端nohup.out日志，优先检查数据库连接配置是否正确、初始SQL是否完整导入
• 上传档案附件失败：执行mkdir -p /opt/hr_upload && chmod 777 /opt/hr_upload给附件上传目录赋读写权限
• 端口无法访问：检查服务器安全组是否开放80、8080端口，确认防火墙未拦截对应端口