iCloud Photos Downloader

 (github.com/icloud-photos-downloader)
3 điểm bởi GN⁺ 2026-01-12 | 1 bình luận | Chia sẻ qua WhatsApp
  • Công cụ mã nguồn mở cho phép tải ảnh trực tiếp từ dòng lệnh bằng tài khoản iCloud
  • Có thể chạy trên các hệ điều hành chính như Linux, Windows, macOS, đồng thời hỗ trợ cài đặt qua Docker, PyPI, AUR, npm
  • Hoạt động với ba chế độ Copy·Sync·Move, đồng thời bao gồm khả năng xử lý Live Photos·ảnh RAW·siêu dữ liệu EXIF
  • Cung cấp nhiều tùy chọn như tự động loại bỏ trùng lặp, theo dõi thay đổi liên tục, tối ưu hóa chạy tăng dần
  • Được phát hành theo giấy phép MIT và hiện đang tìm người duy trì (maintainer)

Tổng quan dự án

  • iCloud Photos Downloader là công cụ dòng lệnh dùng để tải ảnh được lưu trên iCloud về hệ thống cục bộ
    • Có thể tải toàn bộ ảnh iCloud hoặc chỉ đồng bộ các thay đổi
    • Được phát triển và duy trì bởi cộng đồng tình nguyện viên, hiện đang tuyển thêm người đóng góp mới
  • Phát hành theo giấy phép MIT, cho phép tự do sử dụng và chỉnh sửa
  • Trên GitHub hiện có hơn 10k sao (star) và 705 fork

Nền tảng hỗ trợ và cách phân phối

  • Tương thích hệ điều hành: hỗ trợ Linux, Windows, macOS và môi trường NAS
  • Kênh phân phối:
    • Ảnh Docker
    • Gói PyPI
    • Arch Linux AUR
    • Gói npm
  • Có thể tải trực tiếp tệp thực thi hoặc build từ mã nguồn

Tính năng chính

  • Ba chế độ hoạt động
    • Copy: chỉ tải ảnh mới (chế độ mặc định)
    • Sync: xóa ảnh ở máy cục bộ nếu ảnh đó đã bị xóa trên iCloud (--auto-delete)
    • Move: xóa ảnh trên iCloud sau khi tải xong (--keep-icloud-recent-days)
  • Định dạng hỗ trợ: Live Photos (lưu tách riêng ảnh và video), RAW và RAW+JPEG
  • Tùy chọn tính năng
    • Tự động loại bỏ trùng lặp với ảnh cùng tên
    • Chế độ giám sát liên tục (--watch-with-interval)
    • Tối ưu hóa chạy tăng dần (--until-found, --recent)
    • Chỉnh sửa siêu dữ liệu EXIF (--set-exif-datetime)
  • Có thể xem toàn bộ tùy chọn bằng lệnh --help

Cài đặt và chạy

  • Cách cài đặt
    1. Tải tệp thực thi từ trang GitHub Releases
    2. Cài bằng trình quản lý gói (Docker, PyPI, AUR, npm)
    3. Tự build từ mã nguồn
  • Yêu cầu cấu hình iCloud
    • Bật Access iCloud Data on the Web trên iPhone/iPad
    • Cần tắt Advanced Data Protection
  • Ví dụ sử dụng
    • Chạy đồng bộ: 
      icloudpd --directory /data --username my@email.address --watch-with-interval 3600
    • Tạo phiên xác thực: 
      icloudpd --username my@email.address --password my_password --auth-only

Tính năng thử nghiệm và tình hình phát triển

  • Một số tính năng được thêm trước dưới dạng Experimental Mode để kiểm chứng trước khi đưa vào chính thức
  • Bản phát hành mới nhất là v1.32.2 (ngày 2 tháng 9 năm 2025)
  • Mục tiêu phát hành phiên bản mới là mỗi tuần một lần (thứ Sáu)
  • Các commit gần đây bao gồm hỗ trợ cấu hình nhiều người dùng, sửa bản build không phải Linux, cải thiện môi trường kiểm thử

Đóng góp và cộng đồng

  • Có thể tham gia với vai trò nhà phát triển bên ngoài thông qua hướng dẫn đóng góp (CONTRIBUTING.md)
  • 42 người đóng góp đã tham gia vào mã nguồn, đồng thời có sử dụng các công cụ tự động hóa như Dependabot
  • Hiện dự án đang công khai tuyển người duy trì
  • Tài liệu chính thức và thảo luận được thực hiện trên GitHub Discussions

Bài viết liên quan

1 bình luận

 
GN⁺ 2026-01-12
Ý kiến trên Hacker News

  • Tôi là tác giả của Photos Backup Anywhere. Điều khiến tôi ngạc nhiên khi phân tích Apple Photos là chỉ riêng các tệp trên đĩa không thể biểu diễn toàn bộ trạng thái
    Album, Live Photos, chụp liên tiếp, quay chậm, lịch sử chỉnh sửa, chỉnh sửa ngày chụp, v.v. được quản lý riêng, và hầu hết công cụ sao lưu không thể tái dựng chúng đúng cách khi khôi phục
    Vì vậy tôi xem chính Photos là nguồn sự thật (source of truth), và chọn cách xác minh dựa trên đó khi khôi phục
    Công cụ này khôi phục đầy đủ album và mọi loại ảnh, đồng thời giữ nguyên vị trí, ngày tạo và ngày sửa đổi
    Trang dự án ở photosbackup.app

    • Khi chuyển ảnh từ iPhone, tôi dùng ứng dụng ‘Image Capture’ để sao chép theo dải 0~9999. Khi vượt quá 10 nghìn ảnh thì tên tệp lại quay về 00001(1), rất bất tiện
      SSD trên MacBook của tôi nhỏ và tôi không muốn đi qua iCloud, nên tôi muốn biết có cách nào xuất trực tiếp RAW/JPEG/Live/Video gốc ra ổ đĩa ngoài hay không
    • Tôi đã có một trải nghiệm đúng là ác mộng khi trích xuất ảnh từ một điện thoại Android cũ. Nếu giao diện không hiện đúng thì phải dựa vào công cụ quét vét cả ổ đĩa
    • Không biết có hỗ trợ sao lưu lên kho lưu trữ tương thích S3 (ví dụ: Backblaze B2) không
    • Bạn đã từng xem qua Parachute Backup chưa? Bên đó cũng tuyên bố có thể sao lưu cả dữ liệu phức tạp của iPhotos

  • Dự án này thật sự rất tuyệt. Có thể nó sẽ thay thế được ứng dụng iCloud cho Windows
    Tôi cũng có khoảng 2TB dữ liệu iCloud, nhưng MacBook không đủ dung lượng nên tôi đặt một Photo Library riêng trên ổ ngoài
    Ứng dụng iCloud cho Windows lúc nào cũng đang tải xuống ở 50MB/s, nhưng khi mở thư mục thì phần lớn vẫn ở trạng thái ‘chỉ khả dụng trực tuyến’
    Hiện tôi mới tải được khoảng 944GB, nên có lẽ sẽ còn mất thời gian để xong hẳn
    Tôi muốn biết có trình xem ảnh thay thế nào trên Windows hiển thị tốt HEIC và Live Photo không

  • Có Parachute là phần mềm trả phí, nhưng chỉ dành cho macOS. Nó có thể tải xuống toàn bộ ảnh và tệp trong thư viện iCloud
    Liên kết App Store

    • Trên iOS, PhotoSync cũng khá ổn. Có thể chuyển ảnh tới NAS hoặc các dịch vụ từ xa như B2
    • Bản desktop của Parachute ổn định, nhưng bản iOS không thể hoàn tất sao lưu gia tăng cho thư viện 1TB chỉ trong một đêm
      Nó xuất tệp gốc nhưng không bao gồm tệp AAE. Trong khi đó, điểm đáng tiếc của PhotoSync là không có chức năng khôi phục
    • Tôi đã hỏi liệu nó có tương thích với tài khoản ADP không nhưng không nhận được phản hồi. Tôi cũng muốn biết có giải pháp tải xuống nào dùng được cho tài khoản ADP không
    • Tôi cũng muốn biết có thể kiểm chứng độ an toàn về mặt quyền riêng tư hay không, và có lựa chọn thay thế nào cho Windows không

  • Thật đáng ngạc nhiên là không có cách chính thức nào để tải tất cả ảnh từ iCloud cùng một lúc (khoảng 400GB)
    Thay vào đó, có thể nhận toàn bộ ảnh iCloud bằng một công cụ dòng lệnh mã nguồn mở

    • Thực ra trên Mac hoặc iPhone, nếu vào thiết lập iCloud Photo Library và chọn ‘Tải về bản gốc’ thì có thể tải toàn bộ xuống
    • Nếu là người dùng EU, bạn có thể yêu cầu toàn bộ dữ liệu Apple đang lưu giữ tại privacy.apple.com
    • Trong ứng dụng Photos trên Mac, bạn có thể xuất bản gốc bằng Cmd+A > File > Export Unmodified Originals
    • Cũng có thể đây là chủ đích của Apple để người dùng không rời đi. Việc làm cho chuyện di chuyển ảnh trở nên khó khăn trông giống một chiến lược khóa chặt hệ sinh thái

  • Vài ngày trước tôi đã sao lưu thư viện dùng chung, xử lý khoảng 10K ảnh và video (300GB)
    Khôi phục thư viện iPhoto → xuất ra chia theo từng năm → chuyển sang HDD ngoài → đặt thư viện trên HDD ngoài làm mặc định rồi đồng bộ lại với iCloud
    Kết nối Ethernet có dây và tính năng Repair đã giúp ích rất nhiều

    • Tôi muốn biết cách này có khác gì so với việc chuyển tệp Photos Library sang HDD ngoài rồi trỏ Photos.app đến đường dẫn đó hay không

  • Tôi sao chép trực tiếp tệp ảnh từ iPhone bằng tổ hợp usbmuxd + ifuse
    Không cần chờ tải lên hay tải xuống, chỉ cần cắm cáp là lấy được bản gốc ngay, thậm chí còn có thể di chuyển chúng để giải phóng dung lượng

    • Tôi muốn biết cách này có dùng được với mọi iPhone không. Có thể mount thư mục DCIM qua USB và thậm chí có quyền ghi hay không

  • Tôi dùng một shell script nhỏ để tải ảnh iCloud định kỳ
    Dùng container icloudpd/icloudpd:latest để lưu bản gốc theo cấu trúc thư mục

    • Tuy nhiên, dùng nguyên thẻ latest là nguy hiểm. Không nên giao thông tin xác thực iCloud cho một image chưa được kiểm chứng. Cố định theo phiên bản cụ thể hoặc hash sẽ an toàn hơn

  • Gia đình tôi tạo ra khoảng 2TB media mỗi năm. Tổng cộng hiện khoảng 12TB
    Tính năng kỷ niệm của iCloud thì hay, nhưng 60 USD mỗi tháng là quá nặng nên tôi làm như sau

    • Dùng docker-icloudpd để sao lưu ảnh của nhiều tài khoản vào bộ nhớ cục bộ
    • Chỉ giữ 2 năm gần nhất trên iCloud, còn cũ hơn thì lưu cục bộ
    • Ảnh cũ thì duyệt và tìm kiếm bằng Immich. Tự host nhưng trải nghiệm ứng dụng rất tốt
      Đĩa cục bộ tốc độ cao (ví dụ: OWC 4M2 + M.2 SSD) rất quan trọng. NAS dùng HDD thì chậm
      Liên kết GitHub docker-icloudpd
    • Tôi muốn biết có tính năng nào bạn dùng trong Photos mà Immich chưa có không. Tôi dùng Android nên chỉ với Immich là đã hoàn toàn hài lòng rồi

  • Trong iCloud Photos.app, một số ảnh không hiện ra, nhưng trong Photometor.app (thuộc sở hữu của Apple) thì lại thấy
    Tôi không hiểu vì sao Photos.app không hiển thị chúng nên rất bực bội

  • Thật tiếc là Apple gần như không cho phép tích hợp bên thứ ba
    Tôi muốn tự động đồng bộ ảnh từ một album cụ thể sang khung ảnh của bố mẹ hoặc Samsung Frame TV, nhưng các tính năng như vậy đều bị chặn
    Chỉ cần mở ra một chút thôi là có lẽ đã có thể tạo ra những cách sử dụng đầy đổi mới

    • Tôi giải quyết vấn đề này bằng PhotoSync. Tôi đặt quy tắc đồng bộ theo từng album để tự động chuyển ảnh