进阶 docs.pangolin.net 2026-11-21 15:06:37 · 1 阅读

第5章 Pangolin 工作原理

第5章:Pangolin 工作原理

了解 Pangolin 的核心机制及其协同运作方式。本页介绍 Pangolin 的关键概念:服务器、站点、资源、用户和客户端。建议首先阅读本页。若希望深入了解软件组件及其交互机制,请参阅本页之后的《系统架构》。

基本步骤

使用站点使远程网络可用。通过站点连接器访问远程网络。Pangolin 的轻量级连接器利用智能路由和 NAT 穿透,使任意位置的网络均可接入。站点创建完成后,即可从任何地方访问该网络上的资源。

定义资源。为你的站点网络中用户需要访问的对象创建资源。每种资源遵循特定协议:浏览器中的 HTTPS、通过客户端访问的 IP 或网络段、SSH、远程桌面、LLM 访问等。资源可以是公开的,也可以是完全私有的。

用户访问资源。经过身份验证的用户通过资源自身的协议访问资源。通常,公开资源通过 Web 浏览器访问,而私有资源通过 Pangolin 客户端访问。相同的用户、角色和策略适用于两者。用户无需关心连接哪个站点,只需访问资源,Pangolin 会自动路由到正确的连接器。

核心概念

Pangolin 依赖多个协同工作的组件来提供安全网络。每个组件在确保仅经过身份验证的用户能够访问其被授权使用的资源方面扮演着特定角色。

Pangolin 服务器

Pangolin 服务器是您网络的核心协调组件。它存储配置变更,管理访问策略,并协调客户端与站点之间的连接。服务器负责处理用户身份验证、生成决定各用户可访问资源的访问控制列表、托管 UI 和 API 等。它是您 Pangolin 网络的大脑。

您可以使用完全托管的 Pangolin Cloud,也可以自托管 Pangolin 服务器,以完全掌控基础设施和数据。参见《Pangolin Cloud 与自托管对比》。

在 Pangolin Cloud 上免费试用。这是体验全托管控制平面最快的方式。免费注册

阅读关于自托管 Pangolin 的指南。了解如何部署您自己的自托管 Pangolin 服务器。

站点

站点将远程网络连接至您的 Pangolin 服务器。它们使用 Pangolin 站点连接器(有时也被称为其工程代号“Newt”)从远程网络建立回连到 Pangolin 的安全隧道。站点允许您将这些网络上的资源暴露给授权用户。

站点预期完全由管理员管理,通常属于“设置一次,长期免维护”。用户无需了解站点,只需访问站点上可用的资源。

在 Pangolin 仪表盘中管理站点,显示每个站点的状态、正常运行时间和资源计数。

站点运行在远程网络的防火墙之后。它们维持与 Pangolin 服务器的出站连接。默认情况下,站点会阻止所有流量,直到您定义资源并授予访问权限。这确保仅部署站点本身不会暴露任何网络资源。

创建站点:选择平台,复制安装命令,并在远程网络上运行连接器。

当使用私有资源(类似 VPN 的访问)时,客户端使用点对点(P2P)NAT 穿透直接连接到站点连接器。如果客户端与站点连接器位于同一网络,则使用本地网络地址。

站点连接器非常智能,处理隧道创建、NAT 穿透和路由。它无需复杂的防火墙规则或公共 IP 地址即可使远程网络可用。它还解锁了基于浏览器的 SSH、RDP 和 VNC 资源、带有边缘 TLS 终止的私有 HTTP、当同一资源可从多个位置访问时的智能多站点路由等更多功能。

阅读更多关于站点的内容。了解站点、其工作原理以及如何安装和配置。

资源

Pangolin 基于资源构建。资源是访问的最小单元:您定义它,授予用户和角色访问权限,Pangolin 仅路由被授权的流量。用户连接到资源,而非站点。

资源根据您暴露的内容遵循不同的协议(例如,但不限于):

浏览器中可用的 HTTPS 应用 通过 Pangolin 客户端访问的 IP 地址 通过 Pangolin 客户端可达的网络段 用于 LLM 访问的 AI Gateway 资源 远程桌面 SSH

访问模型保持不变,仅协议不同。

公开资源是面向公众的、指向您 Pangolin 服务器的代理。通常,这些资源以公共 FQDN 的形式暴露,如 Web 浏览器中可用的网站或 API。

仪表盘中的公开资源:带健康状态、正常运行时间和访问 URL 的 HTTPS、SSH、RDP 和 VNC。

私有资源需要 Pangolin 客户端连接,并保持在公共互联网之外。它们用于对远程网络上资源的 VPN 式、完全私有的访问。

仪表盘中的私有资源:带目标和别名的主机、HTTP、SSH 和 CIDR 范围。

在用户能够访问资源之前,必须定义资源并分配访问权限。默认情况下,站点上没有可用资源。这确保只能访问明确定义的资源。

资源启动器

资源启动器是您的用户(非管理员)看到的仪表盘。它在一个地方列出他们有权访问的所有资源,按站点或标签分组,并支持搜索和筛选。用户可以从该中心打开 Web 应用、复制主机名,或启动私有资源。

按站点分组的资源启动器,显示用户可以打开的资源。

选择资源总会展开一个面板,显示该类型相关的重要细节:URL 或别名、连接方式以及额外的设置需求。下图是一个 AI Gateway 示例。所有资源都使用相同的面板。

资源启动器详情面板。此示例显示一个私有 SSH 资源。

资源启动器。查找、启动并保存您可访问资源的视图。

阅读更多关于资源的内容。了解公开和私有资源以及如何创建它们。

用户和角色

身份信息与站点和资源位于同一个控制平面。您在一个地方管理团队:Pangolin 用户、身份提供商以及授予访问权限的角色。

使用 Pangolin 内置的用户,或接入 Google Workspace、Microsoft Entra ID、Okta 或任何 OIDC 提供商。用户只需进行一次身份验证。该身份适用于仪表盘、浏览器资源、Pangolin 客户端、AI Gateway 及其他所有组件。

角色用于分组人员以实现 RBAC。您在每个资源上分配角色,使访问权限遵循团队结构,而非每种协议单独的列表。用户的有效访问权限是其角色所能触及范围的并集。相同的用户和角色适用于公开资源、私有资源和 AI Gateway 资源。

仪表盘中的用户,与身份提供商和角色一起管理。

用户和角色。添加内部或外部用户,并分配角色以获取资源访问权限。

添加身份提供商。让用户使用 Google、Microsoft Entra ID、Okta 或任何 OIDC 提供商登录。

客户端

客户端是安装在用户设备或机器上的软件组件。它们允许用户和自动化系统通过安全隧道直接连接到站点以访问私有资源。客户端还在边缘强制执行访问控制和安全性。

用户通过客户端使用其用户凭据在 Web 登录流程中进行身份验证。机器使用机器客户端凭据连接。一旦连接,用户可以访问其账户有权访问的所有资源。客户端处理路由决策,并建立到相应站点的加密隧道。

仪表盘中的用户设备,显示身份提供商、连接状态和客户端版本。

客户端适用于所有主要平台。它们与应用透明协作,因此无需配置应用程序。

下载 Pangolin 客户端。获取适用于 Mac、Windows、Linux、iOS 和 Android 的客户端。

阅读更多关于客户端的内容。了解用户和机器客户端如何连接私有资源。

AI Gateway

AI Gateway 是一种用于 LLM 访问的特殊资源类型。它是协议感知的,类似于 HTTPS 资源理解 HTTP 的方式。

创建一个类型设置为 AI Gateway 的公开资源。

Pangolin 已经会检查 HTTPS 流量以应用身份、访问规则、请求日志和分析。AI Gateway 资源对模型 API 执行等效操作。由于网关理解 LLM 协议,它可以为每次调用归属用户,记录成本和令牌使用情况,保留聊天会话历史,并执行关于谁可以使用哪些模型和预算的限制。

访问基于身份。您像对待 HTTPS 或 SSH 一样,在资源上授予用户和角色访问权限。然后由 Pangolin 决定该身份可以调用哪些模型,以及预算是否仍允许该请求。

AI Gateway 会话日志,显示提供商、模型、资源和发起调用的用户。

私有 AI Gateway 像其他任何私有资源一样使用 Pangolin 客户端。运行在最终用户设备上的客户端已为该用户完成身份验证。该设备上的编码代理通过隧道调用资源,Pangolin 将请求归属于已连接的身份。这消除了笔记本电脑上的提供商 API 密钥需求:上游密钥保留在提供商处。

阅读更多关于 AI Gateway 的内容。为编码代理和 AI 客户端设置提供商、资源和基于身份的访问。

远程节点

远程节点是自托管的 Pangolin 服务器,由您控制,同时使用 Pangolin Cloud 进行管理协调。您保持对基础设施和数据流的完全控制,而云处理控制平面、DNS、证书管理和备份。

您可以部署多个远程节点以实现高可用性和自动故障转移。如果您的节点不可用,流量可以选择性地故障转移到云基础设施,直到您恢复服务。

阅读更多关于远程节点的内容。了解远程节点及其如何提供高可用性和简化运维。

系统架构

若希望深入了解软件组件及其交互机制,请参阅《系统架构》。

此页是否有用?

评论 (0)