如何生成 Apache .htaccess 配置文件

选择需要的重定向、缓存、安全响应头和自定义规则选项后，工具会生成 Apache .htaccess 配置文本。默认输入不会加入这些可选配置区块。

认识配置文本的用途

.htaccess 文件可以为 Apache 站点提供目录级配置。这个工具会把你选择的重定向、缓存过期设置、安全响应头和自定义规则整理成 Apache 配置文本，适合在准备配置内容时使用。它的重点是生成可供你查看的文本，而不是替你判断这些规则是否适合某个站点环境。

使用前，先明确你要处理的是协议重定向、主机名重定向、缓存设置，还是需要附加已有规则；不同选项会在结果中形成不同的配置部分。若只想查看基础输出，可以先保留默认输入，再根据结果逐项增加设置。

按选项生成配置

打开工具后，先查看重定向模式。默认模式为“无”，也可以选择 HTTPS、WWW 或自定义模式。选择 HTTPS 时，生成的重写配置会把 HTTPS 状态关闭的请求转向同一主机的 HTTPS 地址，并保留捕获到的路径；选择 WWW 时，会生成把捕获路径转向带有 www 主机名的 HTTPS 地址的 301 规则。
如果选择自定义重定向，请填写非空的重定向地址。只有在该条件满足时，结果中才会加入相应的 301 规则；工具会把所填地址放入规则中，因此输入前应确认地址的写法和用途。
按需设置缓存控制。保留默认的“无”时，结果不会加入缓存区块；填写其他值后，输出会加入 Apache 过期设置，并把该值放入访问加过期设置的相关文本中。
需要相关响应头时，启用安全响应头选项。生成内容会包括防止 MIME 类型嗅探、禁止页面被框架嵌入以及 XSS 防护方面的指令，但这些指令仍应结合你的 Apache 配置进行检查。
若要附加自己的 Apache 规则，把内容填写到自定义规则输入区域。只要输入含有非空白字符，文本就会追加到自定义规则标记之后，并保持原来的形式；空白输入则不会形成可用的自定义规则内容。
生成后逐段阅读输出，核对重定向模式、地址、缓存值和自定义规则的排列。由于重定向地址、缓存控制值和自定义规则会按输入内容写入结果，不能把输入框中的内容视为已经经过检查或转义。

判断输出代表什么

如果输入保持默认状态，结果仍然是 Apache 配置文本，但其中不会出现重定向、缓存、安全响应头或自定义规则区块。看到某个区块时，应根据对应的输入选项判断其来源，而不要把输出文本当成站点当前状态的说明。

HTTPS 模式的 301 规则面向同一主机的 HTTPS 地址，并保留请求路径；WWW 模式则面向带有 www 主机名的 HTTPS 地址。自定义模式是否出现规则，取决于是否提供了非空的重定向地址，而不是仅仅取决于模式名称。

缓存设置会影响生成的过期配置文本，安全响应头选项会带来相应的响应头指令，自定义规则则会以输入时的形式出现在指定标记之后。对于这些内容，应结合域名、目录结构、现有模块和站点需求逐项审阅，尤其要留意输入值是否被原样写入。

工具输出的是 .htaccess 配置文本，所以生成结果本身不等于配置已经部署、激活或在 Apache 站点中生效。完成检查后，还需要按照你的管理流程处理这段文本，并由你确认它与现有配置之间是否协调。

使用示例

网站管理员正在整理 Apache 站点的 HTTPS 重定向与安全响应头配置。

某站点准备将未使用 HTTPS 的请求转向 HTTPS，同时加入相关安全响应头。选择 HTTPS 重定向并启用安全响应头后生成文本，再分别查看重写规则和响应头指令是否出现在输出中。

结果应为 Apache 配置文本，其中可见与 HTTPS 重定向和安全响应头对应的规则或指令；文本本身不表示配置已部署或生效。

使用限制

输出仅是 Apache 配置文本，不表示内容已经部署或生效；输入的重定向地址、缓存值和自定义规则也不会由工具验证或转义。

常见错误

选择自定义重定向模式却留下空的重定向地址时，不会生成该规则；请提供非空地址，再检查输出中插入的内容是否符合预期。

常见问题

可以生成 HTTPS 重定向吗？

选择 HTTPS 模式后，结果会包含把 HTTPS 状态关闭的请求转向同一主机 HTTPS 地址的 301 重写规则，并保留捕获到的路径。

自定义重定向地址会自动检查吗？

自定义模式只有在填写非空重定向地址时才会加入 301 规则；工具不会验证或转义该地址，而是将其插入生成的规则。

默认会生成缓存配置吗？

保留默认的缓存控制选项时不会加入缓存区块；改为其他值后，结果才会出现 Apache 过期设置及相关文本。