用于阻止请求的自定义VCL

您可以使用适用于Magento2的Fastly CDN模块创建一个包含要阻止的IP地址列表的Edge ACL。 然后,您可以将该列表与VCL代码段一起使用来阻止传入的请求。 该代码检查传入请求的IP地址。 如果与ACL列表中包含的IP地址匹配,Fastly将阻止请求访问您的站点并返回403 Forbidden error。 允许访问所有其他客户端IP地址。

先决条件:

  • 您的环境必须配置为使用Fastly CDN。 请参阅配置Fastly服务

  • 确保您运行的是Magento2的最新版Fastly CDN模块。 请参阅升级Fastly模块

  • 验证Fastly服务的环境配置。 请参阅检查Fastly缓存

  • 您必须拥有管理员凭据才能访问暂存环境和生产环境。

  • 要阻止的客户端IP地址列表

创建Edge ACL以阻止客户端IP地址

您可以创建一个Edge ACL来定义要阻止的IP地址列表。 创建ACL后,您可以在自定义VCL代码片段中使用它来管理对暂存或生产站点的访问。

通过在两个环境中创建同名的Edge ACL来管理暂存和生产站点的访问权限。 VCL代码片段代码适用于这两个环境。

  1. 登录到管理员。
  2. 导航到​ 商店 >设置> 配置 > 高级 > 系统 > 全页缓存 > 快速配置
  3. 展开​ Edge ACL ​部分。
  4. 单击​ 添加ACL ​以创建列表。 列入阻止列表在此示例中,将列表命名为“”。
  5. 在列表中输入IP地址值。 添加到此列表的任何客户端IP地址都将被阻止,并且无法访问该站点。
  6. 如果需要,可选中​ 否定 ​复选框。

在VCL代码片段中按名称引用Edge ACL。

列入阻止列表为创建自定义VCL

NOTE
此示例向高级用户展示如何创建VCL代码段来配置自定义阻止规则以上载到Fastly服务。 列入阻止列表 列入允许列表您可以使用Fastly CDN中针对Magento2模块提供的阻止功能,根据Adobe Commerce管理员的国家/地区配置或。

定义Edge ACL后,可以使用它创建VCL代码片段,以阻止对ACL中指定的IP地址的访问。 您可以在暂存环境和生产环境中使用相同的VCL代码片段,但必须分别将该代码片段上传到每个环境。

列入阻止列表以下自定义VCL代码片段(JSON格式)显示了使用与ACL中的地址匹配的客户端IP地址阻止传入请求的逻辑。

{
  "name": "blocklist",
  "dynamic": "0",
  "type": "recv",
  "priority": "5",
  "content": "if ( client.ip ~ blocklist) { error 403 \"Forbidden\"; }"
}

在基于此示例创建代码片段之前,请查看值以确定是否需要进行任何更改:

  • name: VCL代码片段的名称。 在此示例中,我们使用了名称blocklist

  • priority:确定VCL代码片段的运行时间。 优先级为5以立即运行并检查管理员请求是否来自允许的IP地址。 该代码片段在任何默认MagentoVCL代码片段(magentomodule_*)的优先级为50之前运行。 根据您希望代码片段运行的时间,将每个自定义代码片段的优先级设置为高于或低于50。 优先级较低的代码片段首先运行。

  • type:指定VCL代码片段的类型,以确定代码片段在生成的VCL代码中的位置。 在本例中,我们使用recv,它将VCL代码插入vcl_recv子例程中、样板VCL的下方和任何对象的上方。 有关代码片段类型的列表,请参阅Fastly VCL代码片段引用

  • content:要运行的VCL代码片段,用于检查客户端IP地址。 如果IP位于Edge ACL中,则会阻止其访问,并显示整个网站的403 Forbidden错误。 允许访问所有其他客户端IP地址。

查看并更新环境的代码后,使用以下任一方法将自定义VCL代码段添加到Fastly服务配置中:

  • 从Admin添加自定义VCL代码片段。 如果您可以访问管理员,则建议使用此方法。 (需要Fastly版本1.2.58或更高版本。)

  • 将JSON代码示例保存到文件(例如,blocklist.json)中,然后使用Fastly API上载它。 如果您无法访问管理员,请使用此方法。

添加自定义VCL代码片段

  1. 登录管理员。

  2. 单击​ 存储 >设置> 配置 > 高级 > 系统

  3. 展开​ 全页缓存 > Fastly配置 > 自定义VCL代码片段

  4. 单击​ 创建自定义代码片段

  5. 添加VCL代码片段值:

    • 名称blocklist

    • 类型recv

    • 优先级5

    • 添加​ VCL ​代码片段内容:

      code language-conf
      if ( client.ip ~ blocklist) { error 403 "Forbidden"; }
      
  6. 单击​ 创建 ​以生成名称模式为type_priority_name.vcl的VCL代码片段文件,例如recv_5_blocklist.vcl

  7. 重新加载页面后,单击​ Fastly配置 ​部分中的​ 将VCL上传到Fastly ​以将文件添加到Fastly服务配置。

  8. 上传后,根据页面顶部的通知刷新缓存。

Fastly在上传过程中验证VCL代码的更新版本。 如果验证失败,请编辑自定义VCL代码片段以解决该问题。 然后,再次上传VCL。

阻塞请求的其他VCL示例

以下示例显示如何使用内联条件语句而不是ACL列表来阻止请求。

WARNING
在这些示例中,VCL代码的格式为JSON有效负荷,该有效负荷可以保存到文件中并在Fastly API请求中提交。 您可以从Admin🔗提交VCL代码片段,或使用Fastly API作为JSON字符串提交。 要防止在将Fastly API与JSON字符串一起使用时发生验证错误,必须使用反斜杠对特殊字符进行转义。
NOTE
如果要从Admin提交VCL代码片段,请从示例VCL代码中提取各个值,并将它们输入到相应的字段中。 例如:
  • 名称: <name of the VCL>
  • 动态: <0/1>
  • 类型: <type>
  • 优先级:<priority>
  • 内容: <content>

请参阅Fastly VCL文档中的使用动态VCL代码片段

VCL代码示例:按国家/地区代码分块

此示例使用双字符ISO 3166-1国家/地区代码来表示与IP地址关联的国家/地区。

{
  "name": "blockbycountrycode",
  "dynamic": "0",
  "type": "recv",
  "priority": "5",
  "content": "if ( client.geo.country_code == \"HK\" ) { error 405 \"Not allowed\";}"
}
NOTE
您可以使用云基础架构管理员上的Adobe Commerce中的Fastly Blocking功能来按国家/地区代码或国家/地区代码列表配置阻止,而不使用自定义VCL代码片段。

VCL代码示例: Block by HTTP User-Agent请求标头

{
  "name": "blockbyuseragent",
  "dynamic": "0",
  "type": "recv",
  "priority": "5",
  "content": "if ( req.http.User-Agent ~ \"(UCBrowser|MQQBrowser|LieBaoFast|Mb2345Browser)\" ) {error 405 \"Not allowed\";}"
}
NOTE
您可以向环境中的$MAGENTO_CLOUD_APP_DIR/var/vcl_snippets_custom目录添加代码片段,而不是手动上传自定义VCL代码片段。 当您在Commerce Admin中单击​_将VCL上传到Fastly_​时,此目录中的代码片段会自动上传。 有关Magento2文档,请参阅Fastly CDN模块中的自动自定义VCL代码片段部署

修改自定义VCL代码片段

  1. 登录管理员。

  2. 单击​ 存储 > 设置 > 配置 > 高级 > 系统

  3. 展开​ 全页缓存 > Fastly配置 > 自定义VCL代码片段

    管理自定义VCL代码片段

  4. 在​ 操作 ​列中,单击要编辑的代码片段旁边的设置图标。

  5. 重新加载页面后,在​ Fastly配置 ​部分中单击​ 将VCL上传到Fastly

  6. 上载完成后,根据页面顶部的通知刷新缓存。

WARNING
自定义VCL代码片段 UI选项仅显示通过Adobe Commerce管理员添加的代码片段。 如果您使用Fastly API添加代码片段,请使用该API 管理它们

删除自定义VCL代码片段

  1. 登录管理员。

  2. 单击​ 存储 > 设置 > 配置 > 高级 > 系统

  3. 展开​ 全页缓存 > Fastly配置 > 自定义VCL代码片段

    管理自定义VCL代码片段

  4. 在​ 操作 ​列中,单击要删除的代码片段旁边的垃圾桶图标。

  5. 在下一个模式窗口中,单击​ DELETE ​并激活新版本。

WARNING
自定义VCL代码片段 UI选项仅显示通过Adobe Commerce管理员添加的代码片段。 如果您使用Fastly API添加代码片段,请使用该API 管理它们
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26