---
title: "Pingle SDK — Pingle"
description: "‏Pingle SDK به شما امکان می‌دهد VPN را روی همان هستهٔ Rust کلاینت‌های Pingle در اپلیکیشن خودتان بگنجانید."
lang: "fa"
dir: "rtl"
canonical_url: "https://pingle.one/fa/sdk"
markdown_url: "https://pingle.one/fa/sdk.md"
alternates:
  ru: "https://pingle.one/ru/sdk.md"
  en: "https://pingle.one/sdk.md"
  ar: "https://pingle.one/ar/sdk.md"
  fa: "https://pingle.one/fa/sdk.md"
  zh: "https://pingle.one/zh/sdk.md"
---

# Pingle SDK

‏Pingle SDK به شما امکان می‌دهد VPN را روی همان هستهٔ Rust کلاینت‌های Pingle در اپلیکیشن خودتان بگنجانید.

## این چیست

‏Pingle SDK کمک می‌کند VPN را در محصولتان بگنجانید: یک اپلیکیشن، فریم‌ور یک روتر، یک دستگاه. لازم نیست تونل، مسیریابی و یکپارچگی با سکو را از صفر بنویسید — همان قطعاتی را برمی‌دارید که کلاینت Pingle از آن‌ها ساخته شده.

**این SDK در حال توسعه است و هنوز منتشر نشده.** اگر می‌خواهید جزو اولین‌ها امتحانش کنید، راه تماستان را در فرم همین صفحه بگذارید.

## بر چه پایه‌ای ساخته شده

این SDK همان هستهٔ Pingle است که برای محصولات دیگران بسته‌بندی شده:

- **هسته‌ای با Rust** — مثل اپلیکیشن‌های Pingle: ایمن در کار با حافظه، سریع و قابل انتقال، از گوشی تا میکروکنترلر.
- **افزونه‌ها در WebAssembly** — مسیریابی، ایزوله‌سازی دوطرفه و قابلیت‌های دیگر ماژول‌هایی در جعبهٔ شنی بسته‌اند: نه هسته را خراب می‌کنند، نه به دادهٔ دیگران می‌رسند.
- **تونل بومی خود سکو** — این SDK تونل را همان‌طور بالا می‌آورد که خود سیستم انتظار دارد، نه از طریق لایه‌ای عمومی.


## سکوها

سکوها همان سکوهای کلاینت Pingle‌اند:

| روش بالا آوردن تونل | سکوها |
| --- | --- |
| Network Extension | iPhone، iPad، Mac، Apple TV |
| VpnService | Android، Android TV |
| Wintun | Windows |
| TUN | Linux، Steam Deck، Raspberry Pi، FreeBSD، OpenWrt |
| کانتینر | Synology، QNAP، Docker، Home Assistant |
| WebAssembly | مرورگر |
| no_std | ESP32 |

روی دستگاه‌های Apple، VPN فقط به شکل Network Extension اجرا می‌شود و روی Android از طریق VpnService و با اجازهٔ کاربر. سازوکار خود سیستم، تونل را بخشی از دستگاه می‌کند.

هنوز معلوم نیست نسخهٔ اول چه سکوهایی را پوشش می‌دهد: سکوی مورد نیازتان را در فرم بنویسید — این در ترتیب کار اثر دارد.

## برای چه کسانی

- **توسعه‌دهندگان اپلیکیشن** که VPN را درون محصولشان می‌خواهند، نه اپلیکیشنی جداگانه در کنار آن.
- **سازندگان سخت‌افزار** — روتر، NAS، ست‌تاپ‌باکس — که تونل را در فریم‌ور می‌خواهند.
- **اپراتورهای سرویس** که برای سکوی خودشان به کلاینت نیاز دارند.

برای یک سرویس VPN کامل با برند خودتان، با تعرفه و صورت‌حساب، SDK بیش از نیاز است — [سرویس اختصاصی](https://pingle.one/fa/for-business) را ببینید.

## وضعیت

این SDK از هستهٔ کلاینت Pingle بیرون می‌آید. یک SDK عمومی، مستند و نسخه‌دار هنوز وجود ندارد؛ تا نسخهٔ اول، رابط‌ها ممکن است تغییر کنند و تاریخی اعلام نمی‌کنیم که نتوانیم به آن پایبند بمانیم.

**امروز نمی‌توانید محصولی روی این SDK بسازید**، اما می‌توانید دربارهٔ نیازتان به ما بگویید تا نسخهٔ اول آن را در نظر بگیرد.

## پیوستن به فهرست انتظار

در فرم بگویید چه می‌سازید و برای کدام سکوها: از روی پاسخ‌ها تصمیم می‌گیریم چه چیزی اول ساخته شود. وقتی نسخهٔ اول برای امتحان آماده شد، برایتان می‌نویسیم؛ مستندات هم‌زمان با SDK نوشته می‌شود. برای پرسش‌های دیگر، [به ما بنویسید](https://pingle.one/fa/contact).

## دسترسی زودهنگام به SDK

SDK در حال توسعه است. راه ارتباطی بگذارید تا به محض باز شدن دسترسی، آن را برایتان بفرستیم و به پرسش‌های یکپارچه‌سازی پاسخ دهیم.

[درخواست دسترسی زودهنگام](https://pingle.one/fa/sdk#lead)

## زبان

- [Русский](https://pingle.one/ru/sdk.md)
- [English](https://pingle.one/sdk.md)
- [العربية](https://pingle.one/ar/sdk.md)
- [中文](https://pingle.one/zh/sdk.md)