Title: WP fail2ban Blocklist
Author: invisnet
Published: <strong>2022 年 2 月 27 日</strong>
Last modified: 2025 年 5 月 1 日

---

搜索插件

![](https://ps.w.org/wpf2b-addon-blocklist/assets/banner-772x250.png?rev=2814742)

![](https://ps.w.org/wpf2b-addon-blocklist/assets/icon-256x256.png?rev=2814742)

# WP fail2ban Blocklist

 作者：[invisnet](https://profiles.wordpress.org/invisnet/)

[下载](https://downloads.wordpress.org/plugin/wpf2b-addon-blocklist.2.2.2.zip)

 * [详情](https://cn.wordpress.org/plugins/wpf2b-addon-blocklist/#description)
 * [评价](https://cn.wordpress.org/plugins/wpf2b-addon-blocklist/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/wpf2b-addon-blocklist/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/wpf2b-addon-blocklist/#developers)

 [支持](https://wordpress.org/support/plugin/wpf2b-addon-blocklist/)

## 描述

There are many plugins that use a database to check for malicious IPs **after** 
they connect, and of course `fail2ban` stops _repeated_ attacks, but what if bad
IPs could be blocked **before** they attack?

By working collaboratively – sharing attack data – _WP fail2ban Blocklist_ does 
exactly that.

The Blocklist Network Service (BNS) collects attack data from participating sites,
performs some analytical magic, and sends back a list of IPs that are attacking 
sites now but haven’t yet attacked that site. In other words, each site periodically
gets a unique list of IPs to block **preemptively**.

#### GDPR

The BNS doesn’t collect personal data, and bots don’t have rights.

That said, the BNS only collects the minimum data required (time, IP, event), and
only for IPs that have behaved maliciously.

Of course, it is possible that some data is generated by _people_ behaving maliciously,
but the BNS has no way to differentiate – and nor should it: an attack is an attack.

#### Freemius

To work, the BNS **must** know:

 * which sites are running the blocklist add-on,
 * which version is in use,
 * and a shared secret for secure communication.

Freemius already provides all these, and _WP fail2ban_ already uses Freemius; why
reinvent the wheel?

Therefore, unlike the core _WP fail2ban_ plugin, you _must_ opt into Freemius for
the blocklist to work.

## 屏幕截图

 * [[
 * Dashboard widget

## 安装

 1. Ensure [_WP fail2ban_](https://wordpress.org/plugins/wp-fail2ban/) is installed.**
    N.B.** Requires version **4.4.0** or later.
 2. Install via the Plugin Directory, or upload to your plugins directory.
 3. Activate the plugin through the ‘Plugins’ menu in WordPress.
 4. Opt into Freemius; the Blocklist will not work without without this.
 5. The Blocklist Network Service (BNS) uses the WordPress REST API to communicate.
    If there is another security plugin installed be sure it allows access to the blocklist
    endpoint: `/wp-json/wp-fail2ban/v1/blocklist`
 6. **Important:** ensure you set `maxretry = 1` in your `wordpress‑hard` or `wpf2b‑
    blocklist‑hard` jail; the add-on will not work otherwise.

Details of the configuration steps can be found [here](https://docs.wp-fail2ban.com/projects/wp-fail2ban-blocklist/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=wp-fail2ban-addon-blocklist-2.2.2).

## 评价

![](https://secure.gravatar.com/avatar/6bcc2d95170fd3f3053f630eeefe0b6b6176237f9ed00ea5fa9fcd683068d0e3?
s=60&d=retro&r=g)

### 󠀁[Essential for any WP website](https://wordpress.org/support/topic/essential-for-any-wp-website/)󠁿

 [Attila Bogozi](https://profiles.wordpress.org/waaab/) 2025 年 11 月 6 日

Setup is easy, usage is flawless. I recommend for everyone who is serious about 
WP security.

![](https://secure.gravatar.com/avatar/40202dae6497f7981139494e666627ad827be668871d2c305901e8381fcb517f?
s=60&d=retro&r=g)

### 󠀁[Prevenire e meglio che curare](https://wordpress.org/support/topic/prevenire-e-meglio-che-curare/)󠁿

 [Mac Boris Perc](https://profiles.wordpress.org/percboris/) 2024 年 5 月 27 日

WP fail2ban Blocklist – Superb Wordpress plugin Prevention is better than cure.

 [ 阅读所有1条评价 ](https://wordpress.org/support/plugin/wpf2b-addon-blocklist/reviews/)

## 贡献者及开发者

「WP fail2ban Blocklist」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ invisnet ](https://profiles.wordpress.org/invisnet/)

[帮助将「WP fail2ban Blocklist」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/wpf2b-addon-blocklist)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/wpf2b-addon-blocklist/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/wpf2b-addon-blocklist/)，或通过[RSS](https://plugins.trac.wordpress.org/log/wpf2b-addon-blocklist/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/wpf2b-addon-blocklist/)。

## 更新日志

#### 2.2.2

 * Fix issue with parsing jails which use journald.
 * Fix harmless warning with PHP 8.3.
 * Fix documentation links in Site Health checks.

#### 2.2.1

 * Fix issue with opting into Freemius (h/t @Nyanchovy).
 * Fix Site Health passing test reported as failing (h/t @Patmos).
 * Improve debug code.

#### 2.2.0

 * Add [`WP_FAIL2BAN_ADDON_BLOCKLIST_DEBUG`](https://docs.wp-fail2ban.com/projects/wp-fail2ban-blocklist/en/2.2/defines/constants/WP_FAIL2BAN_ADDON_BLOCKLIST_DEBUG.html?utm_source=wordpress.org&utm_medium=readme&utm_campaign=wp-fail2ban-addon-blocklist-2.2.2).
 * Add [`WP_FAIL2BAN_ADDON_BLOCKLIST_DEBUG_TRY_ALL_KEYS`](https://docs.wp-fail2ban.com/projects/wp-fail2ban-blocklist/en/2.2/defines/constants/WP_FAIL2BAN_ADDON_BLOCKLIST_DEBUG_TRY_ALL_KEYS.html?utm_source=wordpress.org&utm_medium=readme&utm_campaign=wp-fail2ban-addon-blocklist-2.2.2).
 * Improve i18n.

#### 2.1.1

 * Fix harmless warning with PHP 8.1.
 * Compatibility changes for upcoming `WPf2b` release.

#### 2.1.0

 * Add Site Health checks.
 * Fix REST authentication issue (CORS headers) with some web servers.

#### 2.0.1

 * Fix harmless warning in dashboard widget; appears only before first polling.
 * Fix REST authentication when both free and premium installed.
 * Fix help links.

#### 2.0.0

 * **IPv6 support.** (Requires WP fail2ban 5.0 or later).
 * Change filter filenames to start with `wpf2b-` instead of `wordpress-`.
 * Add queue info to admin dashboard widget.

#### 1.1.2

 * Add mouseover hints to dashboard widget.
 * Improve secret key lookup.

#### 1.1.1

 * Fix bug with secret key lookup.

#### 1.1.0

 * Add event queue info to dashboard widget.
 * Increase maximum queue to 16384 events.
 * Fix bug handling too many events.

#### 1.0.2

 * Minor bug-fix.

#### 1.0.1

 * Minor bug-fix.

#### 1.0.0

 * First WordPress directory release.

## 额外信息

 *  版本 **2.2.2**
 *  最后更新：**1 年前**
 *  活跃安装数量 **4,000+**
 *  WordPress 版本 ** 4.9 或更高版本 **
 *  已测试的最高版本为 **6.8.5**
 *  PHP 版本 ** 7.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/wpf2b-addon-blocklist/)
 * 标签
 * [blocklist](https://cn.wordpress.org/plugins/tags/blocklist/)[fail2ban](https://cn.wordpress.org/plugins/tags/fail2ban/)
   [security](https://cn.wordpress.org/plugins/tags/security/)
 *  [高级视图](https://cn.wordpress.org/plugins/wpf2b-addon-blocklist/advanced/)

## 评级

 5 星（最高 5 星）。

 *  [  2 条 5 星评价     ](https://wordpress.org/support/plugin/wpf2b-addon-blocklist/reviews/?filter=5)
 *  [  0 条 4 星评价     ](https://wordpress.org/support/plugin/wpf2b-addon-blocklist/reviews/?filter=4)
 *  [  0 条 3 星评价     ](https://wordpress.org/support/plugin/wpf2b-addon-blocklist/reviews/?filter=3)
 *  [  0 条 2 星评价     ](https://wordpress.org/support/plugin/wpf2b-addon-blocklist/reviews/?filter=2)
 *  [  0 条 1 星评价     ](https://wordpress.org/support/plugin/wpf2b-addon-blocklist/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/wpf2b-addon-blocklist/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/wpf2b-addon-blocklist/reviews/)

## 贡献者

 *   [ invisnet ](https://profiles.wordpress.org/invisnet/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/wpf2b-addon-blocklist/)