如何开始使用 Kimai?
Kimai 提供两条上手路径：想省去服务器维护，选 Kimai Cloud，官网标注“免费开始”，即时开通、自动更新与备份、插件包含在内；想完全掌控数据和基础设施，选 自托管，从官网下载后用 Docker 或手动安装，代码基于 AGPL 3 开源。两条路径共用同一套核心功能，先确定部署方式，再按下面的步骤走。
先判断：Cloud 还是自托管
| 维度 | Kimai Cloud | 自托管 |
|---|---|---|
| 部署方式 | 托管 SaaS，无需服务器 | 自己的服务器，Docker 或手动安装 |
| 维护责任 | 官方负责基础设施、更新与备份 | 自己负责升级、备份、运行环境 |
| 数据控制 | 数据存放在服务方（官网称 GDPR 合规的欧盟托管） | 100% 数据自主 |
| 支持渠道 | 优先支持 | 社区支持 |
| 插件 | 已包含 | 通过插件市场自行安装 |
| 授权 | 商业托管服务 | 开源（AGPL 3） |
判断标准很简单：团队没有运维人力、希望当天就能开始记录工时，选 Cloud；有合规或数据主权要求、已有服务器和运维能力，选自托管。官网引用的客户反馈中，Pagemachine AG 就明确提到选择 Kimai 的原因是“开源、数据主权和对软件的完全控制”。
路径一：使用 Kimai Cloud
- 打开官网 kimai.org，进入定价页查看当前方案与限制（价格与试用条款以页面实时信息为准，本文不代为判断是否免费）。
- 点击“免费开始”完成注册，按提示创建账号。
- 登录后先建立基础数据：客户 → 项目 → 活动，这是 Kimai 记录工时的三层结构。
- 开始计时或手动补录条目，然后在报表中按用户、客户、项目、活动、标签、时间段等维度查看汇总。
- 需要对外出账时，配置发票模板（支持 PDF、DOCX、HTML、XLSX、ODS 格式，可自定义编号与条目分组）。
预期结果：无需接触服务器即可完成从计时到出报表、出发票的闭环。
路径二：自托管部署
前提：一台可运行 Docker 的服务器（或满足手动安装要求的环境），以及基本的运维能力。
- 从官网“自托管服务 → 下载”获取安装包或镜像。
- 按官方文档选择 Docker 或手动安装方式完成部署。
- 完成初始配置，创建管理员账号。
- 按需从插件市场安装扩展。
- 建立客户、项目、活动结构后即可开始记录。
验证方法：登录后新建一条计时记录，确认能正常保存并在报表中出现；再测试一次发票导出，确认模板渲染正常。
常见卡点：自托管意味着更新、备份和安全加固都由自己承担，部署前先确认有人负责这些事；如果团队依赖 LDAP、SAML 单点登录或 TOTP 双因素认证，需在配置阶段一并接入（官网说明支持 Google Workspace、Azure AD、Authentik 等身份提供者）。
两条路径共有的核心能力
- 认证与安全：外部身份提供者登录（LDAP、SAML）、TOTP 双因素认证。
- 报表与分析：按用户、客户、项目、活动、标签、时间段等维度评估已记录时间。
- 发票：多模板、条目分组、可配置编号，支持自定义 PDF、DOCX、HTML、XLSX、ODS 模板。
- JSON API：读写数据，供外部应用和自建工具对接。
- 多语言界面：官网提供包括中文在内的多种语言版本，界面可切换。
上手前可以先试
官网提供演示入口、文档和用户手册，正式部署前可先用演示环境走一遍计时、报表、发票流程，确认工作流是否符合团队习惯。如果只是个人或小团队记录日常工时，Cloud 的即时开通通常比自建更省事；如果时间数据涉及敏感客户或需要长期自主保存，自托管更合适。