动态与公告

产品动态

公告

新手指引

产品简介

产品概述

产品优势

应用场景

基本概念

使用限制

CDN性能说明（抽样）

购买指南

CDN 购买指南

ECDN 购买指南

快速入门

从零开始配置 CDN

接入域名

配置 CNAME

域名归属权验证

域名接入常见问题

配置指南

域名管理

域名配置

统计分析

刷新预热

日志服务

安全加速

服务查询

离线缓存

权限管理

权限配置

控制台权限说明

子账号或协作者开通实时日志的方法

场景教学

CDN 加速 COS 资源

实践教程

CDN 迁移至 EdgeOne 工具使用指南

CDN - CVM

CDN - COS

DNSPod 一键配置 CNAME

CDN日志定时存储

API 文档

History

Introduction

API Category

Content Management APIs

Real-time Log APIs

Service Query APIs

Data Query APIs

Making API Requests

Log Query APIs

StopCdnDomain

Configuration Management APIs

Obsoleted APIs

Other APIs

Data Types

Error Codes

常见问题

功能特性问题

计费相关问题

域名接入问题

缓存配置问题

刷新预热问题

统计分析问题

HTTPS 相关问题

访问相关问题

故障相关问题

故障处理

状态码说明及处理建议

不同节点缓存内容不一致

接入 CDN 后，网页访问速度慢

流量命中率偏低

CDN 域名突然出现404状态

页面展示异常-访问跨域报错

资源缓存未生效

CDN Service Level Agreement

词汇表

UA 黑白名单配置

PDF

Focus Mode

Font Size

Last updated: 2025-01-13 10:21:58

配置场景
腾讯云 CDN 支持通过配置 User-Agent 黑白名单规则实现访问控制。
通过对用户 HTTP 请求头中的 User-Agent 进行规则判断，按需放行或拒绝用户访问。
配置指南
配置约束
仅支持全部设置为黑名单或全部设置为白名单，不支持同时设置黑、白名单规则。
最多可配置 10 条黑或白名单规则。
规则内容支持通配符*，多个值情况下使用 |分隔。
生效类型支持全部文件、文件类型、文件目录、指定文件路径四种模式，暂不支持正则匹配。
配置说明
登录 CDN 控制台，在菜单栏里选择【域名管理】，单击域名右侧【管理】，即可进入域名配置页面，第二栏【访问控制】中可看到 UA 黑白名单配置，默认情况下为关闭状态：
﻿

关闭状态下，单击【新增规则】，可按需逐条添加黑(白)名单：
﻿
﻿
注意：
1. 支持通配符*和多个值，如 curl*|*IE*|*Chrome*|*firefox*。
^$ 表示为空的User-Agent，如果规则内容中包含了为空的User-Agent，按照如下方式处理：
白名单场景下，如果请求中的 User-Agent 为空，则允许该请求。
黑名单场景下，如果请求中的 User-Agent 为空，则拒绝该请求。
2. 无*情况下，其他字符均为完全匹配。
规则添加完成后，此时整体配置为关闭状态，因此不会影响现网服务：
﻿

可通过单击【开启】按钮，将所配置的黑(白)名单发布至现网：
﻿
﻿
配置示例
若加速域名cloud.tencent.com的 UA 黑白名单配置如下：
﻿

当 HTTP Request Header 中 User-Agent 如下时：
user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.61 Safari/537.36
命中黑名单，将直接返回403。