3分钟上手!开源HRMS系统本地部署全攻略:从安装到员工管理零代码实现
【免费下载链接】hrms Open Source HR and Payroll Software 项目地址: https://gitcode.com/GitHub_Trending/hr/hrms
你还在为企业HR系统每年支付数万元订阅费?尝试过的开源软件不是缺核心功能就是部署门槛高?本文亲测当前GitHub最火的开源HRMS解决方案,全程零代码、3步完成部署,包含员工入离职管理、考勤打卡、薪资核算等20+企业刚需功能,完全适配国内中小企业使用场景。
读完本文你将获得:
- Docker一键部署HRMS的完整操作指南
- 员工自助端与管理后台的配置要点
- 考勤规则与薪资模块的避坑技巧
- 移动端应用的无缝接入方案
项目简介:为什么选择Frappe HRMS
Frappe HRMS是GitHub上星标超1.5万的开源人力资源管理系统,基于Python+Vue.js构建,提供从员工入离职到薪资发放的全流程管理。与传统HR软件相比,它具备三大核心优势:
- 全功能覆盖:包含组织架构管理、招聘流程、考勤打卡、绩效评估、薪资核算等13个功能模块,完整功能清单
- 本地化适配:已内置中国法定节假日数据,支持多级别审批流程与社保公积金计算
- 移动端支持:配套PWA应用实现员工手机打卡、请假申请,前端源码
部署准备:3分钟环境检查清单
在开始部署前,请确认你的服务器满足以下条件(以Linux系统为例):
| 环境要求 | 最低配置 | 推荐配置 |
|---|---|---|
| CPU | 2核 | 4核 |
| 内存 | 4GB | 8GB |
| 存储 | 20GB SSD | 50GB SSD |
| 网络 | 开放8000端口 | 配置域名与SSL |
必须安装的依赖工具:
- Docker Engine 20.10+
- Docker Compose v2+
- Git 2.30+
检查命令:
docker --version && docker-compose --version && git --version
部署步骤:Docker一键启动方案
1. 获取源码与启动容器
通过Git克隆仓库并启动Docker容器(全程无需手动配置数据库):
git clone https://gitcode.com/GitHub_Trending/hr/hrms
cd hrms/docker
docker-compose up -d
docker-compose.yml配置文件详解:
- 使用MariaDB 10.8作为数据库,数据持久化存储在mariadb-data卷
- 映射8000端口作为Web访问入口,9000端口为后台进程通信
- 自动执行init.sh完成初始化,查看配置文件
2. 系统初始化与登录
容器启动后等待约2分钟(首次启动需创建数据库表结构),通过以下地址访问系统:
- 管理后台:http://服务器IP:8000
- 默认账号:Administrator
- 默认密码:admin
首次登录强制修改密码后,系统会自动进入引导式配置界面,完成组织架构创建: 
核心功能配置:企业实战指南
组织架构搭建
- 在【设置】→【公司】中创建企业信息,注意配置正确的纳税地区
- 通过【组织架构】模块导入部门数据,支持CSV批量导入
- 配置岗位体系与汇报关系,数据模型定义
考勤系统配置
- 在【考勤】→【考勤规则】中设置:
- 工作时间:如"09:00-18:00",支持弹性打卡
- 迟到规则:15分钟内警告,30分钟按旷工处理
- 加班计算:平时加班1.5倍,周末加班2倍
- 导入年度节假日,系统已内置2025年全国法定假日数据
- 启用移动端打卡,配置允许打卡的地理范围(需在mobile settings中设置经纬度)
薪资模块配置
- 在【薪资】→【薪资结构】中创建:
- 基础薪资项目:基本工资、绩效工资等
- deduction项目:社保、公积金、个税等
- 配置个税计算规则,系统已内置2025年个税累进税率
- 测试薪资计算,生成薪资条示例
移动端接入:员工自助服务
HRMS提供PWA应用,员工可通过手机完成日常操作:
- 员工使用工号登录Web系统后,在个人中心点击"安装应用"
- 支持的功能:
- 上下班打卡(带地理位置验证)
- 请假申请与审批
- 查看薪资条与缴税记录
- 提交费用报销
- 移动端源码
常见问题解决
容器启动失败
检查日志命令:
docker-compose logs -f frappe
常见原因:端口冲突(修改docker-compose.yml中8000:8000为其他端口)
中文显示乱码
进入容器修改数据库配置:
docker exec -it hrms_frappe_1 bash
mysql -u root -p123
ALTER DATABASE hrms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
数据备份方案
每日自动备份脚本示例(保存为backup.sh并添加定时任务):
docker exec hrms_mariadb_1 mysqldump -u root -p123 hrms > /backup/hrms_$(date +%Y%m%d).sql
功能扩展与社区支持
HRMS采用模块化架构,可通过以下方式扩展功能:
获取社区支持:
部署总结与下一步行动
通过本文的3步部署法,你已成功搭建企业级HR管理系统。建议后续完成:
- 进行数据迁移:从Excel导入现有员工信息
- 配置邮件服务器:实现通知自动发送
- 开启SSL加密:保护敏感薪资数据传输
现在就可以开始创建第一个员工账号,体验完整的HR管理流程。如有任何部署问题,欢迎在评论区留言讨论。
本文配套视频教程:B站部署实操(非官方链接,供参考)
【免费下载链接】hrms Open Source HR and Payroll Software 项目地址: https://gitcode.com/GitHub_Trending/hr/hrms
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考






