腾讯云全球应用加速GAAP完全对接指南：从开通到生产级部署

apphuang2026年07月02日 21:10:382

1. 全球应用加速GAAP是什么

全球应用加速（Global Application Acceleration Platform，GAAP）是腾讯云推出的一款PaaS类网络加速产品。它的核心价值在于：当你的业务服务器部署在一个地域，而用户分散在全球各地时，由于跨地域公网链路复杂、路由跳数多、网络拥塞等因素，用户访问体验往往会出现延迟高、卡顿、丢包严重等问题。GAAP通过在遍布全球的50多个加速节点与源站区域之间建立高速对等连接通道，利用腾讯云全球高速内网和智能路由技术，让各地用户就近接入加速节点，然后通过高速通道直达源站，从而避开不稳定的公共互联网。

从技术架构上看，GAAP的核心组件包括：加速区域（用户所在区域，即加速通道的入口节点）、源站区域（业务服务器所在区域，即加速通道的回源节点）、加速通道（连接加速区域与源站区域的高速网络通道）、监听器（定义协议、端口、转发策略和健康检查规则）以及源站（实际的业务服务器，支持IP或域名方式添加）。GAAP单通道最高可支持10G带宽和100万并发连接，大区域内互联时延可控制在60ms以下。

需要先登录腾讯云控制台，点击：腾讯云控制台，还没有账号，点击：注册后再关联，已有账号点击：登录后再关联

2. 开通服务与权限准备

2.1 开通GAAP服务

使用GAAP服务前，首先需要完成服务开通。当前GAAP控制台仅支持腾讯云企业认证账号使用。登录腾讯云控制台后，在产品列表中找到“全球应用加速GAAP”，进入服务页面，初次使用时需阅读并勾选相关服务条款，然后单击“开通服务”即可开始使用。

2.2 权限配置

如果希望子账号或协作者账号也能操作GAAP，需要进行权限授权。主账号或拥有AdministratorAccess权限的账号登录腾讯云控制台后，进入“访问管理”控制台。在左侧菜单中单击“策略”，进入策略管理页面，在搜索栏中输入“GAAP”进行检索。找到GAAP相关的策略权限后，单击“关联用户/组”，勾选需要授权的子账号，确认后即完成授权。

3. 添加源站

源站是GAAP加速的最终目标服务器，也就是你的业务实际运行的地方。添加源站是使用GAAP的第一步。

3.1 控制台添加源站

在GAAP控制台的“源站管理”页面，单击“新增源站”。在弹出的窗口中，需要填写源站名称和源站信息。源站支持通过IP地址或域名两种方式添加。如果源站是云服务器，直接填写其公网IP或内网IP均可；如果源站是自建机房或第三方云平台的服务，则填写其公网IP或域名。可以一次性添加多个源站，方便后续在监听器中灵活配置。

3.2 API方式添加源站

GAAP提供了完整的API接口，方便通过代码自动化管理。添加源站对应的接口是AddRealServers，接口请求域名为gaap.tencentcloudapi.com，默认接口请求频率限制为20次/秒。该接口的核心参数包括ProjectId（源站对应的项目ID）、RealServerIP.N（源站的IP或域名列表）和RealServerName（源站名称）。调用成功后，返回结果中会包含源站ID（RealServerId），这个ID在后续绑定监听器时会用到。

4. 创建加速通道

加速通道是连接加速区域与源站区域的“高速公路”。创建通道时，需要选择加速区域（用户所在区域）和源站区域（服务器所在区域）。通道类型分为跨境通道和非跨境通道两种。如果加速区域和源站区域属于不同国家或地区（例如加速区域选美国、源站区域选中国），则需要创建跨境通道。使用跨境通道需通过联通跨境资质审核，目前GAAP国际站已支持在控制台在线提交跨境资料，由联通后端线上完成审核。如果加速区域和源站区域在同一国家或地区内，则创建非跨境通道即可。

创建通道时还需要设置通道的规格，主要包括带宽上限和并发连接数上限。通道规格直接影响加速性能，也决定了通道费用。通道费用按天独立结算，不同规格对应不同单价。例如，并发20K、带宽10M的通道日费用为80.64元/天；并发1000K、带宽10000M的通道日费用为2016元/天。建议根据业务实际需求选择合适的规格，避免资源浪费。通道创建时GAAP会冻结等同于通道规格单日费用的账户余额，如余额不足将导致通道创建失败。

5. 配置监听器

监听器是GAAP中定义“如何加速”的核心组件。它决定了加速通道使用什么协议、监听哪个端口、如何将请求转发到源站、以及如何进行健康检查。GAAP支持四层协议（TCP、UDP）和七层协议（HTTP、HTTPS）。

5.1 TCP监听器配置

TCP监听器适用于需要可靠传输的业务场景，如数据库连接、游戏长连接、远程桌面等。创建TCP监听器需要指定监听端口、源站访问策略（调度算法）以及是否开启健康检查。

源站访问策略（Scheduler）支持四种模式：rr（轮询，将请求依次分发到各源站）；wrr（加权轮询，按权重比例分发）；lc（最小连接数，分发到当前连接数最少的源站）；lrtt（最小时延，分发到网络延迟最低的源站，该模式需要开通白名单）。如果源站类型为域名（DOMAIN），则不支持wrr和lrtt模式。

健康检查是保障服务高可用的关键机制。开启健康检查后，GAAP会定期向源站发送探测请求，判断源站是否存活。TCP监听器的健康检查参数包括：DelayLoop（健康检查时间间隔，取值范围5-300秒）；ConnectTimeout（响应超时时间，取值范围2-60秒，且必须小于DelayLoop）；HealthyThreshold（健康阈值，连续成功多少次后认定源站健康，范围1-10）；UnhealthyThreshold（不健康阈值，连续失败多少次后认定源站不健康，范围1-10）。当健康检查判断源站异常时，该源站将不再接收流量转发，直至其恢复健康。

TCP监听器还支持开启主备模式（FailoverSwitch），开启后主源站正常时所有流量发往主源站，主源站异常时自动切换到备源站。但域名类型源站不支持开启主备模式。

5.2 UDP监听器配置

UDP监听器适用于对实时性要求高、允许少量丢包的业务场景，如音视频直播、VoIP通话、在线游戏对战等。UDP监听器的配置与TCP类似，但需要注意的是UDP监听器不支持健康检查。

5.3 HTTP/HTTPS监听器配置

七层监听器适用于Web应用加速场景。HTTP/HTTPS监听器支持基于URL规则的转发，可以根据域名和路径将不同请求分发到不同的源站。HTTPS监听器还支持配置SSL证书，实现加密传输。七层监听器的一个重要特性是支持配置默认域名——当客户端请求未匹配任何已配置的域名规则时，GAAP会将请求转发给默认域名，从而避免返回403错误。

6. 获取客户端真实IP（TOA）

在使用GAAP加速后，源站收到的请求来自GAAP的加速节点，而非真实的客户端IP。如果业务需要获取客户端的真实IP地址（例如用于日志分析、地域识别、安全审计等），需要在TCP监听器中开启TOA（TCP Option Address）功能。开启TOA后，GAAP会在TCP报文的选项字段中携带客户端的真实IP信息，源站服务器需要加载TOA内核模块来解析该信息。控制台操作路径为：GAAP控制台 > 加速通道 > 新增TCP监听器管理 > 勾选TOA。对于七层HTTP/HTTPS监听器，GAAP支持通过自定义Header（如X-Forwarded-For）携带客户端真实IP。

7. 绑定源站与测试验证

监听器创建完成后，最后一步是将监听器与源站绑定。在监听器管理页面，选择已创建的监听器，单击“绑定源站”，从源站列表中选择需要绑定的源站即可。绑定完成后，整个加速通道就搭建好了。此时，客户端可以通过GAAP提供的加速域名或加速IP来访问业务。如果使用域名接入，需要在DNS服务商处将业务域名解析到GAAP分配的CNAME地址。

建议在正式上线前进行充分的测试验证。可以通过ping、traceroute等工具测试网络延迟变化，也可以通过业务层面的功能测试确认加速后服务是否正常。GAAP控制台提供了多维度的数据统计功能，包括通道出入带宽、出入包量、时延、丢包率、并发连接数等。这些数据可以帮助评估加速效果并及时发现异常。

8. Python SDK编程接入

除了控制台操作，GAAP提供了完整的API和SDK，支持通过编程方式实现自动化管理。下面以Python SDK为例，演示如何通过代码创建GAAP加速通道。

8.1 安装SDK

腾讯云官方提供了Python版本的GAAP SDK，可以通过pip安装：

pip install tencentcloud-sdk-python-common
pip install tencentcloud-sdk-python-gaap

8.2 初始化客户端

使用SDK前需要准备好腾讯云的SecretId和SecretKey，可以在控制台的“访问管理 > API密钥管理”中获取。初始化代码如下：

from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.gaap.v20180529 import gaap_client, models

# 实例化认证对象
cred = credential.Credential("你的SecretId", "你的SecretKey")

# 实例化http和client配置
httpProfile = HttpProfile()
httpProfile.endpoint = "gaap.tencentcloudapi.com"

clientProfile = ClientProfile()
clientProfile.httpProfile = httpProfile

# 实例化客户端
client = gaap_client.GaapClient(cred, "", clientProfile)

8.3 添加源站

def add_real_servers(client):
    req = models.AddRealServersRequest()
    params = {
        "ProjectId": 0,
        "RealServerIP": ["1.2.3.4"],
        "RealServerName": "my-test-server"
    }
    req.from_json_string(json.dumps(params))
    resp = client.AddRealServers(req)
    return resp.RealServerSet[0].RealServerId

该接口返回的RealServerId需要保存下来，后续绑定监听器时会用到。

8.4 创建加速通道

def create_proxy(client):
    req = models.CreateProxyRequest()
    params = {
        "ProjectId": 0,
        "ProxyName": "my-gaap-proxy",
        "AccessRegion": "ap-guangzhou",      # 加速区域
        "RealServerRegion": "ap-singapore",   # 源站区域
        "Bandwidth": 10,                       # 带宽上限(Mbps)
        "Concurrent": 2                        # 并发连接数(万)
    }
    req.from_json_string(json.dumps(params))
    resp = client.CreateProxy(req)
    return resp.ProxyId

创建通道时需要指定加速区域（AccessRegion）和源站区域（RealServerRegion），这两个区域的选择直接影响加速效果和费用。

8.5 创建TCP监听器

def create_tcp_listener(client, proxy_id):
    req = models.CreateTCPListenersRequest()
    params = {
        "ListenerName": "my-tcp-listener",
        "Ports": [8080],
        "Scheduler": "rr",
        "HealthCheck": 1,
        "RealServerType": "IP",
        "ProxyId": proxy_id,
        "DelayLoop": 30,
        "ConnectTimeout": 20,
        "HealthyThreshold": 3,
        "UnhealthyThreshold": 3
    }
    req.from_json_string(json.dumps(params))
    resp = client.CreateTCPListeners(req)
    return resp.ListenerIds[0]

创建TCP监听器时，HealthCheck设为1表示开启健康检查。Scheduler参数支持rr、wrr、lc、lrtt四种策略。

8.6 绑定监听器与源站

def bind_listener_real_servers(client, listener_id, real_server_id):
    req = models.BindListenerRealServersRequest()
    params = {
        "ListenerId": listener_id,
        "RealServerIds": [real_server_id]
    }
    req.from_json_string(json.dumps(params))
    resp = client.BindListenerRealServers(req)
    return resp

通过BindListenerRealServers接口将监听器与之前创建的源站绑定，完成整个加速通道的搭建。

9. 监控告警配置

生产环境中，对加速通道进行持续监控和告警是保障服务稳定性的重要手段。GAAP支持接入腾讯云监控服务，提供多维度的监控指标和告警配置。可配置的告警项包括：通道出入带宽告警、并发连接数告警、源站状态异常告警等。当监控指标超过设定的阈值时，系统会通过短信、邮件或微信等方式通知运维人员。

GAAP控制台还提供了详细的数据统计面板，支持查看通道级别和监听器级别的带宽、并发、丢包、延迟、包转发等统计数据。建议在业务上线初期密切关注这些指标，根据实际流量情况调整通道规格。

10. 计费与成本优化

GAAP的计费由基础计费项和增值服务计费项组成。基础计费项主要包括通道费用和带宽费用，均采用日结后付费模式。通道费用与通道规格（并发数/带宽）相关，按天结算。前一天产生的通道费用会在第二天18:00前完成扣费。带宽费用按日峰值计费：以1分钟为粒度取当天通道出、入带宽中的最大值，以通道规格的带宽值为封顶。增值服务计费项主要包括跨境流量费用，仅在使用跨境通道时产生。

成本优化方面，建议采取以下策略：首先，根据业务实际峰值流量选择合适的通道规格，避免过度配置造成浪费；其次，对于非跨境场景，优先选择同区域或邻近区域的加速节点以降低延迟和费用；第三，关注GAAP控制台的带宽和流量统计，及时发现异常流量增长（如遭受攻击或盗刷），避免产生意外的高额费用。

11. 常见故障排查

在使用GAAP过程中，如果遇到加速不生效的问题，可以按照以下顺序排查：第一步，确认控制台已正确绑定源站和设备License；第二步，检查SDK初始化是否成功，确认AccCallback.onAccStart()回调是否触发，如果未触发说明初始化失败，需要检查appId和sign是否正确。此外，还需要检查源站是否正常运行、监听器的协议和端口配置是否正确、安全组或防火墙是否放行了GAAP的回源IP等。

如果加速效果不理想，建议通过控制台的监控数据查看延迟和丢包率，判断是哪个环节出现了瓶颈。可以尝试调整监听器的调度策略（如从轮询改为最小时延模式），或者升级通道规格以获得更高的带宽和并发能力。

12. 总结

腾讯云全球应用加速GAAP通过全球部署的加速节点和高速内网通道，有效解决了跨地域访问的延迟和卡顿问题。从开通服务、添加源站、创建通道和监听器，到绑定源站和配置健康检查，整个接入流程清晰明了。控制台操作适合快速上手和日常运维，而API/SDK方式则适合需要自动化管理和大规模部署的场景。通过合理的规格选型、健康检查调优和监控告警配置，可以将GAAP稳定地部署到生产环境中，为全球用户提供流畅的访问体验。

常见问题解答

问1：GAAP和CDN有什么区别？
答：CDN主要用于静态内容的分发加速，通过将内容缓存到边缘节点来提升访问速度。而GAAP是动态加速产品，针对的是动态请求和实时交互场景，通过建立高速通道优化网络传输路径，适用于游戏、直播、API调用等需要低延迟的业务。

问2：GAAP支持哪些协议？
答：GAAP全面支持TCP、UDP、HTTP、HTTPS四种协议。TCP和UDP属于四层协议加速，HTTP和HTTPS属于七层协议加速，七层监听器还支持基于URL规则的转发。

问3：使用GAAP后源站如何获取用户的真实IP？
答：对于TCP监听器，可以在创建监听器时开启TOA功能，源站服务器加载TOA内核模块即可解析真实IP。对于HTTP/HTTPS监听器，GAAP会通过X-Forwarded-For等自定义Header携带真实IP。

问4：GAAP通道创建后可以修改规格吗？
答：可以。GAAP支持业务无感知的在线升降配，无需停服即可调整通道的带宽和并发规格。

问5：GAAP的跨境通道有什么特殊要求？
答：跨境通道需通过联通跨境资质审核。目前GAAP国际站已支持在控制台在线提交跨境资料，由联通后端线上完成审核，审核通过后方可创建跨境通道进行跨境数据通信。

问6：GAAP欠费后会怎样？
答：账户欠费后有2小时缓冲时间。若2小时后账户仍未冲正，GAAP服务将被停止，实例进入隔离状态但配置保留24小时。如果24小时后账户仍未充正，实例将被释放，相关配置数据将被永久删除且不可恢复。