国内镜像自动替换——default.redirect 配置详解

设计初衷

使用国外搜索引擎（Google、DuckDuckGo）时，体验往往不如国内引擎好。原因包括：

• 国外网站索引权重不如国内，中文技术内容搜不到
• 搜索引擎能搜到但链接访问不通
• 国内的替代镜像其实早已有之，但索引权重低，普通搜索找不到

uWeb 用 default.redirect 解决了这个问题——把国外网址自动重定向到国内镜像，让你用国外搜索引擎，但享受国内网站的访问速度。

配置文件格式

default.redirect 每一行的格式是：

域名:正则表达式:替换表达式

三个字段可以部分省略：

• 正则表达式为空 → 默认与域名相同
• 正则表达式和替换表达式都为空 → 该域名允许 CORS 跨域访问（目前仅对 GET 请求生效）

基础示例

developer.android.com::developer.android.google.cn

意思是：访问 developer.android.com 时，自动替换为 developer.android.google.cn（Android 中国官方站）。

带正则的示例

pan\.baidu\.com(.+):https://pan\.baiduwp\.com$1

用正则表达式和捕获组实现更灵活的替换。

官方推荐的镜像规则

官方文档收录了常见的镜像替换：

注意：镜像站的可用性、安全性、版权状况需要你自行判断。uWeb 只提供重定向能力，不对镜像本身负责。

四种使用方法

default.redirect 的规则可以通过多种方式触发：

方式一：长按链接 + 国内镜像.js

1. 在 longclick/ 目录下放一个名为"国内镜像.js"的文件
2. 文件内容只一行：//e:%u（e: 是"edit"内部协议，意味着会触发重定向）
3. 强制清空后台重启
4. 在任意网页上长按一个国外链接 → 菜单里选"国内镜像" → 自动重定向到镜像站

方式二：长按图像按钮

图像按钮的特色服务（default.urls）里可以配置重定向入口。

方式三：长按设置 → 自定义重定向

全局开启重定向规则应用。

方式四：长按设置 → 自定义资源重定向

更彻底——不仅访问的 URL 重定向，网页中的所有资源（图片、JS、CSS、字体等）也重定向。

资源重定向

长按设置 → "自定义资源重定向"开启后，网页中引用的第三方资源也会应用 default.redirect 规则。这个功能特别有用：

• 某些网页里引用了 Google Fonts → 自动替换为国内字体镜像
• CDN 资源被墙 → 自动替换为国内 CDN
• 这比只重定向 HTML 更彻底

允许 CORS

对于某些你自己控制的域名，如果只在 default.redirect 里写：

yourdomain.com::

（正则和替换表达式都为空），那访问 yourdomain.com 时不会重定向，但 uWeb 会允许对它的 CORS 跨域 GET 请求。

与全局重定向的关系

当你同时配置了全局重定向和 default.redirect 时：

• 如果全局重定向 URL 有效 → 全局重定向优先，default.redirect 不生效
• 如果全局重定向 URL 无效（未配置或清空） → default.redirect 生效

下一章

• 资源重定向 — 资源重定向详解
• CF Pages 部署 — 用 CF Pages 部署重定向中间层