Format_C/pivilion
1
0
Fork 0
mirror of https://gitlab.com/hacklab01/pivilion.git synced 2025-04-29 16:47:17 +00:00
Code Issues Projects Releases Wiki Activity

Delete tutorial / moved to WIKI

Browse Source
This commit is contained in:
v3d 2016-11-25 14:05:40 +00:00
parent 61a7811342
commit f7a1d07f21
1 changed files with 0 additions and 116 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

116
docs/tutorial
View File

@ -1,116 +0,0 @@
Pivilion manual setup
You can chose to download one of our pre-installed images or follow this guide to install Pivilion on your Raspberry Pi from scratch and use it as a portable darknet gallery. It installs Tor with Lighttpd as a hidden service and runs a simple php based gallery system. Tor is free software for enabling anonymous communication and censorship circumvention. However, Pivilion doesn't use Tor for its anonimity features. Tor is used to host a HTTP server as a hidden service. We make extensive use of its NAT punching capabilites to enable us to host a gallery behind NATs and firewalls. Keep in mind that this may or may not be legal in your country.
Checklist
Raspbian image
https://www.raspberrypi.org/downloads/raspbian/
Tor Browser
https://www.torproject.org/download/download-easy.html.en
Windows only
Putty SSH client
http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
First we need to put a fresh Rasbpian image on our RPi's SD card.
You can use either the full or the lite image, it’s up to you.
Rpi installing images
https://www.raspberrypi.org/documentation/installation/installing-images/README.md
Choose your system. We’ll be using Linux + dd.
Once that’s done, connect your RPi to a DHCP network with an ethernet cable and power it on.
Depending on your network configuration, you can login to your RPi using it's hostname "raspberry", or use a network discovery tool to find it's IP address.
We will use nmap to scan our DHCP IP range for all hosts that are up. Replace 10.0.0.1/24 with your IP address range. You can also check you router's settings to see all devices connected to your network and their IPs.
nmap 10.0.0.1/24
Login to your pi using SSH with username: pi password: raspberry.
Upgrade your system.
sudo apt-get update && sudo apt-get upgrade
Expand your filesystem.
sudo raspi-config (select the first option from the menu).
Reboot.
Check used and available storage with
df -h
Install Lighttpd. Kighttpd (pronounced "lighty") is an open-source web server optimized for speed-critical environments while remaining standards-compliant, secure and flexible.
sudo apt-get install lighttpd
You can now navigate to your Rpi's IP (or hostname - raspberry) using a browser.
You will see lighttpd's placeholder page.
Install php-gd.
sudo apt-get install php5-gd
Apt will install all required dependencies.
Install Tor.
sudo apt-get install tor
Next, we install Git. Git is needed so we can clone the scripts and settings we need to run Pivilion.
Install hostapd. Hostapd (Host access point daemon) is a user space software access point capable of turning normal network interface cards into access points and authentication servers. We use it, in conjuction with dnsmaq, to turn the Rpi into an access point.
sudo apt-get install hostapd
Install dnsmasq. Dnsmasq is a Domain Name System (DNS) forwarder and Dynamic Host Configuration Protocol (DHCP) server for small computer networks. We use it to provide the clients connected to our access point with IP addresses.
sudo apt-get install dnsmaq
Install git
sudo apt-get install git. Git (/ɡɪt/) is a version control system (VCS) that is used for software development and other version control tasks. We use it synchronise
You can now chose to either pull the Pivilion scripts and Tor / Rpi configuration (if so skip to here) from our Gitlab or make the next step manually and make your own Tor hidden service without Pivilion.
Uncomment RunAsDeamon 1
In the section intended for hidden services only, uncomment the two lines
HiddenServiceDir /var/lib/tor/hidden_service
HiddenServicePort 80 127.0.0.1:80
In order to setup additional services, simply add their port's to this list, followed by your localhost IP (always 127.0.0.1). Eg. for SSH via Tor we would add
HiddenServicePort 22 127.0.0.1:22
Note that hidden service ports don't need to be the same as their local ports. It is reccomended to run services on high ports (1024-65535) for (not much) added security. The port for the http service is left at the default port 80, because otherwise we need to input the port in the URL, i.e. 7j4kxhmso6yhz2df.onion:1337 tp access the website on port 1337.
Now restart tor
sudo systemctl restart tor
Tor will generate a hostname. to view your hostname run
sudo cat /var/lib/tor/hostname/hidden_service/hostname
Will output your onion domain.
Check if your hidden service works by opening Tor Browser and navigating to your onion domain.
You should see the same lighttpd placeholder page as before.
Cloning Pivilion settings and scripts via Git
Our script assumes that your user is named pi. It will create direcotries in pi's home dir (/home/pi) and use scripts that reference that directory.