mirror of
https://github.com/okxlin/appstore.git
synced 2026-09-23 16:01:01 +00:00
renovate[bot]
9cb289efa0
Verified before merge: main service image update only; upstream LinuxServer compose requirements reviewed; real 2.61.0 to 2.62.0 upgrade passed with the MariaDB container and 35 tables preserved; APP_SECRET/TRUSTED_HOSTS compatibility fix added for new installs and existing .env files; adapter strict-store passed for versioned and latest packages; logs contained no secret leak or fatal migration error.
67 lines
2.9 KiB
Markdown
67 lines
2.9 KiB
Markdown
# Kimai
|
|
|
|
## 产品介绍
|
|
Kimai 是一个开源的时间跟踪系统，适用于个人、团队和项目工时管理。本应用使用 LinuxServer.io 维护的 Kimai 镜像，并配套 MariaDB 数据库。
|
|
|
|
## 主要功能
|
|
- 记录工作时间、客户、项目和活动
|
|
- 支持团队、用户权限、发票和报表
|
|
- 提供 Web 界面、API 和多语言支持
|
|
- 使用独立 MariaDB 服务持久化业务数据
|
|
|
|
## 访问说明
|
|
- Web 入口：安装后通过 `http://<服务器 IP>:<HTTP 端口>` 访问。
|
|
- HTTPS 入口：如启用容器内 HTTPS，可通过表单配置的 HTTPS 端口访问。
|
|
- 实际端口以安装时填写的 `PANEL_APP_PORT_HTTP` 和 `PANEL_APP_PORT_HTTPS` 为准。
|
|
|
|
## Introduction
|
|
Kimai is an open source time-tracking system for individuals, teams and project-based work. This package uses the Kimai image maintained by LinuxServer.io together with a MariaDB service.
|
|
|
|
## Features
|
|
- Tracks working time, customers, projects and activities
|
|
- Supports teams, user permissions, invoices and reports
|
|
- Provides a web interface, API and multilingual UI
|
|
- Persists application data in a dedicated MariaDB service
|
|
|
|
## 部署说明
|
|
- 本应用使用 Docker Compose 在 1Panel 中部署。
|
|
- 应用分类：CRM。
|
|
- 支持架构：amd64、arm64。
|
|
- 可选版本以应用商店页面为准。
|
|
- 安装后按应用表单中的端口访问 Web UI、SSH 或对应服务。
|
|
|
|
## 端口
|
|
| 变量 | 说明 | 默认值 | 必填 |
|
|
| --- | --- | --- | --- |
|
|
| PANEL_APP_PORT_HTTP | HTTP 端口 | 80 | 是 |
|
|
| PANEL_APP_PORT_HTTPS | HTTPS 端口 | 443 | 是 |
|
|
|
|
## 数据持久化
|
|
| 变量 | 说明 | 默认值 | 必填 |
|
|
| --- | --- | --- | --- |
|
|
| CONFIG_PATH | 配置文件路径 | ./data/config | 是 |
|
|
| DB_DATA_PATH | 数据库数据目录 | ./data/db | 是 |
|
|
|
|
升级或迁移前，请在 1Panel 中备份上述数据目录。
|
|
|
|
## 配置项
|
|
| 变量 | 说明 | 默认值 | 必填 |
|
|
| --- | --- | --- | --- |
|
|
| DB_PASSWORD | 数据库密码 | kimai-change-me | 是 |
|
|
| APP_SECRET | 用于会话和安全令牌的应用密钥 | 安装时随机生成 | 是 |
|
|
| TIME_ZONE | 时区 | Asia/Shanghai | 是 |
|
|
| TRUSTED_HOSTS | 允许访问 Kimai 的主机名正则表达式 | .* | 是 |
|
|
| TRUSTED_PROXIES | 可信代理 | 127.0.0.1/32 | 否 |
|
|
|
|
## 使用说明
|
|
- 安装完成后，在 1Panel 应用页面查看运行状态、端口和日志。
|
|
- `APP_SECRET` 会在新安装时随机生成；旧版本升级时如缺失或为空，升级脚本会生成并写入现有 `.env`。
|
|
- 建议按实际域名或 IP 收紧 `TRUSTED_HOSTS`，使用 `.*` 可保持现有访问方式兼容。
|
|
- 首次启用前，请按安装表单填写域名、账号、密码、Token、数据目录等参数。
|
|
- 如需对外开放访问，请同步检查防火墙、安全组和反向代理配置。
|
|
|
|
## 参考资料
|
|
- 官网: <https://www.kimai.org/>
|
|
- 文档: <https://docs.linuxserver.io/images/docker-kimai/>
|
|
- 源码: <https://github.com/linuxserver/docker-kimai>
|