跳到主内容

Timeminator 怎么用:从 SQLite 单文件到 MySQL 正式部署的完整实操

结论先说:Timeminator 用 SQLite 版跑起来只要一分钟,但放到服务器上给别人用,坑不在代码里,而在三个地方——默认分支是 develop、安装器只在没有 config.php 时才跑、Docker 版的 config.php 根本不持久化。我拿本机 PHP 8.1.33 从头装了一遍,把账、坑和一个不该踩的地雷都过了一遍。

准备:先把三个版本说法对齐

Timeminator 是自托管工时追踪工具,数据模型是"客户 → 项目 → 工作包 → 任务"四级,工时挂在这条链上,同一份数据既出仪表盘也出周历和统计。Community 版 MIT、2 个 star、32 个未关闭 issue,代码在 github.com/freshNfunky/Timeminator-Community。

第一个坑在克隆:默认分支是 develop,不是 main。要发布版就拉 tag——VERSION 文件写着 0.9.1,最新 release v0.9.1 发于 2026-10-15,可仓库到 10-28 还在推提交,十几天有代码没发版。

第二个坑是 PHP 版本,项目自己说了三个数:README 徽章写 8.1+,仓库简介写 8.5,Dockerfile 用 php:8.3-apache。我用 8.1.33 实测跑通了安装、登录和写库,说明 8.1 是真实下限。扩展只要 pdo_sqlite 或 pdo_mysql,加 zip 和 mbstring。

步骤一:SQLite 单文件版,先把界面跑出来

README 让你先 cp config.sample.php config.php 再起服务,这步建议跳过:install.php 的第一段逻辑是"只要 config.php 存在就 302 跳 index.php",安装器压根不执行,而复制过去的账号还是 CHANGE_ME。我照 README 走,访问 install.php 拿到 302,界面进得去、账号一个都没有。

正确顺序两步:源码放好,php -S 127.0.0.1:8111,打开 install.php 填管理员账号(密码至少 8 位)和时区。实测安装 0.93 秒,落地 data/timeminator.sqlite 180,224 字节,17 张表,种子数据 2 角色、10 权限、1 个管理员,登录一次 0.56 秒。

然后是最该说的一条:php -S 不解析 .htaccess。根目录和 data/ 都写了禁止访问 .sqlite、config.php 的规则,内置服务器完全不看。我直接请求 /data/timeminator.sqlite,返回 200、180,224 字节,整个库连密码哈希一起下载;/.htaccess 也是 200,1105 字节原文吐出。config.php 是 200 但 0 字节,因为 PHP 被执行了,算不幸中的幸运。

所以 php -S 只绑 127.0.0.1,别绑 0.0.0.0 给同事演示。要给人访问必须走 Apache 并开 AllowOverride All——这条和 开源论坛系统本地部署那次是同一个坑,PHP 应用的目录保护全靠 Web 服务器,换服务器就换了一套规则。

步骤二:换 MySQL,配置其实只改三处

db_driver 改 mysql,填 host、port、database、user、password,charset 保持 utf8mb4。别省:这项目自带德语界面,备注栏早晚混进中日韩文字和 emoji,三字节 utf8 会截断。

另外三处容易漏:secure_cookies 在 HTTPS 下必须 true(默认 false 是本地开发用的);debug 生产必须 false,否则报错页把路径和 SQL 一起打到浏览器;timezone 默认 Europe/Berlin,国内要改 Asia/Shanghai,不然晚上八点记的工时算成下午两点。

还有个参数值得单独说:day_boundary_hour 默认 4,含义是"凌晨 4 点前记的工时算前一天"。加班到两点,那两小时落在昨天,不会劈到第二天。做日统计、对客户结算单的人需要这个,按自然日算就设 0。

步骤三:Docker 部署,三条只能静态核对的约束

本机没有 Docker,这段是按 compose 和 Dockerfile 逐行读的,没实跑。app-sqlite 与 app-mysql+db 两组都挂在 profiles 下,直接 docker compose up 不会启动任何东西,必须带 --profile sqlite 或 --profile mysql。

第二个更要命:命名卷 tm_data 只挂 /var/www/html/data,config.php 不在里面,注释自己写了"installer-generated config.php is NOT persisted by default"。down 后 up,配置没了,再访问又是安装界面——库和数据都在,应用连不上。要稳就得把一个宿主机空文件 bind mount 到 /var/www/html/config.php。

第三个约束是个认知纠偏:compose 给 app-mysql 设的 TM_DB_HOST 等变量只是给"点安装界面的人"看的提示,运行时应用不读,config.php 才是唯一来源。数据库用 mariadb:11,健康检查是 healthcheck.sh --connect --innodb_initialized,比 ping 端口靠谱。上次换掉官方 compose 才跑起来属于同类问题:官方编排能跑,但它的默认假设和你的部署方式不一定对得上。

结果校验:怎么确认它真的在记账

装完别只看界面能不能开。四张业务表 clients、projects、work_packages、tasks 是一条链,time_entries 除 task_id 还冗余存了 client_id、project_id、work_package_id:按客户出报表不用四级 join,代价是改归属要同步刷工时表。

这张表还有三个字段能看出设计意图:duration_min 落库是分钟数、不是展示时现算;source 记这条工时从哪来(手动、计时器、CSV 导入);batch_id 关联 import_batches,配合 evidence 能做到"整批 CSV 导入一起撤回"。对外包结算来说这比漂亮界面值钱——客户质疑某个月工时,你能说清每条怎么来的。memos 那次部署的顺序也一样:先确认数据落在哪,再谈界面。

常见问题

打开 install.php 直接跳回首页?目录里已经有 config.php。删掉它,想重来就连 data/timeminator.sqlite 一起删,再访问 install.php。

能用 php -S 0.0.0.0:8000 给局域网同事试用吗?不建议。内置服务器不读 .htaccess,实测数据库文件可直接下载。要演示就导一份脱敏数据另开实例,别把真实账号暴露在可访问地址上。

Docker 重启后为什么又要重新安装?config.php 没被卷持久化,数据在 data/ 而配置在根目录。按 compose 注释把宿主机文件挂上去即可。

界面能改成中文吗?目前只有德语(默认)和英语,URL 加 ?lang=en 切换。新增语言是往 lang/ 丢 <code>.php。

免费版有什么代价?Community 版带横幅轮播,并默认开匿名遥测(版本、install_id、哈希标识、截断 IP 四项,缓存 1 小时发一次),可在 Admin → System 关掉。

相关阅读

分享到:

本文链接:https://www.biyeyuanma.cn/post/383.html

服务热线

加我微信

加我微信