本文档介绍如何为函数配置域名触发器。
当用户通过 HTTP 或 HTTPS 请求访问函数关联的域名，且用户请求与域名的转发规则匹配时，域名触发器会触发函数代码中的 fetch 事件。您需要在代码中监听并处理 fetch 事件。

使用限制 #

一个函数最多允许关联 100 个域名，一个域名最多允许关联 50 个函数。

配置域名触发器 #

您需要完成以下任务来为函数配置域名触发器。

步骤一：为函数关联域名 #

前提条件

• 您的函数已全量发布，且函数的状态是 运行中 或 待关联。
• 您的域名已接入火山引擎 CDN，并且 域名状态 是 在线。

参见以下步骤为函数关联一个域名。

1. 打开 函数管理 页面。
2. 在 函数管理 页面，在 名称 列找到您创建的函数，然后点击函数的名称。
3. 选择 触发器 标签页，然后选择 域名 标签页，点击 添加域名。
4. 在 添加域名 对话框中，选择一个或多个需要关联的域名，然后点击 保存。

域名关联成功后，您可以在 触发器 标签页查看 域名 。由于添加的域名没有配置转发规则，该域名的状态为 离线。

步骤二：为域名配置转发规则 #

为函数添加域名后，您还需要为域名配置转发规则。

1. 打开 函数管理 页面。
2. 在 函数管理 页面，在 名称 列找到您创建的函数，然后点击函数的名称。
3. 选择 触发器 标签页，然后选择 域名 标签页。
4. 在 域名 标签页下的域名列表中，选择需要配置转发规则的域名。如果您要为该函数下的多个域名配置相同的转发规则，勾选多个域名。

5. 点击域名列表下方的 配置转发规则。

6. 在 配置转发规则 页面参见下表配置转发规则。

* 文件后缀：规则应用于具有指定后缀名的所有文件。
  * URL目录：规则应用于指定目录下的所有文件。
  * URL全路径：规则应用于指定文件。

* 如果类型是 **文件后缀**，需要输入一个或者多个文件后缀。比如 `xlsx` 或者 `png;txt`。文件后缀可以包含英文字母和数字。
  * 如果类型是 **URL目录**，需要输入一个或者多个目录路径。目录路径必须以斜杠（/）开头和结尾。比如 `/www/img/byte/;/www/doc/`。目录路径不能包含连续斜杠（//）、百分号（%）、空格。如果要指定域名下的所有目录，输入 `/`。
  * 如果类型是 **URL全路径**，需要输入一个或多个完整路径。路径以斜杠（/）开头。比如 `/www/img/abc.png;/doc/study.docx`。文件路径不能包含连续斜杠（//）、百分号（%）、空格。

7. 转发规则配置完成后，点击 保存。

您需要等待几分钟。当域名的状态变为 在线 时，表示域名触发器对于该域名生效。此时，如果用户向该域名发起 HTTP/HTTPS 请求且该请求匹配转发规则，那么火山引擎 CDN 会把用户请求转发到边缘函数，而且域名触发器会触发与该域名关联的函数中的 fetch 事件。

步骤三：在函数代码中监听 fetch 事件 #

您需要在函数代码中监听 fetch 事件来处理用户请求。下面的示例代码展示了如何注册一个事件监听器监听 fetch 事件并在 fetch 事件被触发时调用回调函数向用户返回自定义响应。

// 注册一个事件监听器监听 fetch 事件
addEventListener('fetch', event => {
  event.respondWith(handleRequest(event.request));
})
// fetch 事件被触发时，该回调函数被调用
async function handleRequest(request) {
        return new Response('Hello World!', { status: 200 });
}

解除函数与域名的关联 #

前提条件 #

域名在 触发器 标签页中的状态是 离线。

操作步骤 #

参见以下步骤为函数解除关联一个域名。

1. 打开 函数管理 页面。
2. 在 函数管理 页面，在 名称 列找到您创建的函数，然后点击函数的名称。
3. 选择 触发器 标签页，然后选择 域名 标签页。
4. 在 域名 标签页下的域名列表中，找到需要解除关联的域名，点击 操作 列的 解除关联。
5. 在弹出的对话框中点击 确定。

解除关联后，该域名不会再出现在域名列表中。