ذخیره و هم‌رسانی فایل‌ها

صفحهٔ **ذخیره‌سازی** (در منوی بالا، یا [zaryn.xyz/storage](/storage)) جایی است که هر چه در زرین نگه می‌دارید کنار هم می‌آید: مخزن‌ها، فایل‌هایی که با پیوند هم‌رسانی می‌کنید، و بسته‌هایتان؛ هر کدام با اینکه چقدر از طرحتان را گرفته است. ## بارگذاری فایل و هم‌رسانی پیوندش 1. **ذخیره‌سازی** را باز کنید. 2. فایل را روی **بارگذاری فایل** رها کنید، یا رویش کلیک کنید و فایل را انتخاب کنید. می‌توانید چند فایل را با هم انتخاب کنید. 3. وقتی تمام شد، **کپی پیوند** را بزنید و پیوند را برای هر کسی که لازم دارد بفرستید. همین. کسی که پیوند را می‌گیرد به حساب کاربری نیاز ندارد. پیوند این شکلی است: ```text https://ipfs.io/ipfs/bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi?filename=report.pdf ``` فایل‌هایتان زیر **فایل‌های من** می‌مانند، تازه‌ترین اول، با **کپی پیوند** و **باز کردن** کنار هر کدام. > **فایل‌های اینجا عمومی‌اند.** هر کسی که پیوند را داشته باشد می‌تواند فایل را باز کند، و هر کسی بازش کرده ممکن است نسخه‌ای نگه دارد. رمز عبور، عکس خصوصی، قرارداد یا هر چیزی که عمومی منتشرش نمی‌کنید را بارگذاری نکنید. برای کار خصوصی از [مخزن خصوصی](/docs/fa/encrypted-repositories) استفاده کنید. ## چرا پیوند همیشه کار می‌کند فایل‌ها در IPFS نگه داشته می‌شوند؛ شبکه‌ای عمومی از رایانه‌ها که فایل‌ها را بر اساس **محتوایشان** پیدا می‌کنند، نه **جایشان**. هر فایل شناسه‌ای می‌گیرد که از محتوایش ساخته می‌شود (یک *CID*، که زیر دکمهٔ ▾ کنار فایل دیده می‌شود). - پیوند همیشه دقیقاً همان فایل را باز می‌کند. هیچ‌کس، حتی زرین، نمی‌تواند چیز دیگری جایش بگذارد. - اگر فایل را تغییر دهید و دوباره بارگذاری کنید، نسخهٔ تازه شناسه و پیوند تازه‌ای می‌گیرد. پیوند قدیمی همچنان نسخهٔ قدیمی را باز می‌کند. - بارگذاری دوبارهٔ همان فایل، فضا را دو بار نمی‌گیرد. یک پیوند می‌خواهید که همیشه *آخرین* نسخه‌تان را نشان دهد؟ این **نشانی‌ای است که می‌توانید به‌روز کنید** (IPNS)، زیر **پیشرفته** در صفحهٔ ذخیره‌سازی. ## چقدر فضا دارید | | رایگان | پریمیوم | |---|---|---| | فایل‌هایی که با پیوند هم‌رسانی می‌کنید | ۵۰۰ مگابایت، تا ۵۰ فایل | خیلی بیشتر، [طرح‌ها](/billing) را ببینید | | مخزن‌ها | ۲ گیگابایت، هر فایل تا ۲۵۰ مگابایت | بیشتر | | بسته‌ها | ۵۰۰ مگابایت | بیشتر | نوارهای بالای صفحهٔ ذخیره‌سازی نشان می‌دهند چقدر استفاده کرده‌اید. وقتی نواری کهربایی شود از ۷۵٪ گذشته‌اید، و وقتی به سقفی برسید زرین به شما اعلان می‌دهد. ## حذف فایل (توقف میزبانی) منوی ▾ کنار فایل را باز کنید، **توقف میزبانی** را بزنید و تأیید کنید. فایل دیگر از فضای شما کم نمی‌کند و زرین دیگر آن را در دسترس نگه نمی‌دارد. چون IPFS شبکه‌ای مشترک است، نسخه‌ای که کس دیگری گرفته ممکن است تا مدتی کار کند؛ برای همین چیزهای خصوصی جایشان اینجا نیست. ## برای توسعه‌دهنده‌ها همین کار با API، با یک [توکن دسترسی شخصی](/settings) که دامنهٔ `pin:write` دارد: ```bash # بارگذاری: پاسخ، cid و یک پیوند آماده دارد curl -X POST "https://api.zaryn.xyz/v1/pins?name=report.pdf" \ -H "Authorization: Bearer $ZARYN_TOKEN" \ --data-binary @report.pdf # فهرست فایل‌ها و فضای شما curl -H "Authorization: Bearer $ZARYN_TOKEN" https://api.zaryn.xyz/v1/pins # توقف میزبانی یکی curl -X DELETE -H "Authorization: Bearer $ZARYN_TOKEN" https://api.zaryn.xyz/v1/pins/<cid> ``` هر بارگذاری رسیدی دارد که سرور امضایش کرده (کدام فایل، چه حجمی، چه زمانی) و هر کسی بعداً می‌تواند بررسی‌اش کند. ابزارهای **پیشرفته** در صفحهٔ ذخیره‌سازی بقیه را پوشش می‌دهند: بررسی فایل در دروازه‌های عمومی، پیوند دادن فایل به کامیتی که از آن ساخته شده، مانیفست برای عامل‌های هوش مصنوعی، نسخه‌ها و دیتاست‌ها، و نشانی‌های IPNS. اینکه زرین چطور فایل‌ها را روی چند سرور در دسترس نگه می‌دارد در [پین کردن و IPFS Cluster](/docs/fa/pinning-and-cluster) آمده است.