From 1951272effbf57deb2901a08acba4883f76c9d05 Mon Sep 17 00:00:00 2001 From: Quentin McGaw Date: Thu, 24 Sep 2020 22:11:38 -0400 Subject: [PATCH] Servers section --- Home.md | 1 + Servers/Cyberghost.md | 107 ++++++++++++++++++++++++++++ Servers/Surfshark.md | 159 ++++++++++++++++++++++++++++++++++++++++++ Servers/Updating.md | 37 ++++++++++ 4 files changed, 304 insertions(+) create mode 100644 Servers/Cyberghost.md create mode 100644 Servers/Surfshark.md create mode 100644 Servers/Updating.md diff --git a/Home.md b/Home.md index 7d40972..65dad1d 100644 --- a/Home.md +++ b/Home.md @@ -2,5 +2,6 @@ 1. [Setup](Setup) 1. [FAQ](FAQ) +1. [Servers](Servers) 1. [HTTP Control server](HTTP-Control-server) 1. [Contributing](Contributing) diff --git a/Servers/Cyberghost.md b/Servers/Cyberghost.md new file mode 100644 index 0000000..adb63ec --- /dev/null +++ b/Servers/Cyberghost.md @@ -0,0 +1,107 @@ +## Server groups + +The following server groups are available to be set for the environment variable `CYBERGHOST_GROUP`: + +- NoSpy TCP Europe +- NoSpy UDP Europe +- Premium TCP Asia +- Premium TCP Europe +- Premium TCP USA +- Premium UDP Asia +- Premium UDP Europe +- Premium UDP USA + +## Regions + +The following region names can be set with the `REGION` environment variable. Note that some regions are available under multiple server groups or under a single server group. + +- Albania +- Algeria +- Andorra +- Argentina +- Armenia +- Australia +- Austria +- Bahamas +- Bangladesh +- Belarus +- Belgium +- Bosnia and Herzegovina +- Brazil +- Bulgaria +- Cambodia +- Canada +- Chile +- China +- Colombia +- Costa Rica +- Cyprus +- Czech Republic +- Denmark +- Egypt +- Estonia +- Finland +- France +- Georgia +- Germany +- Greece +- Greenland +- Hong Kong +- Hungary +- Iceland +- India +- Indonesia +- Iran +- Ireland +- Isle of Man +- Israel +- Italy +- Japan +- Kazakhstan +- Kenya +- Korea +- Latvia +- Liechtenstein +- Lithuania +- Luxembourg +- Macao +- Macedonia +- Malaysia +- Malta +- Mexico +- Moldova +- Monaco +- Mongolia +- Montenegro +- Morocco +- Netherlands +- New Zealand +- Nigeria +- Norway +- Pakistan +- Panama +- Philippines +- Poland +- Portugal +- Qatar +- Romania +- Russian Federation +- Saudi Arabia +- Serbia +- Singapore +- Slovakia +- Slovenia +- South Africa +- Spain +- Sri Lanka +- Sweden +- Switzerland +- Taiwan +- Thailand +- Turkey +- Ukraine +- United Arab Emirates +- United Kingdom +- United States +- Venezuela +- Vietnam diff --git a/Servers/Surfshark.md b/Servers/Surfshark.md new file mode 100644 index 0000000..49a7be9 --- /dev/null +++ b/Servers/Surfshark.md @@ -0,0 +1,159 @@ +# Surfshark + +## Regions available + +- Albania +- Australia Adelaide +- Australia Brisbane +- Australia Melbourne +- Australia Perth +- Australia Sydney +- Austria +- Azerbaijan +- Belgium +- Bosnia and Herzegovina +- Brazil +- Bulgaria +- Canada Montreal +- Canada Toronto +- Canada Vancouver +- Chile +- Colombia +- Costa Rica +- Croatia +- Cyprus +- Czech Republic +- Denmark +- Estonia +- Finland +- France Bordeaux +- France Marseilles +- France Paris +- Germany Berlin +- Germany Frankfurt am Main st001 +- Germany Frankfurt am Main st002 +- Germany Frankfurt am Main st003 +- Germany Frankfurt am Main +- Germany Munich +- Germany Nuremberg +- Greece +- Hong Kong +- Hungary +- Iceland +- India Chennai +- India Indore +- India Mumbai +- Indonesia +- Ireland +- Israel +- Italy Milan +- Japan Tokyo st001 +- Japan Tokyo st002 +- Japan Tokyo st003 +- Japan Tokyo st004 +- Japan Tokyo st005 +- Japan Tokyo st006 +- Japan Tokyo st007 +- Japan Tokyo +- Kazakhstan +- Korea +- Latvia +- Luxembourg +- Libya +- Malaysia +- Moldova +- Netherlands Amsterdam st001 +- Netherlands Amsterdam +- New Zealand +- Nigeria +- North Macedonia +- Norway +- Paraguay +- Philippines +- Poland Gdansk +- Poland Warsaw +- Portugal Lisbon +- Portugal Loule +- Portugal Porto +- Romania +- Russia Moscow +- Russia St. Petersburg +- Serbia +- Singapore st001 +- Singapore st002 +- Singapore st003 +- Singapore st004 +- Singapore +- Slovekia +- Slovenia +- South Africa +- Spain Barcelona +- Spain Madrid +- Spain Valencia +- Sweden +- Switzerland +- Taiwan +- Thailand +- Turkey +- UK Glasgow +- UK London st001 +- UK London st002 +- UK London st003 +- UK London st004 +- UK London st005 +- UK London +- UK Manchester +- US Atlanta +- US Bend +- US Boston +- US Buffalo +- US Charlotte +- US Chicago +- US Dallas +- US Denver +- US Gahanna +- US Houston +- US Kansas City +- US Las Vegas +- US Latham +- US Los Angeles +- US Maryland +- US Miami +- US New York City mp001 +- US New York City st001 +- US New York City st002 +- US New York City st003 +- US New York City st004 +- US New York City st005 +- US New York City +- US Orlando +- US Phoenix +- US Saint Louis +- US Salt Lake City +- US San Francisco +- US Seatle +- US Tampa +- Ukraine +- United Arab Emirates +- Vietnam +- Italy Rome + +Note 1: the container uses information extracted from [openvpn files downloaded from Surfshark](https://account.surfshark.com/api/v1/server/configurations), so there is more regions available than from the website. +Note 2: Regions with `st00x` suffixes means they have a corresponding single static IP address. You might want to use these if you want to always have the same IP address. + +## Multi hop regions + +Simply set the `REGION` environment variable using one of the following: + +- Australia US +- Canada US +- Germany Singapour +- Germany UK +- France Sweden +- India UK +- Netherlands US +- Singapore Hong Kong +- UK Germany +- UK France +- US Netherlands +- US Portugal diff --git a/Servers/Updating.md b/Servers/Updating.md new file mode 100644 index 0000000..773d998 --- /dev/null +++ b/Servers/Updating.md @@ -0,0 +1,37 @@ +# Updating + +## Pre-requisites + +- Use Docker images `latest` or superior to release tag `v3.2.0` +- Bind mount the directory `/gluetun` of the container as this is where persistent server information is stored (in /gluetun/servers.json). For example you can use `-v /yourpath:/gluetun` in a `docker run` command. + +## Update mechanism + +The update mechanism works for all VPN service providers, and merges information built in the program of the Docker image with the information persisted in your `/gluetun/servers.json` file. For each provider, it takes the most recent information and discards the older one. That way you can either pull the Docker image or update the servers information yourself. + +## Periodic update + +The best way is to set the environment variable `UPDATE_PERIOD=24h` for example, which is disabled by default. This means every 24 hours, after the tunnel is ready, the container will update all the servers information for all service providers. + +⚠️ This does *a lot* of DNS requests (especially for Cyberghost and Windscribe) + +💁 This will be changed to update the servers information for the vpn service provider you currently use in the future + +## CLI operation + +You can run the docker container in CLI operation, check the possible options with: + +```sh +docker run -it --rm qmcgaw/private-internet-access update -help +``` + +To update your servers.json file with, for example `mullvad`, use: + +```sh +docker run -it --rm -v /yourpath:/gluetun qmcgaw/private-internet-access update -file -mullvad +``` + +Note that this operation is very quick 🚀 for some providers (`pia`, `mullvad`, `nordvpn`, ...) and very slow 🐢 for other providers (`cyberghost`, `windscribe`, ...). + +⚠️ This will show your ISP/Government/Sniffing actors that you access some VPN service providers and try to resolve their server hostnames. +That might not be the best solution depending on your location. Plus some of the requests might be blocked, hence not allowing certain server information to be updated.