Идентификатори на съдържанието (CID)

Уникалният пръстов отпечатък, който всеки IPFS файл получава.

CIDv0 срещу CIDv1: Сравнение на форматите

Свойство	CIDv0	CIDv1
Представка	Qm...	bafy... (dag-pb, директории и файлове с множество части), bafk... (raw, малко съдържание в един блок), плюс други според кодека
Хеш функция	Само SHA-256	Множество (SHA-256, Blake2b и др.)
Кодиране	Base58 (смесен регистър)	Multibase — base32 по подразбиране (малки букви, безопасно за DNS)
Самоописващ се	Не	Да (включва информация за кодек + хеш)
Разделяне на части	256 KiB по подразбиране (стар вариант)	1 MiB съгласно IPIP-0499
Кодиране на листата	Опаковано в dag-pb	Сурови байтове (raw-leaves=true)

Какво връща IPFS.NINJA

Качванията и закаченията, направени след 2026-07-13, връщат CIDv1 по подразбиране: base32 кодиране на CIDv1, части от 1 MiB, сурови листа — профилът IPIP-0499 unixfs-v1-2025. Практически последствия:

• Малките файлове (≤ 1 MiB) се връщат като bafk... (raw CIDv1 в един блок)
• По-големите файлове и директории се връщат като bafy... (dag-pb CIDv1)
• Файл, качен през нас, получава същия CID, който всеки съвременен инструмент (Helia, последен Kubo, ipfs-car) би изчислил от същите байтове

Обратна съвместимост

По-старите CID-ове Qm... от предишни качвания остават напълно разрешими — gateway, POST /pin, GET /file/:cid, IPNS резолверите и всяка друга крайна точка приемат и двата формата за неопределено време. Ако имате Qm... CID от по-ранно качване, нищо от изграденото от вас не спира да работи.

Какво е CID?

Идентификаторът на съдържанието (CID) е самоописващ се етикет, който уникално идентифицира част от данни в IPFS. Той е извлечен от криптографския хеш на съдържанието на файла, комбиниран с метаданни за използвания алгоритъм за хеширане и формат на кодиране.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

CID-овете, които започват с bafy (или bafk за малко съдържание в един блок), използват CIDv1 — модерния самоописващ се формат. По-старите CID-ове, които започват с Qm, използват CIDv0 (base58-кодиран SHA-256) — все още валидни, все още разрешими, но вече не са изходният формат по подразбиране за ново съдържание.

Ключови свойства

• Детерминистичен — Един и същ файл винаги произвежда един и същ CID. Качете едно и също изображение два пъти и получавате същия идентификатор.
• Уникален — Дори промяна на един байт произвежда напълно различен CID. Това прави CID устойчив на подправяне.
• Самоверифициращ — Всеки, който получи файл, може да преизчисли хеша и да потвърди, че съвпада с поискания CID.
• Неизменяем — CID винаги сочи към едно и също съдържание. Не можете да промените към какво CID сочи.

CID в IPFS.NINJA

Всеки файл, който качите, връща CID в API отговора. Използвайте го за:

• Достъп до файла чрез gateway: ipfs.ninja/ipfs/<CID>
• Извличане на метаданни на файла: GET /file/<CID>
• Референция на съдържание on-chain (NFT, смарт контракти)
• Споделяне с всеки — могат да проверят дали съдържанието съвпада

Вижте общ преглед на IPFS.NINJA, за да разберете как CID-овете се вписват в процеса на качване. Научете как да закачите съдържание по CID, за да остане постоянно достъпно.