Skip to content

部署 uBlock Origin:配置

fang5566 edited this page Apr 2, 2024 · 8 revisions

返回“部署 uBlock Origin”


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

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

userSettings

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

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

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

例如:

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

advancedSettings

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

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

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

例如:

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

disableDashboard

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

disabledPopupPanelParts

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

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.comexample.org 以后所管理的存储的样子:

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

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

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

toAdd

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

trustedSiteDirectives

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

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

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

Clone this wiki locally