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

PirateBox app for YunoHost (based on php-piratebox)

License

Notifications You must be signed in to change notification settings

labriqueinternet/piratebox_ynh

Repository files navigation

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

About

PirateBox app for YunoHost (based on php-piratebox)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published