Συχνές Ερωτήσεις

Συχνές ερωτήσεις σχετικά με το 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 πύλη εξυπηρετεί μόνο CID που έχουν ανέβει ή καρφιτσωθεί από χρήστη IPFS Ninja. Τα αιτήματα για άγνωστα CID επιστρέφουν HTTP 410 Gone με δείκτη σε δημόσιες πύλες IPFS (ipfs.io, dweb.link). Για να εξυπηρετήσετε ένα CID τρίτου μέσω της πύλης μας, εκτελέστε πρώτα POST /pin στον λογαριασμό σας — μόλις καρφιτσωθεί, το CID γίνεται προσβάσιμο τόσο στο apex όσο και στο URL της αφιερωμένης πύλης σας.

Ποια είναι η διαφορά μεταξύ της apex πύλης και της αφιερωμένης πύλης;

Πτυχή	Apex ipfs.ninja/ipfs/<CID>	Αφιερωμένη <slug>.gw.ipfs.ninja/ipfs/<CID>
Εμβέλεια	Κοινή για όλους τους χρήστες	Μόνο τα δικά σας CID
Πιστοποίηση	Καμία	Προαιρετικό token / whitelist IP / whitelist origin
SLA	Best-effort	Πλήρες SLA
Συνιστάται για	Περιστασιακούς συνδέσμους	Παραγωγική ενσωμάτωση (NFT, βίντεο, ιστότοποι)
Όρια ρυθμού	Κοινά ανά IP + ανά CID	Ανά πλάνο, ρυθμιζόμενα

Και οι δύο εξυπηρετούν πανομοιότυπο περιεχόμενο. Για παραγωγική κίνηση, χρησιμοποιήστε την αφιερωμένη πύλη.

Ποιοι τύποι αρχείων υποστηρίζονται;

Υποστηρίζονται όλοι οι τύποι αρχείων. Αντικείμενα και πίνακες JSON μπορούν να αποσταλούν απευθείας. Όλα τα υπόλοιπα αρχεία (εικόνες, PDF, HTML, βίντεο, ήχος, δυαδικά αρχεία) αποστέλλονται ως περιεχόμενο κωδικοποιημένο σε base64.

Υπάρχει όριο μεγέθους αρχείου;

Οι μεμονωμένες μεταφορτώσεις περιορίζονται από το όριο αποθηκευτικού χώρου του πλάνου σας. Δεν υπάρχει όριο μεγέθους ανά αρχείο πέρα από τον διαθέσιμο αποθηκευτικό σας χώρο.

Μπορώ να καρφιτσώσω περιεχόμενο που ήδη υπάρχει στο IPFS;

Ναι. Χρησιμοποιήστε POST /pin με οποιοδήποτε έγκυρο CID. Το cluster μας θα ανακτήσει το περιεχόμενο από το δίκτυο IPFS και θα το καρφιτσώσει στον λογαριασμό σας. Δείτε τα έγγραφα του API καρφιτσώματος για λεπτομέρειες.

Πόσο χρόνο διαρκεί το καρφίτσωμα;

Εξαρτάται από το μέγεθος του αρχείου και το πόσοι κόμβοι IPFS διαθέτουν το περιεχόμενο. Μικρά, καλά διανεμημένα αρχεία καρφιτσώνονται σε δευτερόλεπτα. Μεγάλο ή σπάνια καρφιτσωμένο περιεχόμενο μπορεί να χρειαστεί μερικά λεπτά. Το endpoint καρφιτσώματος επιστρέφει αμέσως με κατάσταση pinning — κάντε poll στο GET /pin/:cid για να ελέγξετε την πρόοδο.

Τι συμβαίνει αν δεν βρεθεί ένα CID;

Η κατάσταση αλλάζει σε failed. Αυτό σημαίνει ότι το CID είναι είτε μη έγκυρο είτε το περιεχόμενο δεν είναι πλέον διαθέσιμο σε κανέναν προσβάσιμο κόμβο IPFS.

Είναι δημόσια τα δεδομένα που ανεβαίνουν στο IPFS;

Ναι. Όλο το περιεχόμενο που καρφιτσώνεται στο IPFS είναι δημόσια προσβάσιμο μέσω του CID του από οποιαδήποτε πύλη IPFS. Αν χρειάζεστε ιδιωτική πρόσβαση, χρησιμοποιήστε μια αφιερωμένη πύλη σε λειτουργία υποχρεωτικού token — αυτό περιορίζει την πρόσβαση μέσω της πύλης σας, αν και το περιεχόμενο παραμένει διαθέσιμο στο ευρύτερο δίκτυο IPFS.

Γιατί τα νέα μου CID άλλαξαν από Qm... σε bafy...;

Οι νέες μεταφορτώσεις και τα καρφιτσώματα επιστρέφουν πλέον σύγχρονο CIDv1 (bafk… για μικρό περιεχόμενο ενός block, bafy… για μεγαλύτερα αρχεία και καταλόγους) σύμφωνα με το προφίλ IPIP-0499 unixfs-v1-2025: κωδικοποίηση CIDv1 base32, τμήματα 1 MiB, raw leaves. Αυτό ταιριάζει με ό,τι παράγουν τα σύγχρονα εργαλεία (Helia, το πιο πρόσφατο Kubo, ipfs-car) για το ίδιο περιεχόμενο, οπότε ένα αρχείο που ανεβαίνει μέσω εμάς παίρνει το ίδιο CID που θα υπολόγιζε οποιοσδήποτε σύγχρονος client για τα ίδια bytes.

Τα παλαιότερα CID Qm… από προηγούμενες μεταφορτώσεις παραμένουν πλήρως επιλύσιμα — η πύλη, το POST /pin, το GET /file, το IPNS, και κάθε άλλο endpoint δέχεται και τις δύο μορφές επ' αόριστον. Τίποτα από όσα ήδη έχετε δεν σταματά να λειτουργεί.

Πώς καρφιτσώνω περιεχόμενο που βρίσκεται σε ιδιωτικό / μη-DHT κόμβο;

Το POST /pin δέχεται προαιρετικά multiaddresses[] (έως 5). Αν παρέχονται, το cluster μας εκτελεί ipfs swarm connect <multiaddr> για κάθε υπόδειξη πριν εκτελεστεί το καρφίτσωμα, ώστε περιεχόμενο σε peers που δεν διαφημίζονται μέσω του δημόσιου DHT (ιδιωτικοί κόμβοι, περιβάλλοντα staging, τοπικά μηχανήματα VPN) να είναι προσβάσιμο. Δείτε τον οδηγό Καρφίτσωμα από ιδιωτικό κόμβο IPFS.

Θα παραμείνουν τα αρχεία μου στο IPFS αν ακυρώσω τον λογαριασμό μου;

Ξεκαρφιτσώνουμε τα αρχεία σας από τους κόμβους μας όταν ακυρώνετε. Αν άλλοι κόμβοι IPFS έχουν αποθηκεύσει προσωρινά το περιεχόμενό σας, ενδέχεται να παραμείνει προσβάσιμο. Ωστόσο, χωρίς ενεργό καρφίτσωμα, τα αρχεία θα αφαιρεθούν τελικά μέσω garbage collection σε όλο το δίκτυο.

Πιστοποίηση & API

Πώς πιστοποιώ τα αιτήματα API;

Περάστε το κλειδί API σας μέσω της κεφαλίδας X-Api-Key. Δημιουργήστε κλειδιά από τη σελίδα API Keys στον πίνακα ελέγχου σας.

Υπάρχουν όρια ρυθμού για το API;

Όχι. Το IPFS Ninja δεν επιβάλλει όρια ρυθμού στα αιτήματα API. Μπορείτε να κάνετε όσα αιτήματα χρειάζεστε σε οποιοδήποτε πλάνο.

Λήγουν τα κλειδιά API;

Όχι. Τα κλειδιά API παραμένουν έγκυρα μέχρι να τα διαγράψετε. Μπορείτε να δημιουργήσετε πολλαπλά κλειδιά και να τα ανακαλέσετε μεμονωμένα.

Ποια είναι η διαφορά μεταξύ κλειδιών API και token πύλης;

Τα κλειδιά API (bws_) έχουν πλήρη πρόσβαση — μεταφόρτωση, διαγραφή, λίστα αρχείων. Τα token πύλης (gwt_) είναι μόνο για ανάγνωση και μπορούν να έχουν πρόσβαση σε αρχεία μόνο μέσω της αφιερωμένης πύλης σας. Τα token πύλης είναι ασφαλή για ενσωμάτωση σε εφαρμογές frontend.

Αφιερωμένες Πύλες

Τι είναι μια αφιερωμένη πύλη;

Μια ιδιωτική πύλη IPFS στο δικό σας subdomain (π.χ. abc123.gw.ipfs.ninja) που εξυπηρετεί μόνο αρχεία καρφιτσωμένα στον λογαριασμό σας. Σε αντίθεση με τη δημόσια πύλη, δεν θα επιλύει CID άλλων χρηστών.

Ποια πλάνα περιλαμβάνουν αφιερωμένη πύλη;

Οι αφιερωμένες πύλες είναι διαθέσιμες σε όλα τα επί πληρωμή πλάνα (Bodhi 5$/μήνα, Karma 19$/μήνα, Nirvana 59$/μήνα). Το μηνιαίο όριο εύρους ζώνης κάθε πλάνου καλύπτει την κίνηση τόσο από την apex όσο και από τις αφιερωμένες πύλες. Δείτε "Υπάρχουν χρεώσεις εύρους ζώνης;" παρακάτω για τα όρια ανά πλάνο.

Μπορώ να περιορίσω ποιος έχει πρόσβαση στην πύλη μου;

Ναι. Μπορείτε να ενεργοποιήσετε τη λειτουργία υποχρεωτικού token (απαιτεί ένα token gwt_ σε κάθε αίτημα) και/ή να ορίσετε λίστα επιτρεπόμενων IP (έως 100 διευθύνσεις).

Μπορώ να περιορίσω την πύλη μου κατά origin/domain;

Ναι. Ρυθμίστε το allowedOrigins στις ρυθμίσεις πύλης σας με μια λίστα origins HTTPS. Μόνο τα αιτήματα browser από αυτά τα origins θα επιτρέπονται. Αιτήματα που δεν προέρχονται από browser (χωρίς κεφαλίδα Origin) περνούν κανονικά. Μια κενή λίστα επιτρέπει όλα τα origins.

Τι είναι τα signed upload token;

Τα signed upload token είναι διαπιστευτήρια περιορισμένης διάρκειας για μεταφορτώσεις από την πλευρά του client. Τα δημιουργείτε στον server σας χρησιμοποιώντας POST /upload/signed-url και τα περνάτε σε browsers ή εφαρμογές mobile. Ο client πιστοποιείται με Authorization: Signed <token> αντί να εκθέτει το κλειδί API σας. Κάθε token παρακολουθεί τη χρήση του και λήγει αυτόματα. Δείτε τα έγγραφα Signed Tokens για λεπτομέρειες.

Μπορώ να βελτιστοποιήσω εικόνες που εξυπηρετούνται από το 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, χωρίς απαίτηση πιστωτικής κάρτας.

Υπάρχουν χρεώσεις εύρους ζώνης;

Καμία χρέωση μετρούμενου εύρους ζώνης σε κανένα πλάνο. Κάθε πλάνο περιλαμβάνει μηνιαίο όριο εύρους ζώνης πύλης που αποτελεί αυστηρό ανώτατο όριο — το περιεχόμενό σας σταματά να εξυπηρετείται στην apex και στις αφιερωμένες πύλες μόλις εξαντληθεί το όριο, και επανέρχεται την 1η του επόμενου μήνα ή μετά από αναβάθμιση:

Πλάνο	Μηνιαίο εύρος ζώνης
Dharma	2 GB
Bodhi	20 GB
Karma	100 GB
Nirvana	500 GB

Θα λαμβάνετε προειδοποιητικά emails στο 80% και στο 100% του ορίου σας.

Μηδενίζεται ο αποθηκευτικός χώρος;

Ο αποθηκευτικός χώρος δεν μηδενίζεται. Το πλάνο σας περιλαμβάνει συνολικό όριο αποθηκευτικού χώρου (Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB). Για να ελευθερώσετε χώρο, διαγράψτε αρχεία που δεν χρειάζεστε πλέον. Η αναβάθμιση του πλάνου σας αυξάνει το συνολικό σας όριο.

Μπορώ να ακυρώσω οποιαδήποτε στιγμή;

Ναι. Ακυρώστε τη συνδρομή σας μέσω της πύλης χρέωσης — χωρίς δέσμευση. Ο λογαριασμός σας επιστρέφει στο δωρεάν επίπεδο, και τα υπάρχοντα καρφιτσωμένα αρχεία παραμένουν προσβάσιμα.

Τι συμβαίνει στα αρχεία μου αν υποβαθμίσω το πλάνο μου;

Τα αρχεία σας παραμένουν καρφιτσωμένα στο IPFS, αλλά δεν μπορείτε να ανεβάσετε άλλα αν η τρέχουσα χρήση σας υπερβαίνει το όριο αποθηκευτικού χώρου του νέου πλάνου. Διαγράψτε αρχεία για να επιστρέψετε κάτω από το όριο.

Ασφάλεια

Είναι κρυπτογραφημένα τα δεδομένα μου;

Όλα τα δεδομένα είναι κρυπτογραφημένα κατά τη μεταφορά μέσω TLS/HTTPS. Η πιστοποίηση χρησιμοποιεί JWT token (Cognito) και κλειδιά API αποθηκευμένα με ασφάλεια. Το περιεχόμενο αρχείων στο IPFS δεν είναι κρυπτογραφημένο σε κατάσταση ηρεμίας — το IPFS είναι ένα δημόσιο δίκτυο εκ σχεδιασμού.

Είναι ασφαλές να χρησιμοποιώ κλειδιά API στον server-side κώδικά μου;

Ναι. Τα κλειδιά API είναι σχεδιασμένα για χρήση από την πλευρά του server. Ποτέ μην τα εκθέτετε σε client-side κώδικα. Για πρόσβαση σε αρχεία από την πλευρά του client, χρησιμοποιήστε token πύλης (gwt_) που είναι μόνο για ανάγνωση.

Υποστήριξη

Πώς μπορώ να λάβω βοήθεια;

Στείλτε email στο info@ipfs.ninja ή δείτε την τεκμηρίωση API Reference.

Υπάρχει SLA;

Επιδιώκουμε υψηλή διαθεσιμότητα αλλά δεν προσφέρουμε επίσημο SLA αυτή τη στιγμή. Η υπηρεσία παρέχεται σε βάση "ως έχει".