IPFS Ninja

Μεταφορτώστε εύκολα εικόνες, αρχεία PDF και JSON στο IPFS και αποκτήστε ένα μόνιμο αναγνωριστικό περιεχομένου (CID) με άμεση πρόσβαση μέσω gateway.

Τι είναι το IPFS?

Το InterPlanetary File System (IPFS) είναι ένα αποκεντρωμένο πρωτόκολλο αποθήκευσης, ομότιμου δικτύου (peer-to-peer). Το IPFS χωρίζει τα αρχεία σε μικρότερα τμήματα, τα διανέμει σε όλο το δίκτυο και αναθέτει σε κάθε αρχείο ένα μοναδικό αναγνωριστικό περιεχομένου (CID) βάσει του περιεχομένου του.

Αυτό σημαίνει:

• Κατανεμημένη αποθήκευση — τα αρχεία σας αποθηκεύονται σε πολλαπλούς κόμβους για βελτιωμένη αξιοπιστία.
• Διευθυνσιοδότηση περιεχομένου — το CID προκύπτει από το ίδιο το περιεχόμενο του αρχείου, εξασφαλίζοντας αμεταβλητότητα.
• Προσβασιμότητα σε όλο το δίκτυο — οποιοσδήποτε διαθέτει το CID μπορεί να ανακτήσει το αρχείο από οποιονδήποτε κόμβο IPFS.

Τι κάνει το IPFS Ninja

Το IPFS Ninja είναι μια διαχειριζόμενη υπηρεσία που σας επιτρέπει να μεταφορτώνετε αρχεία και να καρφιτσώνετε (pin) υπάρχον περιεχόμενο στο IPFS μέσω ενός απλού REST API. Δεν χρειάζεται να τρέχετε τον δικό σας κόμβο IPFS.

• Μεταφόρτωση νέων αρχείων — στείλτε οποιοδήποτε αρχείο μέσω POST /upload/new και λάβετε ένα μόνιμο CID
• Καρφίτσωμα υπαρχόντων CID — έχετε ήδη περιεχόμενο στο IPFS; Καρφιτσώστε το στο cluster μας μέσω POST /pin για να διασφαλίσετε ότι παραμένει διαθέσιμο
• Πρόσβαση μέσω gateway — όλο το καρφιτσωμένο περιεχόμενο είναι προσβάσιμο στο ipfs.ninja/ipfs/<CID> (το apex gateway εξυπηρετεί μόνο CID που ανήκουν στον λογαριασμό σας ή σε άλλους λογαριασμούς IPFS Ninja — δείτε Πρόσβαση μέσω gateway παρακάτω)
• Προσαρμοσμένα μεταδεδομένα — επισυνάψτε ζεύγη κλειδιού-τιμής στις μεταφορτώσεις και τα pins για οργάνωση και φιλτράρισμα
• Υπογεγραμμένα tokens μεταφόρτωσης — δημιουργήστε tokens περιορισμένης διάρκειας για μεταφορτώσεις από την πλευρά του client χωρίς να εκθέτετε το API key σας
• Μεταβλητά ονόματα IPNS — δημιουργήστε σταθερά ονόματα που δείχνουν σε μεταβαλλόμενα CID μέσω του IPNS API, με έως 10 ονόματα ανά λογαριασμό
• Βελτιστοποίηση εικόνων — αλλάξτε μέγεθος, μετατρέψτε και συμπιέστε εικόνες on-the-fly μέσω παραμέτρων URL του gateway

Πίνακας ελέγχου

Παρακολουθήστε τις μεταφορτώσεις, την αποθήκευση και το εύρος ζώνης του gateway από τον προσωπικό σας πίνακα ελέγχου. Ο πίνακας ελέγχου σάς επιτρέπει επίσης να χρησιμοποιήσετε το μεγαλύτερο μέρος του API χωρίς να γράψετε κώδικα:

• Μεταφόρτωση με μεταφορά και απόθεση (drag-and-drop) — αρχεία, φακέλους (συσκευασμένους σε κατάλογο UnixFS μέσα στο πρόγραμμα περιήγησής σας) ή αρχεία .car
• Μετονομασία αρχείων μετά τη μεταφόρτωση· η περιγραφή συμπληρώνεται αυτόματα από το όνομα αρχείου κατά την επιλογή
• Στιγμιότυπο (snapshot) ενός φακέλου για να λάβετε ένα ενιαίο CID καταλόγου για ό,τι περιέχεται μέσα
• Διαμόρφωση S3 CORS ανά bucket μέσω ενός editor φόρμας (για ενσωματώσεις browser SDK)
• Διαχείριση API keys, tokens gateway, ονομάτων IPNS και ρυθμίσεων αποκλειστικού gateway

Πρόσβαση μέσω gateway

Κάθε αρχείο που μεταφορτώνεται είναι προσβάσιμο μέσω του gateway του IPFS Ninja, το οποίο λειτουργεί ως γέφυρα μεταξύ του αποκεντρωμένου δικτύου IPFS και των παραδοσιακών προγραμμάτων περιήγησης στο διαδίκτυο.

Η διεύθυνση URL του gateway ακολουθεί αυτό το μοτίβο:

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

Εμβέλεια apex gateway

Το apex gateway στο https://ipfs.ninja/ipfs/<CID> εξυπηρετεί μόνο CID που έχουν μεταφορτωθεί ή καρφιτσωθεί από εγγεγραμμένο χρήστη του IPFS Ninja. Τα αιτήματα για οποιοδήποτε άλλο CID επιστρέφουν HTTP 410 Gone με παραπομπή σε δημόσια gateways IPFS όπως ipfs.io ή dweb.link. Για να εξυπηρετήσετε ένα CID τρίτου μέσω του gateway μας, εγγραφείτε δωρεάν και κάντε POST /pin για αυτό στον λογαριασμό σας πρώτα.

TIP

Τα αρχεία σας είναι επίσης προσβάσιμα από οποιοδήποτε δημόσιο gateway IPFS (π.χ. dweb.link, w3s.link) χρησιμοποιώντας το ίδιο CID — το δίκτυο IPFS είναι αποκεντρωμένο.

Όλα τα επί πληρωμή πλάνα λαμβάνουν ένα αποκλειστικό gateway στο δικό τους subdomain (<slug>.gw.ipfs.ninja) που εξυπηρετεί μόνο αρχεία καρφιτσωμένα στον λογαριασμό τους — με προαιρετικό έλεγχο πρόσβασης βάσει token και περιορισμούς origin. Το αποκλειστικό gateway είναι η συνιστώμενη διεύθυνση URL για ενσωμάτωση σε παραγωγή (βίντεο, εργαλεία προβολής NFT, ιστότοπους).

Υποστηριζόμενοι τύποι αρχείων

Τύπος	Μορφές	Είσοδος
JSON	Οποιοδήποτε έγκυρο αντικείμενο ή πίνακας JSON	string / object
Εικόνες	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	Τυπικά έγγραφα PDF	base64
HTML	Έγγραφα HTML	base64
Οποιοδήποτε	Οποιοδήποτε αρχείο (δυαδικό, κείμενο, βίντεο κ.λπ.)	base64

Όλοι οι τύποι αρχείων γίνονται δεκτοί. Ο τύπος ανιχνεύεται αυτόματα και καταγράφεται για αναφορά σας.

Ασφάλεια

Οι απαντήσεις του gateway περιλαμβάνουν κεφαλίδες ασφαλείας (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) που εμποδίζουν τα προγράμματα περιήγησης να εκτελούν scripts στο περιεχόμενο που παρέχεται.