部署 uBlock Origin：配置

返回“部署 uBlock Origin”

---

uBO 支持通过中央策略进行配置，请参见管理员浏览器文档：

• Chromium："Configuring Apps and Extensions by Policy"
• Firefox："Managed storage manifests"
• Tutorial: Deploying uBO configuration for Microsoft Edge Chromium and Google Chrome - newer way (Editing Registry by PowerShell)，来自 u/DefinitelyYou
• Deploying uBlock via Google workspace? (Q&A discussion) (with successful deployment)

以下设置说明仅适用于 uBO 1.33.0 及更高版本。

userSettings

userSettings 属性用于设置各项用户设置的值。（更具体来说，是修改这些变量）。

数组中的每一项都由一对名称-值的字符串组成。每个名称字符串都必须是一个已支持的用户设置项，每个值字符串都必须正确对应一个已支持的值。

每个有效的项都用于在启动阶段覆盖对应的默认用户设置。

例如：

{
    "userSettings": [
        [ "contextMenuEnabled", "false" ],
        [ "dynamicFilteringEnabled", "false" ]
    ]
}

advancedSettings

advancedSettings 属性用于设置各项高级设置的值。

数组中的每一项都由一对名称-值的字符串组成。每个名称字符串都必须是一个已支持的高级设置项，每个值字符串都必须正确对应一个已支持的值。

每个有效的项目都用于覆盖对应的默认用户设置，并且是只读的，即用户无法更改。

例如：

{ "advancedSettings": [ [ "disableWebAssembly", "true" ] ] }

disableDashboard

设置为 true 可禁止访问 uBO 的控制面板。

disabledPopupPanelParts

字符串数组，每个字符串都表示禁止在弹出界面显示一部分内容。目前支持以下几个字符串名称：

• globalStats：禁止访问 “自安装后已拦截” 的统计信息。
• basicTools：禁止访问基础工具。
• extraTools：禁止访问基于站点的开关。
• overviewPane：禁止访问概要面板。

toOverwrite

toOverwrite 分支里的属性将完全代替对应的本地设置。目前支持以下几种属性：

filters

filters 属性是一个字符串数组，每行的文本都表示 “自定义静态规则” 版块 的内容。

filterLists

filterLists 属性是一个字符串数组，每个字符串都是一个令牌，用于识别默认启用的规则列表。要启用一个自带的规则列表，就要根据 assets.json 的内容使用该令牌识别对应的列表。对于外部列表，即不在 assets.json 出现的列表，令牌就是列表的 URL。

如果要默认启用 “自定义静态规则” 版块里的规则，请确认使用 user-filters 这个令牌。

作为参考，以下数组对应的是 uBO 默认启用的规则列表：

[
  "user-filters",
  "ublock-filters",
  "ublock-badware",
  "ublock-privacy",
  "ublock-abuse",
  "ublock-unbreak",
  "easylist",
  "easyprivacy",
  "urlhaus-1",
  "plowe-0"
]

此外，根据当前语言，uBO 会启用一个或多个区域性规则列表。

trustedSiteDirectives

trustedSiteDirectives 属性是一个字符串数组，每个字符串都必须是一个有效的受信任站点，用于指示 uBO 禁止在该站点生效。

下例显示的是 Chromium/Linux 平台在添加 example.com 和 example.org 以后所管理的存储的样子：

xxxxx@xxxxx:~$ cat /etc/chromium/policies/managed/ubo.json 
{
  "3rdparty": {
    "extensions": {
      "cjpalhdlnbpafiamejdnhcphjbkeiagm": {
        "toAdd": {
          "trustedSiteDirectives": [
            "example.com",
            "example.org"
          ]
        }
      }
    }
  }
}

这些属性都将添加在本地属性之后。

关于如何创建有效的受信任站点，请参见文档：“如何标记为受信任站点”

toAdd

toAdd 分支里的属性会附在现有的本地设置后面。目前支持以下几种属性：

trustedSiteDirectives

trustedSiteDirectives 属性是一个字符串数组，每个字符串都必须对应一个有效的受信任站点，用于指示 uBO 禁止该站点生效。

这里所有的地址都将附在本地地址后面。

关于如何创建有效的受信任站点，请参见文档：“如何标记为受信任站点”