Docker部署OrangeHRM（人事管理）

OrangeHRM是什么？

OrangeHRM 是一款诞生于 2005 年的全球知名人力资源管理系统，为企业提供从招聘、员工档案、考勤休假、绩效评估到薪酬福利、培训发展的全流程 HR 管理解决方案。它以模块化、高灵活度和多语言支持著称，尤其开源版本凭借零成本部署、可定制扩展的优势，深受中小团队与开发者青睐，帮助 HR 部门高效处理事务性工作，同时为企业提供数据驱动的人力决策支持。

工具特点：

员工信息管理：集中存储员工档案、职位 / 薪资变动记录
招聘与入职管理：职位发布、候选人全流程跟踪、面试排期与自动化提醒，可对接企业官网招聘页
考勤与工时管理：支持打卡 / 线上签到、排班配置，自动统计出勤、迟到早退数据并生成报表
休假与考勤管理：员工自助请假、多级审批流、假期余额自动计算，支持多种休假规则配置
绩效管理：目标设定、360 度评估、9-box 矩阵分析，可自定义绩效周期与评估模板
报表与数据分析：内置多维度 HR 报表（员工人数、招聘效率、出勤统计），支持自定义报表与定时推送
权限与安全管理：自定义用户角色、多因素认证、操作审计日志，记录所有系统变更行为
扩展与集成能力：提供 REST API 接口，支持插件扩展，可对接其他系统实现数据同步
移动端适配：支持手机端请假审批、考勤打卡、候选人查看，满足移动办公场景
多语言与本地化：支持中文在内的多语言界面，适配不同地区的 HR 流程与合规需求

有哪些使用场景：

适用于多种 HR 管理场景，既可以帮助中小企业以低成本搭建一站式员工档案、考勤休假与绩效管理体系，也能支撑多部门、多地点团队的跨地域 HR 协同与招聘流程标准化；同时它也支持员工自助服务，减少 HR 事务性工作，还能通过自动报表满足企业内部管理与外部审计的合规需求，其开源特性也方便企业进行二次开发，对接现有 OA、财务系统。

OrangeHR安装部署

1、常见本地存储目录

复制代码

 mkdir -p /opt/orangehrm /opt/orangehrm/data
 cd /opt/orangehrm

2、Docker Compoese配置

连接外部数据库

复制代码

 version: '3'
 services:
   orangehrm:
     image: orangehrm/orangehrm:latest
     container_name: orangehrm
     restart: always
     ports:
       - "8202:80"
     volumes:
       - ./data:/orangehrm
     environment:
       - MYSQL_HOST=192.168.1.64
       - MYSQL_PORT=3306
       - MYSQL_DATABASE=orangehrm
       - MYSQL_USER=root
       - MYSQL_PASSWORD=123456

3、Docker Compoese带数据库安装版本

复制代码

 version: '3'
 
 services:
   mysql:
     image: mysql:8.0
     container_name: orangehrm-mysql
     restart: always
     ports:
       - "3306:3306"
     volumes:
       - mysql_data:/var/lib/mysql
     environment:
       MYSQL_ROOT_PASSWORD: 123456
       MYSQL_DATABASE: orangehrm
       MYSQL_USER: root
       MYSQL_PASSWORD: 123456
     command:
       --default-authentication-plugin=mysql_native_password
       --character-set-server=utf8mb4
       --collation-server=utf8mb4_unicode_ci
 
   orangehrm:
     image: orangehrm/orangehrm:latest
     container_name: orangehrm
     restart: always
     ports:
       - "8202:80"
     volumes:
       - ./data:/orangehrm
     environment:
       MYSQL_HOST: mysql
       MYSQL_PORT: 3306
       MYSQL_DATABASE: orangehrm
       MYSQL_USER: root
       MYSQL_PASSWORD: 123456
     depends_on:
       - mysql
 
 volumes:
   mysql_data:

额外说明：

depends_on 保证先启动数据库再启动 OA 系统

数据库数据用命名卷 mysql_data 持久化，删容器数据不丢

4、使用Docker命令方式

复制代码

 docker run -d \
   --name orangehrm \
   --restart always \
   -p 8202:80 \
   -v $(pwd)/data:/orangehrm \
   -e MYSQL_HOST=192.168.1.64 \
   -e MYSQL_PORT=3306 \
   -e MYSQL_DATABASE=orangehrm \
   -e MYSQL_USER=root \
   -e MYSQL_PASSWORD=123456 \
   orangehrm/orangehrm:latest

OrangeHR使用指南

1、注意事项和初始化

1）初始账号密码

默认：admin / admin
登录后立刻改密码 + 开启强制密码复杂度

2）汉化设置

设置路径：开启中文

Admin → Configuration → Localization

Language：选 Chinese (Simplified)
保存后刷新，大部分界面变中文

没有汉化设置，下载语言包

2、人员管理

1）添加管理员

2）添加员工

3、高效管理员工

1）批量导入员工（Excel）

路径：PIM → Employee List → Import

下载模板，填好员工信息（ID、姓名、部门、岗位等）
支持批量覆盖 / 新增，避免手动逐条添加

2）自定义员工字段

路径：PIM → Configuration → Custom Fields

新增字段：如 "工牌号""紧急联系人""社保号"
字段类型：文本、日期、下拉框，支持必填 / 选填。

3）组织架构图可视化

路径：Organization → Organization Chart

自动生成上下级关系图，支持导出图片 / PDF