PirateBox app for YunoHost (based on php-piratebox)
PHP Shell CSS JavaScript Other
Switch branches/tags
Nothing to show
Clone or download
Latest commit 19029e9 Aug 30, 2017
Permalink
Failed to load latest commit information.
conf
scripts
sources
LICENSE
README.md point to dev.yunohost.org in README Nov 28, 2015
manifest.json
screenshot_admin.png Update admin screenshot Jul 25, 2015
screenshot_app.png

README.md

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