深耕数码、AI兴趣领域
17
5
Docker新手必看！轻松搭建Radicale日历和联系人应用
2025-01-01 17:36:35
2点赞
17收藏
0评论
Docker新手必看！轻松搭建Radicale日历和联系人应用
一、Radicale介绍
1.1 Radicale简介
Radicale简介
Radicale 是一个小型但功能强大的 CalDAV（日历、待办事项列表）和 CardDAV（联系人）服务器。
1.2 Radicale特点
通过 CalDAV、CardDAV 和 HTTP 共享日历和联系人列表。
支持事件、待办事项、日记条目和名片。
开箱即用，无需复杂的设置或配置。
可以通过身份验证来限制访问。
可以使用 TLS 保护连接。
可与许多 CalDAV 和 CardDAV 客户端配合使用
将文件系统上的所有数据存储在简单的文件夹结构中。
可以通过插件进行扩展。
是 GPLv3 许可的免费软件。
1.3 Radicale使用场景
Radicale 作为一个轻量级但功能全面的 CalDAV 和 CardDAV 服务器，适用于多种个人与团队协作场景，具体包括：
个人日程管理：用户可以利用Radicale同步和管理个人的日历事件，如会议安排、生日提醒、重要截止日期等，实现跨设备（如电脑、手机、平板）的日历访问与更新，保持生活与工作的高度组织化。
团队协作与会议规划：团队成员可以通过Radicale共享项目进度会议、团队建设活动、业务评审等日程信息，增进团队间的透明度与协调性。管理员工假期、团建活动等公共日历，帮助团队有效安排资源与时间。
任务与待办事项追踪：结合CalDAV的任务管理功能，用户可以创建并跟踪个人或团队的待办事项列表，设置优先级、截止日期等，确保重要任务不被遗漏，提升工作效率。
集中式联系人管理：CardDAV支持让用户在服务器上集中存储和同步联系人信息，无论是个人通讯录还是公司客户数据库，都能确保在所有设备上保持最新状态，便于快速查找与联系。
跨平台兼容性：Radicale良好的协议支持使其能无缝对接各种操作系统（如Windows、macOS、Linux）及应用程序（如Apple Calendar、Thunderbird、Microsoft Outlook等），满足不同用户偏好。
私有云部署：对于重视数据隐私的企业和个人，Radicale提供了自托管解决方案，让用户完全控制自己的日历和联系人数据，避免了第三方云服务的数据安全与隐私风险。
集成开发环境：开发团队可以将Radicale集成到他们的工作流中，用于跟踪项目里程碑、代码提交计划、版本发布时间线等，特别是在使用支持CalDAV的项目管理工具时，能进一步提升团队协同效率。
1.3 Radicale
二、本地环境介绍
2.1 本地环境规划
本次实践为个人测试环境，操作系统版本为centos7.6。
2.2 本次实践介绍
1.本次实践部署环境为个人测试环境，生产环境请谨慎； 2.】使用Docker部署Radicale应用。
三、本地环境检查
3.1 检查Docker服务状态
检查Docker服务是否正常运行，确保Docker正常运行。
[root@jeven ~]# systemctl status docker
● docker.service - Docker Application Container Engine
Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled)
Active: active (running) since Thu 2024-03-21 18:42:13 CST; 3min 53s ago
Main PID: 43305 (dockerd)
Tasks: 82
Memory: 103.6M
CGroup: /system.slice/docker.service
3.2 检查Docker版本
检查Docker版本
[root@jeven ~]# docker -v
Docker version 20.10.17, build 100c701
3.3 检查docker compose 版本
检查Docker compose版本，确保2.0以上版本。
[root@jeven ~]# docker compose version
Docker Compose version v2.6.0
四、下载Radicale镜像
从docker hub中拉取Radicale镜像
[root@jeven ~]# docker pull tomsquest/docker-radicale
Using default tag: latest
latest: Pulling from tomsquest/docker-radicale
latest: Pulling from tomsquest/docker-radicale
31e352740f53: Pull complete
c2d340d8e600: Pull complete
4cc4d1164eec: Pull complete
c38d83629c71: Pull complete
Digest: sha256:d76aabdf8e55578d207ea3fa7b393a3fdee2a2ad507eac28f489e081cfe73675
Status: Downloaded newer image for tomsquest/docker-radicale:latest
docker.io/tomsquest/docker-radicale:latest
五、部署Radicale
5.1 创建目录
创建部署目录/data/radicale/
mkdir -p /data/radicale/data && cd /data/radicale
5.2 使用docker-cli方式部署
使用docker-cli方式部署，官方示例如下。本次实践使用docker compose方式部署。
docker run -d
--name radicale
--restart always
-p 7800:5232
--init
--read-only
--security-opt="no-new-privileges:true"
--cap-drop ALL
--cap-add CHOWN
--cap-add SETUID
--cap-add SETGID
--cap-add KILL
--pids-limit 50
--memory 500M
--health-cmd="curl --fail http://localhost:5232 || exit 1"
--health-interval=30s
--health-retries=3
-v /data/radicale/data:/data
tomsquest/docker-radicale
5.3 编辑docker-compose.yaml文件
使用docker compose运行Radicale容器
version: '3'
services:
radicale:
image: tomsquest/docker-radicale
container_name: radicale
ports:
- 7800:5232
init: true
read_only: true
security_opt:
- no-new-privileges:true
cap_drop:
- ALL
cap_add:
- SETUID
- SETGID
- CHOWN
- KILL
deploy:
resources:
limits:
memory: 500M
# pids: 50
healthcheck:
test: curl -f http://127.0.0.1:5232 || exit 1
interval: 30s
retries: 3
restart: always
volumes:
- /data/radicale/data:/data
5.4 创建Radicale容器
使用docker-compose.yaml文件创建Radicale容器
[root@jeven radicale]# docker compose up -d
[+] Running 2/2
⠿ Network radicale_default Created 0.1s
⠿ Container radicale Started 1.2s
5.5 检查Radicale容器状态
检查Radicale容器状态，确保Radicale容器正常启动。
[root@jeven radicale]# docker compose ps
NAME COMMAND SERVICE STATUS PORTS
radicale "docker-entrypoint.s…" radicale running (healthy) 0.0.0.0:7800->5232/tcp, :::7800->5232/tcp
六、访问Radicale首页
6.1 进入Radicale初始页
访问地址：http://192.168.3.166:7800，将IP替换为自己服务器IP地址，进入到Radicale初始页。如果无法访问，则检查服务器防火墙是否设置，云服务器的安全组端口是否放行等。
6.2 设置登录账号
在Radicale初始页，设置账号密码，选择"下一步”。
设置完账号后，进入到Radicale首页。
6.3 创建项目
选择创建地址簿或日历
填写相关信息，标题和描述，类型选择日历、日记和任务。
重新查看首页效果
七、总结
使用Radicale的经历就像拥有了一把钥匙，打开了通往高效个人与团队组织的大门。它小巧而强大，以令人信赖的姿态管理着我的日历事件、待办事项乃至整个联系人网络。无论是在安排紧凑的日程中穿梭，还是在团队项目协作的海洋里遨游，Radicale都以其出色的CalDAV和CardDAV支持，确保信息在多设备间无缝流转。自托管的特性更像是一道安全阀，让数据掌控权稳稳握在自己手中。总而言之，Radicale以其实用而不失优雅的方式，让日常的安排与交流变得既轻松又私密，是数字时代个人与团队协同工作的得力助手。
作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～
