apache全站链接迁移需分域名级和目录级两类精准配置：域名级用rewritecond+rewriterule全路径跳转并保留参数；目录级按一对一或正则批量映射，优先redirect简单跳转、rewriterule处理动态路径；规则须解耦至独立配置文件，启用mod_rewrite后通过curl和日志验证生效。
全站改版时做链接迁移，Apache 的 301 重定向核心是“精准映射 + 永久跳转 + 配置解耦”，不能只靠一条规则粗暴跳转，否则会丢失路径语义、损害 SEO 权重传递。关键在于区分两类场景：域名级迁移（如 old.com → new.com）和目录结构级迁移（如 /old/news/ → /new/articles/），并用合适方式组织规则。
域名级全站跳转：用 RewriteCond + RewriteRule 精准匹配
适用于旧域名整体停用、所有请求都需转向新域名（含子域名、路径、参数）。推荐写法：
- 在虚拟主机配置或独立重定向文件中启用重写引擎：
RewriteEngine On - 用
RewriteCond同时覆盖主域和 www 子域，不区分大小写：RewriteCond %{HTTP_HOST} ^(www\.)?old-site\.com$ [NC] - 用
RewriteRule保留原始路径和查询参数：RewriteRule ^(.*)$ https://new-site.com$1 [R=301,L,QSA]（QSA确保 ?utm_source=xxx 等参数不丢失）
目录结构级路径迁移：混合使用 Redirect 和 RewriteRule
当新旧 URL 路径有明确对应关系（比如 /product/123.html → /items/123），应逐条映射，而非通配跳转：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 简单路径一对一跳转，优先用
Redirect 301（无需开启重写引擎，语法简洁、性能高）：Redirect 301 "/old/about.html" "/company" - 含动态路径的批量映射（如 /old/blog/2023/01/post.html → /articles/2023/01/post），必须用
RewriteRule+ 正则：RewriteRule "^/old/blog/(\d{4})/(\d{2})/(.*)\.html$" "/articles/$1/$2/$3" [R=301,L] - 避免混用
Redirect和RewriteRule在同一上下文导致冲突；建议把Redirect放前面，RewriteRule放后面
把规则单独存放，用 Include 解耦管理
上百条迁移规则直接塞进主配置易出错、难维护。生产环境务必分离：
- 新建独立文件（如
/etc/apache2/redirects/migration-2026.conf），只放迁移相关规则，开头不重复写RewriteEngine On - 在站点的
<virtualhost></virtualhost>块内、DocumentRoot下方插入：Include /etc/apache2/redirects/migration-2026.conf - 路径必须为绝对路径；确保 Apache 对该文件有读取权限；修改后执行
apachectl configtest验证语法，再systemctl reload apache2生效
上线前必须验证的三件事
规则写完不等于生效，漏掉任一环节都可能导致 404 或循环跳转：
- 检查 mod_rewrite 是否启用：
a2enmod rewrite（Debian/Ubuntu）或确认httpd.conf中LoadModule rewrite_module已取消注释 - 用 curl 测试真实响应头：
curl -I http://old-site.com/old/page.html，确认返回HTTP/1.1 301 Moved Permanently及正确Location头 - 检查日志：
tail -f /var/log/apache2/error.log，留意是否有Invalid command 'RewriteCond'或正则匹配失败提示
