Skip to content
This repository has been archived by the owner on Jan 19, 2021. It is now read-only.

Latest commit

 

History

History
41 lines (28 loc) · 2.01 KB

README.md

File metadata and controls

41 lines (28 loc) · 2.01 KB

PirateBox

Overview

PirateBox app for YunoHost.

Based on php-piratebox.

Features

The YunoHost administration is only available through the wired connection.

How It Works

Explanations:

  1. all packets to port 53 are redirected to the port 4253,
  2. a fake DNS resolver listens on the port 4253, and systematically responds the IPv4 address of the server (a fake DNS resolver is mandatory for responding to any requests, without internet connection),
  3. a MASQUERADE rule allows the fake DNS to respond in place of the initially requested resolver,
  4. all packets to port 80 are redirected to the port 4280,
  5. a Nginx vhost listens on the port 4280, and redirects to the PirateBox web page.

Prerequisites

Limitations

  • IPv4-only because the NAT table is not available for IPv6 before the kernel 3.9.0 and iptables 1.4.18 (not in Debian stable for now)
  • Don't redirect to the PirateBox web page with explicit HTTPS requests (in order to avoid offering self-signed certificates on well-known domains)

BUG REPORTS SHOULD BE OPEN HERE