IPFS Ninja

Dễ dàng tải lên hình ảnh, PDF và tệp JSON lên IPFS và nhận mã định danh nội dung vĩnh viễn (CID) với quyền truy cập gateway tức thì.

IPFS là gì?

Hệ thống Tệp Liên Hành Tinh (IPFS) là một giao thức lưu trữ phi tập trung, ngang hàng. IPFS chia các tệp thành các phần nhỏ hơn, phân phối chúng trên toàn mạng và gán cho mỗi tệp một mã định danh nội dung (CID) duy nhất dựa trên nội dung của nó.

Điều này có nghĩa là:

• Lưu trữ phân tán — các tệp của bạn được lưu trữ trên nhiều nút để cải thiện độ tin cậy.
• Định địa chỉ theo nội dung — CID được tạo ra từ chính nội dung tệp, đảm bảo tính bất biến.
• Khả năng truy cập toàn mạng — bất kỳ ai có CID đều có thể truy xuất tệp từ bất kỳ nút IPFS nào.

IPFS Ninja làm gì

IPFS Ninja là một dịch vụ được quản lý cho phép bạn tải lên tệp và ghim nội dung hiện có trên IPFS thông qua một API REST đơn giản. Không cần chạy nút IPFS của riêng bạn.

• Tải lên tệp mới — gửi bất kỳ tệp nào qua POST /upload/new và nhận CID vĩnh viễn
• Ghim CID hiện có — đã có nội dung trên IPFS? Ghim nó vào cụm của chúng tôi qua POST /pin để đảm bảo nó luôn khả dụng
• Truy cập qua gateway — tất cả nội dung đã ghim đều có thể truy cập tại ipfs.ninja/ipfs/<CID> (cổng apex chỉ phục vụ các CID trong tài khoản của bạn hoặc trong các tài khoản IPFS Ninja khác — xem Truy cập cổng bên dưới)
• Siêu dữ liệu tùy chỉnh — đính kèm các cặp khóa-giá trị vào các lần tải lên và ghim để tổ chức và lọc
• Token tải lên có chữ ký — tạo token có thời hạn cho tải lên phía client mà không cần lộ khóa API của bạn
• Tên có thể thay đổi IPNS — tạo tên ổn định trỏ đến các CID thay đổi qua API IPNS, với tối đa 10 tên mỗi tài khoản
• Tối ưu hóa hình ảnh — thay đổi kích thước, chuyển đổi và nén hình ảnh trực tiếp qua tham số URL gateway

Bảng điều khiển

Theo dõi các lần tải lên, dung lượng lưu trữ và băng thông gateway từ bảng điều khiển cá nhân của bạn. Bảng điều khiển cũng cho phép bạn điều khiển hầu hết API mà không cần viết mã:

• Kéo-và-thả tải lên — tệp, thư mục (được đóng gói thành một thư mục UnixFS ngay trong trình duyệt của bạn), hoặc kho lưu trữ .car
• Đổi tên tệp sau khi tải lên; mô tả tự động điền từ tên tệp khi chọn
• Chụp nhanh một thư mục để lấy một CID thư mục duy nhất cho mọi thứ bên trong
• Cấu hình S3 CORS theo từng bucket qua trình chỉnh sửa dạng biểu mẫu (cho các tích hợp SDK trình duyệt)
• Quản lý khóa API, token gateway, tên IPNS và cài đặt gateway chuyên dụng

Truy cập gateway

Mọi tệp đã tải lên đều có thể truy cập thông qua gateway IPFS Ninja, đóng vai trò cầu nối giữa mạng IPFS phi tập trung và các trình duyệt web truyền thống.

URL gateway theo mẫu sau:

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

Phạm vi cổng apex

Cổng apex tại https://ipfs.ninja/ipfs/<CID> chỉ phục vụ các CID đã được tải lên hoặc ghim bởi người dùng IPFS Ninja đã đăng ký. Các yêu cầu cho bất kỳ CID nào khác trả về HTTP 410 Gone với con trỏ đến các cổng IPFS công cộng như ipfs.io hoặc dweb.link. Để phục vụ CID của bên thứ ba qua cổng của chúng tôi, đăng ký miễn phí và thực hiện POST /pin vào tài khoản của bạn trước.

TIP

Các tệp của bạn cũng có thể truy cập từ bất kỳ gateway IPFS công cộng nào (ví dụ: dweb.link, w3s.link) sử dụng cùng CID — mạng IPFS là phi tập trung.

Tất cả các gói trả phí đều nhận được một gateway chuyên dụng tại tên miền phụ riêng (<slug>.gw.ipfs.ninja) chỉ phục vụ các tệp được ghim vào tài khoản của họ — với kiểm soát truy cập tùy chọn dựa trên token và hạn chế nguồn gốc. Gateway chuyên dụng là URL được khuyến nghị cho nhúng sản xuất (video, trình xem NFT, trang web).

Các loại tệp được hỗ trợ

Loại	Định dạng	Đầu vào
JSON	Bất kỳ đối tượng hoặc mảng JSON hợp lệ	string / object
Hình ảnh	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	Tài liệu PDF tiêu chuẩn	base64
HTML	Tài liệu HTML	base64
Bất kỳ	Bất kỳ tệp nào (nhị phân, văn bản, video, v.v.)	base64

Tất cả các loại tệp đều được chấp nhận. Loại tệp được tự động phát hiện và ghi lại để bạn tham khảo.

Bảo mật

Các phản hồi gateway bao gồm tiêu đề bảo mật (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) ngăn trình duyệt thực thi script trong nội dung được phục vụ.