davical-docker

]([***]

基于***PHP镜像的独立DAViCal Docker镜像，DAViCal是一款CalDAV/CardDAV服务器，用于提供日程安排和联系人管理服务。

标签

镜像标签包含DAViCal版本、AWL版本、PHP版本和发行版信息。

latest标签指向当前稳定Debian系统上的最新镜像版本。

nightly标签指向基于DAViCal和AWL主分支在当前稳定Debian系统上的构建版本。

可在Docker Hub的fintechstudios/davical查看最新推送的镜像，或通过GitLab CI流水线了解构建状态。

使用方法

该镜像运行的DAViCal基于***php:apache镜像构建，因此只需提供PostgreSQL数据库即可使用。默认情况下，通过下文列出的环境变量指定数据库连接信息，但也可通过提供自定义的DAViCal config.php覆盖此行为。

镜像还包含数据库设置脚本和DAViCal更新所需的迁移脚本。执行这些操作需要PostgreSQL的特权访问（在生产环境中可能不希望如此），因此必须通过单独的环境变量启用。

环境变量

以下变量用于连接PostgreSQL，提供了符合DAViCal典型使用场景的合理默认值：

• PGHOST - 数据库主机
• PGPASSWORD - PGUSER的密码
• PGUSER -（默认：davical_app）数据库用户
• PGDATABASE -（默认：davical）数据库名称
• PGPORT -（默认：5432）数据库端口

您可能还需要提供以下变量以覆盖默认行为：

• HOST_NAME -（默认：localhost）用作Apache的ServerName
• ADMIN_EMAIL -（默认：***）登录页面显示的及密码重置邮件的"发件人"
• TZ -（默认：UTC）系统时区名称

数据库创建/迁移

若要运行数据库迁移，需提供以下变量（以及前面提到的变量）：

• ROOT_PGUSER - 具有创建用户和数据库权限的PostgreSQL用户
• ROOT_PGPASSWORD - ROOT_PGUSER的密码
• DAVICAL_ADMIN_PASS - DAViCal admin用户的密码
• DBA_PGUSER -（默认：davical_dba）DAViCal用于数据库操作的PG（超级）用户
• DBA_PGPASSWORD -（默认：PGPASSWORD的值）DBA_PGUSER的密码
• RUN_MIGRATIONS_AT_STARTUP -（默认：无）若设为"true"，则每次镜像启动时运行迁移。默认禁用此行为。

示例

本仓库提供的docker-compose.yml展示了最小配置。可直接运行并通过http://localhost:4080访问DAViCal实例：

shell
docker-compose up

在生产环境中，通常希望禁用RUN_MIGRATIONS_AT_STARTUP，仅在需要时运行迁移（确保迁移是有意执行的）。可通过docker-compose执行：

shell
# 仅启动postgres
docker-compose up -d postgres
# 运行迁移后退出
docker-compose run --rm -e RUN_MIGRATIONS_AT_STARTUP=true davical run-migrations
# 仅运行davical（不执行迁移）
docker-compose run --service-ports -e RUN_MIGRATIONS_AT_STARTUP= davical

若要指定自定义config.php，只需将其挂载到/etc/davical/config.php以覆盖现有文件：

shell
docker-compose run --service-ports -v ./my-config.php:/etc/davical/config.php davical 

构建

要构建镜像，只需运行docker-compose或docker构建命令：

shell
docker-compose build davical
# 或
docker build -t fintechstudios/davical .

可通过构建参数指定不同版本的DAViCal。您可以指定DAViCal / AWL仓库的标签名、分支名或提交哈希作为版本。例如：

shell
docker-compose build \
  --build-arg DAVICAL_VERSION="r1.1.10" \
  --build-arg DAVICAL_SHA512="20a4a473b12d467131a3b93aed1828ae978cf3b34feedecda384a974814b285c1b842d1ec0d2638b***a94643ed6f5566a5993884b6e71bdaf6789ce43bd63" \
  --build-arg AWL_VERSION="r0.62" \
  --build-arg AWL_SHA512="c4de99e627ba3bd0a0ace1feef89a341d1bb29c79e4f1f0dc786da890b7540577444a19f10d0ae118d53ae723bd61538e82fee15aa689d1a4b7fc13a39c4a559" \
  davical

将SHA512值设为空可跳过校验：

shell
docker-compose build \
  --build-arg DAVICAL_VERSION="e8b43e60dbbd7bf6860b00a820556ef484aca9e5" \
  --build-arg DAVICAL_SHA512= \
  --build-arg AWL_VERSION="3f044e2dc8435c2eeba61a3c41ec11c820711ab3" \
  --build-arg AWL_SHA512= \
  davical

参考项目

• IridiumXOR/davical（及分支）
• Elrondo46/davical-docker-standalone