A powerful network filtering solution that combines kernel-level packet inspection with user-friendly controls for managing internet access and content filtering.
- Ad Blocking: Advanced ad filtering at the network level
- Adult Content Filtering: Family-friendly internet browsing
- Domain Management: Easy-to-use interface for managing blocked domains
- Kernel-Level Filtering: High-performance packet inspection
- Real-Time Updates: Instant application of filtering rules
- User-Friendly GUI: Simple interface for managing all features
- Site Block Notifications 🔔:
- Real-time Telegram notifications when sites are blocked
- Detailed blocking events with timestamps
- Linux-based operating system
- Python 3.8 or higher
- GCC compiler
- Make build system
- Root/sudo privileges for kernel module operations
- Clone the repository:
git clone https://github.com/yourusername/My_Internet.git
cd My_Internet
- Run the installation script:
sudo ./scripts/install.sh
- Activate the system:
sudo ./scripts/activate.sh
- The GUI will automatically launch and you can start managing your internet filtering settings.
sudo ./scripts/deactivate.sh
The system consists of three main components:
-
Kernel Module:
- Handles packet inspection
- Implements domain filtering
- Manages DNS request interception
-
Server:
- Manages filtering rules
- Handles domain list updates
- Coordinates between GUI and kernel module
-
Client GUI:
- User interface for system control
- Real-time status updates
- Domain management interface
- Create a virtual environment:
python3 -m venv venv
source venv/bin/activate
- Install development dependencies:
pip install -r requirements.txt
- Install the package in development mode:
pip install -e .
Run the test suite:
pytest tests/
The system can be configured through:
client/config.json
: Client-side settings- Kernel module parameters (see documentation)
- Server configuration files
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature
) - Commit your changes (
git commit -m 'Add some AmazingFeature'
) - Push to the branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Common issues and solutions:
-
Kernel Module Loading Failed
- Ensure you have the correct kernel headers installed
- Check kernel logs:
dmesg | grep Network_Filter
-
GUI Not Starting
- Verify Python dependencies are installed
- Check application logs in
client_logs/
-
Filtering Not Working
- Verify the kernel module is loaded:
lsmod | grep Network_Filter
- Check server status and logs
- Verify the kernel module is loaded:
- The system requires root privileges for kernel module operations
- All network traffic is processed locally
- No data is sent to external servers
This project is licensed under the MIT License - see the LICENSE file for details.
- Linux Kernel Development Community
- Python Networking Libraries Contributors
- Mom and Dad
Made with ❤️ for a safer internet