---
title: "Pingle SDK — Pingle"
description: "把 Pingle 的隧道集成进你自己产品的工具。仍在开发中，尚未发布；欢迎加入候补名单。"
lang: "zh"
dir: "ltr"
canonical_url: "https://pingle.one/zh/docs/sdk"
markdown_url: "https://pingle.one/zh/docs/sdk.md"
alternates:
  ru: "https://pingle.one/ru/docs/sdk.md"
  en: "https://pingle.one/docs/sdk.md"
  ar: "https://pingle.one/ar/docs/sdk.md"
  fa: "https://pingle.one/fa/docs/sdk.md"
  zh: "https://pingle.one/zh/docs/sdk.md"
---

# Pingle SDK

把 Pingle 的隧道集成进你自己产品的工具。仍在开发中，尚未发布；欢迎加入候补名单。

> [!WARNING]
> **开发中。**SDK 尚未发布。它的接口没有公开，并且在首个版本发布前可能发生变化。想在有东西可以试用时得到通知， 请在 [SDK 页面](https://pingle.one/zh/sdk#waitlist)加入候补名单。

## 这是什么

Pingle SDK 是一套把 VPN 集成进你自己产品的工具：应用、路由器固件或设备。你不必从零编写隧道、路由和平台集成，而是直接使用组成 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 |

首个版本覆盖其中哪些平台，目前尚未确定。

## 状态

目前还没有公开、有文档、带版本号的 SDK，所以今天还无法基于它构建产品。没有发布日期，我们也不会给出无法兑现的日期。

## 候补名单

请在 [SDK 页面](https://pingle.one/zh/sdk#waitlist)的表单中留下联系方式，并告诉我们你在构建什么、面向哪些平台：这决定了我们先做什么。这份文档正在与 SDK 同步编写，[API 参考](https://pingle.one/zh/docs/api)会随之充实。

## 语言

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