DEV Community


Posted on • Originally published at

Create a proxy with a Raspberry Pi 3 (or above)

Original article :

If you need to use a proxy that has the same IP address as your home, here is a tutorial on how to do it.

Install and configure your Raspberry Pi OS

Install and configure a raspberry pi without a mouse nor a keyboard :

  1. Download the last version of raspbian lite here and download Etcher which we will use to flash the disk image on the SD card.
  2. Start Elena, select the Raspbian Lite imake disk, select the target which is the SD card you use for your raspberry pi and click on Flash!.

While the image disk is getting installed, we will create the file that contains the wifi information so the raspberry can connect to it automatically. Open a text note and paste this inside :


Enter fullscreen mode Exit fullscreen mode

Replace internet_box_name and password by your home internet box settings and save that file underwpa_supplicant.conf

Then we will create an empty file which name is simply ssh. This file will tell the raspberry that you want to enable the SSH connection which is usually set off by default. With that settings on we will be able to connect to the raspberry pi through the network using another computer.

Place both files that you just created in the BOOT folder of the SD card you just flashed.

Congratulation ! Now you can eject the SD card and insert it in your raspberry pi.

If everything worked out, when you switch on your Raspberry Pi you should see it in the list of the device connected to your home internet network by checking your router.

Now the next step is to connect to your Raspberry Pi with SSH. Launch a terminal and if you are on mac type this command :

ssh pi@local_ip_of_your_raspberry

It will ask for a password, type raspberry

To avoid that IP to change, we will set a static IP to your raspberry. You need to modify the file dhcpd.conf located in the folder /etc/.

Once you have opened the file, go to the last line and add this content

interface eth0
static ip_address=
static routers=
static domain_name_servers=

interface wlan0
static ip_address=
static routers=
static domain_name_servers=
Enter fullscreen mode Exit fullscreen mode

Here, the eth0 correspond to a internet cable connection, and wlan0 to a internet wifi connection. Up to you to choose which one you will use.

Static ip_address indicate the IP that your Raspberry Pi will have when it switch on. usually the IP is of the type 192.168.1.x, replace the x by an available slot on your network. If your box is on a different IP address then modify static router et static domain_name_servers accordingly.

Save the file and exit.

Setting up the raspberry pi

1) Update the raspberry pi

sudo apt-get update
sudo apt-get upgrade
sudo apt-get dist-upgrade
Enter fullscreen mode Exit fullscreen mode

2) Install terminal editor Joe

sudo apt-get install joe
Enter fullscreen mode Exit fullscreen mode

3) Install the following

sudo apt-get -y install fail2ban software-properties-common
sudo apt-get install build-essential libevent-dev libssl-dev
cd /etc
sudo wget
sudo tar zxvf 0.8.12.tar.gz
sudo mv 3proxy-0.8.12 3proxy
cd 3proxy
Enter fullscreen mode Exit fullscreen mode

4) Edit the file proxy.h

sudo joe src/proxy.h
Enter fullscreen mode Exit fullscreen mode

And add the line following line above the other lines starting with #DEFINE

#define ANONYMOUS 1
Enter fullscreen mode Exit fullscreen mode

5) Compile and install the software

sudo make -f Makefile.Linux
sudo make -f Makefile.Linux install
Enter fullscreen mode Exit fullscreen mode

6) Download 3proxy.cfg

sudo wget
Enter fullscreen mode Exit fullscreen mode

7) Edit the 3proxy.cfg with Joe

sudo joe 3proxy.cfg
Enter fullscreen mode Exit fullscreen mode

8) Change those lines

users root:CL:passwd
allow root
Enter fullscreen mode Exit fullscreen mode

To any username you prefer instead of root and change the passwd to a strong password. If you changed root to a different username don't forget to change allow root to allow and whatever username you decided. Save that file when you are finished

9) Change file permission

sudo chmod 700 3proxy.cfg
Enter fullscreen mode Exit fullscreen mode

10) Download the script file

cd /etc/3proxy/scripts/rc.d/
sudo mv
sudo wget
Enter fullscreen mode Exit fullscreen mode

11) Start the proxy server

sudo sh /etc/3proxy/scripts/rc.d/ start
Enter fullscreen mode Exit fullscreen mode

It should give the output “Starting 3Proxy”. If it doesn’t then there is a problem somewhere in your config files.

12) Add it to the autorun so after reboot it will start again

sudo joe /etc/rc.local
Enter fullscreen mode Exit fullscreen mode

And add line :

sh /etc/3proxy/scripts/rc.d/ start
Enter fullscreen mode Exit fullscreen mode

This line has to be added above the line exit 0.

The best way to check if everything is alright is by doing a full reboot of your Raspberry and checking if everything still works after the reboot :

sudo shutdown -r now
Enter fullscreen mode Exit fullscreen mode

Access your Raspberry Pi with SSH outside your home local network

You will need to add the fixed IP you choose for your Raspberry Pi in your internet box router settings. Add this IP address in the DHCP settings (the aim of this tutorial is not to each how to do that so look ressources on google).

Now edit your NAT/PAT settings to redirect the port 22 (SSH) and 3129 (your proxy) to the fixed IP address you just set up in the DHCP.

Now to access your home internet network from outside, you need a way to now its public IP address which might change over time. We will use a very good services to achieve that is called no-ip.

  1. Register on
  2. Create a hostname like « »
  3. Install the DUC on your raspberry pi which will automatically update the public IP no-ip will redirect the hostname to :

    cd /usr/local/src/
    sudo wget
    sudo tar xf noip-duc-linux.tar.gz
    cd noip-2.1.9-1
    sudo make install
  4. Then a little bit of configuration

    sudo cp /usr/local/src/noip-2.1.9-1/ /etc/init.d/
    sudo joe /etc/init.d/
  5. And add the following code abose this line DAEMON=/usr/local/bin/noip2:

    # Provides:
    # Required-Start:    $remote_fs $local_fs
    # Required-Stop:     $remote_fs $local_fs
    # Should-Start:
    # Should-Stop:
    # Default-Start:     2 3 4 5
    # Default-Stop:      0 1 6
    # Short-Description: Dynamic IP client updater
    # Description:

    Now the client can be started, stopped or restarted manually

    sudo /etc/init.d/ <start|stop|restart>
  6. Change files read write properties :

    sudo chown root.root /etc/init.d/
    sudo chmod +x /etc/init.d/
  7. Start the server

    sudo /etc/init.d/ start
  8. To allow starting the service automatically at startup, run the following command:

    sudo update-rc.d defaults
  9. Then try sudo reboot to see if service start by itself

    To check if there is a running instance use this command :

    sudo noip2 -S

Finish ! Now you should be able to connect to your proxy with the hostname address you used in no-ip and the port 3129 like this ''. The authorized username and password to connect to the proxy are the one you decided previously in the step 8 of configuring the proxy.

Useful Commands

  • If you need to reconfigure the DUC file from no-ip use that command : sudo /usr/local/bin/noip2 -C
  • Connect to the raspberry pi by SSH with Terminal (Mac) : ssh pi@ip Then yes, and type password
  • Check if there is a no-ip instance running sudo noip2 -S
  • Check if proxy is running ps -A

Top comments (0)