
30秒速读:TimeTracker 是把工时追踪、项目管理和开票装进同一个自托管应用的工具,计时存在服务器端,关掉浏览器也不会丢,工时可以直接走到 PDF 发票乃至 Peppol 电子发票。它适合自由职业者、小型团队和代理机构,前提是你能接受自己维护 Docker、数据库、HTTPS 和备份。不想碰服务器运维的人,直接选托管型计时工具更省心。
软件信息
| 软件名称 | TimeTracker |
| 一句话定位 | 自托管工时追踪、开票与 Peppol 电子发票平台 |
| 运行方式 | Python + Flask 自托管 Web 应用,Docker / Docker Compose 部署,内置 PostgreSQL |
| 系统要求 | Docker 20.10+、Docker Compose 2.0+,建议 2GB 以上内存 |
| 核心能力 | 服务器端持久计时、项目与任务管理、PDF 发票、Peppol Bridge 电子发票 |
| 发票标准 | PDF 内嵌 Factur-X / ZUGFeRD XML,Peppol BIS,EN 16931 |
| 许可证 | GPL-3.0 |
| 获取渠道 | GitHub 仓库与 Docker 镜像,支持 NAS、VPS、树莓派等自托管环境 |
从计时到收款的一条线
很多计时工具只管记时间,账单还得另起一套流程,TimeTracker 想打通的是计时、项目、开票三个环节都在一处完成。
- 服务器端持久计时:计时状态存在服务器,不依赖浏览器页面一直开着,关电脑、换设备都不会把进行中的计时弄丢。
- 项目与任务管理:按客户、项目、任务组织工时,多个客户并行时账算得清楚,不会月底对账才发现时间记混了客户。
- PDF 发票:工时可以直接生成 PDF 发票,还能在 PDF 里嵌入 Factur-X 或 ZUGFeRD XML,让对方的财务系统能机读发票内容。
- Peppol 电子发票:内置 Peppol Bridge,支持走 Peppol 网络发送符合 EN 16931 的电子发票,适合有跨境或欧洲业务往来的组织。
- Docker 一键起步:官方提供 Docker 镜像和 Compose 文件,NAS 上也有粘贴即用的 compose 配置,部署门槛比从源码搭低得多。
上手指南
- 准备服务器:一台能跑 Docker 的机器即可,NAS、VPS、树莓派都在官方支持的自托管环境里,内存建议 2GB 以上。
- 拉起服务:用官方 Compose 文件启动,默认通过 HTTP 访问 8080 端口,NAS 用户可直接粘贴官方提供的 NAS compose 配置。
- 先设密钥再对外:启动配置里的 SECRET_KEY 必须改成自己的随机值,生产环境不要用默认配置直接暴露到公网。
- 建客户和项目:先把客户、项目、任务结构搭好,再开始计时,事后补结构比事前搭结构更容易记错账。
- 跑一次完整开票:记一笔测试工时,生成一张 PDF 发票,确认金额、税项和客户信息无误,再正式用它给客户开票。
上线前先改这 4 处
- SECRET_KEY:部署第一步就改掉默认密钥,这是会话安全的底线,改完重启服务确认登录状态正常。
- HTTPS 与访问控制:生产环境必须配 HTTPS 并收紧访问入口,计时和发票数据走明文 HTTP 等于把客户账单挂在公网上。
- 数据库备份:给内置 PostgreSQL 定好可恢复的备份,工时和发票是事后无法重算的数据,备份没验过恢复等于没备份。
- 发票信息核对:开票前核对卖方信息、税号、货币和发票格式,Peppol 发送前还要按所在地区要求确认 Peppol Bridge 的配置和连通性。
明确取舍:自托管还是托管型
| 适合选 TimeTracker | 数据必须留在自己的服务器上;需要服务器端持久计时;工时要直接走到 PDF 或 Peppol 发票 |
| 不适合选 TimeTracker | 只想轻量计时不想运维;希望服务商负责合规和基础设施;团队没人愿意管 Docker 和备份 |
| 推荐结论 | 先在内网跑起来,跑通计时到开票全流程并验过备份恢复,再决定是否把它当作正式的计费系统 |
自托管的代价不在安装那一刻,而在之后每一次升级、备份和证书续期。能接受这份长期运维成本,换来的才是数据自主和零订阅费;接受不了,托管型工具的月费其实是替你买了运维。
常见问题
关掉浏览器,计时还在跑吗?在跑。计时状态存在服务器端,不依赖页面保持打开,这是它相对纯前端计时工具最实在的一点。
Peppol 电子发票是不是装好就能发?不是开箱即用。Peppol 的配置、网络连通性和适用范围要按 Peppol Bridge 文档和所在地区要求逐项确认,发票合规不能只看软件功能列表。
国内电子发票能用它吗?要分清楚:Peppol 面向的是欧洲等地区的电子发票网络,与国内税控发票体系不是一回事。国内开票合规要按国内财税要求另行处理,不能把 Peppol 发票直接当国内发票用。
升级前要注意什么?先备份数据库和应用数据,再验证数据库迁移、发票生成和电子发票发送流程,升级后第一张发票先走测试客户,别直接拿真实客户验证。
GitHub 国内访问较慢,如打不开可多刷新几次

关注「软件教程管家」
回复软件名即取即下:网盘下载链接 + 提取码,一步直达,不用再跳转。
本站资源仅供个人学习交流,请勿用于商业用途。软件与资料版权归原作者所有;如有侵权,请通过公众号「软件教程管家」联系我们,我们将在 24 小时内下架处理。查看免责声明 ›







