Kimai 部署指南：开源工时记录系统，自建项目计费平台

Kimai 部署指南开源工时记录系统自建项目计费平台Kimai 是一个开源的工时追踪系统支持按项目、客户、活动分类记录时间自动生成发票非常适合自由职业者、小型设计/开发工作室、需要向客户计费的团队。SaaS 版本同类工具如 Toggl、Harvest每人每月都要收费自建 Kimai 完全免费功能一点不少。适用场景自由职业者记录各客户的工时月底生成发票设计/开发团队统计每个项目的工时成本公司内部工时合规记录多人团队的工时汇总报表服务器配置规格推荐CPU1 核内存512MB硬盘10GB非常轻量可以和其他服务共用一台机器。我把 Kimai 和 Monica、Actual Budget 等工具放在同一台 雨云服务器 rainyuncom 入门款机型上总内存用量不到 1GB。注册填优惠码2026off领 5 折优惠券比 Toggl Business 版便宜 99%。Docker Compose 部署mkdir-p/opt/kimaicat/opt/kimai/docker-compose.ymlEOF version: 3.8 services: sqldb: image: mysql:8.0 container_name: kimai_db volumes: - mysql:/var/lib/mysql environment: - MYSQL_DATABASEkimai - MYSQL_USERkimai - MYSQL_PASSWORD数据库强密码 - MYSQL_ROOT_PASSWORDRoot强密码 command: --default-storage-engine innodb healthcheck: test: [CMD-SHELL, mysqladmin -u kimai -p数据库强密码 ping] interval: 10s timeout: 5s retries: 5 restart: unless-stopped kimai: image: kimai/kimai2:apache container_name: kimai ports: - 8001:8001 environment: - ADMINMAILadmin你的域名.com - ADMINPASS管理员强密码 - DATABASE_URLmysql://kimai:数据库强密码sqldb/kimai?charsetutf8mb4serverVersion8.0.32 - TRUSTED_HOSTSkimai.你的域名.com,localhost - MAILER_URLsmtp://邮件账号:邮件密码smtp.你的邮件服务商.com:587?encryptiontls - MAILER_FROMkimai你的域名.com volumes: - kimai-data:/opt/kimai/var/data - kimai-public:/opt/kimai/public/avatars depends_on: sqldb: condition: service_healthy restart: unless-stopped volumes: mysql: kimai-data: kimai-public: EOFcd/opt/kimaidockercompose up-d等待约 1 分钟初始化完成dockercompose logs-fkimai# 看到 apache2 is ready 后再访问配置 HTTPSCaddysudotee-a/etc/caddy/CaddyfileEOF kimai.你的域名.com { reverse_proxy localhost:8001 } EOFsudosystemctl reload caddy初始设置访问https://kimai.你的域名.com用admin你的域名.com和管理员密码登录。基础配置顺序创建客户Customers创建项目Projects并关联客户创建活动类型Activities如「开发」「设计」「会议」「测试」邀请团队成员Users核心使用流程开始计时首页 → 开始计时 选择项目 → 活动 → 描述可选 → 开始计时器在后台运行可以随时暂停或停止。手动添加工时工时单 → 新建工时单 填写开始时间、结束时间、项目、活动查看工时统计报表 → 工时统计 筛选条件日期范围、客户、项目、员工 导出格式Excel / CSV / PDF发票生成Kimai 内置发票模板可以直接生成发票 PDF发票 → 创建发票 - 选择客户 - 设置账单日期和截止日期 - 选择要纳入发票的工时单 - 设置单价按小时或固定价格 → 预览 → 导出 PDF自定义发票模板HTML/Twig 格式管理 → 发票模板 → 新建模板团队功能用户角色角色权限Super Admin全部权限Admin管理系统设置Teamlead管理团队成员的工时User只能管理自己的工时审批流程管理员可以审批员工的工时记录确认后不可修改工时单 → 审批 → 批量审批移动端访问Kimai 的 Web 界面支持响应式布局手机浏览器访问效果很好随时可以开始/停止计时。也可以使用第三方 Kimai 移动 AppiOS/Android连接到你的服务器地址。插件扩展Kimai 有丰富的免费插件# 在容器内安装插件dockerexec-itkimaibashcd/opt/kimai# 常用插件composerrequire kimai/kimai-plugins:^2.0 bin/console kimai:plugin:install常用插件Translation更多语言支持ExpenseBundle记录项目支出MetaFieldsBundle自定义字段CustomCSSBundle自定义样式数据备份cat/opt/backup_kimai.shEOF #!/bin/bash docker exec kimai_db mysqldump -u kimai -p数据库强密码 kimai /backup/kimai-$(date %Y%m%d).sql find /backup -name kimai-*.sql -mtime 30 -delete EOFchmodx /opt/backup_kimai.shecho0 2 * * * /opt/backup_kimai.sh|crontab-更新cd/opt/kimaidockercompose pulldockercompose up-dKimai 对自由职业者和小型工作室来说是非常实用的工具。把工时记录和发票生成结合在一起月底对账和开票效率大大提高。部署在雨云服务器上所有客户数据、工时记录都在自己手里不用担心第三方 SaaS 服务的数据安全问题。