Install Shadowsocks on Raspbian and Setup a Raspberry Pi Proxy Server

This tutorial will show you how to install the command line client of Shadowsocks on Raspbian OS and setup a proxy server on Raspberry Pi. After that you need to setup other computers in your local ntwork to use the shadowsock client so that they can bypass Internet filters. I assume you have configured a shadowsocks server.

Install Shadowsocks Command Line Client on Raspbian

SSH into your Raspberry Pi and update local package index.

sudo apt-get update

Install shadowsocks command line client.

sudo apt-get install python-pip
sudo pip install shadowsocks

The above commands will install the python version of Shadowsocks.

Create a Configuration File

Create a configuration file under /etc/ directoy.

sudo nano /etc/shadowsocks.json

Put the following text in the file. Replace server-ip with the actual IP address of your shadowsocks server and set a password. Set the value of local_address to the IP address of Raspberry Pi. This is important. For example, I set this value to because is the IP address of my RPi.

"local_address": "the-ip-address-of-RPi",

Save and close the file. Then run shadowsocks command line client in the background.

sudo sslocal -c /etc/shadowsocks.json -d start

To see if it’s running, enter this command:

ps aux | grep sslocal

Auto Start the Client on System Boot

Edit /etc/rc.local file

sudo nano /etc/rc.local

Put the following line above the exit 0.

sslocal -c /etc/shadowsocks.json -d start

Then save and close the file.

Setup Computers in Your Local Network

If you are using Firefox on a computer a your local network, then you don’t have to install anything on your computer to bypass Internet filter. just open Firefox and go to preference > advanced > network > settings. This will open the proxy configuration window of Firefox.

firefox proxy configuration

In this window, check Manual proxy configuration. Then enter the IP address of your RPi and port number in the Socks Host field. Check SOCKS v5 and Remote DNS. Save your settings and now you can use the shadowsock client installed on RPi to bypass Internet filters.

If you are using Google Chrome browser, you need to install an extension called SwitchyOmega and then you will be able to configure proxy for Google Chrome.

configure proxy for Google Chrome using SwitchyOmega

One little advice is that you assign a fixed IP address for Raspberry Pi in your router.

Rate this tutorial
[Total: 20 Average: 3.8]

Leave a Comment

  • Comments with links are moderated by admin before published.
  • Your email address will not be published.
  • Use <pre> ... </pre> HTML tag to quote the output from your terminal/console.
  • Please use the community ( for questions unrelated to this article.
  • I don't have time to answer every question. Making a donation would incentivize me to spend more time answering questions.

The maximum upload file size: 2 MB.
You can upload: image.