本仓库是 gorhill/uBlock 的私有 fork，不向上游推送。 上游作者已明确 uBO 不做设置自动同步；本 fork 为自用目的添加了该能力。
uBO 原版的设置（过滤规则、自定义规则、白名单等）只存在本机，换设备/换浏览器要手动导出导入。DAV-Sync 让任意多个浏览器实例通过任意标准 WebDAV 服务（坚果云、InfiniCLOUD、Nextcloud 等）自动保持 uBO 设置一致：
- 自动同步：启动 18 秒后自动同步一次；之后每 30 分钟定时 + 本地变更防抖 1 分钟自动推送，无需人工干预；
- 多端可靠：固定扩展 ID（
odecihgahfphabajblgnmopeibmkhifp）、ETag 条件写入（If-Match 防盲覆盖）、lock 文件防多端并发、PUT 后读回校验防静默截断； - 跨浏览器：基于 uBO 官方云存储通道（
vAPI.cloud）实现，任何能装 uBO 的浏览器都适用； - 零外部依赖：直接用扩展自身的
fetch访问 WebDAV，无需本地代理或额外服务端。
三个发行包在 Releases，按浏览器选择：
| 包 | 适用浏览器 | 安装方式 |
|---|---|---|
.crx |
百分、360 极速等保留 MV2 的国产 Chromium 壳 | 扩展页开启「开发者模式」→ 拖入 crx → 确认。安装后持久生效，重启不丢 |
.zip |
Kiwi Browser（Android） | push 到设备 → 扩展页「+ (from .zip/.crx/.user.js)」选择 |
| 解包目录 | Turbo 等不支持 crx 安装的壳 | --load-extension=<解包目录> 启动（会话级），详见载体测试文档第 11 节 |
firefox.xpi |
Firefox 115+（桌面） | web-ext run 临时加载（会话级）；运行时同步待验证 |
命名说明：
firefox.xpi是 Firefox/gecko 专用构建；Chromium 系没有 xpi——它们的拖拽安装只认.crx。
各浏览器对 MV2/自签 crx 的支持差异与绕过方法，见
docs/DAVSYNC-TESTING.md第 11 节（如 Turbo 需--load-extension，其 crx 安装被策略拒绝且 policy 服务被剥离）。
- 扩展安装后打开 uBO 设置页 → 底部「DAV-Sync」区块
- 填 WebDAV 地址（如
https://dav.jianguoyun.com/dav/）、账号、应用密码（坚果云用授权密码而非登录密码）、设备名 - 开启开关 → 立即首推；其余设备填同一 WebDAV 目录、不同设备名即可自动互相同步
| 平台 | 载体 | 安装 | 双向同步 E2E |
|---|---|---|---|
| Windows | 百分浏览器 150 | ✅ crx 拖拽 | ✅ 通过 |
| Windows | Turbo 154 | ✅ --load-extension（会话级） | ✅ 通过 |
| Android (MuMu x86) | Kiwi x86 | ✅ zip 加载 | ✅ 安装运行、同步均正常（在可直连坚果云的网络环境下） |
| Windows | Firefox 159 | ✅ web-ext 临时加载 | ⏳ 待配置验证 |
| Windows | Chrome 155+ | ❌ MV2 已移除 | — |
| 文件 | 作用 |
|---|---|
src/js/davsync.js |
WebDAV 客户端、自动同步调度、快照生成/应用、lock/size 校验 |
src/js/dav-cloud.js |
把 uBO 云存储路由接到 WebDAV |
src/js/settings.js / src/settings.html |
设置页 DAV-Sync 配置 UI |
tools/make-packages.cjs + tools/make-packages.md |
一键打包 crx/zip + 打包说明与踩坑记录 |
docs/DAVSYNC-TESTING.md |
全平台载体兼容性验证 + 侧载方法 + E2E 记录（持续迭代） |
ARTIFACTS.md |
仓库分支布局、密钥管理、换机重建指南 |
- 基于 uBO 1.75.1.16（Manifest V2）。Chrome 137+ 已禁用 MV2（Chrome/Edge 商店与加载均不可用）；
- 个别 Android 网络环境可能无法直连坚果云 WebDAV（桌面端不受影响）。如遇同步连接错误，请检查网络环境（切换网络/使用系统代理通常可解决），或改用其他标准 WebDAV 服务商（InfiniCLOUD/TeraCLOUD/自建 Nextcloud 均可）；
- Turbo 154 拒绝自签 crx 安装且 policy 服务被剥离无法白名单（已提 issue #724），该浏览器用
--load-extension方案。
| Browser | Install from ... | Status |
|---|---|---|
 |
Firefox Add-ons | uBO works best on Firefox |
 |
Edge Add-ons | "Moving the Microsoft Edge extensions ecosystem forward with Manifest Version 3": "Beginning in August 2026, Microsoft Edge will start the consumer transition away from Manifest Version 2 (MV2) extensions and toward MV3. Our goal is to complete the consumer transition by the end of 2026, with enterprise deprecation following in early 2027." |
 |
Opera Add-ons | |
 |
Removed | "Manifest V2 support timeline": "Aug 31st 2026: All remaining Manifest V2 extensions removed from the Chrome Web Store" About Google Chrome's "This extension may soon no longer be supported" |
 |
Thunderbird Add-ons | No longer updated and stuck at 1.49.2. Later versions require "GitHub - Releases". |
 |
GitHub - Releases | Stable and development versions on Firefox, Chromium MV2, and Thunderbird. Must be placed manually into web browsers; the Chromium and Thunderbird versions usually won't auto-update. |
Related:
uBlock Origin Lite
uBlock Origin (uBO) is a CPU and memory-efficient wide-spectrum content blocker for Chromium and Firefox. It blocks ads, trackers, coin miners, popups, annoying anti-blockers, malware sites, etc., by default using EasyList, EasyPrivacy, Peter Lowe's Blocklist, Online Malicious URL Blocklist, and uBO filter lists. There are many other lists available to block even more. Hosts files are also supported. uBO uses the EasyList filter syntax and extends the syntax to work with custom rules and filters.
You may easily unselect any preselected filter lists if you think uBO blocks too much. For reference, Adblock Plus installs with only EasyList, ABP filters, and Acceptable Ads enabled by default.
It is important to note that using a blocker is NOT theft. Do not fall for this creepy idea. The ultimate logical consequence of blocking = theft is the criminalization of the inalienable right to privacy.
Ads, "unintrusive" or not, are just the visible portion of the privacy-invading means entering your browser when you visit most sites. uBO's primary goal is to help users neutralize these privacy-invading methods in a way that welcomes those users who do not wish to use more technical means.
| Basic Mode | Advanced Mode |
|---|---|
| The simple popup user interface for an install-it-and-forget-it type of installation that is configured optimally by default. | The advanced popup user interface includes a point-and-click firewall that is configurable on a per-site basis. |
 |
 |
Visit the Wiki for documentation.
For support, questions, or help, visit /r/uBlockOrigin.
uBO works best on Firefox and is available for desktop and Android versions.
Chrome Web Store: Removed on 2026-08-31
Microsoft Edge Add-ons (Published by Nicole Rolls until version 1.62. Ownership transfer at version 1.64.)
uBO should be compatible with any Chromium-based browser.
In Thunderbird, uBlock Origin does not affect emails, just feeds.
Do NOT use uBO with any other content blocker. uBO performs as well as or better than most popular blockers. Other blockers can prevent uBO's privacy or anti-blocker-defusing features from working correctly.
Help translate uBO via Crowdin.
Free. Open-source. For users by users. No donations sought.
If you ever want to contribute something, think about the people working hard to maintain the filter lists you are using, which are available to use by all for free.