fintechstudios/davical

davical-docker

![GitHub branch checks state]([***]

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

标签

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

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

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

可在https://hub.docker.com/r/fintechstudios/davical%E6%9F%A5%E7%9C%8B%E6%9C%80%E6%96%B0%E6%8E%A8%E9%80%81%E7%9A%84%E9%95%9C%E5%83%8F%EF%BC%8C%E6%88%96%E9%80%9A%E8%BF%87GitLab CI流水线了解构建状态。

使用方法

该镜像运行的DAViCal基于官方https://github.com/docker-library/php/blob/master/8.1/bullseye/apache/Dockerfile%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%9B%A0%E6%AD%A4%E5%8F%AA%E9%9C%80%E6%8F%90%E4%BE%9BPostgreSQL%E6%95%B0%E6%8D%AE%E5%BA%93%E5%8D%B3%E5%8F%AF%E4%BD%BF%E7%94%A8%E3%80%82%E9%BB%98%E8%AE%A4%E6%83%85%E5%86%B5%E4%B8%8B%EF%BC%8C%E9%80%9A%E8%BF%87%E4%B8%8B%E6%96%87%E5%88%97%E5%87%BA%E7%9A%84%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E6%8C%87%E5%AE%9A%E6%95%B0%E6%8D%AE%E5%BA%93%E8%BF%9E%E6%8E%A5%E4%BF%A1%E6%81%AF%EF%BC%8C%E4%BD%86%E4%B9%9F%E5%8F%AF%E9%80%9A%E8%BF%87%E6%8F%90%E4%BE%9B%E8%87%AA%E5%AE%9A%E4%B9%89%E7%9A%84DAViCal config.php覆盖此行为。

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

环境变量

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

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

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

• HOST_NAME -（默认：localhost）用作Apache的ServerName
• ADMIN_EMAIL -（默认：admin@davical.example.com）登录页面显示的及密码重置邮件的"发件人"
• 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="20a4a473b12d467131a3b93aed1828ae978cf3b34feedecda384a974814b285c1b842d1ec0d2638b14388a94643ed6f5566a5993884b6e71bdaf6789ce43bd63" \
  --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

参考项目

• https://github.com/IridiumXOR/davical%EF%BC%88%E5%8F%8A%E5%88%86%E6%94%AF%EF%BC%89
• https://github.com/Elrondo46/davical-docker-standalone