快速接入 CDN、配置防护规则、排查常见问题。
接入前需要准备事项。
4 步完成域名接入与 HTTPS 配置。
游戏盾客户端SDK完整接入文档。
50x、40x、白屏、HTTPS报错、回调拦截等排查指引。
接入过程中有任何疑问，随时通过 Telegram @VOECDN 服务支持。
GrayShield SDK 支持全平台客户端，为 APP、游戏提供流量防护，防止 DDoS 攻击。
完整接入步骤：依次阅读下载 SDK → 各系统接入 → 错误排查 → 真实 IP 获取 → 接入后处理。
内容待填充。
内容待填充。
内容待填充。
内容待填充。
内容待填充。
domain.com、a.domain.com）和泛域名（*.domain.com）。👉 接入前可用域名查询工具检查健康状况，并参考 《域名保护小技巧》。
你网站的真实服务器地址，需在国内可正常访问。被墙的 IP 接入后同样无法访问。
三项就绪后，即可前往 开始接入。
整个流程共 4 步，最快 5 分钟 完成。开始前请确认已满足准备条件。
全程在 控制面板 内操作，请先登录。
进入 网站管理 → 我的网站 → 新增，填写域名和源站 IP。多个域名用空格隔开，可一次性批量添加。
网站添加成功后，系统会生成一个 CNAME 值。
到你的域名 DNS 服务商添加一条 CNAME 记录，指向该值。
回控制台核对，解析状态显示绿色即配置成功。
解析生效时间取决于域名服务商 DNS 解析速度，快则几秒、慢则几小时，请耐心等待。
根据你是否已有证书，二选一：
情况 A：没有证书（推荐）
在控制台 一键申请 免费证书，平台自动续期、无需手动维护。
⚠️ 申请前需确保所有域名解析都已生效，否则无法签发。
绝大多数是域名解析未正确配置导致。可在 网站管理 → 证书管理 查看状态；确认解析无误后，编辑证书切换签发机构再点「重签」。
情况 B：已有证书
前往 网站管理 → 证书管理，上传并选用你的证书。
最后：打开 HTTPS 开关
域名已成功接入 CDN！
以上为快速接入配置，缓存、防御等均使用平台预设，即开即用。如有特殊需求，可在控制台按需调整。
网站接入后，防护默认为关闭。一旦遇到突发强力 CC 攻击，源站可能因扛不住海量请求而宕机。建议接入完成后开启自动切换策略，让平台在攻击来临时自动启用人机验证。
推荐配置如下：
CC 规则不固定，可按网站实际需求自行调整。更多说明见 《自定义 CC 规则》。
50x 基本都是回源异常。按下面顺序逐一排查，绝大多数能快速定位。
先在未接入 CDN 的情况下直接访问源站。如果源服务本身就打不开，接入 CDN 当然也访问不了。
概率较小，等几分钟再试。
如果采用了宝塔或其他控制面板并开了防御，会挡住 CDN 回源。套 CDN 后，宝塔的基础防御可以关闭，防御机制交给 CDN；如需保留宝塔上的防御，则要给 CDN 节点加入白名单。
详见 《宝塔部署接入须知》。
前往 网站管理 → 监控统计 → 黑名单 IP，查看是否有本机 IP 在内。若在，则是误封，先解除该 IP。建议切换为 默认-宽松，提升-50-旋转图片。
部分 IDC 服务商的低质量服务器 IP 容易进运营商黑名单，被拉黑后会不定时无法连通，需等待恢复。
同样适用于其他类宝塔的面板控制工具。接入前请逐项检查。
宝塔站点支持通配符绑定，确保绑定的域名包含了在 CDN 平台添加的域名。
若宝塔未配置强制 HTTPS 回源，此步可跳过。若宝塔配置了 SSL 且强制 HTTPS 访问，则 CDN 需走 HTTPS 443 回源，否则会报 50x；443 回源需在 CDN 平台配置证书。
关闭宝塔的「强制 SSL 访问」，让 CDN 走 80 端口回源。80 回源比 443 更快、配置项更少。
为了防止宝塔防火墙拉黑 CDN 节点，需要关闭宝塔的防火墙。
某些服务会改动 Nginx 配置文件。若套 CDN 后无法访问，也需排查此处。
接入 CDN 后速度一般不会变慢。如果慢或一直加载中，多半是引入第三方资源出了问题。
最常见的原因是加载第三方资源等待过久，导致页面渲染卡住。
案例中 cdn.staticfile.org 访问缓慢，可以替换静态资源源：
cdn.staticfile.orglib.baomitu.com已知 Staticfile、BootCDN 国内访问不稳定；重要项目建议把静态资源部署到自身服务器。
开启网站 HTTPS 后，混合 HTTP 资源导致样式、图片失效。两种解决方案：
Content-Security-Policy: upgrade-insecure-requests
回调是第三方服务合法请求你的服务器。CDN 默认防御规则可能拦截，需要手动放行。
匹配条件仅示例，请根据业务实际配置。
聊天、AI 流式输出等实时场景需要开启 WebSocket 支持。
清除前端 JS 缓存；部分框架需要额外配置超时、心跳参数。
CDN 访问源站时携带请求头：X-Real-IP、X-Forwarded-For。默认程序拿到的是 CDN 节点 IP。
set_real_ip_from 0.0.0.0/0; real_ip_header X-Forwarded-For;
$realIP = $_SERVER['HTTP_X_REAL_IP'];
面向开发者高级配置；普通用户直接使用平台内置预设策略即可抵御大部分 CC 攻击。
防 CC 规则由三部分：匹配器 → 过滤器 → 执行动作
国内备案域名出现风险概率较低，境外域名更容易遇到污染、劫持。
被 GFW 黑名单拦截后很难解封，优先自查站点内容合规。
解析被篡改，访问跳转到陌生站点；建议使用 DNSPod、阿里云 DNS。
部分地区移动、联通会拦截站点；苏州地区跳转反诈页面可以通过官方渠道申诉。
域名一旦因为污染加载非法内容导致被墙，基本无法恢复，建议重要域名做好备份轮换。
全站 HTTPS 站点推荐开启，在站点高级设置手动打开开关。
源站更新资源后 CDN 缓存不会自动更新，使用刷新清除旧缓存；预热将资源预先拉取到各节点，提升首访速度。
入口：网站管理 → 对应站点 → 刷新预热。
尽量避免全站刷新，会瞬间产生大量回源压力。
适合新版本安装包、活动大图等资源，上线前提前预热。
平台内置默认缓存策略；动态接口、特殊静态资源可以自定义缓存时长。
入口：网站编辑 → 缓存配置。
/static/登录页面、API 接口等动态内容禁止长时间缓存，否则会出现用户看到他人会话、数据过期问题。
规则从上往下依次匹配，匹配第一条即终止，调整顺序十分重要。
黑白名单、请求条件拦截，精细管控谁可以访问网站。
入口：我的网站 → 安全配置 → 添加过滤规则。
规则从上至下顺序执行，放行规则必须放在拦截规则上方。
多台源站分担压力，自动故障转移，避免单点宕机全站不可访问。
入口：网站编辑 → 源站设置。
多个源站文件内容建议保持一致，避免用户访问资源不一致。
查看带宽流量、请求量、缓存命中率、拦截黑名单、下载访问日志排查故障。
入口：网站管理 → 监控统计 / 访问日志。
适用于游戏、自定义 TCP/UDP 协议，非网站业务端口防护与中转。
该功能是否开放取决于你的套餐权限。
入口：四层转发 → 新增转发
443 端口没有配置 SSL 证书、域名未绑定、解析指向错误 IP。
*.xxx.com 不包含裸域名 xxx.com；