102 lines
2.6 KiB
Markdown
102 lines
2.6 KiB
Markdown
# Byparr - Cloudflare & Anti-Bot Bypass
|
|
|
|
Byparr is a self-hosted service that helps bypass anti-bot challenges and Cloudflare protection, making it easier for your *arr stack (Prowlarr, Radarr, Sonarr) to access indexers and trackers.
|
|
|
|
## Service Information
|
|
|
|
- **Image**: `ghcr.io/thephaseless/byparr:latest`
|
|
- **Port**: 8191
|
|
- **API Docs**: http://localhost:8191/docs
|
|
|
|
## Configuration
|
|
|
|
### Basic Setup
|
|
|
|
The service is configured with default settings and exposed on port 8191. It's connected to the heimdall_core_homelab network for access by other services.
|
|
|
|
### Environment Variables
|
|
|
|
- `HOST`: Bind address (default: 0.0.0.0)
|
|
- `PORT`: Service port (default: 8191)
|
|
- `PROXY_SERVER`: Optional proxy in format `protocol://host:port`
|
|
- `PROXY_USERNAME`: Optional proxy username
|
|
- `PROXY_PASSWORD`: Optional proxy password
|
|
|
|
## Integration with *arr Apps
|
|
|
|
To use Byparr with Prowlarr, Radarr, Sonarr, etc.:
|
|
|
|
1. In the *arr app, go to Settings → Indexers
|
|
2. When adding/editing an indexer that requires Cloudflare bypass:
|
|
- Look for "FlareSolverr" or similar bypass options
|
|
- Set the FlareSolverr URL to: `http://byparr:8191`
|
|
3. Save and test the indexer
|
|
|
|
### Prowlarr Configuration
|
|
|
|
1. Settings → Indexers → Add Indexer
|
|
2. Select an indexer (e.g., 1337x, EZTV, etc.)
|
|
3. In the indexer settings:
|
|
- Enable "Use FlareSolverr"
|
|
- FlareSolverr URL: `http://byparr:8191`
|
|
|
|
### Testing
|
|
|
|
Visit http://heimdall-ip:8191/docs to access the API documentation and test the service.
|
|
|
|
## Deployment
|
|
|
|
```bash
|
|
cd /path/to/homelab/nodes/heimdall/byparr
|
|
docker compose up -d
|
|
```
|
|
|
|
## Monitoring
|
|
|
|
Check logs:
|
|
```bash
|
|
docker compose logs -f byparr
|
|
```
|
|
|
|
Check status:
|
|
```bash
|
|
docker compose ps
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### Service Not Working
|
|
|
|
1. Check if the container is running:
|
|
```bash
|
|
docker compose ps
|
|
```
|
|
|
|
2. View logs for errors:
|
|
```bash
|
|
docker compose logs byparr
|
|
```
|
|
|
|
3. Test the API directly:
|
|
```bash
|
|
curl http://localhost:8191/docs
|
|
```
|
|
|
|
### *arr Apps Can't Connect
|
|
|
|
- Ensure Byparr and the *arr apps are on the same Docker network (heimdall_core_homelab)
|
|
- Use `http://byparr:8191` (container name) not `localhost:8191`
|
|
- Check if the FlareSolverr option is enabled in the indexer settings
|
|
|
|
### Challenges Still Not Bypassed
|
|
|
|
- This tool increases chances but doesn't guarantee bypass
|
|
- Some sites may require additional network-level traffic validation
|
|
- Consider configuring a proxy if available (see environment variables)
|
|
|
|
## Links
|
|
|
|
- [GitHub Repository](https://github.com/ThePhaseless/Byparr)
|
|
- [Docker Image](https://ghcr.io/thephaseless/byparr)
|
|
- [API Documentation](http://localhost:8191/docs)
|