Servers section

Quentin McGaw
2020-09-24 22:11:38 -04:00
parent dc88973aee
commit 1951272eff
4 changed files with 304 additions and 0 deletions
+1
@@ -2,5 +2,6 @@
1. [Setup](Setup) 1. [Setup](Setup)
1. [FAQ](FAQ) 1. [FAQ](FAQ)
1. [Servers](Servers)
1. [HTTP Control server](HTTP-Control-server) 1. [HTTP Control server](HTTP-Control-server)
1. [Contributing](Contributing) 1. [Contributing](Contributing)
+107
@@ -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
+159
@@ -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
+37
@@ -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.