Home

nginx-torblocker Wiki

Welcome to the nginx-torblocker documentation wiki! This collection of articles provides comprehensive guides for installing, configuring, and using the nginx-torblocker module.

Quick Navigation

Getting Started

• Installation Guide - Complete step-by-step installation process
• Basic Configuration - Simple setup to get started quickly
• Module Loading - How to properly load the module in Nginx

Configuration Guides

• Configuration Reference - Complete directive documentation
• Context Hierarchy - Understanding http/server/location contexts
• Advanced Configuration - Complex scenarios and edge cases

Real-World Examples

• Server-Wide Blocking - Block Tor access to entire server
• Site-Specific Blocking - Block specific virtual hosts only
• Path-Based Blocking - Block specific URLs/paths only
• Mixed Policies - Combining different blocking strategies

Troubleshooting & Maintenance

• Troubleshooting Guide - Common issues and solutions
• Performance Tuning - Optimizing module performance
• Monitoring & Logging - Tracking blocked requests

Development & Contributing

• Building from Source - Detailed build instructions
• Development Setup - Setting up development environment
• Testing Procedures - How to test your changes

Module Overview

The nginx-torblocker module is a dynamic Nginx module that automatically blocks access from Tor exit nodes. Key features include:

• Automatic Updates: Fetches fresh Tor exit node lists regularly
• Granular Control: Configure blocking at HTTP, server, or location level
• Selective Access: Allow Tor for public content while blocking sensitive areas
• Multi-Site Support: Different policies for different virtual hosts
• Performance Focused: Minimal impact on request processing

Quick Start

For immediate results:

1. Install: Follow the Installation Guide
2. Configure: Add torblock on; to your nginx.conf
3. Test: Restart Nginx and verify module loading
4. Monitor: Check logs for blocked requests

Project Background

This module is inspired by the original AntiTor PHP script developed over 20 years ago. The nginx-torblocker brings this concept into the modern era with native Nginx performance and sophisticated access control policies.

Getting Help

• Issues: Report bugs on GitHub Issues
• Discussions: Join conversations on GitHub Discussions
• Security: See Security Policy for vulnerability reporting
• Contributing: Read Contributing Guide to get involved