---
title: "Pingle SDK — Pingle"
description: "Pingle SDK 让你基于 Pingle 客户端背后的 Rust 内核，把 VPN 集成进自己的应用。"
lang: "zh"
dir: "ltr"
canonical_url: "https://pingle.one/zh/sdk"
markdown_url: "https://pingle.one/zh/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 让你基于 Pingle 客户端背后的 Rust 内核，把 VPN 集成进自己的应用。

## 这是什么

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/zh/for-business)。

## 状态

SDK 源自 Pingle 客户端的内核。公开、有文档、有版本号的 SDK 目前还没有；首个版本发布之前，接口可能会变化，我们也不会公布无法兑现的日期。

**今天还无法基于 SDK 构建产品**，但你可以把使用场景告诉我们，让首个版本考虑进去。

## 加入候补名单

请在表单中告诉我们你在构建什么、面向哪些平台：我们据此决定先做什么。首个版本可以试用时，我们会写信给你；文档正在与 SDK 同步编写。其他问题，请[联系我们](https://pingle.one/zh/contact)。

## 抢先体验 SDK

SDK 正在开发中。留下联系方式，开放后我们会第一时间发送访问权限，并解答集成问题。

[申请抢先体验](https://pingle.one/zh/sdk#lead)

## 语言

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