Outline Server
- 0 ratings
A proxy server that runs a Shadowsocks instance for each access key and a REST API to manage the access keys.
Deploy this app to Linode with a free $100 credit!
This repository has all the code needed to create and manage Outline servers on DigitalOcean. An Outline server runs instances of Shadowsocks proxies and provides an API used by the Outline Manager application.
Go to https://getoutline.org for ready-to-use versions of the software. To join our Outline Community, sign up for the IFF Mattermost.
The system comprises the following components:
See src/shadowbox
In order to build and run the code, you need the following installed:
lts/gallium, version 16.13.0)8.1.0)💡 NOTE: if you have
nvminstalled, runnvm useto switch to the correct node version!
Install dependencies with:
npm installThis project uses NPM workspaces.
We have a very simple build system based on package.json scripts that are called using npm run
and a thin wrapper for what we call build "actions".
We've defined a package.json script called action whose parameter is a relative path:
npm run action $ACTIONThis command will define a run_action() function and call ${ACTION}.action.sh, which must exist.
The called action script can use run_action to call its dependencies. The $ACTION parameter is
always resolved from the project root, regardless of the caller location.
The idea of run_action is to keep the build logic next to where the relevant code is.
It also defines two environmental variables:
⚠️ To find all the actions in this project, run
npm run action:list
Building creates the following directories under build/:
web_app/: The Manager web app.static/: The standalone web app static files. This is what one deploys to a web server or runs with Electron.electron_app/: The launcher desktop Electron appstatic/: The Manager Electron app to run with the electron command-linebundled/: The Electron app bundled to run standalone on each platformpackaged/: The Electron app bundles packaged as single files for distributioninvite_page: the Invite Pagestatic: The standalone static files to be deployedshadowbox: The Proxy ServerThe directories have subdirectories for intermediate output:
ts/: Autogenerated Typescript filesjs/: The output from compiling Typescript codebrowserified/: The output of browserifying the JavaScript codeTo clean up:
npm run cleanShadowsocks used to be blocked in some countries, and because Outline uses Shadowsocks, there has been skepticism about Outline working in those countries. In fact, people have tried Outline in the past and had their servers blocked.
However, since the second half of 2020 things have changed. The Outline team and Shadowsocks community made a number of improvements that strengthened Shadowsocks beyond the censor's current capabilities.
As shown in the research How China Detects and Blocks Shadowsocks, the censor uses active probing to detect Shadowsocks servers. The probing may be triggered by packet sniffing, but that's not how the servers are detected.
Even though Shadowsocks is a standard, it leaves a lot of room for choices on how it's implemented and deployed.
First of all, you must use AEAD ciphers. The old stream ciphers are easy to break and manipulate, exposing you to simple detection and decryption attacks. Outline has banned all stream ciphers, since people copy old examples to set up their servers. The Outline Manager goes further and picks the cipher for you, since users don't usually know how to choose a cipher, and it generates a long random secret, so you are not vulnerable to dictionary-based attacks.
Second, you need probing resistance. Both shadowsocks-libev and Outline have added that. The research Detecting Probe-resistant Proxies showed that, in the past, an invalid byte would trigger different behaviors whether it was inserted in positions 49, 50 or 51 of the stream, which is very telling. That behavior is now gone, and the censor can no longer rely on that.
Third, you need protection against replayed data. Both shadowsocks-libev and Outline have added such protection, which you may need to enable explicitly on ss-libev, but it's the default on Outline.
Fourth, Outline and clients using shadowsocks-libev now merge the SOCKS address and the initial data in the same initial encrypted frame, making the size of the first packet variable. Before the first packet only had the SOCKS address, with a fixed size, and that was a giveaway.
The censors used to block Shadowsocks, but Shadowsocks has evolved, and in 2021, it was ahead again in the cat and mouse game.
In 2022 China started blocking seemingly random traffic (report). While there is no evidence they could detect Shadowsocks, the protocol ended up blocked.
As a reponse, we added a feature to the Outline Client that allows service managers to specify in the access key a prefix to be used in the Shadowsocks initialization, which can be used to bypass the blocking in China.
Shadowsocks remains our protocol of choice because it's simple, well understood and very performant. Furthermore, it has an enthusiastic community of very smart people behind it.
Please login to review this project.
No reviews for this project yet.
Comments (0)
Please login to join the discussion on this project.