type
Post
status
Published
date
Jun 22, 2025
slug
inter10
summary
在home assistant上使用addons部署家谱服务webtrees
tags
计算机网络
Docker
home assistant
家谱
webtrees
category
计算机网络
icon
password
一、什么是 Web Trees？
Web Trees 是一款基于 PHP+MySQL 开发的开源族谱管理系统，它以 GEDCOM（家谱数据交换标准格式）为核心，将家族树从本地文件转化为可在线访问的动态网页。自 2007 年从另一款开源工具 PhpGedView 分支发展而来，Web Trees 已成为全球最受欢迎的开源族谱软件之一，被广泛用于个人家族记录、宗族祠堂数字化、历史研究等场景。
其核心定位是：「让族谱管理从单机走向网络，让家族记忆跨越时空共享」。
二、Web Trees 的核心功能
1. 可视化家族树展示，多维度追溯血缘
Web Trees 提供多种家族树视图，满足不同场景需求：
- * pedigree 视图 ：以 “中心人物” 为起点，向上展示直系祖先（父母、祖父母），向下展示子女，清晰呈现核心血缘脉络；
- 家族视图 ：展示某对夫妇及其所有后代，适合追踪分支家族发展；
- 世系图 ：以时间轴为线索，按辈分纵向排列家族成员，直观呈现 “第几代” 关系；
- 关系计算 **：输入任意两人姓名，自动计算亲属关系（如 “表兄妹”“叔侄”），解决复杂家族关系的称呼难题。
每个家族成员档案包含生日、逝世日、职业、居住地、婚姻状况等基础信息，还支持添加传记、照片、文档（如老信件、土地证）等多媒体资料，让人物形象更立体。
2. 多人协作与权限管理，家族共同书写历史
家谱的完善往往需要家族成员共同参与，Web Trees 为此设计了灵活的权限系统：
- 管理员可创建多个用户账号，为不同亲属分配权限（如 “仅查看”“可编辑分支”“完全管理”）；
- 支持 “待审核编辑” 模式：普通用户提交的家族信息需管理员审核后才生效，避免错误数据混入；
- 内置修改日志，记录所有数据变更（谁修改了什么、何时修改），便于追溯错误来源。
这种协作模式特别适合分散在各地的家族成员共同完善家谱 —— 远在他乡的亲戚可在线补充本地支系信息，长辈可上传老照片，晚辈则负责数字化整理，让家谱成为家族共同的 “协作作品”。
3. 强大的 GEDCOM 兼容与数据管理
作为家谱行业的通用格式，GEDCOM 是不同族谱软件之间数据互通的桥梁。Web Trees 在这方面表现突出：
- 支持导入 / 导出 GEDCOM 格式文件（兼容 5.5.1、7.0 等版本），可与 Ancestry、Family Tree Maker 等主流工具无缝对接；
- 内置数据校验功能，导入时自动检测格式错误（如日期格式不规范、人物关系冲突），并提供修正建议；
- 支持数据备份与恢复，可设置自动备份计划（如每周备份到云端或本地），确保家族数据万无一失。
4. 丰富的扩展功能，满足个性化需求
Web Trees 通过插件系统支持功能扩展，目前官方及社区已开发上百种插件：
- ** 地图集成 ：自动将成员的出生地、居住地标注在地图上，直观展示家族迁徙路线；
- 时间线生成 ：按时间顺序展示家族重大事件（如婚礼、迁徙、战争经历），生成家族史时间轴；
- 统计分析 ：计算家族平均寿命、生育年龄、姓氏分布等数据，用图表呈现家族特征；
- 多语言支持 **：内置 30 + 种语言包（含简体中文、繁体中文），支持自定义翻译校对。
三、Web Trees安装配置
前期准备 addons
Maria DB
可以在官方addons中安装
配置
安装完成后进入配置界面，参考如下配置
webtrees
点击如下链接添加自定义加载项商店
添加后直接搜索即可找到
配置
安装完成后，参考如下配置填写IP及端口
关联数据库
上述配置完成后，点击启动，浏览器输入IP:端口进入配置向导，按照之前的配置填写自己设置的数据库信息
。。。。忘了没截图，很简单，自己配置即可。。。。
另外文章最后面有配置参数，可以查看。
添加主题
webtrees的默认主题一言难尽，非常复古，但是好在可以导入一些第三方主题。
默认主题
三方主题
下载地址：
Modules and themes![Modules and themes]()
Modules and themes
webtrees is a web application that allows you to publish your genealogy online, collaborate with family members and take control of your data.
三方主题配置方法
这个东西有坑！！！！！！
以Argon Theme为例，按照官方指导进行安装：
- 下载最新版本的.zip文件。
- 解压缩包。
- 确保文件夹名为 。
argon
- 将文件夹上传到 Web 服务器上安装 webtrees 的目录中。
modules_v4
- 确保在控制面板中启用了主题。
结果你在登陆好，开开心心更改主题后，会直接报错！整个页面全部变为错误代码，无法切回默认主题，叫天天不应，叫地地不灵，我的解决方案是删除modules_v4文件夹内该主题后再次启动服务就好.
那么，如何修复并正常使用该主题呢？
这个问题在论坛里面有提到（吐槽一句论坛做的跟屎一样，鬼知道我为了处理这个问题找了多久）：
Can't get wt 2.2.1 to work (not even a fresh installation)
Can't get wt 2.2.1 to work (not even a fresh installation)Can't get wt 2.2.1 to work (not even a fresh installation)
只要下载default.zip文件，解压后其上传到modules_v4\<argon>\resources\views\layouts即可
配置url
又一个坑
Web Trees如果你需要外网访问，不单单只是在路由器做个端口转发就能用的，需要在其配置文件里面配置外网域名再加上端口转发才能正常访问，而且修改之后内网也就不能用了，很坑！！！
另外，前面不是将没有截到web trees初次启动关联数据库的设置嘛，可以参考此处
- 作者:CHAOS
- 链接:https://tangly1024.com/article/inter10
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议，转载请注明出处。
相关文章
