cupcakearmy/radicale

Docker Radicale

这是一个用于https://github.com/Kozea/Radicale%E7%9A%84%E5%B0%8F%E5%9E%8BDocker%E9%95%9C%E5%83%8F%EF%BC%8C%E6%97%A8%E5%9C%A8%E5%AE%9E%E7%8E%B0%E8%BD%BB%E6%9D%BE%E9%83%A8%E7%BD%B2%EF%BC%8C%E5%8C%85%E5%90%ABBcrypt%E8%AE%A4%E8%AF%81%E5%8A%9F%E8%83%BD%E3%80%82

!docker pulls !docker size

镜像概述和主要用途

该镜像提供了Radicale服务的容器化部署方案，Radicale是一个轻量级的CalDAV/CardDAV服务器，用于同步日历和联系人数据。本镜像简化了部署流程，内置Bcrypt认证机制，确保数据访问安全，适合个人或小型团队使用。

核心功能和特性

• 轻量级部署：小型镜像体积，资源占用低
• 内置认证：集成Bcrypt密码加密认证
• 数据持久化：支持通过卷挂载保存用户数据
• 灵活配置：可自定义Radicale配置文件
• 跨平台兼容：支持macOS、iOS等客户端同步

使用场景和适用范围

• 个人日历和联系人同步服务
• 小型团队内部日历共享
• 需要自托管CalDAV/CardDAV服务的场景
• 与Traefik等反向代理配合实现HTTPS访问

详细使用方法和配置说明

安装

1. 创建环境变量文件（可选）：

# .env
USER=foo
PASSWORD=secret

环境变量文件不是严格必需的，但如果缺少，将自动生成一个带有Bcrypt密码的默认用户。

2. 创建docker-compose配置文件：

yml
# docker-compose.yml
version: '3.7'

services:
  app:
    image: cupcakearmy/radicale:1
    restart: unless-stopped
    env_file: .env
    volumes:
      - ./data:/data
    ports:
      - 80:5232

3. 启动服务：

bash
docker-compose up -d

macOS 设置

原生客户端在没有SSL/TLS的情况下可能会出现问题，启用SSL后即可正常工作。

!macOS Setup

相同的设置适用于日历应用和iOS设备。

Traefik 配置

以下是Traefik（v1）的配置示例：

yml
version: '3.7'

networks:
  traefik:
    external: true

services:
  app:
    image: cupcakearmy/radicale
    env_file: .env
    volumes:
      - ./data:/data
    networks:
      - traefik
    labels:
      - traefik.enable=true
      - traefik.backend=radicale
      - traefik.frontend.rule=Host:radicale.example.org
      - traefik.docker.network=traefik
      - traefik.port=5232

自定义配置

配置文件

可以通过挂载配置文件到/etc/radicale/config来覆盖默认配置。

用户认证

默认脚本仅使用提供的USER和PASSWORD凭据创建一个默认用户。如需多用户支持，需手动创建用户文件。默认配置中用户文件路径为/data/users。

可使用以下命令添加用户：

bash
htpasswd -bB -c /data/users user pass

然后将该文件挂载到/data/users或Radicale配置文件filesystem_folder中设置的路径（更多信息请参考Radicale文档）。