通用论坛屏蔽插件 - 支持一键拉黑，跨域共享关键字，Docker部署同步服务器等

通用论坛屏蔽插件 | Universal Forum Block

Github: https://github.com/Heavrnl/UniversalForumBlock

v1.2.0 更新日志

• 增加了基于论坛框架的自动URL匹配识别功能，现已支持所有基于Discuz!和Discourse框架的论坛。

由于最初开发时未考虑隔离，为防止影响普通网页的 CSS 样式，强烈建议在脚本头部的 // @match 中限定为自己常用的论坛网站。

Universal Forum Block 是一个功能强大的通用论坛内容屏蔽插件。主要功能有：

• 🎯 支持关键词、正则表达式进行精确过滤
• 🚫 支持一键屏蔽用户，不再需要手动复制粘贴
• 🔗 支持全局共享关键字和用户名，实现全网屏蔽
• ☁️ 支持多个配置定时同步
• 🔄 自动检测论坛框架
• 🌍 支持多种语言
• 🌐 支持自定义站点配置
• 🐳 支持docker部署云端同步

使用示例

界面

使用方法

PC:

1. 安装脚本管理器（如 Tampermonkey）
2. 点击前往GreasyFork 安装脚本
3. 访问支持的论坛网站
4. 在网站左下角找到我们的面板开始使用

特殊说明：在已配置的论坛中，当鼠标移动到用户名上时会出现屏蔽按钮，点击即可一键屏蔽该用户。屏蔽按钮的显示方式可在设置面板中切换为"总是显示"或"悬停显示"。

安卓:

1.使用Microsft Edge浏览器，已完美支持油猴

2.使用AdGuard，在设置-过滤-用户脚本-添加用户脚本，输入

https://update.greasyfork.org/scripts/522871/通用论坛屏蔽插件.user.js

支持的网站

所有基于以下框架的论坛：

• Discuz!
• Discourse

中文论坛：v2ex，nodeseek，nodeloc，nga，百度贴吧，知乎，豆瓣，巴哈姆特

英文论坛：Lowendtalk, reddit

如果需要支持其他网站，请在issue中提出或参考自定义新网站

除了版本更新外，插件不会自动更新内置的网站配置，可以使用仓库中预设配置导入到全局配置中获取实时更新

中文论坛:

https://raw.githubusercontent.com/Heavrnl/UniversalForumBlock/refs/heads/main/website/chinese/config.json

英文论坛:

https://raw.githubusercontent.com/Heavrnl/UniversalForumBlock/refs/heads/main/website/english/config.json

....

同步服务器部署

部署成功后在admin目录下找到admin key，复制使用

注意，最好使用带证书的域名，因为如果不带证书，浏览器不允许在https页面使用不带证书的链接，导致无法使用同步

docker-compose：

services:
  ufb-server:
    container_name: ufb-server
    image: heavrnl/universalforumblock:latest
    ports:
      - "8006:8000"
    volumes:
      - ./user_configs:/app/user_configs
      - ./admin:/app/admin
    restart: unless-stopped

nginx配置：

location / {
        proxy_pass http://127.0.0.1:8006;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header Host $host;
    }

创建新用户

curl -X POST "http://localhost:8006/users/create" -H "X-API-Key: YOUR_ADMIN_KEY"

界面说明:

全局配置界面

配置项	说明
全局关键字	所有已配置的域名共享各自的关键字池
全局用户名	所有已配置的域名共享各自的用户名单
主页/内容页共享关键词	该域名主页和内容页共享关键词池
主页/内容页共享用户名	该域名主页和内容页共享用户名单
配置连接	单向同步一个或多个配置文件的下载，可定时同步，配置模板请看下方配置模板说明

关键词/用户名配置界面

配置项	说明
关键词列表	支持正则表达式，输入需要屏蔽的关键词
用户名列表	支持正则表达式，输入需要屏蔽的用户名

URL匹配模式界面

配置项	说明
主页URL匹配模式	该域名主页URL的正则表达式匹配规则
分页URL匹配模式	开发遗留项，可不配置，仅配置主页URL匹配模式即可
内容页URL匹配模式	该域名内容页URL的正则表达式匹配规则

XPath配置界面

配置项	说明
XPath选择器	用于定位HTML中的元素位置，分为以下几类：
- 主页/分页标题	用于匹配主页/分页中的标题文本
- 主页/分页用户	用于匹配主页/分页中的用户名
- 内容页关键词	用于匹配内容页中的关键词文本
- 内容页用户	用于匹配内容页中的用户名

云端同步界面

配置项	说明
域名输入框	输入带有证书的云端同步服务器地址或域名，不需要前缀
密钥输入框	用户唯一id，用于登录校验

....

进阶用法

配置模板说明

注：以下模板仅供说明使用，如有需要请使用：配置模板

{
    // 全局配置
    "globalConfig": {
      "GLOBAL_KEYWORDS": false,      // 是否启用全局关键词共享
      "GLOBAL_USERNAMES": false,     // 是否启用全局用户名共享
      "SHOW_BLOCK_BUTTON": "hover",  // 屏蔽按钮显示方式:"hover"悬停显示,"always"总是显示
      "TIME_INTERVAL": 30,           // 配置同步时间间隔(分钟)
      "LANGUAGE": "zh-CN",           // 界面语言
      "GLOBAL_CONFIG_URL": [],       // 全局配置URL列表
      "CONFIG_SECTION_COLLAPSED": {   // 各配置区块的折叠状态
        "global_SECTION_COLLAPSED": true,
        "keywords_SECTION_COLLAPSED": true,
        "usernames_SECTION_COLLAPSED": true,
        "url_SECTION_COLLAPSED": true,
        "xpath_SECTION_COLLAPSED": true
      },
      "EDITOR_STATES": {             // 各配置区块子区块的折叠状态
        "keywords": false,           // 关键词编辑器
        "keywords_regex": false,     // 关键词正则编辑器
        "usernames": false,          // 用户名编辑器
        "usernames_regex": false,    // 用户名正则编辑器
        "mainpage_url_patterns": false,  // 主页URL模式编辑器
        "subpage_url_patterns": false,   // 分页URL模式编辑器
        "contentpage_url_patterns": false, // 内容页URL模式编辑器
        "main_and_sub_page_title_xpath": false,  // 主页和分页标题XPath编辑器
        "main_and_sub_page_user_xpath": false,   // 主页和分页用户XPath编辑器
        "contentpage_title_xpath": false,        // 内容页标题XPath编辑器
        "contentpage_user_xpath": false          // 内容页用户XPath编辑器
      }
    },
    // 用户配置列表
    "userConfig": [
      {
        "domain": "",               // 域名（必填）
        "enabled": true,            // 是否启用
        "mainPageUrlPatterns": [],  // 主页URL匹配模式
        "subPageUrlPatterns": [],   // 分页URL匹配模式
        "contentPageUrlPatterns": [], // 内容页URL匹配模式
        "shareKeywordsAcrossPages": false,  // 是否在主页和分页页面间共享关键词
        "shareUsernamesAcrossPages": true,  // 是否在主页和分页页面间共享用户名
        "mainAndSubPageKeywords": {   // 主页和分页关键词配置
          "xpath": [],                // XPath规则列表
          "keywords": [],             // 关键词列表
          "regexPatterns": []         // 正则表达式列表
        },
        "mainAndSubPageUserKeywords": {  // 主页和分页用户关键词配置
          "xpath": [],
          "keywords": [],
          "regexPatterns": []
        },
        "contentPageKeywords": {         // 内容页关键词配置
          "xpath": [],
          "keywords": [],
          "regexPatterns": []
        },
        "contentPageUserKeywords": {      // 内容页用户关键词配置
          "xpath": [],
          "keywords": [],
          "regexPatterns": []
        }
      }
    ]
  }

若配置userConfig了，那么domain是必填项。除了domain，其他全部配置项都是可选

以上配置文件即可用于界面中的导入按钮直接导入，也可以在全局配置的配置连接中导入

若想维护自己的屏蔽词列表，可以这样写

{
    "userConfig": [
      {
        "domain": "example.com",               
        "mainAndSubPageKeywords": {   
          "keywords": ["关键词1", "关键词2", "关键词3"],          
        }
      }
    ]
}

自定义新网站

1. URL匹配模式配置

首先需要分析网站的URL结构,并配置相应的URL匹配模式:

• 主页URL匹配: 如论坛根目录是主页,可填写 ^/$
• 内容页URL匹配: 如帖子页面URL格式为 /thread-123456-1.html,可填写 ^/thread.*

配置正确后,界面顶部会显示当前页面类型。

2. XPath选择器配置

XPath选择器用于定位页面元素,分为以下几类:

• 主页/分页标题
• 主页/分页用户名
• 内容页关键词
• 内容页用户名

在页面中右键目标元素,点击"检查"找到对应HTML结构，然后找到他的容器标签

例如有以下HTML代码：

    
....
    
....
    

        

            
标题
            
        
    

我们应该找到 容器标签 ，这里是li，那么他的标题XPath选择器就是 //li//div[@class="title"]/text()

若他的用户名在属性里，那么他的用户名XPath选择器就是 //li//a[@class="user"]/@username

特殊情况 1 : 假设我们的目标文本在属性里，而且有干扰字符，例如：

    
....
    
....
    

        

            
标题
            
        
    

对于这种情况我们的插件自定义了一种新的方法：/split(参数1,参数2,参数3)

• 参数1：分割符，例如空格，逗号，分号等
• 参数2：目标文本的索引，例如1，2，3等，支持负数，-1表示最后一个
• 参数3：目标文本所在属性，例如username

那么他的XPath选择器就是 //li//a[@class="user"]/split(" ",0,username)

特殊情况 2 : 假设容器标签下用多个同名的标签，例如：

    
....
    
....
    

        

            

                

                    
标题