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>
• 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.

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>

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.

Người dùng gói Nirvana 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.

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ụ.

Giới hạn kích thước

Giới hạn	Giá trị
Payload tối đa mỗi yêu cầu	6 MB (giới hạn API Gateway)
Tổng dung lượng (Dharma)	1 GB
Tổng dung lượng (Bodhi)	10 GB
Tổng dung lượng (Nirvana)	100 GB

Trường hợp sử dụng

Siêu dữ liệu và tài sản NFT

Lưu trữ siêu dữ liệu JSON của NFT và hình ảnh liên quan với CID vĩnh viễn, bất biến.

Lưu trữ tài nguyên tĩnh

Lưu trữ hình ảnh, tài liệu và tệp dữ liệu cho ứng dụng web và di động.

Chia sẻ dữ liệu có thể xác minh

Chia sẻ dữ liệu với nguồn gốc được định địa chỉ theo nội dung — người nhận có thể xác minh rằng không có gì bị giả mạo.