开源时间追踪Kimai完整部署指南,NAS极简配置轻松打造专业计时系统

项目介绍

Kimai 是一款专业级的时间追踪应用，完全开源且免费。它是为自由职业者和拥有数十甚至数百名用户的公司量身打造的时间管理工具。Kimai 不仅能帮助您精确记录项目耗时，还配备了丰富的高级功能，包括 JSON API、发票生成、数据导出、多计时器和打卡模式、标签管理、多用户支持、多时区和多语言支持（已有超过 30 种语言翻译）、SAML/LDAP/数据库身份验证、双因素认证 (2FA) 支持、灵活的角色和团队权限管理、响应式设计、用户/客户/项目级别的费率设置、高级搜索和筛选功能、资金和时间预算管理、详细的报表生成，以及插件支持等众多功能。

无论您是个人自由职业者还是企业管理者，Kimai 都能帮助您更好地管理和追踪工作时间，提高工作效率和账单准确性。

项目地址：点我跳转

部署安装

如果您需要在外网也能访问这个项目，建议配置内网穿透工具。您可以前往 帕斯内网穿透 注册账号，这样就能随时随地访问您的 Kimai 系统。具体的操作步骤可以 点我查看内网穿透全平台快速入门指南，帮助您轻松完成配置。

Docker 快速启动

打开您的 NAS 设备或其他支持 Docker 的平台。

进入本地镜像管理界面，选择'添加镜像'，然后选择'从 URL 添加'的方式。

在镜像地址栏填入：kimai/kimai2:apache（这是包含 Apache 的完整版本，开箱即用）

等待镜像下载完成后，点击启动按钮启动容器。

容器配置说明

勾选开机自动启动 —— 这样每次 NAS 重启后容器会自动运行。

端口映射设置 —— 容器内部运行在 80 端口（HTTP）。您可以将其映射到主机的任意端口，比如 8080、8888 等。如果您的主机 80 端口已被占用，只需修改左侧的映射端口即可，容器内的 80 端口保持不变。

存储位置配置 —— Kimai 需要持久化存储数据库和项目文件。建议在 NAS 上创建一个专用文件夹（如 /mnt/kimai-data），然后将其映射到容器内的 /opt/kimai/var 目录，这样您的所有数据和配置都会被保存下来。

环境变量设置

以下是可配置的环境变量及其默认值：

必须设置：

KIMAI_DATABASE_URL：数据库连接字符串（格式：mysql://user:password@host:3306/kimai）

可选设置：

KIMAI_SECRET：应用密钥，用于加密会话数据

KIMAI_LOCALE：语言设置，默认为 en，可选 de、fr 等 30+ 语言

KIMAI_TIMEZONE：时区设置，默认为 Europe/Berlin

如果您没有现成的 MySQL/MariaDB 数据库，建议同时部署一个数据库容器。其他环境变量通常无需配置，系统会使用默认值。

访问应用

容器启动成功后，在浏览器中访问 http://您的NAS地址:映射端口（比如 http://192.168.1.100:8080），就能看到 Kimai 的登录界面。

默认账号通常是 admin，密码为 admin（首次登录后建议立即修改）。

到此，Kimai 时间追踪系统就已经部署完成，您可以开始记录和管理您的项目时间了！

本篇教程结束