Mã định danh Nội dung (CID)

Dấu vân tay duy nhất mà mỗi tệp IPFS nhận được.

CID là gì?

Mã định danh Nội dung (CID) là nhãn tự mô tả xác định duy nhất một phần dữ liệu trên IPFS. Nó được tạo ra từ hàm băm mật mã của nội dung tệp, kết hợp với siêu dữ liệu về thuật toán băm và định dạng mã hóa được sử dụng.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

Các CID bắt đầu bằng bafy (hoặc bafk cho nội dung nhỏ dạng một khối) sử dụng CIDv1, định dạng tự mô tả hiện đại. Các CID cũ bắt đầu bằng Qm sử dụng CIDv0 (SHA-256 mã hóa base58) — vẫn hợp lệ, vẫn có thể phân giải, nhưng không còn là đầu ra mặc định cho nội dung mới.

Thuộc tính chính

• Xác định — Cùng một tệp luôn tạo ra cùng CID. Tải cùng hình ảnh hai lần và bạn nhận được cùng mã định danh.
• Duy nhất — Ngay cả thay đổi một byte cũng tạo ra CID hoàn toàn khác. Điều này làm CID chống giả mạo.
• Tự xác minh — Bất kỳ ai nhận tệp đều có thể tính lại hàm băm và xác nhận nó khớp với CID đã yêu cầu.
• Bất biến — CID luôn trỏ đến cùng nội dung. Bạn không thể thay đổi CID phân giải đến đâu.

CID trong IPFS.NINJA

Mỗi tệp bạn tải lên trả về CID trong phản hồi API. Sử dụng nó để:

• Truy cập tệp qua gateway: ipfs.ninja/ipfs/<CID>
• Truy xuất siêu dữ liệu tệp: GET /file/<CID>
• Tham chiếu nội dung on-chain (NFT, hợp đồng thông minh)
• Chia sẻ với bất kỳ ai — họ có thể xác minh nội dung khớp

CIDv0 vs CIDv1

Thuộc tính	CIDv0	CIDv1
Tiền tố	Qm...	bafy... (dag-pb, thư mục & tệp nhiều khối), bafk... (raw, nội dung nhỏ dạng một khối), cùng các định dạng khác theo codec
Hàm băm	Chỉ SHA-256	Nhiều loại (SHA-256, Blake2b, v.v.)
Mã hóa	Base58 (chữ hoa/thường lẫn lộn)	Multibase — mặc định base32 (chữ thường, an toàn cho DNS)
Tự mô tả	Không	Có (bao gồm codec + thông tin băm)
Chunker	Mặc định cũ 256 KiB	1 MiB theo IPIP-0499
Mã hóa leaf	Được bọc trong dag-pb	Byte thô (raw-leaves=true)

IPFS.NINJA phát ra định dạng gì?

Các lần tải lên và ghim thực hiện sau 2026-07-13 trả về CIDv1 theo mặc định: mã hóa CIDv1 base32, các khối 1 MiB, raw leaves — hồ sơ IPIP-0499 unixfs-v1-2025. Các tác động thực tế:

• Tệp nhỏ (≤ 1 MiB) trả về dưới dạng bafk... (CIDv1 raw một khối)
• Tệp lớn hơn và thư mục trả về dưới dạng bafy... (CIDv1 dag-pb)
• Một tệp tải lên qua chúng tôi nhận cùng CID mà bất kỳ công cụ hiện đại nào (Helia, Kubo mới nhất, ipfs-car) sẽ tính toán từ cùng byte đó

Khả năng tương thích ngược

Các CID Qm... cũ từ các lần tải lên trước đó vẫn hoàn toàn có thể phân giải — gateway, POST /pin, GET /file/:cid, các trình phân giải IPNS và mọi endpoint khác chấp nhận cả hai định dạng vô thời hạn. Nếu bạn có CID Qm... từ một lần tải lên trước đó, không có gì bạn đã xây dựng ngừng hoạt động.