Ever Gauzy 111.48.2 介绍与选型指南

Ever Gauzy（ever-co/ever-gauzy）开源 ERP/HRM/ATS/时间追踪平台认知篇：定位、NestJS+Angular 架构、PostgreSQL 依赖链、功能边界、与 Odoo/ERPNext/Dolibarr/Kimai 的量化选型对比，全部信息联网溯源（查询日期 2026-10-23）。

Ever GauzyEver GauzyERP时间追踪项目管理自托管2026/10/23

Ever Gauzy 111.48.2 介绍与选型指南

目标：面向正在为团队选型「时间追踪 + 项目管理 + HR/ERP」一体化开源平台的技术决策者，梳理 Ever Gauzy 的定位、技术架构、功能边界、部署形态与同类竞品量化对比。本文为 A1 认知篇，全部信息来自官方公开渠道联网溯源并逐条标注来源，查询日期 2026-10-23，不含本地实测数据。

一、环境信息

本篇为 A1 认知篇，全部信息来自官方公开渠道联网溯源，不涉及本地实验环境。溯源口径如下：

  • 软件名称：Ever Gauzy（Ever® Gauzy™ Platform，官方仓库 ever-co/ever-gauzy，下文简称 Gauzy）
  • 版本溯源渠道：GitHub Releases 页面与 releases/latest 重定向（https://github.com/ever-co/ever-gauzy/releases）
  • 功能与架构溯源渠道：官方仓库 README.md（v111.48.2 标签）、仓库 package.json/.env.sample（同为 v111.48.2 标签内容）
  • 社区规模量化渠道：shields.io 动态徽章（GitHub Stars、Last Commit、License）
  • 官方站点：https://gauzy.co（官网）、https://docs.gauzy.co（文档，WIP）、https://demo.gauzy.co（在线演示）、https://api.gauzy.co/docs（Headless API 文档）
  • 查询日期：2026-10-23（本文所有量化数据的取证时间）
  • 溯源到的关键版本节点（来自 GitHub Releases 页，2026-10-23 查询）：
版本发布/更新时间（UTC）性质
v111.48.22026-10-03 02:12最新稳定版（GitHub 标记 Latest，releases/latest 重定向指向此版本）
v111.130.392026-10-23 00:33Pre-release（master 分支高频 CI 构建）
v111.130.382026-10-23 00:30Pre-release
v111.130.372026-10-23 00:28Pre-release

💡 解读：Ever Gauzy 采用「高频 CI 预发布 + 低频稳定版」的发版模式——master 分支每日产出多个 Pre-release 构建，稳定版从该流中低频切出（Latest 稳定版 v111.48.2 于 2026-10-03 发布）。生产部署应认准 GitHub 标记 Latest 的稳定 tag，不应跟踪 Pre-release。版本号本身是流水号风格（111.x.x），不代表语义化的大版本阶梯。

二、软件概述

2.1 定位：开源业务管理平台（ERP/CRM/HRM/ATS/PM/时间追踪）

官方 README（v111.48.2）对 Gauzy 的定义是：「Open Business Management Platform for Collaborative, On-Demand and Sharing Economies」（面向协作型、按需与共享经济的开源业务管理平台），官方明示覆盖六大域：

  • 企业资源计划（ERP）
  • 客户关系管理（CRM）
  • 人力资源管理（HRM）
  • 候选人招聘追踪（ATS，Applicant Tracking System）
  • 工作与项目管理（PM）
  • 员工时间追踪、活动与生产力追踪（Time-Tracking / Activity Tracking）

一句话概括：Gauzy 是一个把「员工时间追踪（含桌面端截图/活动监控）」与「项目管理、开票计费、HR/CRM/ERP 后台」做在同一套 Web 平台里的全家桶系统，并提供 Headless API 供自研前端（如同门 Ever Teams）接入。与专注单点的 Kimai（纯时间追踪）相比，Gauzy 的差异点在「时间数据直接驱动计费、开票与绩效」的全链路闭环。

2.2 许可证与维护方

  • 许可证：AGPL-3.0（仓库 LICENSE 与 shields.io License 徽章均确认，查询日期 2026-10-23）。AGPL 对「通过网络提供服务」的场景同样要求开源衍生代码，SaaS 化二次分发需特别注意传染性；官方另提供面向商业客户的企业版许可（README《Security》《License》章节提及 Enterprise edition license）。
  • 维护方：Ever Co.（保加利亚索非亚的软件公司，官网 ever.co），同门项目包括 Ever Teams（React/ReactNative 工作与生产力平台）、Ever Works 等。Gauzy 是该公司开源平台战略的核心载体，配套商业 SaaS（app.gauzy.co，官方标注 Alpha 测试期）。

2.3 社区规模（量化，查询日期 2026-10-23）

指标数值取证渠道
GitHub Stars8.4kshields.io github/stars/ever-co/ever-gauzy 徽章
最近提交today（查询当日仍有提交）shields.io github/last-commit 徽章
版本产出节奏稳定版月级 + Pre-release 日级多枚GitHub Releases 页（见第一章版本节点表）
生态配套ever-charts（Helm）、ever-gauzy-terraform（IaC）、ever-teams（Headless 前端）README《Production》《Quick Start》章节链接

💡 说明：Gauzy 社区规模在同类中处于中上水平（对比见第七章量化表），其显著特点是「同一公司全职维护 + 商业 SaaS 同源」，代码活跃度由商业团队保障，而非纯社区志愿驱动。

三、核心架构

3.1 总体形态：TypeScript 全栈 Nx/Lerna 单体仓库

官方 README《Technology Stack and Requirements》明示的技术栈（查询日期 2026-10-23）：

  • 后端 API：Node.js + NestJS（TypeScript），默认端口 3000，对外路径 /api，同时提供 REST 与 GraphQL 两套接口，并内置 Swagger 文档（官方演示 https://api.gauzy.co/docs）。
  • 前端 UI：Angular（RxJS、ngx-admin 模板体系），默认端口 4200。
  • 工程化：Nx + Lerna 管理的 monorepo，apps/ 下同时容纳 api、gauzy（Web UI）、desktop（Electron 桌面端）、desktop-timer、agent（员工监控代理）、worker（异步任务）、mcp 等多个应用；包管理为 Yarn 1.22.x（package.json 的 packageManager 锁定 yarn@1.22.22，engines 要求 node >=24）。
  • ORM 与数据访问：TypeORM / MikroORM / Knex 三套并存（DB_ORM 环境变量在 typeorm | mikro-orm 间切换），通过 DB_TYPE 支持多数据库。

3.2 数据库与可选基础设施（PostgreSQL 依赖链口径）

  • 数据库选型（README 明示 + .env.sample 的 DB_TYPE 注释确认）：sqlite | postgres | better-sqlite3 | mysql 四种内置可选。默认 better-sqlite3（仅建议演示/测试），生产推荐 PostgreSQL（README 原文：「version 14 or later (16.x recommended for production)」；而官方 docker-compose.infra.yml 实际使用 postgres:17-alpine）。
  • 可选组件（README《Optional / Recommended for Production》逐项列出，均可在缺失时降级运行）：Redis（缓存/限流，多副本必需）、OpenSearch（全文检索，缺失时用数据库内置搜索）、MinIO 或任意 S3 兼容存储（文件存储，FILE_PROVIDER=LOCAL 时落本地盘）、Jitsu（数据摄取）、Cube（BI 语义层）、Zipkin（链路追踪）。
  • 官方 docker-compose.yml（生产形态）即由 api + webapp + 上述 infra 组成，API 容器内以 NODE_ENV=production、node main.js 运行（.deploy/api/Dockerfile）。

💡 技术拓展：Gauzy 的「多数据库支持」来自 TypeORM/MikroORM 的方言抽象，但四种 DB_TYPE 并不等价——

DB_TYPE引擎官方口径适用场景
better-sqlite3 / sqlite嵌入式 SQLite仅测试/演示单机试用、桌面端
postgresPostgreSQL生产推荐（14+，16.x 推荐）正式部署首选
mysqlMySQL/MariaDB生产可用已有 MySQL 运维体系

本文选型口径：生产环境用 PostgreSQL；SQLite 仅用于快速体验。（来源：README《Quick Start to manually build & run》Optional 一节，查询日期 2026-10-23）

3.3 客户端与服务形态

  • Web UI：浏览器访问 4200 端口，完整功能面。
  • Ever Gauzy Server：官方预构建的独立服务端安装包，内置 API + SQLite（或外接 PostgreSQL）并托管前端，面向中小组织的推荐自托管形态（README《Server & Desktop Apps》）。
  • 桌面端（Electron）：Gauzy Desktop App（全功能一体）与 Gauzy Desktop Timer App（员工侧时间/活动追踪，含截图监控），Windows/Mac/Linux 安装包从 gauzy.co/downloads 分发。
  • Headless API：REST/GraphQL + Swagger，供 Ever Teams（React/NextJS）等第三方前端接入，是 Gauzy 作为「平台底座」的形态。

四、功能特性

下表整理自官方 README《What is it》《Features》章节（v111.48.2，查询日期 2026-10-23），为官方明示能力，非实测结论：

功能域官方明示能力
时间与生产力时间追踪、活动追踪、工时表（Timesheets）、屏幕截图监控、时间区间/日程/预约
HR 管理员工档案与费率、入职（Onboarding）、请假（Time Off）与节假日审批
招聘（ATS）候选人管理、面试流程
项目管理项目/任务、目标与 KPI/OKR、销售管道、提案（Proposals）
CRM客户/潜在客户/联系人管理、销售管理
财务会计、开票（Invoicing）、报价/估价（Estimates）、计费（Billing）、收款、收支管理
ERP库存（Inventory）、设备共享（Equipment/Sharing）、供应链与生产管理
组织能力多组织（Multi-Organization）、部门与团队、角色与权限、帮助中心/知识库、标签体系
通用能力报表/洞察/分析仪表盘、多币种、多语言（含中文界面）、明暗与多套主题、邮件模板与邮件历史、数据导入/导出
集成Upwork、Hubstaff、GitHub（OAuth 与 GitHub App）、Keycloak SSO（KEYCLOAK_ENABLED）等
AIGauzy AI（独立订阅服务）与内置 LLM 对话配置（.env.sample 中 GAUZY_AI_CHAT_*、OPENAI_API_KEY）

4.1 官方明示的能力边界

  • Headless API 完整公开（api.gauzy.co/docs），Web UI 本身也消费同一套 API，二开可行。
  • 文件存储支持 LOCAL / S3 / WASABI / CLOUDINARY 四种 FILE_PROVIDER（.env.sample），不强绑定 MinIO。
  • 多语言官方支持列表未在 README 展开，界面语言切换能力由 Crowdin 平台托管（仓库 crowdin.yml）。
  • 官方 SaaS 与文档均标注 Alpha/WIP（README《Links》注明 docs.gauzy.co 为 WIP），功能完整度以代码与 Wiki 为准。

五、快速开始（最小可用示例）

以下三条路径均来自官方 README《Quick Start》章节（查询日期 2026-10-23），本篇仅转述官方口径，不包含本地实测；完整的手把手部署实测请见本专栏部署篇。

5.1 在线体验（零安装，最快路径）

  • 访问官方演示站 https://demo.gauzy.co。
  • 超级管理员：admin@ever.co / admin；员工视角：employee@ever.co / 12345678（README 明示的演示专用凭据，仅 Demo 环境有效）。
  • 官方提示演示库每日重置、SaaS（app.gauzy.co）处于 Alpha 阶段需谨慎使用。

5.2 Docker Compose 演示栈（官方推荐的自托管路径）

README 给出的最小步骤（原文口径）：

  1. git clone https://github.com/ever-co/ever-gauzy.git 克隆仓库。
  2. 确认本机 Docker Compose ≥ v2.20（README 明示最低版本）。
  3. 执行 docker-compose -f docker-compose.demo.yml up——使用官方预构建镜像拉起「API + Web UI + 数据库」最小栈（演示栈明确不含 OpenSearch/MinIO/Cube 等可选组件）。
  4. 浏览器打开 http://localhost:4200，用 admin@ever.co / admin 登录（该栈以 DEMO=true 运行，故可用默认凭据）。

5.3 源码构建运行（二开路径）

README《Quick Start to manually build & run》口径：

  1. 安装 Node.js LTS（22.x 或 24.x；package.json engines 要求 >=24）与 Yarn 1.22.x（npm i -g yarn）。
  2. yarn bootstrap 安装依赖并初始化工程。
  3. 复制 .env.sample 为 .env 调整数据库等配置（默认 better-sqlite3，生产建议切 PostgreSQL 14+）。
  4. yarn start 同时拉起 API（3000）与 UI（4200），首次启动时若库中无用户会自动执行最小种子数据。
  5. 生产强调项（README 原文明示）：必须为 JWT_SECRET、JWT_REFRESH_TOKEN_SECRET、JWT_VERIFICATION_TOKEN_SECRET、EXPRESS_SESSION_SECRET 设置强随机值（建议 openssl rand -hex 64），并为 DEMO_SUPER_ADMIN_PASSWORD、DEMO_ADMIN_PASSWORD、DEMO_EMPLOYEE_PASSWORD 设置非默认值——生产模式下 API 对空缺/默认值会拒绝启动、拒绝种子。

💡 提示：5.2/5.3 的完整生产化改造（安全密钥、PostgreSQL 依赖链、持久化与重启恢复）已在本专栏部署篇中逐条实测，见参考链接处的站内指引。

六、适用场景与限制

6.1 适合的场景

  • 远程/混合团队的时间追踪 + 项目结算闭环：员工桌面端记录工时与活动，数据直接进入项目、报价与开票流程，无需在 Kimai 与记账工具间搬运数据。
  • 外包/代理商/自由职业者：客户管理、提案、估价、发票、收款全链路在一套系统内完成。
  • 需要员工绩效监控的组织：截图与活动监控（Desktop Timer + Agent）是原生能力，非第三方拼装。
  • 想把 HR/ATS/CRM/库存整合进单一平台、又希望避免 Odoo/ERPNext 重实施成本的中小组织。
  • 需要 Headless API 做自研前端的团队：REST/GraphQL + Swagger + 同源 SaaS 验证。

6.2 不适合的场景与限制

  • 纯记账/纯库存诉求：Gauzy 的财务模块围绕「服务型业务的收支与开票」，不含完整复式会计科目体系；对财务合规要求高时应选专业会计软件。
  • 许可证约束：AGPL-3.0 对网络服务场景同样生效，基于 Gauzy 二开并提供 SaaS 服务需要开源修改部分或购买商业许可。
  • 文档成熟度：官方文档站 docs.gauzy.co 标注 WIP，细节主要靠 Wiki 与源码，中文资料稀少。
  • 资源与运维复杂度：NestJS + Angular 全功能栈首次种子/编译较重（官方 API 镜像的 Node 堆上限配置为 --max-old-space-size=12288，见 .deploy/api/Dockerfile），完整 compose 栈含 10+ 服务，小规模部署建议裁剪为最小栈。
  • 版本演进快：Pre-release 日级滚动，升级需跟随稳定版节奏并关注 breaking change。

6.3 升级与锁定风险

  • 数据库结构通过 TypeORM 迁移管理，跨多个稳定版升级前应在测试环境演练（迁移命令 migration:run，见本专栏部署篇实测）。
  • 高频预发布意味着「latest 镜像 tag」会漂移到未经验证的构建；官方镜像在 ghcr.io 仅提供 latest tag，生产应以 digest 固定版本（本专栏 B2 篇给出实测 digest）。
  • 对 Ever Co. 的依赖集中（代码、文档、SaaS、企业许可同源），若公司战略调整，社区接管的延续性存在不确定性。

七、同类选型对比

7.1 量化对比表

数据取证说明：Stars 与许可证取自 shields.io 徽章（查询日期 2026-10-23）；技术栈与许可证细节以各项目官方仓库为准；Tryton 星数为其核心仓库 tryton/tryton 的值（Tryton 功能分散在多仓库，星数被低估，特此注记）。

维度Ever GauzyOdoo CEERPNextDolibarrKimaiTryton
GitHub Stars8.4k55k40k7.8k5.1k234（核心仓）
语言/栈TypeScript（NestJS + Angular）PythonPython（Frappe）PHPPHP（Symfony）Python
许可证AGPL-3.0LGPL-3.0GPL-3.0GPL-3.0AGPL-3.0GPL-3.0
核心定位时间追踪+HR+ERP 一体化业务平台全域 ERP 套件（模块海量）全域 ERP（Frappe 低代码底座）中小企业 ERP/CRM（轻量）纯时间追踪与计费模块化 ERP 框架
数据库PostgreSQL/MySQL/SQLitePostgreSQLMariaDB/PostgreSQLMySQL/MariaDB/PostgreSQLMySQL/MariaDBPostgreSQL
时间追踪与截图监控原生（含桌面端）需装模块原生工时，截图需集成无原生原生（核心能力）无原生
开票/财务原生（服务型业务）原生（完整会计）原生（完整会计）原生（轻量会计）仅计费导出原生（模块化）
API 形态REST + GraphQL + SwaggerXML-RPC/JSON-RPC + RESTREST（Frappe API）RESTRESTXML-RPC/JSON-RPC
上手重量中（单体全栈，compose 一键）重（模块多、配置深）重（实施依赖 Frappe 理解）轻（LAMP 单机友好）轻（单点工具）重（开发者导向）

💡 关键差异解读：把「时间追踪驱动计费」作为核心诉求时，Kimai 最轻但财务能力止步于导出，Gauzy 是唯一把追踪、项目、开票、HR 做成原生气泡闭环的中量级选项；若要的是「全企业 ERP 深水区」（制造、会计科目、多公司并账），Odoo/ERPNext 的成熟度更高但实施成本也更高；Dolibarr 胜在轻量易装但无时间追踪。技术栈维度上，Gauzy 是表中唯一的 TypeScript 全栈选项，Node 团队维护成本最低。

7.2 版本节奏与兼容矩阵

维度Ever Gauzy（查询日期 2026-10-23）说明
稳定版v111.48.2（2026-10-03 发布）GitHub Latest 标记
预发布节奏日级多枚（v111.130.x）master 分支 CI 构建
运行时要求Node.js ≥24、Yarn 1.22.x仓库 package.json engines/packageManager
生产数据库PostgreSQL 14+（README 推荐 16.x，官方 compose 实际 17）README + docker-compose.infra.yml
Compose 最低版本Docker Compose ≥ v2.20README 明示
集群/高可用官方推荐 Kubernetes（ever-charts Helm 图）README《Production》

7.3 选型建议（「如果…则…」）

  • 如果团队 10 人以内、主要痛点是「记录工时 → 给客户开票」，且想要截图/活动监控：选 Ever Gauzy，从 Docker Compose 最小栈起步。
  • 如果只需要工时记录与报表、财务走外部系统：选 Kimai，更轻、学习成本接近零。
  • 如果需要完整会计科目、库存生产、多公司并账，且有实施预算：选 Odoo CE 或 ERPNext。
  • 如果只是要一个「装得快、用得久」的轻量 ERP/CRM 且无时间追踪诉求：选 Dolibarr。
  • 如果团队技术栈是 Node/TypeScript、预期深度二开或做 Headless 平台：选 Ever Gauzy，API 全开放 + 同源 SaaS 验证是明确加分项。
  • 如果对许可证传染性零容忍（闭源分发）：Gauzy 与 Kimai 均为 AGPL，应回避或联系厂商获取商业许可，转看 LGPL 的 Odoo CE。

八、参考链接

  • 官方仓库：https://github.com/ever-co/ever-gauzy（README/License/Releases，v111.48.2 标签内容，查询日期 2026-10-23）
  • 版本发布页：https://github.com/ever-co/ever-gauzy/releases（Latest：v111.48.2，2026-10-03）
  • 官网：https://gauzy.co；下载页：https://gauzy.co/downloads
  • 官方文档（WIP）：https://docs.gauzy.co；Wiki：https://github.com/ever-co/ever-gauzy/wiki
  • 在线演示：https://demo.gauzy.co；SaaS（Alpha）：https://app.gauzy.co
  • Headless API 文档：https://api.gauzy.co/docs
  • 许可证：AGPL-3.0 全文 https://www.gnu.org/licenses/agpl-3.0.html
  • 同门项目：Ever Teams https://github.com/ever-co/ever-teams；Helm 图表 https://github.com/ever-co/ever-charts；Terraform https://github.com/ever-co/ever-gauzy-terraform
  • 本专栏后续实测篇目：《Ever Gauzy 111.48.2 Docker Compose 部署指南》、《Ubuntu 22.04 安装 Ever Gauzy 111.48.2 指南》、《Ever Gauzy 111.48.2 配置参数详解》、《Ever Gauzy 111.48.2 API 使用详解》