nafets227/carddav2fb

CardDAV联系人导入AVM FRITZ!Box工具

镜像概述

本镜像基于开源项目carddav2fb，用于将CardDAV服务（如ownCloud）中的VCard联系人导入到AVM FRITZ!Box的电话簿中，无需修改FRITZ!Box固件，支持多账户配置和联系人照片导入。

核心功能

• 支持从CardDAV服务导入VCard联系人到FRITZ!Box电话簿
• 导入时包含VCard中的照片
• 无需修改FRITZ!OS固件
• 可配置多个CardDAV账户及文件夹
• 自定义FRITZ!Box电话簿中联系人全名格式
• 支持通过联系人备注设置快速拨号号码

注意：此工具会覆盖FRITZ!Box当前电话簿的联系人，无警告提示，请谨慎使用！

使用场景

• 个人/家庭用户同步CardDAV联系人到FRITZ!Box电话簿，方便使用FRITZ!Box电话功能
• 需要统一管理多个CardDAV账户的联系人到FRITZ!Box

配置说明

FRITZ!Box前置设置

1. 启用用户名密码登录：进入系统 -> FRITZ!Box用户 -> 通过用户名+密码登录
2. 创建专用用户：在系统 -> FRITZ!Box用户中创建用户，授予以下权限：
   • FRITZ!Box设置（用于上传电话簿数据）
   • 访问NAS内容（用于FTP上传照片）
3. 确保目标电话簿已存在：若电话簿不存在，上传会失败

Docker配置

1. 拉取镜像：

   bash
   docker pull nafets227/carddav2fb
   

2. 创建配置文件：参考https://github.com/nafets227/carddav2fb/blob/master/config.example-docker.php%EF%BC%8C%E5%A4%8D%E5%88%B6%E4%B8%BA%60mycarddav2fbconfig.php%60%E5%B9%B6%E4%BF%AE%E6%94%B9%E5%8F%82%E6%95%B0
3. 启动容器（docker-compose示例）：

   yaml
   services:
     carddav2fb:
       image: nafets227/carddav2fb
       volumes:
           - ./mycarddav2fbconfig.php:/etc/carddav2fb.config.php:ro
           - /path/to/your/directory:/var/lib/carddav2fb
   

   说明：挂载配置文件（只读）和存储中间文件的目录（检测变化避免重复更新）

配置文件示例（ownCloud）

php
$config['fritzbox_ip'] = 'fritz.box';
$config['fritzbox_user'] = '<用户名>';
$config['fritzbox_pw'] = '<密码>';
$config['phonebook_number'] = '0';
$config['phonebook_name'] = '电话簿';
$config['fritzbox_path'] = 'file:///var/media/ftp/';

// 全名格式选项（默认0）
// 0 = '前缀' 姓氏, 名字, '附加名', '后缀', '组织名'
// 1 = '前缀' 名字 姓氏 '附加名' '后缀' '(组织名)'
// 2 = '前缀' 名字 '附加名' 姓氏 '后缀' '(组织名)'
$config['fullname_format'] = 0;

// 全名包含部分（存在时添加）
$config['prefix'] = false; // 前缀
$config['suffix'] = false; // 后缀
$config['addnames'] = false; // 附加名
$config['orgname'] = false; // 组织名

$config['quickdial_keyword'] = 'Quickdial:'; // 备注中添加'Quickdial:+49030123456:**709'设置快速拨号

// CardDAV账户配置
$config['carddav'][0] = array(
  'url' => 'https://<主机名>/remote.php/carddav/addressbooks/<用户名>/contacts',
  'user' => '<用户名>',
  'pw' => '<密码>'
);

依赖说明

使用以下开源库：

• CardDAV-PHP（https://github.com/jens-maus/CardDAV-PHP.git%EF%BC%89
• FRITZ!Box-API-PHP（https://github.com/jens-maus/fritzbox_api_php.git%EF%BC%89
• VCard-Parser（https://github.com/jens-maus/vCard-parser.git%EF%BC%89

许可证

本工具基于公有领域（Public Domain）发布。

作者

Copyright (c) 2012-2016 Karl Glatz, Martin Rost, Jens Maus, Johannes Freiburger