iOS/Android 來電識別與聯繫人同步完全指南 | CardDAV vCards 配置教程

Mobile Contact Sync and Caller ID

在日常使用中，接到快遞、外賣、騷擾電話時，手機往往只顯示一串陌生號碼。vCards 項目通過 CardDAV 協議為中國大陸用戶提供了一套完整的黃頁解決方案，涵蓋快遞、外賣、銀行、政府機構等常用號碼，讓你的 iOS/Android 設備能夠像手機管家一樣智能識別來電歸屬。

什麼是 vCards？

vCards 是一個開源的中國大陸電話號碼黃頁數據庫，由社區維護更新，包含：

📦 快遞物流：順豐、京東、菜鳥、中通、圓通等
🍔 外賣餐飲：美團、餓了麼、肯德基、麥當勞等
🏦 金融機構：各大銀行、信用卡中心、保險公司
🏛️ 政府服務：公安、稅務、社保、公積金中心
📞 客服熱線：電商平臺、運營商、公共服務
⚠️ 騷擾標記：已知的營銷、詐騙號碼

項目地址： https://github.com/metowolf/vCards

核心優勢

優勢	說明
🆓 完全免費	開源項目，無需付費訂閱
🔄 自動更新	CardDAV 訂閱方式支持自動同步
🔒 隱私安全	可自建服務，數據完全可控
📱 跨平臺	支持 iOS、Android、macOS
🌐 雲端同步	多設備共享同一份通訊錄
🎯 精準識別	社區維護，準確率高

工作原理

CardDAV 服務器 (vcards.metowolf.com)
         ↓ 同步
   iCloud / 本地通訊錄
         ↓ 匹配
   來電/短信界面顯示名稱

數據源：vCards 維護號碼數據庫
傳輸協議：CardDAV（基於 WebDAV 的通訊錄同步協議）
同步方式：定期從服務器拉取最新數據
本地匹配：來電時系統自動匹配通訊錄

方法一：安裝 CardDAV 描述文件（推薦）

這是最簡單快捷的方式，適合大多數 iOS 用戶。

1. 使用系統相機掃描下方二維碼，下載配置描述文件

掃描二維碼

掃碼步驟：

1. 打開 iPhone 相機 App
2. 對準二維碼掃描
3. 點擊彈出的通知 "下載描述文件"
4. Safari 會自動下載 .mobileconfig 文件

2. 打開"設置"App，輕點"已下載描述文件"或"註冊 [組織的名稱]"

打開描述文件

詳細操作：

路徑 1（常見）：
設置 → 頂部橫幅 "已下載描述文件" → 點擊進入

路徑 2（備選）：
設置 → 通用 → VPN 與設備管理 → 描述文件

3. 在右上角點擊"安裝"，按屏幕提示操作完成導入。

安裝流程：

步驟 1：點擊右上角 "安裝"
步驟 2：輸入鎖屏密碼（驗證身份）
步驟 3：閱讀警告信息 → 繼續安裝
步驟 4：再次點擊 "安裝" 確認
步驟 5：點擊 "完成"

驗證成功：
設置 → 通訊錄 → 賬戶
應該能看到新增的 CardDAV 賬戶

⚠️ 注意事項：

描述文件僅包含配置信息，不會竊取隱私
安裝後可在"描述文件"管理中隨時刪除
如提示"未簽名"，選擇"仍然安裝"即可

方法二：手動訂閱 CardDAV 服務

採用訂閱方式導入，優勢是會自動更新，也方便區分和管理個人通訊錄和黃頁，避免混合兩種列表。

服務器：vcards.metowolf.com
用戶名：cn
密碼：cn 或任意填寫

如擔心隱私問題，可參考自建教程。

CardDAV 配置詳解

什麼是 CardDAV？

CardDAV 是基於 WebDAV 協議的通訊錄同步標準，由 IETF 制定。相比傳統的 VCF 文件導入，CardDAV 具有以下優勢：

✅ 自動同步：定期從服務器獲取更新 ✅ 雙向同步：修改可同步回服務器（可選） ✅ 增量更新：僅傳輸變更部分，節省流量 ✅ 多設備支持：所有設備保持數據一致

設置步驟

iOS 配置

iOS ^[1] 「設置」→「通訊錄」→「賬戶」→「添加賬戶」→「其他」→「添加 CardDAV 賬戶」

詳細操作流程：

步驟 1：打開設置
設置 → 通訊錄 → 賬戶

步驟 2：添加新賬戶
點擊 "添加賬戶" → 滾動到底部 → 選擇 "其他"

步驟 3：選擇賬戶類型
點擊 "添加 CardDAV 賬戶"

步驟 4：填寫服務器信息
┌─────────────────────────────┐
│ 服務器：vcards.metowolf.com │
│ 用戶名：cn                  │
│ 密碼：cn                    │
│ 描述：vCards 黃頁（可選）   │
└─────────────────────────────┘

步驟 5：驗證並保存
點擊 "下一步" → 等待驗證 → 點擊 "存儲"

步驟 6：配置同步選項
☑️ 通訊錄（必須勾選）
□ 提醒事項（不需要）
□ 備忘錄（不需要）

高級設置（可選）：

設置 → 通訊錄 → 賬戶 → vCards 黃頁

端口：443（HTTPS 默認）
使用 SSL：開啟（推薦）
同步範圍：所有通訊錄

macOS 配置

Mac ^[2] 「通訊錄」→「設置」→「賬戶」→「其他通訊錄賬戶」

詳細操作流程：

步驟 1：打開通訊錄 App
應用程序 → 通訊錄

步驟 2：進入賬戶設置
菜單欄 → 通訊錄 → 設置（偏好設置）
→ 賬戶標籤頁

步驟 3：添加賬戶
點擊左下角 "+" → 選擇 "其他通訊錄賬戶"

步驟 4：填寫信息
┌──────────────────────────────┐
│ 賬戶類型：CardDAV            │
│ 用戶名：cn                   │
│ 密碼：cn                     │
│ 服務器地址：vcards.metowolf.com │
│ 端口：443                    │
│ 使用 SSL：✓                  │
└──────────────────────────────┘

步驟 5：創建賬戶
點擊 "登錄" → 等待驗證 → 完成

驗證同步狀態：

通訊錄 → 左側邊欄
應該能看到 "vCards" 或 "cn" 分組
包含數千個聯繫人條目

⚠️ 默認 iOS 獲取新資料的方式為「自動」，此情況下只有連接電源和 WLAN 時才會推送數據，請耐心等待。

優化同步策略：

方法 1：強制立即同步
設置 → 通訊錄 → 賬戶 → vCards
關閉 "通訊錄" → 等待 5 秒 → 重新開啟

方法 2：連接電源和 WiFi
將設備連接充電器
連接到穩定的 WiFi 網絡
等待 10-30 分鐘

方法 3：手動觸發（macOS）
通訊錄 → 文件 → 同步通訊錄
或使用快捷鍵 Cmd + R

同步頻率說明：

條件	同步行為
連接電源 + WiFi	自動同步（最快）
僅 WiFi	延遲同步
蜂窩網絡	不同步（節省流量）
手動刷新	立即同步

方法三：下載導入

如果不希望使用 CardDAV 訂閱，可以手動下載 VCF 文件並導入到通訊錄。這種方式適合：

🟡 網絡環境無法訪問 CardDAV 服務器
🟡 希望完全離線使用
🟡 需要自定義篩選號碼

詳細操作步驟

前往 vCards Releases 頁面下載最新打包文件 archive.zip

下載說明：

1. 訪問 GitHub Releases 頁面
2. 找到最新版本（Latest release）
3. 下載 Assets 中的 archive.zip
4. 文件大小約 5-10 MB

解壓後，根據不同平臺指南導入 vcf 文件至 iCloud（建議單獨創建「黃頁」分組以便管理與隱藏）

解壓文件：

bash

# macOS/Linux
unzip archive.zip

# Windows
右鍵 → 解壓縮到當前文件夾

解壓後得到：
├── cn.vcf          # 中國大陸黃頁
├── tw.vcf          # 臺灣地區
├── hk.vcf          # 香港地區
└── ...

macOS

詳細導入流程：

步驟 1：創建專用分組
1. 打開通訊錄 App
2. 左側邊欄右鍵 → "新建群組"
3. 命名為 "vCards 黃頁" 或 "黃頁"

步驟 2：導入 VCF 文件
1. 雙擊 cn.vcf 文件
   或
2. 通訊錄 → 文件 → 導入 → 選擇 cn.vcf

步驟 3：選擇目標分組
導入時會詢問添加到哪個分組
選擇剛創建的 "vCards 黃頁"

步驟 4：驗證導入結果
1. 點擊左側 "vCards 黃頁" 分組
2. 應該看到數千個聯繫人
3. 隨機搜索測試（如 "順豐"、"美團"）

批量導入多個文件：

bash

# 一次性導入所有地區
for file in *.vcf; do
  open "$file"
done

iOS / Web

通過 iCloud.com 導入：

步驟 1：訪問 iCloud
瀏覽器打開 https://www.icloud.com/contacts

步驟 2：登錄 Apple ID
使用你的 Apple ID 登錄

步驟 3：創建分組
1. 左下角點擊 "+" → "新建群組"
2. 命名為 "vCards 黃頁"

步驟 4：導入 VCF
1. 左下角點擊齒輪圖標 ⚙️
2. 選擇 "導入 vCard"
3. 選擇 cn.vcf 文件
4. 等待上傳完成（可能需要幾分鐘）

步驟 5：同步到設備
iPhone 設置 → [你的名字] → iCloud
確保 "通訊錄" 開關已開啟
等待同步完成

通過 AirDrop 導入（iOS）：

步驟 1：準備文件
在 Mac 上打開 cn.vcf

步驟 2：AirDrop 發送
右鍵文件 → 分享 → AirDrop
選擇你的 iPhone

步驟 3：iPhone 接收
點擊 "接受" → 選擇 "全部添加"
或 "添加到現有聯繫人"

注意：此方式會合併到主通訊錄
建議先創建空分組再導入

三種方法對比

特性	描述文件	CardDAV 訂閱	手動導入
配置難度	⭐ 簡單	⭐⭐ 中等	⭐⭐⭐ 複雜
自動更新	✅ 是	✅ 是	❌ 否
數據隔離	✅ 獨立賬戶	✅ 獨立賬戶	⚠️ 需手動分組
多設備同步	✅ 自動	✅ 自動	❌ 需重複操作
離線可用	✅ 是	⚠️ 需聯網同步	✅ 是
隱私控制	⚠️ 依賴官方	⚠️ 依賴官方	✅ 完全自主
適用場景	快速上手	長期使用	特殊需求

推薦選擇：

新手用戶 → 方法一（描述文件）
長期用戶 → 方法二（CardDAV 訂閱）
隱私敏感 → 方法三（手動導入）或自建

高級用法

1. 自建 CardDAV 服務器

如果你擔心隱私問題，可以自建 CardDAV 服務器。

推薦方案：

方案	難度	特點
Radicale	⭐⭐	輕量級 Python 實現
Baïkal	⭐⭐⭐	功能完整，支持 CalDAV
Nextcloud	⭐⭐⭐⭐	全功能雲平臺
Docker 一鍵部署	⭐	最簡單

Docker 快速部署示例：

yaml

# docker-compose.yml
version: '3'
services:
  radicale:
    image: tomsquest/docker-radicale
    ports:
      - "5232:5232"
    volumes:
      - ./data:/data
      - ./config:/config
    environment:
      - RADICALE_CONFIG=/config/config

配置步驟：

bash

# 1. 克隆 vCards 倉庫
git clone https://github.com/metowolf/vCards.git

# 2. 轉換 VCF 為 CardDAV 格式
cd vCards
python3 convert.py

# 3. 啟動 Radicale
docker-compose up -d

# 4. 訪問 http://localhost:5232
# 創建集合並導入數據

詳細教程：https://github.com/metowolf/vCards/issues/208

2. Android 配置

雖然 vCards 主要針對 iOS 優化，但 Android 用戶也可以使用。

推薦應用：

應用	特點	下載
DAVx⁵	開源，功能強大	F-Droid / Play Store
CardDAV-Sync	輕量級	Play Store
EteSync	端到端加密	官網

DAVx⁵ 配置步驟：

步驟 1：安裝 DAVx⁵
F-Droid 或 Play Store 搜索 "DAVx⁵"

步驟 2：添加賬戶
打開 DAVx⁵ → "+" → "登錄已有服務器"

步驟 3：填寫信息
URL: https://vcards.metowolf.com
用戶名: cn
密碼: cn

步驟 4：同步通訊錄
勾選 "通訊錄" → 開始同步

步驟 5：設置默認通訊錄
電話 App → 設置 → 默認通訊錄
選擇 vCards

來電識別增強：

安裝 Truecaller 或類似應用
導入 vCards 數據
獲得更精準的來電識別

3. 數據篩選與定製

如果只需要特定類型的號碼，可以自行篩選。

使用 grep 篩選：

bash

# 只保留快遞相關
grep -A 5 "順豐\|京東\|菜鳥" cn.vcf > delivery.vcf

# 只保留銀行相關
grep -A 5 "銀行\|信用卡" cn.vcf > bank.vcf

# 排除騷擾號碼
grep -v "營銷\|騷擾" cn.vcf > clean.vcf

編輯 VCF 文件：

bash

# 使用文本編輯器
vim cn.vcf

# 或使用專用工具
brew install vcardutils
vcf-edit cn.vcf

4. 自動化腳本

定期更新腳本（macOS）：

bash

#!/bin/bash
# update-vcards.sh

# 下載最新版本
curl -L https://github.com/metowolf/vCards/releases/latest/download/archive.zip \
  -o /tmp/vcards.zip

# 解壓
unzip -o /tmp/vcards.zip -d /tmp/vcards

# 備份舊數據
cp ~/Library/Application\ Support/AddressBook/Sources/*/cn.vcf \
   ~/Backup/cn.vcf.backup

# 導入新數據
open /tmp/vcards/cn.vcf

echo "vCards 更新完成！"

設置定時任務：

bash

# 每週日凌晨 3 點自動更新
crontab -e
0 3 * * 0 /path/to/update-vcards.sh

常見問題排查

Q1: CardDAV 賬戶添加失敗？

可能原因：

網絡連接問題
服務器地址錯誤
認證信息錯誤

解決方案：

bash

# 1. 測試網絡連通性
ping vcards.metowolf.com

# 2. 驗證 HTTPS 證書
curl -I https://vcards.metowolf.com

# 3. 檢查憑據
# 確認用戶名和密碼都是 "cn"

# 4. 嘗試備用服務器
# 查看 GitHub Issues 是否有鏡像

Q2: 通訊錄中沒有顯示 vCards 聯繫人？

排查步驟：

步驟 1：檢查同步狀態
設置 → 通訊錄 → 賬戶 → vCards
查看最後同步時間

步驟 2：強制同步
關閉 "通訊錄" 開關 → 等待 → 重新開啟

步驟 3：檢查分組顯示
通訊錄 App → 左上角 "群組"
確保 vCards 分組已勾選

步驟 4：重啟設備
有時需要重啟才能生效

Q3: 來電仍然不顯示名稱？

可能原因：

數據尚未同步完成
號碼格式不匹配
系統緩存問題

解決方案：

方法 1：等待同步完成
首次同步可能需要數小時
連接電源和 WiFi 加速

方法 2：檢查號碼格式
vCards 使用 +86 格式
確保來電號碼格式一致

方法 3：重建索引
設置 → 通用 → 傳輸或還原 iPhone
→ 還原 → 還原所有設置
（不會刪除數據）

方法 4：重新導入
刪除 CardDAV 賬戶
重新添加並等待同步

Q4: 如何更新 vCards 數據？

CardDAV 方式：

自動更新：
- 系統會在連接電源和 WiFi 時自動同步
- 通常每天更新一次

手動觸發：
- 設置 → 通訊錄 → 賬戶 → vCards
- 關閉再開啟 "通訊錄" 開關

手動導入方式：

1. 下載最新版 archive.zip
2. 解壓獲取 cn.vcf
3. 按照方法三重新導入
4. 覆蓋舊數據

Q5: 如何刪除 vCards 通訊錄？

iOS 刪除步驟：

1. 設置 → 通訊錄 → 賬戶
2. 選擇 vCards 賬戶
3. 點擊 "刪除賬戶"
4. 選擇 "從我的 iPhone 刪除"

注意：這隻會刪除本地副本
不會影響服務器數據

macOS 刪除步驟：

1. 通訊錄 → 設置 → 賬戶
2. 選擇 vCards 賬戶
3. 點擊 "-" 刪除
4. 確認刪除

隱私與安全

數據安全說明

使用官方 CardDAV 服務：

✅ 數據傳輸加密（HTTPS）
✅ 僅讀取公開數據
✅ 不收集個人信息
⚠️ 信任第三方服務器

自建服務：

✅ 完全數據自主
✅ 無第三方依賴
✅ 可審計代碼
⚠️ 需要維護成本

隱私保護建議

1. 最小權限原則
   - 僅授予通訊錄讀取權限
   - 不允許寫入（如不需要）

2. 定期檢查
   - 審查已安裝的描述文件
   - 監控通訊錄變化

3. 數據隔離
   - 使用獨立分組管理黃頁
   - 便於隨時禁用或刪除

4. 自建優先
   - 如有技術能力，推薦自建
   - 完全掌控數據流向

總結

通過 vCards 和 CardDAV 協議實現智能來電識別：

✅ 方法一（推薦）：掃碼安裝描述文件，最簡單快捷
✅ 方法二（長期）：手動訂閱 CardDAV，支持自動更新
✅ 方法三（離線）：下載 VCF 手動導入，完全自主控制

關鍵收益：

🎯 來電自動顯示商家名稱
📱 短信智能識別來源
🔒 隱私安全可控
🔄 數據自動更新
🌐 多設備同步

下一步學習：

讓你的手機更加智能便捷！🚀✨

延伸阅读

免责声明

本文仅供技术交流和学习参考。涉及第三方服务的链接可能包含 sponsored 标记，请自行核实服务条款、价格和可用性，并遵守当地法律法规。

iOS/Android 來電識別與聯繫人同步完全指南 | CardDAV vCards 配置教程 ​

什麼是 vCards？ ​

核心優勢 ​

工作原理 ​

方法一：安裝 CardDAV 描述文件（推薦） ​

1. 使用系統相機掃描下方二維碼，下載配置描述文件 ​

2. 打開"設置"App，輕點"已下載描述文件"或"註冊 [組織的名稱]" ​

3. 在右上角點擊"安裝"，按屏幕提示操作完成導入。 ​

方法二：手動訂閱 CardDAV 服務 ​

CardDAV 配置詳解 ​

設置步驟 ​

iOS 配置 ​

macOS 配置 ​

方法三：下載導入 ​

詳細操作步驟 ​

macOS ​

iOS / Web ​

三種方法對比 ​

高級用法 ​

1. 自建 CardDAV 服務器 ​

2. Android 配置 ​

3. 數據篩選與定製 ​

4. 自動化腳本 ​

常見問題排查 ​

Q1: CardDAV 賬戶添加失敗？ ​

Q2: 通訊錄中沒有顯示 vCards 聯繫人？ ​

Q3: 來電仍然不顯示名稱？ ​

Q4: 如何更新 vCards 數據？ ​

Q5: 如何刪除 vCards 通訊錄？ ​

隱私與安全 ​

數據安全說明 ​

隱私保護建議 ​

總結 ​

延伸阅读 ​

iOS/Android 來電識別與聯繫人同步完全指南 | CardDAV vCards 配置教程

什麼是 vCards？

核心優勢

工作原理

方法一：安裝 CardDAV 描述文件（推薦）

1. 使用系統相機掃描下方二維碼，下載配置描述文件

2. 打開"設置"App，輕點"已下載描述文件"或"註冊 [組織的名稱]"

3. 在右上角點擊"安裝"，按屏幕提示操作完成導入。

方法二：手動訂閱 CardDAV 服務

CardDAV 配置詳解

設置步驟

iOS 配置

macOS 配置

方法三：下載導入

詳細操作步驟

macOS

iOS / Web

三種方法對比

高級用法

1. 自建 CardDAV 服務器

2. Android 配置

3. 數據篩選與定製

4. 自動化腳本

常見問題排查

Q1: CardDAV 賬戶添加失敗？

Q2: 通訊錄中沒有顯示 vCards 聯繫人？

Q3: 來電仍然不顯示名稱？

Q4: 如何更新 vCards 數據？

Q5: 如何刪除 vCards 通訊錄？

隱私與安全

數據安全說明

隱私保護建議

總結

延伸阅读