适用场景与准备工作
.htaccess 是 Apache HTTP Server 的分布式配置文件,放在网站根目录或某个子目录下,可以对该目录及其子目录生效,不需要重启 Apache。对于使用虚拟主机、共享主机的站长来说,没有权限修改服务器主配置文件 httpd.conf,.htaccess 几乎是唯一能自己掌控的配置入口;即使拥有独立服务器,把少量目录级规则写在 .htaccess 里,也比动主配置更灵活。
常见适用场景包括:URL 重写与伪静态、HTTP 跳转 HTTPS、旧网址 301 重定向、防盗链、限制或放开某个 IP 访问、禁止列出目录文件、给目录加访问密码等。需要先确认两点:第一,Apache 已加载 rewrite 模块(Debian/Ubuntu 执行 sudo a2enmod rewrite,CentOS 确认 httpd.conf 中 LoadModule rewrite_module 未被注释);第二,主配置中该目录的 AllowOverride 为 All,否则 .htaccess 会被完全忽略。
重要提醒:.htaccess 的语法错误会直接导致网站 500 错误,全站打不开。动手之前务必先下载一份原有 .htaccess 备份到本地,一次只加一段规则、保存后立即访问页面验证,出问题先用备份覆盖回去,再逐段排查。生产环境请避开访问高峰期操作。
第一步:创建 .htaccess 并开启重写引擎
用 FTP 工具或宝塔面板文件管理器进入网站根目录(通常是 /www/wwwroot/你的域名 或 public_html),新建名为 .htaccess 的文件。注意文件名以点开头,且没有后缀,部分系统默认隐藏点文件,需要在客户端打开显示隐藏文件选项。
所有重写规则都要以开启引擎开头,把下面这段作为文件第一行:
RewriteEngine On
如果网站部署在子目录(例如 example.com/blog/),还要指定基准路径,否则规则会匹配错地址:
RewriteBase /blog/
保存后用浏览器访问网站首页和任意一篇文章,确认显示正常,再进行下一步。
第二步:配置常用重写与跳转规则
最常用的三类规则是强制 HTTPS、统一 www 前缀和旧地址 301 跳转,都依赖 RewriteCond 判断条件加 RewriteRule 执行动作的写法。
强制全站 HTTPS,同时把常见的裸域名和带 www 的访问合并到 https 的 www 域名下:
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://www.example.com/$1 [R=301,L]
把不带 www 的访问 301 到带 www 的版本,避免权重分散:
RewriteCond %{HTTP_HOST} ^example\.com$ [NC]
RewriteRule ^(.*)$ https://www.example.com/$1 [R=301,L]
网站改版后旧栏目地址需要永久跳转到新地址,单条写法如下,多条规则按顺序排列即可:
Redirect 301 /old-page.html https://www.example.com/new-page.html
说明:R=301 表示永久重定向,搜索引擎会转移权重;L 表示该规则命中后不再继续匹配后面的规则。测试期间可先用 R=302 临时跳转,确认无误再改回 301。

第三步:防盗链、访问控制与目录安全
防盗链用于阻止其他站点直接引用你的图片、下载文件,白嫖带宽。下面规则放行空 Referer(用户直接访问)和本站域名,其他来源的图片、压缩包请求统一跳转到一张提示图:
RewriteCond %{HTTP_REFERER} !^$
RewriteCond %{HTTP_REFERER} !example\.com [NC]
RewriteRule \.(jpg|jpeg|png|gif|zip)$ https://www.example.com/hotlink.png [NC,R,L]
禁止列出目录结构,防止访客看到文件清单:
Options -Indexes
限制敏感文件与目录的访问,比如禁止外网直接访问配置文件、日志文件:
<FilesMatch "\.(env|log|ini|conf)$">
Require all denied
</FilesMatch>
只允许公司固定 IP 访问后台目录,其他 IP 一律拒绝(Apache 2.4 语法):
<Directory "/www/wwwroot/example.com/admin">
Require ip 203.0.113.10
Require ip 198.51.100.0/24
</Directory>
提醒:IP 白名单一旦写错,会把自己也挡在后台之外。建议先写好、保存前再核对一遍,同时准备一台备用机器或其他远程入口;家庭宽带 IP 会变动,不建议作为唯一白名单。
第四步:规则不生效与 500 错误的排查
问题一:规则保存后完全没反应。先确认 AllowOverride 是否为 All——用宝塔面板的站点配置文件检查,或执行 grep -n AllowOverride /etc/apache2/apache2.conf,显示 None 就要改为 All 并执行 sudo systemctl reload apache2;其次确认 rewrite 模块已启用;再次检查文件名是不是 .htaccess.txt 之类的错误名字。
问题二:网站突然 500 错误。九成是语法问题,最常见的是 RewriteCond 与 RewriteRule 顺序颠倒、正则里的点号没转义、中文注释或空规则。处理办法是立即用备份文件覆盖,然后二分法排查:只留一半规则测试,逐步缩小范围。有服务器权限时可以先执行 sudo apachectl configtest 验证语法,再重载服务。
问题三:跳转出现循环,浏览器提示重定向次数过多。通常是 HTTPS 判断和 www 判断两条规则互相打架,把两条合并成一条、一次性判断完整目标地址即可;CDN 或代理场景下 %{HTTPS} 可能取不到值,需要按后端协议头判断,可查看 CDN 回源协议说明。
常见问题(FAQ)
问题一:.htaccess 和 Nginx 的 conf 文件有什么区别?两者作用类似但语法完全不通用。.htaccess 只对 Apache 有效,Nginx 不支持 .htaccess,伪静态规则必须写在站点配置文件里,改完要执行 nginx -t 校验并重载。如果服务器是 Nginx,在根目录放 .htaccess 不会有任何效果。
问题二:规则写错了,网站 500 打不开,怎么恢复?通过 FTP 或面板文件管理,用事先下载的备份 .htaccess 覆盖线上文件即可恢复,全过程一两分钟。这正是动手前必须备份的原因。若没有备份,也可以新建一个只含 RewriteEngine On 的空规则文件临时恢复访问,再重新逐段添加。
问题三:WordPress 会自动改写 .htaccess 吗?会。WordPress 在后台修改固定链接格式时会自动往 .htaccess 写入默认伪静态规则(# BEGIN WordPress 到 # END WordPress 之间),手动添加的规则建议写在这段标记之外,否则可能被覆盖。修改固定链接后建议重新检查一遍自己的规则是否还在。
问题四:多条规则的先后顺序有影响吗?有。Apache 按文件从上到下的顺序匹配,命中带 L 标记的规则后不再继续。因此范围小、优先级高的规则(如具体文件的跳转)放前面,通用规则(如全站 HTTPS)放后面;防盗链这类拦截规则则要放在普通重写之前,避免被提前改写。
总结
.htaccess 是 Apache 环境下性价比最高的配置入口:不重启服务、即时生效,重写、跳转、防盗链、访问控制都能在一个文件里完成。操作上记住三条原则:动手前先下载备份、一次只加一段并立即验证、语法拿不准就先 apachectl configtest 或写简单规则。规则本身不复杂,难的是排错,而备份加逐段验证就是最好的排错预案。如果你的服务器是 Nginx,可参考本站 Nginx 伪静态与反向代理相关教程,思路相通、写法不同。












暂无评论内容