DRYTRIX/TimeTracker

这是什么？

核心功能

• 01服务端计时器，关闭浏览器后仍持续运行
• 02根据跟踪工时生成发票并导出 PDF
• 03支持通过 Peppol 发送发票，并嵌入 EN 16931 XML
• 04费用、付款与预算跟踪，超出阈值时提醒
• 05基于角色的权限控制，支持用户名或 OIDC/SSO 登录
• 06提供带令牌权限范围的 REST API，以及 Flutter 和 Electron 客户端

适用场景

• 同时服务多个客户的自由职业者按小时计费
• 需要跟踪项目预算和客户发票的小型代理机构
• 需要通过 Peppol 网络自行发送电子发票的企业
• 希望免除按席位付费 SaaS 的家庭服务器或 NAS 用户

快速上手

1. 1

   下载 compose 文件，创建带密钥的 .env，并用 Docker Compose 启动

   curl -fsSLO https://raw.githubusercontent.com/drytrix/TimeTracker/main/docker-compose.nas.yml
2. 2

   将 SECRET_KEY 生成并写入 .env

   echo "SECRET_KEY=$(openssl rand -hex 32)" > .env
3. 3

   使用 Docker Compose 启动应用

   docker compose -f docker-compose.nas.yml up -d
4. 4

   在浏览器中打开 http://localhost:8080；首次登录时创建管理员账户

使用前须知

• !默认部署需要 Docker。
• !Peppol 电子发票功能需要通过 Peppol Bridge 进行额外配置。

收录于专题

标签

常见问题

TimeTracker 是什么？

可自托管的时间跟踪与开票应用，提供计时器、项目管理、PDF 发票和 Peppol 电子发票。 TimeTracker 是一款可自托管的网页应用，用于记录工时、管理项目和客户，并将跟踪的时间转为发票。计时器运行在服务端，关闭浏览器后仍会继续计时，通过 Docker Compose 与 PostgreSQL 一同部署。

TimeTracker 可以免费使用吗？用的什么许可证？

TimeTracker 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

TimeTracker 还在维护吗？

活跃维护中。TimeTracker 最近一次提交是在 2026年11月7日。

TimeTracker 适合用来做什么？

同时服务多个客户的自由职业者按小时计费 需要跟踪项目预算和客户发票的小型代理机构 需要通过 Peppol 网络自行发送电子发票的企业 希望免除按席位付费 SaaS 的家庭服务器或 NAS 用户

TimeTracker 怎么安装和运行？

下载 compose 文件，创建带密钥的 .env，并用 Docker Compose 启动: curl -fsSLO https://raw.githubusercontent.com/drytrix/TimeTracker/main/docker-compose.nas.yml 将 SECRET_KEY 生成并写入 .env: echo "SECRET_KEY=$(openssl rand -hex 32)" > .env 使用 Docker Compose 启动应用: docker compose -f docker-compose.nas.yml up -d 在浏览器中打开 http://localhost:8080；首次登录时创建管理员账户

在哪里获取 TimeTracker？

源代码和安装说明在 GitHub 上：https://github.com/DRYTRIX/TimeTracker