本地代理网关概述

Yeastar 本地代理网关 (Onsite Proxy) 是一款命令行代理软件，旨在为 Yeastar P 系列软件版 和远程 IP 话机之间建立便捷、安全的连接，解决常见的防火墙与网络问题。

场景

当总部与分支机构处于不同网络，且分支机构部署了多台 IP 话机时，可将本地代理网关部署在与 IP 话机相同的子网中，并将其连接到 PBX。

连接成功后，即可通过此代理网关配置 IP 话机。本地代理网关将转发话机与 PBX 之间的配置链接、SIP 信令、RTP 数据包等，使二者如同在同一子网中工作。

该方案无需在 PBX 侧为话机所在网络配置冗余的端口映射或防火墙规则，同时降低了传统远程访问方案带来的数据转发延迟与丢包风险。

使用要求

PBX 服务器
项目 要求
PBX 固件 83.22.0.134 或更高版本。
公网访问配置 确保 PBX 可通过公网 IP 地址、域名、或星纵数字域名访问，并将以下端口正确转发至 PBX：
  • 公网 Web 服务端口
  • 公网隧道端口
协议 确保已在 PBX 上启用 HTTPS 协议 (路径：系统 > 网络 > Web 服务器 > 传输协议 > 传输协议)。
本地代理网关运行主机
项目 要求
网络 主机必须与远程 IP 话机处于同一子网，且该子网与 PBX 服务器网络互通。
操作系统 主机已安装符合要求的操作系统。
硬件 主机满足最低硬件配置要求。
端口映射 主机的 UDP 5060 端口可用。
IP 地址 主机已配置静态 IP 地址。

亮点功能

IP 话机自动发现
本地代理网关可通过 PnP (即插即用) 功能，自动发现同一子网内可用的 IP 话机，并将话机信息 (包括 MAC 地址、IP 地址、供应商及型号) 上报至 PBX。
零接触自动配置

为本地代理网关通过 PnP 自动发现的 IP 话机分配分机时，代理会将 PBX 下发的配置链接转发至对应话机，触发话机自动下载配置文件并完成分机注册，实现零接触部署。

SIP 信令代理

本地代理网关将话机的 SIP 注册请求转发至 PBX 并维持注册稳定。注册完成后，本地代理网关通过其运行主机的 UDP 5060 端口，中转话机与 PBX 之间所有 SIP 信令 (如 REGISTER, INVITE, BYE)。

语音 RTP 透传
本地代理网关支持语音 RTP 透传功能。启用后，若多台 IP 话机通过同一本地代理网关注册，话机之间的 RTP 音频流将直接点对点传输，不经过 PBX 与代理网关，可降低延迟、节省带宽，并显著提升通话质量。

操作目标

本文档的操作目标及实现这些目标的参考文章如下：

将本地代理网关连接至 Yeastar P 系列软件版
  1. 在 PBX 上添加本地代理网关实例，获取用于配置本地代理网关的连接信息。更多信息，请参见 在 Yeastar PBX 上添加本地代理网关实例。
  2. 在远程 IP 话机所在的子网中安装并配置本地代理网关，使用上一步获取的连接信息将其连接到 PBX。更多信息，请参见 安装本地代理网关。
自动配置远程 IP 话机
本地代理网关与 PBX 建立连接后，可使用 PnP 或 DHCP 配置方式，通过该代理网关配置远程 IP 话机，使话机和 PBX 如同在同一子网中工作。