kozea/radicale

Radicale

镜像概述和主要用途

Radicale是一个轻量级但功能完善的CalDAV和CardDAV服务器，主要用于共享和管理日历、待办事项及联系人数据。它通过标准的CalDAV、CardDAV协议和HTTP提供服务，适用于个人或小型团队自托管日历和联系人服务，无需复杂的基础设施即可实现跨设备数据同步。

核心功能和特性

• 多协议支持：通过CalDAV、CardDAV和HTTP协议共享日历和联系人列表
• 数据类型支持：兼容事件、待办事项、日记条目和名片
• 易用性：开箱即用，无需复杂的设置或配置过程
• 访问控制：支持通过认证机制限制访问权限
• 安全保障：可通过TLS加密保护网络连接
• 客户端兼容性：与众多CalDAV和CardDAV客户端（如Thunderbird、Evolution、iOS日历等）兼容
• 文件系统存储：所有数据以简单的文件夹结构存储在文件系统中，易于备份和管理
• 可扩展性：支持通过插件扩展功能
• 开源许可：采用GPLv3许可的自由软件

使用场景和适用范围

• 个人用户：自托管个人日历和联系人，实现跨设备同步
• 小型团队：共享团队日历和联系人信息，提高协作效率
• 隐私敏感场景：需要控制数据存储位置的隐私保护需求
• 开发测试：作为CalDAV/CardDAV客户端开发的测试服务器

使用方法和配置说明

基本部署

通过Docker快速启动Radicale服务：

bash
docker run -d \
  --name radicale \
  -p 5232:5232 \
  -v /path/to/radicale/data:/data \
  radicale/radicale

参数说明：

• -p 5232:5232：映射容器的5232端口（Radicale默认端口）到主机
• -v /path/to/radicale/data:/data：挂载数据卷，持久化存储日历和联系人数据

自定义配置

Radicale的配置通过config.ini文件管理，可通过挂载配置目录自定义设置：

bash
docker run -d \
  --name radicale \
  -p 5232:5232 \
  -v /path/to/radicale/config:/etc/radicale \
  -v /path/to/radicale/data:/data \
  radicale/radicale

配置文件主要选项：

• [server]：服务器设置（端口、主机地址等）
• [auth]：认证配置（如启用HTTP基本认证）
• [rights]：访问权限控制
• [storage]：数据存储设置
• [tls]：TLS加密配置

启用TLS安全连接

1. 准备TLS证书文件（如cert.pem和key.pem）
2. 在config.ini中配置TLS：

   ini
   [tls]
   certificate = /etc/radicale/cert.pem
   key = /etc/radicale/key.pem
   

3. 启动容器时挂载证书目录：

   bash
   docker run -d \
     --name radicale \
     -p 5232:5232 \
     -v /path/to/radicale/config:/etc/radicale \
     -v /path/to/radicale/certs:/etc/radicale/certs \
     -v /path/to/radicale/data:/data \
     radicale/radicale
   

启用认证

编辑config.ini配置认证机制：

ini
[auth]
type = htpasswd
htpasswd_filename = /etc/radicale/users
htpasswd_encryption = bcrypt

创建用户文件（需安装htpasswd工具）：

bash
htpasswd -B -c /path/to/radicale/config/users username

相关资源

• 完整文档：Radicale 主文档
• Wiki：https://github.com/Kozea/Radicale/wiki
• 问题跟踪：https://github.com/Kozea/Radicale/issues
• 讨论区：https://github.com/Kozea/Radicale/discussions

报告问题前，请先查阅https://github.com/Kozea/Radicale/wiki/01-%E2%80%90-Reporting-Issues