nathanvaughn/webtrees

webtrees Docker镜像

https://github.com/NathanVaughn/webtrees-docker/workflows/Check%20and%20Push%20Updates/badge.svg](https://github.com/NathanVaughn/webtrees-docker)

这是一个多架构、最新的webtrees Docker镜像，支持通过HTTP或HTTPS提供服务。可部署在反向代理（如CloudFlare或Traefik）之后，也可独立运行。

使用方法

快速开始

如需立即使用，可参考提供的https://github.com/NathanVaughn/webtrees-docker/blob/master/docker-compose.yml%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E3%80%82

环境变量

提供了多个环境变量用于自动配置容器。未定义的环境变量将使用默认值。

🚨 警告 🚨 这些环境变量将在webtrees控制面板的“服务器信息”下可见。请将控制面板限制为管理员访问，或使用webtrees设置向导。

此外，可在任何环境变量名后添加_FILE，使其从指定文件读取值。例如，设置DB_PASS_FILE=/run/secrets/my_db_secret将从该文件读取内容作为DB_PASS的值。

若无需容器自动配置（如从现有webtrees安装迁移），可留空数据库（DB_）和webtrees（WT_）相关变量，然后通过设置向导手动配置。

数据库

webtrees推荐使用MySQL（或兼容数据库）。需单独部署数据库容器，如：

• https://hub.docker.com/_/mariadb
• https://hub.docker.com/_/mysql

PostgreSQL（pgsql）和SQLite（sqlite）也受支持，但https://github.com/fisharebest/webtrees/issues/5099#issuecomment-2581440755%E3%80%82%E6%9C%AC%E9%95%9C%E5%83%8F%E4%B8%8D%E6%94%AF%E6%8C%81Microsoft SQL Server，以保证多架构兼容性（详见https://github.com/microsoft/msphpsql/issues/441#issuecomment-310237200%EF%BC%89%E3%80%82

SQLite配置

如需使用SQLite数据库，设置：

• DB_TYPE = sqlite
• DB_NAME = desiredfilename（无需扩展名）

PostgreSQL配置

如需使用PostgreSQL数据库，设置：

• DB_TYPE = pgsql
• DB_PORT = 5432

其他配置与MySQL相同。

数据卷

镜像挂载以下目录：

• /var/www/webtrees/data/（媒体文件存储在media子目录）

如需添加自定义主题或模块，还可挂载/var/www/webtrees/modules_v4/目录。

示例docker-compose配置：

yml
volumes:
  - app_data:/var/www/webtrees/data/
  - app_themes:/var/www/webtrees/modules_v4/
---
volumes:
  app_data:
    driver: local
  app_themes:
    driver: local

安装自定义主题或模块的步骤通常如下：

bash
docker exec -it webtrees_app_1 bash   # 连接到运行中的容器
cd /var/www/webtrees/modules_v4/      # 进入模块目录
curl -L <下载链接> -o <文件名>         # 下载文件

# 若为.tar.gz文件
tar -xf <文件名.tar.gz>               # 解压tar包（参考https://xkcd.com/1168/）
rm <文件名.tar.gz>                    # 删除tar包

# 若为.zip文件
apt update && apt install unzip       # 安装unzip工具
unzip <文件名.zip>                    # 解压zip文件
rm <文件名.zip>                       # 删除zip文件

exit                                  # 退出容器

网络

镜像暴露端口80（HTTP）和443（HTTPS）。

示例docker-compose配置：

yml
ports:
  - 80:80
  - 443:443

启用HTTPS重定向时仍需暴露端口80；若不使用HTTPS，无需暴露端口443。

ImageMagick

本镜像包含ImageMagick，用于加速缩略图创建。webtrees将自动优先使用它，无需额外配置。

标签

特定版本

webtrees的每个稳定版、旧版、测试版和alpha版都会生成对应的Docker镜像标签。

示例：

yml
image: ghcr.io/nathanvaughn/webtrees:2.1.2

最新版本

当前提供latest（最新稳定版）、latest-alpha（最新alpha版）、latest-beta（最新测试版）和latest-legacy（最新旧版）标签。

示例：

yml
image: ghcr.io/nathanvaughn/webtrees:latest

注意 webtrees旧版已不再受支持。

问题反馈

Dockerfile的新版本由webtrees上游版本自动生成，无需人工审核每个版本。尽管已尽力维护，仍可能出现问题。如有问题，请提交https://github.com/NathanVaughn/webtrees-docker/issues%E3%80%82

反向代理问题

webtrees在反向代理后运行时可能出现兼容性问题，需根据实际情况手动调整数据库值。

例如，通过HTTPS反向代理访问容器的HTTP服务时，可能需执行以下SQL命令修改数据库：

sql
mysql -u webtrees -p

use webtrees;
update wt_site_setting set setting_value='https://example.com/login' where setting_name='LOGIN_URL';
update wt_site_setting set setting_value='https://example.com/' where setting_name='SERVER_URL';
quit;

更多信息详见此处。

镜像仓库

本镜像可从以下仓库获取：

• https://hub.docker.com/r/nathanvaughn/webtrees
• https://github.com/users/nathanvaughn/packages/container/package/webtrees