ssankur/radicale

Radicale 3.5.4 Docker镜像文档

镜像概述

本镜像基于python:alpine构建，包含Radicale 3.5.4版本，是一款轻量级CalDAV（日历）和CardDAV（联系人）服务器。支持标准的CalDAV/CardDAV协议，可用于个人或小型团队的日历、任务和联系人数据存储与同步。

核心功能和特性

• 协议支持：完整支持CalDAV和CardDAV标准协议，兼容主流客户端（如Thunderbird、iOS日历/联系人、Android DavX⁵等）
• 安全认证：集成bcrypt加密支持，提供用户认证功能
• 数据持久化：通过卷挂载实现数据持久化，防止容器重启导致数据丢失
• 轻量级设计：基于Alpine Linux构建，镜像体积小，资源占用低
• 简单部署：开箱即用，无需复杂配置即可快速启动服务

使用场景

• 个人日历和联系人管理与跨设备同步
• 小型团队共享日历和任务协作
• 作为私有云环境中的日历/联系人服务组件

使用方法

基本运行

通过以下命令快速启动Radicale服务：

bash
docker run -d -p 5232:5232 -v radicale_data:/var/lib/radicale --name radicale radicale:3.5.4

• -p 5232:5232：将容器5232端口映射到主机5232端口
• -v radicale_data:/var/lib/radicale：使用命名卷radicale_data持久化存储数据
• --name radicale：指定容器名称为radicale

自定义配置

如需自定义配置，可将本地配置文件挂载到容器内：

1. 本地创建配置文件（如radicale_config目录下的config文件）
2. 启动命令添加配置文件挂载：

bash
docker run -d -p 5232:5232 \
  -v radicale_data:/var/lib/radicale \
  -v ./radicale_config:/etc/radicale \
  --name radicale radicale:3.5.4

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  radicale:
    image: radicale:3.5.4
    ports:
      - "5232:5232"
    volumes:
      - radicale_data:/var/lib/radicale
      # 如需自定义配置，取消以下注释并添加本地配置目录
      # - ./radicale_config:/etc/radicale
    restart: unless-stopped

volumes:
  radicale_data:

启动服务：docker-compose up -d

配置说明

• 数据存储：所有日历和联系人数据默认存储在/var/lib/radicale目录，通过卷挂载可实现持久化
• 端口：默认监听5232端口，可通过-p参数映射到主机其他端口
• 认证配置：默认无认证，如需启用认证，需通过配置文件设置（详见Radicale官方文档）
• 网络绑定：通过ENTRYPOINT参数已固定绑定到0.0.0.0:5232，支持外部访问

访问服务

服务启动后，可通过http://<主机IP>:5232访问Radicale服务器，根据客户端配置说明添加CalDAV/CardDAV账户即可开始使用。