คำถามที่พบบ่อย

คำถามที่พบบ่อยเกี่ยวกับ IPFS Ninja

ทั่วไป

IPFS Ninja คืออะไร?

IPFS Ninja เป็นบริการ IPFS pinning ที่จัดการ คุณอัปโหลดไฟล์ใดก็ได้ผ่าน REST API ที่ง่ายดาย หรือปักหมุด CID ที่มีอยู่จากเครือข่าย IPFS แต่ละไฟล์จะได้รับตัวระบุเนื้อหาถาวร (CID) และเข้าถึงได้ผ่าน gateway ของเราที่ ipfs.ninja/ipfs/<CID>

ipfs.ninja/ipfs/<CID> ให้บริการ CID ใด ๆ บนเครือข่าย IPFS หรือไม่?

ไม่ apex gateway ให้บริการเฉพาะ CID ที่ได้รับการอัปโหลดหรือปักหมุดโดยผู้ใช้ IPFS Ninja เท่านั้น คำขอสำหรับ CID ที่ไม่รู้จักจะส่งคืน HTTP 410 Gone พร้อมตัวชี้ไปยัง gateway IPFS สาธารณะ (ipfs.io, dweb.link) หากต้องการให้บริการ CID ของบุคคลที่สามผ่าน gateway ของเรา ให้ทำ POST /pin ไปยังบัญชีของคุณก่อน — เมื่อปักหมุดแล้ว CID จะเข้าถึงได้ทั้งที่ apex และ URL ของ gateway เฉพาะของคุณ

ความแตกต่างระหว่าง apex gateway และ gateway เฉพาะคืออะไร?

แง่มุม	apex ipfs.ninja/ipfs/<CID>	เฉพาะ <slug>.gw.ipfs.ninja/ipfs/<CID>
ขอบเขต	ใช้ร่วมกันระหว่างผู้ใช้ทั้งหมด	เฉพาะ CID ของคุณ
การยืนยันตัวตน	ไม่มี	โทเค็นเสริม / IP allowlist / origin allowlist
SLA	Best-effort	SLA เต็มรูปแบบ
แนะนำสำหรับ	ลิงก์ทั่วไป	การฝังในระบบจริง (NFT, วิดีโอ, เว็บไซต์)
ขีดจำกัดอัตรา	ใช้ร่วมกันต่อ IP + ต่อ CID	ตามแผน กำหนดค่าได้

ทั้งสองให้บริการเนื้อหาที่เหมือนกัน สำหรับการรับส่งข้อมูลในระบบจริง ให้ใช้ gateway เฉพาะ

รองรับไฟล์ประเภทใดบ้าง?

รองรับไฟล์ทุกประเภท อ็อบเจกต์และอาร์เรย์ JSON สามารถส่งได้โดยตรง ไฟล์อื่นๆ ทั้งหมด (รูปภาพ, PDF, HTML, วิดีโอ, เสียง, ไบนารี) จะถูกส่งเป็นเนื้อหาที่เข้ารหัสด้วย base64

มีขีดจำกัดขนาดไฟล์หรือไม่?

การอัปโหลดแต่ละครั้งจำกัดตามปริมาณพื้นที่จัดเก็บของแผนของคุณ ไม่มีขีดจำกัดขนาดต่อไฟล์นอกเหนือจากพื้นที่จัดเก็บที่คุณมี

ฉันสามารถปักหมุดเนื้อหาที่มีอยู่แล้วบน IPFS ได้หรือไม่?

ได้ ใช้ POST /pin กับ CID ที่ถูกต้องใดก็ได้ คลัสเตอร์ของเราจะดึงเนื้อหาจากเครือข่าย IPFS และปักหมุดไว้ในบัญชีของคุณ ดูรายละเอียดที่ เอกสาร Pinning API

การปักหมุดใช้เวลานานเท่าไร?

ขึ้นอยู่กับขนาดไฟล์และจำนวนโหนด IPFS ที่มีเนื้อหา ไฟล์ขนาดเล็กที่กระจายดีจะปักหมุดได้ในไม่กี่วินาที เนื้อหาขนาดใหญ่หรือที่ถูกปักหมุดน้อยอาจใช้เวลาไม่กี่นาที endpoint การปักหมุดจะตอบกลับทันทีด้วยสถานะ pinning — สอบถาม GET /pin/:cid เพื่อตรวจสอบความคืบหน้า

จะเกิดอะไรขึ้นหาก CID ไม่พบ?

สถานะจะเปลี่ยนเป็น failed ซึ่งหมายความว่า CID ไม่ถูกต้องหรือเนื้อหาไม่สามารถใช้งานได้จากโหนด IPFS ที่เข้าถึงได้อีกต่อไป

ข้อมูลที่อัปโหลดไปยัง IPFS เป็นสาธารณะหรือไม่?

ใช่ เนื้อหาทั้งหมดที่ปักหมุดบน IPFS สามารถเข้าถึงได้สาธารณะผ่าน CID ผ่าน IPFS gateway ใดก็ได้ หากคุณต้องการการเข้าถึงแบบส่วนตัว ใช้ gateway เฉพาะ ด้วยโหมดต้องใช้โทเค็น — ซึ่งจำกัดการเข้าถึงผ่าน gateway ของคุณ แม้ว่าเนื้อหาจะยังคงใช้งานได้บนเครือข่าย IPFS ที่กว้างกว่า

ทำไม CID ใหม่ของฉันเปลี่ยนจาก Qm... เป็น bafy...?

การอัปโหลดและการปักหมุดใหม่จะส่งคืน CIDv1 รุ่นใหม่ (bafk… สำหรับเนื้อหาบล็อกเดียวขนาดเล็ก, bafy… สำหรับไฟล์และไดเรกทอรีขนาดใหญ่กว่า) ตามโปรไฟล์ IPIP-0499 unixfs-v1-2025: การเข้ารหัส CIDv1 base32, ชิ้นข้อมูลขนาด 1 MiB, raw leaves ตรงกับสิ่งที่เครื่องมือรุ่นใหม่ (Helia, Kubo ล่าสุด, ipfs-car) สร้างสำหรับเนื้อหาเดียวกัน ดังนั้นไฟล์ที่อัปโหลดผ่านเราจะได้ CID เดียวกับที่ไคลเอนต์รุ่นใหม่ใด ๆ จะคำนวณได้จากไบต์เดียวกัน

CID แบบเก่า Qm… จากการอัปโหลดก่อนหน้ายังคงแก้ไขได้อย่างสมบูรณ์ — gateway, POST /pin, GET /file, IPNS และทุก endpoint อื่นยอมรับทั้งสองรูปแบบตลอดไป สิ่งที่คุณมีอยู่แล้วจะไม่หยุดทำงาน

ฉันจะปักหมุดเนื้อหาที่อยู่บนโหนดส่วนตัว/ไม่อยู่บน DHT ได้อย่างไร?

POST /pin รับ multiaddresses[] ที่เป็นตัวเลือก (สูงสุด 5 รายการ) หากระบุ คลัสเตอร์ของเราจะทำ ipfs swarm connect <multiaddr> สำหรับแต่ละคำใบ้ ก่อน ที่การปักหมุดจะรัน ดังนั้นเนื้อหาบน peer ที่ไม่ได้ประกาศผ่าน DHT สาธารณะ (โหนดส่วนตัว, สภาพแวดล้อม staging, เครื่องภายใน VPN) จึงเข้าถึงได้ ดูคู่มือ การปักหมุดจากโหนด IPFS ส่วนตัว

ไฟล์ของฉันจะยังคงอยู่บน IPFS หากฉันยกเลิกบัญชีหรือไม่?

เราจะถอนปักหมุดไฟล์ของคุณจากโหนดของเราเมื่อคุณยกเลิก หากโหนด IPFS อื่นๆ ได้แคชเนื้อหาของคุณไว้ มันอาจยังคงเข้าถึงได้ อย่างไรก็ตาม หากไม่มีการปักหมุดที่ใช้งานอยู่ ไฟล์จะถูกลบออกโดย garbage collection ในที่สุดทั่วทั้งเครือข่าย

การยืนยันตัวตนและ API

ฉันจะยืนยันตัวตนคำขอ API ได้อย่างไร?

ส่ง API key ของคุณผ่านเฮดเดอร์ X-Api-Key สร้างคีย์จากหน้า API Keys ในแดชบอร์ดของคุณ

มีขีดจำกัดอัตราการใช้ API หรือไม่?

ไม่มี IPFS Ninja ไม่กำหนดขีดจำกัดอัตราการใช้คำขอ API คุณสามารถส่งคำขอได้มากเท่าที่ต้องการในทุกแผน

API key หมดอายุหรือไม่?

ไม่ API key ใช้ได้จนกว่าคุณจะลบ คุณสามารถสร้างคีย์หลายตัวและเพิกถอนแต่ละตัวได้

ความแตกต่างระหว่าง API key และ gateway token คืออะไร?

API key (bws_) มีสิทธิ์เข้าถึงเต็มรูปแบบ — อัปโหลด, ลบ, แสดงรายการไฟล์ Gateway token (gwt_) เป็นแบบอ่านอย่างเดียวและสามารถเข้าถึงไฟล์ได้เฉพาะผ่าน gateway เฉพาะของคุณ Gateway token ปลอดภัยในการฝังในแอปฝั่งหน้า

Gateway เฉพาะ

Gateway เฉพาะคืออะไร?

Gateway IPFS ส่วนตัวที่ซับโดเมนของคุณเอง (เช่น abc123.gw.ipfs.ninja) ที่ให้บริการเฉพาะไฟล์ที่ปักหมุดในบัญชีของคุณ ต่างจาก gateway สาธารณะ จะไม่แก้ไข CID จากผู้ใช้อื่น

แผนไหนรวม gateway เฉพาะ?

Gateway เฉพาะมีให้ในทุกแผนที่เสียเงิน (Bodhi $5/เดือน, Karma $19/เดือน, Nirvana $59/เดือน) โควตาแบนด์วิดท์รายเดือนของแต่ละแผนครอบคลุมการรับส่งข้อมูลทั้งจาก apex และ gateway เฉพาะ ดู "มีค่าธรรมเนียมแบนด์วิดท์หรือไม่?" ด้านล่างสำหรับโควตาแต่ละแผน

ฉันสามารถจำกัดผู้ที่เข้าถึง gateway ของฉันได้หรือไม่?

ได้ คุณสามารถเปิดใช้โหมดต้องใช้โทเค็น (ต้องมีโทเค็น gwt_ ในทุกคำขอ) และ/หรือตั้ง IP whitelist (สูงสุด 100 ที่อยู่)

ฉันสามารถจำกัด gateway ตาม origin/domain ได้หรือไม่?

ได้ กำหนดค่า allowedOrigins ในการตั้งค่า gateway ของคุณด้วยรายการ HTTPS origin เฉพาะคำขอจากเบราว์เซอร์จาก origin เหล่านั้นเท่านั้นที่จะได้รับอนุญาต คำขอที่ไม่ใช่เบราว์เซอร์ (ไม่มีเฮดเดอร์ Origin) จะผ่านไปได้ รายการว่างอนุญาตทุก origin

โทเค็นอัปโหลดที่ลงนามคืออะไร?

โทเค็นอัปโหลดที่ลงนามเป็นข้อมูลรับรองที่มีระยะเวลาจำกัดสำหรับการอัปโหลดฝั่งไคลเอนต์ คุณสร้างมันบนเซิร์ฟเวอร์ของคุณโดยใช้ POST /upload/signed-url และส่งให้เบราว์เซอร์หรือแอปมือถือ ไคลเอนต์ยืนยันตัวตนด้วย Authorization: Signed <token> แทนที่จะเปิดเผย API key ของคุณ แต่ละโทเค็นจะติดตามการใช้งานและหมดอายุโดยอัตโนมัติ ดูรายละเอียดที่ เอกสารโทเค็นที่ลงนาม

ฉันสามารถปรับแต่งรูปภาพที่ให้บริการจาก IPFS ได้หรือไม่?

ได้ ใช้ GET /image/:cid พร้อมพารามิเตอร์คิวรีเช่น w, h, format และ quality เพื่อปรับขนาด แปลง และบีบอัดรูปภาพแบบ on-the-fly การตอบกลับจะถูกแคชตาม CID ที่ระบุด้วยเนื้อหา ใช้งานได้ในทุกแผน ดู การปรับแต่งรูปภาพ

ฉันสามารถแนบ metadata กับไฟล์ได้หรือไม่?

ได้ รวมอ็อบเจกต์ metadata พร้อมคู่คีย์-ค่าสูงสุด 10 คู่เมื่ออัปโหลดผ่าน POST /upload/new หรือปักหมุดผ่าน POST /pin metadata จะถูกส่งคืนในรายการไฟล์และ endpoint รายละเอียดไฟล์ ดูเอกสาร ไฟล์ และ การปักหมุด

การเรียกเก็บเงินและแผน

มีแผนฟรีหรือไม่?

มี แผน Dharma ฟรีตลอดไป — พื้นที่จัดเก็บ 1 GB, คำขอ API ไม่จำกัด, ไม่ต้องใช้บัตรเครดิต

มีค่าธรรมเนียมแบนด์วิดท์หรือไม่?

ไม่มีค่าธรรมเนียมแบนด์วิดท์แบบวัดปริมาณในทุกแผน แต่ละแผนมีโควตาแบนด์วิดท์ gateway รายเดือนที่เป็นเพดานตายตัว — เนื้อหาของคุณจะหยุดให้บริการทั้งบน apex และ gateway เฉพาะเมื่อถึงโควตา และจะกลับมาให้บริการในวันที่ 1 ของเดือนถัดไปหรือหลังการอัปเกรด:

แผน	แบนด์วิดท์รายเดือน
Dharma	2 GB
Bodhi	20 GB
Karma	100 GB
Nirvana	500 GB

คุณจะได้รับอีเมลแจ้งเตือนที่ 80% และ 100% ของโควตาของคุณ

พื้นที่จัดเก็บรีเซ็ตหรือไม่?

พื้นที่จัดเก็บไม่รีเซ็ต แผนของคุณรวมปริมาณพื้นที่จัดเก็บทั้งหมด (Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB) หากต้องการเพิ่มพื้นที่ว่าง ให้ลบไฟล์ที่คุณไม่ต้องการแล้ว การอัปเกรดแผนจะเพิ่มปริมาณทั้งหมดของคุณ

ฉันสามารถยกเลิกได้ตลอดเวลาหรือไม่?

ได้ ยกเลิกการสมัครสมาชิกผ่านพอร์ทัลการเรียกเก็บเงิน — ไม่มีการผูกมัด บัญชีของคุณจะกลับสู่ระดับฟรี และไฟล์ที่ปักหมุดอยู่ยังคงเข้าถึงได้

จะเกิดอะไรขึ้นกับไฟล์ของฉันหากฉันดาวน์เกรด?

ไฟล์ของคุณจะยังคงปักหมุดอยู่บน IPFS แต่คุณจะไม่สามารถอัปโหลดเพิ่มได้หากการใช้งานปัจจุบันของคุณเกินขีดจำกัดพื้นที่จัดเก็บของแผนใหม่ ลบไฟล์เพื่อกลับไปอยู่ภายใต้ขีดจำกัด

ความปลอดภัย

ข้อมูลของฉันถูกเข้ารหัสหรือไม่?

ข้อมูลทั้งหมดถูกเข้ารหัสระหว่างการส่งผ่าน TLS/HTTPS การยืนยันตัวตนใช้ JWT token (Cognito) และ API key ที่จัดเก็บอย่างปลอดภัย เนื้อหาไฟล์บน IPFS ไม่ได้ถูกเข้ารหัสขณะจัดเก็บ — IPFS เป็นเครือข่ายสาธารณะโดยการออกแบบ

ปลอดภัยหรือไม่ที่จะใช้ API key ในโค้ดฝั่งเซิร์ฟเวอร์?

ปลอดภัย API key ถูกออกแบบมาสำหรับการใช้งานฝั่งเซิร์ฟเวอร์ อย่าเปิดเผยในโค้ดฝั่งไคลเอนต์ สำหรับการเข้าถึงไฟล์ฝั่งไคลเอนต์ ใช้ gateway token (gwt_) ซึ่งเป็นแบบอ่านอย่างเดียว

การสนับสนุน

ฉันจะขอความช่วยเหลือได้อย่างไร?

ส่งอีเมลไปที่ info@ipfs.ninja หรือดูเอกสาร เอกสารอ้างอิง API

มี SLA หรือไม่?

เรามุ่งมั่นให้บริการที่มีความพร้อมใช้งานสูงแต่ไม่ได้เสนอ SLA อย่างเป็นทางการในขณะนี้ บริการนี้ให้บริการ "ตามสภาพ"