IPFS Ninja

อัปโหลดรูปภาพ, PDF และไฟล์ JSON ไปยัง IPFS ได้อย่างง่ายดาย และรับตัวระบุเนื้อหาถาวร (CID) พร้อมการเข้าถึง gateway ทันที

IPFS คืออะไร?

InterPlanetary File System (IPFS) คือโปรโตคอลการจัดเก็บข้อมูลแบบกระจายศูนย์แบบ peer-to-peer IPFS แบ่งไฟล์ออกเป็นชิ้นส่วนเล็กๆ กระจายไปทั่วเครือข่าย และกำหนด ตัวระบุเนื้อหา (CID) ที่ไม่ซ้ำกันให้กับแต่ละไฟล์ตามเนื้อหาของมัน

ซึ่งหมายความว่า:

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

IPFS Ninja ทำอะไร

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

• อัปโหลดไฟล์ใหม่ — ส่งไฟล์ใดก็ได้ผ่าน POST /upload/new และรับ CID ถาวร
• ปักหมุด CID ที่มีอยู่ — มีเนื้อหาอยู่บน IPFS แล้ว? ปักหมุดไปยังคลัสเตอร์ของเราผ่าน POST /pin เพื่อให้แน่ใจว่ายังคงใช้งานได้
• เข้าถึงผ่าน gateway — เนื้อหาที่ปักหมุดทั้งหมดสามารถเข้าถึงได้ที่ ipfs.ninja/ipfs/<CID> (apex gateway ให้บริการเฉพาะ CID ในบัญชีของคุณหรือในบัญชี IPFS Ninja อื่น ๆ — ดู การเข้าถึง gateway ด้านล่าง)
• metadata ที่กำหนดเอง — แนบคู่คีย์-ค่ากับการอัปโหลดและการปักหมุดเพื่อการจัดระเบียบและการกรอง
• โทเค็นอัปโหลดที่ลงนาม — สร้างโทเค็นที่มีระยะเวลาจำกัดสำหรับการอัปโหลดฝั่งไคลเอนต์โดยไม่ต้องเปิดเผย API key ของคุณ
• IPNS ชื่อที่เปลี่ยนได้ — สร้างชื่อที่เสถียรที่ชี้ไปยัง CID ที่เปลี่ยนแปลงผ่าน IPNS API โดยมีชื่อได้สูงสุด 10 ชื่อต่อบัญชี
• การปรับแต่งรูปภาพ — ปรับขนาด แปลง และบีบอัดรูปภาพแบบ on-the-fly ผ่านพารามิเตอร์ URL ของ gateway

แดชบอร์ด

ติดตามการอัปโหลด พื้นที่จัดเก็บ และแบนด์วิดท์ gateway จากแดชบอร์ดส่วนตัวของคุณ แดชบอร์ดยังช่วยให้คุณขับเคลื่อน API ส่วนใหญ่ได้โดยไม่ต้องเขียนโค้ด:

• การอัปโหลดแบบลากและวาง — ไฟล์, โฟลเดอร์ (ถูกแพ็กเป็นไดเรกทอรี UnixFS ในเบราว์เซอร์ของคุณ) หรือไฟล์เก็บถาวร .car
• เปลี่ยนชื่อ ไฟล์หลังอัปโหลด; คำอธิบายจะกรอกให้อัตโนมัติจากชื่อไฟล์เมื่อเลือก
• สแนปช็อต โฟลเดอร์เพื่อรับ directory CID เดียวสำหรับทุกอย่างในนั้น
• กำหนดค่า S3 CORS ต่อ bucket ผ่านตัวแก้ไขแบบฟอร์ม (สำหรับการผสานรวม SDK บนเบราว์เซอร์)
• จัดการ API key, gateway token, ชื่อ IPNS และการตั้งค่า gateway เฉพาะ

การเข้าถึง Gateway

ทุกไฟล์ที่อัปโหลดสามารถเข้าถึงได้ผ่าน IPFS Ninja gateway ซึ่งทำหน้าที่เป็นสะพานเชื่อมระหว่างเครือข่าย IPFS แบบกระจายศูนย์กับเว็บเบราว์เซอร์ทั่วไป

รูปแบบ URL ของ gateway เป็นดังนี้:

https://ipfs.ninja/ipfs/<CID>

ขอบเขตของ apex gateway

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

TIP

ไฟล์ของคุณยังสามารถเข้าถึงได้จาก IPFS gateway สาธารณะใดก็ได้ (เช่น dweb.link, w3s.link) โดยใช้ CID เดียวกัน — เครือข่าย IPFS เป็นแบบกระจายศูนย์

ทุกแผนที่เสียเงิน จะได้รับ gateway เฉพาะ ที่ซับโดเมนของตนเอง (<slug>.gw.ipfs.ninja) ซึ่งให้บริการเฉพาะไฟล์ที่ปักหมุดในบัญชีของพวกเขา — พร้อมการควบคุมการเข้าถึงด้วยโทเค็นและข้อจำกัดต้นทางที่เป็นตัวเลือก gateway เฉพาะเป็น URL ที่แนะนำสำหรับการฝังในระบบจริง (วิดีโอ, ตัวแสดงผล NFT, เว็บไซต์)

ประเภทไฟล์ที่รองรับ

ประเภท	รูปแบบ	อินพุต
JSON	อ็อบเจกต์หรืออาร์เรย์ JSON ใดก็ได้	string / object
รูปภาพ	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	เอกสาร PDF มาตรฐาน	base64
HTML	เอกสาร HTML	base64
อื่นๆ	ไฟล์ใดก็ได้ (binary, text, video ฯลฯ)	base64

ยอมรับไฟล์ทุกประเภท ประเภทจะถูกตรวจจับอัตโนมัติและบันทึกไว้เพื่อการอ้างอิงของคุณ

ความปลอดภัย

การตอบกลับจาก gateway รวมถึงเฮดเดอร์ความปลอดภัย (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) ที่ป้องกันไม่ให้เบราว์เซอร์รันสคริปต์ในเนื้อหาที่ให้บริการ