Repolode
MGeurts

MGeurts/genealogy

基于 Laravel 构建的自托管家谱应用,用于记录家庭成员及其关系,并支持 GEDCOM 导入导出。

可替代:AncestryMyHeritage

Star
370
Fork
116
未关闭 Issue
0
最近提交
昨天

这是什么?

Genealogy 是一个用 PHP 编写的家谱网页应用,用于记录家庭成员以及他们之间的关系。每个人可关联生父、生母、父母组合、伴侣和子女,夫妻关系可标记为已婚或分居。祖先树和后代树通过 MySQL 或 MariaDB 的递归公用表表达式(Recursive CTE)生成,避免构建大型树时出现 N+1 查询问题。

应用基于 Laravel Jetstream 的团队功能组织数据,提供所有者、经理、编辑和成员等角色,控制谁可以创建、编辑或仅查看人物与夫妻信息。系统支持图片和文档上传(可选水印),提供事件时间线、定时每日备份的备份管理器,以及用于查看慢查询和错误的日志查看器,还可启用双因素认证和 API。

GEDCOM 导入导出功能已经具备初步能力,但仍在开发中,完整的 GEDCOM 7 支持尚未完成。界面支持十一种语言,包括简体中文。技术栈使用 Livewire、Alpine.js、Tailwind CSS,以及 Filament 的表格组件。

核心功能

  • 01记录人物及其父母、伴侣、子女之间的关系
  • 02使用递归 SQL 查询生成祖先树和后代树
  • 03基于团队的多租户,提供所有者、经理、编辑、成员等角色
  • 04支持图片和文档上传,可选添加水印
  • 05支持手动和定时数据库备份,备份后发送邮件通知
  • 06提供初步的 GEDCOM 导入导出,功能仍在开发中

适用场景

  • 与家人共享访问权限,记录家族历史
  • 整理王室或名门家族的谱系用于研究
  • 在自己的服务器上私有部署家谱
  • 学习基于 Jetstream 团队和 Livewire 的 Laravel 应用结构

快速上手

  1. 1

    从 GitHub Container Registry 拉取生产环境 Docker 镜像

    docker pull ghcr.io/mgeurts/genealogy:latest
  2. 2

    按照 README-DOCKER.md 中的 Docker 设置指南完成配置并启动应用

使用前须知

  • GEDCOM 导入和导出功能仍不完整,仍在积极开发中。
  • 需要 MySQL 8.0.1 及以上或 MariaDB 10.2.2 及以上版本,并支持递归公共表表达式(Recursive CTE)。
  • 生产环境必须使用 HTTPS。

收录于专题

标签

#family-tree#genealogy#laravel#php#self-hosted#gedcom#recursive-cte#ancestry#common-table-expression#genealogy-application

常见问题

genealogy 是什么?
基于 Laravel 构建的自托管家谱应用,用于记录家庭成员及其关系,并支持 GEDCOM 导入导出。 Genealogy 是一个用 PHP 编写的家谱网页应用,用于记录家庭成员以及他们之间的关系。每个人可关联生父、生母、父母组合、伴侣和子女,夫妻关系可标记为已婚或分居。祖先树和后代树通过 MySQL 或 MariaDB 的递归公用表表达式(Recursive CTE)生成,避免构建大型树时出现 N+1 查询问题。
genealogy 可以免费使用吗?用的什么许可证?
genealogy 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
genealogy 还在维护吗?
活跃维护中。genealogy 最近一次提交是在 2026年11月6日。
genealogy 适合用来做什么?
与家人共享访问权限,记录家族历史 整理王室或名门家族的谱系用于研究 在自己的服务器上私有部署家谱 学习基于 Jetstream 团队和 Livewire 的 Laravel 应用结构
genealogy 怎么安装和运行?
从 GitHub Container Registry 拉取生产环境 Docker 镜像: docker pull ghcr.io/mgeurts/genealogy:latest 按照 README-DOCKER.md 中的 Docker 设置指南完成配置并启动应用
在哪里获取 genealogy?
源代码和安装说明在 GitHub 上:https://github.com/MGeurts/genealogy

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目