搭建私人CardDAV/CalDAV服务

2023-04-29 15:03| 来源: 网络整理| 查看: 265

搭建私人CardDAV/CalDAV服务_通讯录/日历同步服务_debian11_radicale3_nginx_DAVx5

转载注明来源: 本文链接来自osnosn的博客，写于 2022-04-25.

参考【radicale 官网】【radicale3 的文档】【radicale GitHub】【DAVx5-ose GitHub】【DAVx5 官网】【ICSx5 GitHub】【ICSx5 官网】安装环境 debian-11, apt install radicale, debian11 stable 中，实际安装的版本是 radicale-3.0.6, 我没有使用 pip 安装，也没有去安装最新版 3.1.7, nginx 用的是 apt install nginx-full, debian-11 stable 中的版本是 nginx-1.18.0, 安装 radicale 的官网说，3.x 版本是开箱即用的。用 apt install radicale 安装的版本，已经装好 radicale.service 服务启动脚本, 已经有了 /etc/radicale/ 配置目录。已经有了 /var/lib/radicale/collections/ 数据目录。并且还有了，用 uwsgi 启动的配置目录 /etc/uwsgi/ (我没有使用uwsgi) 因为用 apt 安装的, 方便齐全, 并且够用。所以我没有使用 pip 安装。配置修改 radicale 配置修改 /etc/radicale/config 文件在 [server] 中, 添加 host = localhost:5232 。计划用 nginx 做反向代理，没必要绑定到 0.0.0.0:5232 或 [::]:5232 。用 localhost:5232，启动服务后，内网用 http://192.168.x.x:5232/不能访问。用 0.0.0.0:5232，启动服务后，内网用 http://192.168.x.x:5232/可以访问。在 [auth] 中, 修改/添加 type = htpasswd, 和 htpasswd_filename = /etc/radicale/users, 和 htpasswd_encryption = plain, 自己个人使用，账号文件，我选择不加密。自己忘了密码，还能查看。如果你想更安全，可以选择 md5 加密。改 [web] 中, type = none, 关闭web登录页面, 只使用客户端访问。关于 radicale 其他的配置项，用默认值。创建 /etc/radicale/users 文件。 (用户名写成 email 格式，是为了在 DAVx5 中显示的账号，看起来更有辨识度), plain的格式是,user01@myhost:pass123 user02@myhost:pass456 如果你选用 md5 加密，则需要用 htpasswd 命令去创建 users 文件。为了安全，不让users文件全局可读， chown radicale.radicale /etc/radicale/users; chmod 640 /etc/radicale/users; 我的 nginx 已经配置好 ssl，而 nginx 和 radicale 又在同一台机器。所以，我就不再配置 radicale 的 ssl 证书了。 radicale 服务, 将会以 radicale 用户身份执行。而安装时，/var/lib/radicale/collections 目录的 owner 是 root。会导致无法写入。需要 chown radicale.radicale /var/lib/radicale/collections 修改 collections 目录的权限。 systemctl enable radicale 激活服务。 systemctl start radicale 启动服务。如果修改了 users 账号文件，无需重启 radicale 即生效。用户(比如用户名:gst)的数据，将会放在 /var/lib/radicale/collections/collection-root/gst/ 中。如果gst用户不再使用，则简单的删除 gst/ 目录即可。修改 nginx 配置我的 nginx 是配置了 ssl 的。是使用 https:// 访问的。在 nginx 的配置文件中，合适的地方，加入，(抄自radicale官方文档)， location /card/ { # The trailing / is important! allow all; proxy_pass http://127.0.0.1:5232/; # The trailing / is important! proxy_set_header X-Script-Name /card; #与location中的目录名相同，去掉最后的/号 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header Host $http_host; proxy_pass_header Authorization; } service nginx reload 重启 nginx。使用用浏览器访问 https://xxxx.mydomain.com:8888/card/ (这里用的是,我的 nginx 对外的 ddns 域名和端口) 登录账号，可以创建 addressbook 空集合和 calendar 空集合，可以修改集合的名称，描述。(名称,描述都能在DAVx5中能看到,描述中的中文显示正常). 可以上传 ics 或 vcf 文件, 生成一个新集合。(vcf对应通讯录,ics对应日历)。可以下载已有集合中的所有数据，成为一个单独文件。下载的vcf版本格式，与你之前上传的一样。你之前上传的是vcf-2.1格式的，下载时也是vcf-2.1格式的。 3.0.6版中，web不能编辑集合中的内容(增,删,改)。在 Android 手机中安装 DAVx5，添加账号，"使用 URL 和用户名登录"。 "根地址" 填https://xxxx.mydomain.com:8888/card/ 即可。然后点击刚才加入的账号。选择"CARDDAV", 点右上角的"三个点", 选"刷新通讯录列表"。勾选上需要同步的集合，点击右下角"同步"图标。就能双向同步对应的集合了。一个radicale账号中,可以有多个集合, DAVx5也支持。方便你对通讯录分类保存,同步。 CalDAV创建了集合后，在手机日历中, 新创建的事件，就可以同步到服务器。 DAVx5对于CalDAV默认只同步90天内的事件。可以在设置中"旧日程时间限制"设置为空,表示"同步所有日程"。或者, 根据需要改为 180天，365天。手机中的通讯录，默认是存在 "本机"。如果要变成 cardDAV 的。需要从手机中导出通讯录，然后在浏览器中，上传通讯录(支持vcf,ics格式) 上传vcf文件后，会在当前用户中生成一个没有名字的新的通讯录集合。在DAVx5中，要在对应账号中，点击 "刷新通讯录列表"，才能看到。导入的无名称的新集合，只能在web网页端修改名称。在DAVx5中，有创建新集合，删除已有集合。没有修改已有集合名称的地方。在浏览器中，删除一个集合。系统目录 /var/lib/radicale/collections/collection-root/用户名/ 中, 对应集合的目录也删除了。没有数据残留。上传 ics 文件，是导入日历事件。手机中的通讯录，默认存在 "本机" 的联系人，转存到 cardDAV 的不通过电脑的其他办法。首先，在DAVx5中，carddav中创建一个通讯录集合，用于后续的导入操作。如果手机通讯录中有 "复制联系人"功能，则选择从"本机"复制到"DAVx5"账号的通讯录集合中。或者，把手机通讯录，导出到"存储设备"中。然后从"存储设备"中导入到"DAVx5"账号的通讯录集合中。最后在手机的目录中, 删除刚才导出的"00001.vcf"文件。 DAVx5 可以去 F-Droid 下载, 目前的最新版是 4.2.0.3-ose，10MB。【DAVx5-ose GitHub】【DAVx5 官网】 DAVx5 中的 mount "WebDAV 文件系统" 功能，是只读的，比较鸡肋。没什么用处。如果要查看 WebDAV 中的文件，只能通过分享到第三方应用打开查看。其他如果不想开放 radicale 的 web 页面登陆。仅使用 DAVx5. 改 /etc/radicale/config 文件, [web] 中, type = none, 然后重启 radicale 即可。如果想限制 radicale 的 web 页面登陆的IP范围。 web访问，会访问/card/.web/, 有GET, PROPFIND,PUT,...请求, 没有POST。 DAVx5 没有 GET,POST请求, 不访问/card/.web/目录。可以配置 nginx , 限制/.web/目录的访问, 或者限制GET请求。 radicale 有机制, 记录所有通讯录的改变。比如，每当通讯录有改变, 就自动调用 git 命令提交一次记录。看官方文档中，关于 [storage]中, hook = 的描述。 DAVx5 支持服务自动发现。需要把两个链接临时重定向(302)到 radicale 的目录。这样, 在DAVx5中添加账号时，根地址(URL)就不用写全路径了。 /.well-known/caldav → CalDAV service path (302 Found), → /card/ /.well-known/carddav → CardDAV service path (302 Found), → /card/ 这个可以通过 nginx 的配置 return 302 xxx 或者 rewrite xxx xxx redirect, 来实现。错误如果通过手机"复制联系人", 或者在手机中"导出"再"导入", 基本不会出现错误。如果通过浏览器，上传 vcf 文件失败。在服务器上执行 tail -f /var/log/syslog, 再次上传试试，看看 syslog 中输出了什么错误。方便您定位错误。我发现 3.0.6 版，对 vcf-3.0 版的格式，支持很好。我发现 3.0.6 版，上传华为手机鸿蒙系统导出的 vcf-2.1 版，支持不好。 BEGIN:VCARD VERSION:2.1 N;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:;=E6=B5=8B=E8=AF=95=E6=B5=8B=E8=AF=95=E6=B5=8B=E8=AF=95=E6=B5=8B=E8=AF= =95=E6=B5=8B=E8=AF=95=E6=B5=8B;;; FN;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:=E6=B5=8B=E8=AF=95=E6=B5=8B=E8=AF=95=E6=B5=8B=E8=AF=95=E6=B5=8B=E8=AF= =95=E6=B5=8B=E8=AF=95=E6=B5=8B TEL;CELL:12 345 678 90 PHOTO;ENCODING=BASE64;JPEG:/9j/4AAQS.... 2wBDAQcHBwo.... END:VCARD

上面的文件,上传会失败。

把 Quoted-Printable 编码，整理成一行。 Quoted-Printable编码的基本方法是：输入数据在33-60、62-126范围内的，直接输出；其它的需编码为“=”加两个字节的HEX码(大写)。为保证输出行不超过规定长度，可在行尾加“=/r/n”序列作为软回车。 PHOTO 项中(如果有头像)，要把 ENCODING=BASE64 改为 ENCODING=B 才行。

修改为下面的内容，才行，

BEGIN:VCARD VERSION:2.1 N;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:;=E6=B5=8B=E8=AF=95=E6=B5=8B=E8=AF=95=E6=B5=8B=E8=AF=95=E6=B5=8B=E8=AF=95=E6=B5=8B=E8=AF=95=E6=B5=8B;;; FN;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:=E6=B5=8B=E8=AF=95=E6=B5=8B=E8=AF=95=E6=B5=8B=E8=AF=95=E6=B5=8B=E8=AF=95=E6=B5=8B=E8=AF=95=E6=B5=8B TEL;CELL:12 345 678 90 PHOTO;ENCODING=B;JPEG:/9j/4AAQS.... 2wBDAQcHBwo.... END:VCARD

才能成功上传。

完成其他CardDAV安装，请看【搭建私人通讯录/日历同步服务_使用cardDAV/calDAV服务】 WebDAV 的搭建，请看【搭建私人的云笔记_使用webdav服务】修改 Radicale 显示 WebCal 订阅集合

成功了，但似乎没什么用。不知道还缺了什么。

我用的是debian的默认安装。 Radicale-3.0.6-3 修改 /usr/lib/python3/dist-packages/radicale/app/propfind.py --- propfind.py_org 2022-05-01 12:46:29.744932752 +0800 +++ propfind.py 2022-05-01 12:50:38.153823346 +0800 @@ -78,7 +78,7 @@ raise ValueError("Only use one of props, propname and allprops") is_collection = isinstance(item, storage.BaseCollection) if is_collection: - is_leaf = item.get_meta("tag") in ("VADDRESSBOOK", "VCALENDAR") + is_leaf = item.get_meta("tag") in ("VADDRESSBOOK", "VCALENDAR","VSUBSCRIBED") collection = item else: collection = item.collection @@ -251,6 +251,10 @@ child_element = ET.Element( xmlutils.make_clark("C:calendar")) element.append(child_element) + elif item.get_meta("tag") == "VSUBSCRIBED": + child_element = ET.Element( + xmlutils.make_clark("CS:subscribed")) + element.append(child_element) child_element = ET.Element(xmlutils.make_clark("D:collection")) element.append(child_element) elif tag == xmlutils.make_clark("RADICALE:displayname"): 修改 /usr/lib/python3/dist-packages/radicale/item/__init__.py --- __init__.py_org 2022-05-01 12:56:01.865771350 +0800 +++ __init__.py 2022-05-01 13:00:07.658694689 +0800 @@ -67,7 +67,7 @@ The ``tag`` of the collection. """ - if tag and tag not in ("VCALENDAR", "VADDRESSBOOK"): + if tag and tag not in ("VCALENDAR", "VADDRESSBOOK","VSUBSCRIBED"): raise ValueError("Unsupported collection tag: %r" % tag) if not is_collection and len(vobject_items) != 1: raise ValueError("Item contains %d components" % len(vobject_items)) @@ -185,7 +185,7 @@ if not v: del props[k] continue - if v not in ("VCALENDAR", "VADDRESSBOOK"): + if v not in ("VCALENDAR", "VADDRESSBOOK","VSUBSCRIBED"): raise ValueError("Unsupported collection tag: %r" % v) 然后，重启 radicale。然后，用浏览器访问 radicale的后台，创建一个 calendar 的集合。然后，登录服务器，进入目录，cd /var/lib/radicale/collections/collection-root/你的用户名/刚刚创建的日历集合/, 修改文件 .Radicale.props (建议先备份)。删除原来的所有内容，改为。 {"tag": "VSUBSCRIBED", "D:displayname": "Online Calendar", "ICAL:calendar-color": "#00BBEEFF", "CS:source": "https://xxxx.mydomain.com:8888/myics/my_webcal.php"} 这时候，手机端的 DAVx5 就能刷出这个webcal订阅集合了。

可是，点击这个订阅集合，DAVx5 说，找不到支持 webcal的应用。就算装了 ICSx5，也还是说找不到。只好放弃。这时候，浏览器登陆radicale后台，被修改的日历集合，就不见了。在 DAVx5 的 WebCal 中，点击对应的订阅集合，选择"删除集合"，勾上"从服务器上删除"，可以成功删除这个集合。去后台的文件系统查看，对应的目录也被删除了。其实，要发布 WebCal，不需要 Radicale 支持。要使用 WebCal，ICSx5 能直接添加 URL 订阅，支持用户认证。注: 小米手机日历自带的 URL 订阅功能，不支持用户认证。请看:【创建自己的 WebCal 日历订阅链接】可以考虑写个php程序，扫描某个特定的 radicale 的日历集合目录中的 ics文件。输出一个订阅链接。这样，就可以用手机登陆 radicale 账号。手工维护一个日历订阅。关于php读取radicale目录的权限。可以通过 usermode www-data -G radicale; service php74-fpm restart; 解决。

----end----

转载注明来源: 本文链接 https://www.cnblogs.com/osnosn/p/16184705.html 来自 osnosn的博客 https://www.cnblogs.com/osnosn/ .

【本文地址】

公司简介

联系我们

今日新闻

推荐新闻

专题文章