datze/davical_https

DAViCal Docker容器

Docker镜像包含完整的https://www.davical.org/服务器（DAViCal + Apache2 + PostgreSQL），基于Alpine Linux。GitHub仓库中包含DAViCal的示例配置文件（以及用于创建Docker镜像的Dockerfile）。

关于DAViCal

https://www.davical.org/是一款共享日历服务器，实现了CalDAV协议，并以iCalendar格式存储日历。

支持的客户端列表：Mozilla Thunderbird/Lightning、Evolution、Mulberry、Chandler、iCal等。

核心功能与特性

• DAViCal是自由软件，采用GPL许可协议
• 使用SQL数据库存储事件数据
• 支持通过WebDAV进行向后兼容访问（只读或读写模式，不推荐）
• 致力于与尽可能广泛的CalDAV客户端软件互操作
• 支持日历用户间的基本读写权限委托
• 允许多个用户或客户端同时读写同一日历条目
• 支持会议安排并显示忙闲时间（*https://www.davical.org/*）

配置说明

暴露端口

• TCP 80：Web服务器监听端口，默认主机名为davical.example（需设置本地hosts文件将davical.example指向127.0.0.1）
• TCP 443：HTTPS端口（需配置SSL证书）

暴露卷

• /config：需挂载包含个性化配置文件的目录
• /var/lib/postgresql/data/：PostgreSQL数据库存储目录，包含backups/子目录（用于数据库备份）

环境变量

• TIME_ZONE：默认值为"Europe/Rome"，可根据tzdata设置其他时区（如"Europe/Paris"或"Europe/London"）
• HOST_NAME：默认值为"davical.example"，可自定义主机名

详细配置说明

/config卷

需挂载包含以下个性化配置文件的目录：

• apache.conf：Apache服务器配置
• davical.php：DAViCal应用配置
• rsyslog.conf：日志配置
• supervisord.conf：进程管理配置

可从仓库下载示例配置文件，修改后放入挂载目录供容器使用。

HTTPS配置

要使用TCP 443端口的HTTPS，需：

1. 取消apache.conf中相关HTTPS配置行的注释
2. 在/config目录中提供域名对应的SSL证书

数据库备份与恢复

• 备份：/var/lib/postgresql/data/backups/目录中，crond每天通过/sbin/backup_db自动将DAViCal数据库备份为davical_backup.tar
• 恢复：将备份文件放入挂载的/config目录，启动容器后执行docker exec container_name /sbin/restore_db

日志配置

rsyslog服务器配置为将Apache和PostgreSQL日志收集到/var/log/messages，但不收集Apache的access.log（已禁用）。可通过修改rsyslog.conf自定义日志配置。

默认管理员用户

• 用户名：admin
• 密码：12345（可通过DAViCal界面修改）

Docker使用示例

简单测试

bash
docker run -d --name davical-test -p 8080:80 docker.xuanyuan.run/datze/davical_https

创建并运行DAViCal容器，通过主机8080端口访问。无需额外配置，仅用于测试！删除容器后所有日历数据将丢失！

简单HTTP模式

bash
docker run -d --name davical -p 8080:80 -v var/davical/data:/var/lib/postgresql/data docker.xuanyuan.run/datze/davical_https

创建并运行DAViCal容器，使用默认配置，通过主机8080端口访问。数据库文件存储在/var/davical/data，删除容器后日历数据不会丢失。

完整示例

bash
docker run -d --name davical -p 8080:80 -p 8443:443 -v /var/davical/config:/config -v /var/davical/data:/var/lib/postgresql/data -e HOST_NAME='my.example.com' -e TIME_ZONE='Europe/Berlin' docker.xuanyuan.run/datze/davical_https

创建并运行DAViCal容器，通过主机8080（HTTP）和8443（HTTPS）端口访问。时区设置为Europe/Berlin，主机名设为my.example.com。

需在/var/davical/config中创建配置文件，数据库文件存储在/var/davical/data。需在/var/davical/config中放置SSL证书并在apache.conf中引用（可使用以下命令生成自签名证书：openssl req -x509 -newkey rsa:4096 -keyout /var/davical/config/ssl/private.pem -out /var/davical/config/ssl/cert.pem -days 1000）。

参考

基于https://github.com/IridiumXOR/davical和https://hub.docker.com/r/oliveria/davical（无HTTPS支持，使用较旧的PostgreSQL和PHP版本）。