Differences

This shows you the differences between two versions of the page.

--- litespeed_wiki:config:geolocation [2019/01/09 17:19]
Jackson Zhang [How to Enable]
+++ litespeed_wiki:config:geolocation [2020/01/16 16:14] (current)
Lisa Clarke Redirected to new URL
@@ Line 1: / Line 1: @@
-====== Enabling GeoLocation (GEOIP) ======
+~~REDIRECT>litespeed_wiki:cache:common:geoip-support~~
-Geolocation (GEOIP) enables developers to enhance the user experience. Content and advertising may be customized for a specific user's country, showing pages more relevant to the location of the user. Admins can further enhance a site's security by blocking a client based on country.
-===== How to Enable GeoIP module =====
-Enabling GeoIP is easy. The following are simple steps on a CentOS system to install through yum to install MaxMind GeoIP Legacy database. Check [[litespeed_wiki:cache:common:geoip-support|this wiki]] for MaxMind GeoIP2 database and IP2Location database setup.
-==== Install ====
-Install GeoIP database for CentOS users:
-<code>yum install GeoIP-data</code>
-Install other modules:
-<code>yum install GeoIP-devel zlib-devel</code>
-==== Setup ====
-Check geo database:
-<code>rpm -ql GeoIP</code>
-It may return a database path similar to:
-<code>/usr/share/GeoIP/GeoIP.dat </code>
-In LSWS WebAdmin, configure the database location.  Navigate to **Configuration > Server > General > General settings > [[https://www.litespeedtech.com/docs/webserver/config/general#geolocationDB|IP to GeoLocation DB]]** \\
-Enter **DB File Path**:
-<code>/usr/share/GeoIP/GeoIP.dat </code>
-Set **DB Cache Type** to ''MemoryCache''\\
-{{:litespeed_wiki:config:geo-4.png?900|}}
-Navigate to **Web Admin > Configurations > Your Virtual Hosts > Rewrite** to add rewrite rules that will control the redirect:
-<code>
-<IfModule LiteSpeed>
-  RewriteEngine on
-  RewriteCond %{ENV:GEOIP_COUNTRY_CODE} ^(CA)$
-  RewriteRule ^(.*)$ https://en.wikipedia.org/wiki/Canada [R,L]
-</IfModule>
-</code>
-Refer to [[http://dev.maxmind.com/geoip/legacy/mod_geoip2/#Redirecting_a_client_based_on_country | Maxmind]] for more rewrite examples.
-=====How to Verify =====
-====Change Your Source IP by Proxy====
-===Method 1:===
-From [[https://hide.me/en/proxy | this site ]], we can simply put in a web IP and choose a country from three(USA, Germany, Netherlands). If you want more than three countries, then you need to register for a paid plan. \\
-{{:litespeed_wiki:config:geo-3.png?600|}}
-===Method 2:===
-You can choose a free proxy server from online free resources, e.g. [[ https://free-proxy-list.net/ | Free_Proxy]] \\
-{{:litespeed_wiki:config:geo-1.png?600|}}\\
-Setup the proxy IP with your browser. Here are the steps for Chrome:
-  - Click on **Settings**.
-  - Click **Show advanced settings**
-  - Scroll further down the list until you see **System**
-  - Click **Open proxy settings**
-  - Click the **LAN settings** button.
-  - On the **Internet Properties** window, click the **LAN settings** button.
-  - In the **LAN Settings**, uncheck the box that says **Automatically detect settings**.
-  - In the **Proxy Server** section, click the checkbox to enable ''Use a proxy server for your LAN...''
-  - In the **Address** field, enter the IP Address and Port Number of your Proxy Server.
-  - Press the **OK** button and then press **OK** again to save your settings.
-  - Now when you surf the web, you will be surfing by using the Proxy Server.
-==== Check Correct IP is Set====
-  * You can check source IP via LiteSpeed default php page ''<nowiki>http://your_domain/phpinfo.php</nowiki>''. First, you need to set **Admin > Configurations > Your Virtual Hosts > General > Enable GeoLocation Lookup** to ''Yes'' <code>
-_SERVER["GEOIP_ADDR"]
-_SERVER["GEOIP_COUNTRY_CODE"]
-_SERVER["GEOIP_COUNTRY_NAME"]
-_SERVER["GEOIP_CONTINENT_CODE"]
-</code>
-  * Or use online IP check, e.g. [[http://whatismyipaddress.com/| What is my IP]]
-  * Or ''ipinfo.io'' online service, which will return json format: <code>curl ipinfo.io/153.232.58.88
->>>
-{
-  "ip": "153.232.58.88",
-  "hostname": "88.58.232.153.ap.dti.ne.jp",
-  "city": "Tokyo",
-  "region": "Tokyo",
-  "country": "JP",
-  "loc": "35.6850,139.7514",
-  "org": "AS4713 NTT Communications Corporation",
-  "postal": "102-0082"
-}</code>
-==== Check DB by lookup command====
-Use ''geoiplookup''/''geoiplookup6'' command to verify GeoData is working: <code>geoiplookup /usr/share/GeoIP/GeoIP.dat 62.26.0.0
->> GeoIP Country Edition: DE, Germany
-geoiplookup /usr/share/GeoIP/GeoIP.dat 210.212.193.192
->> GeoIP Country Edition: IN, India
-</code>
-====Set Rewrite Rules====
-Navigate to **Web Admin > Configurations > Your Virtual Hosts > Rewrite**:
-  * Set **Rewrite** to ''Yes''
-  * For testing purpose, set **Log Level** to ''9''.
-  * Add the following rules to **Rewrite Rules** content: <code>
-# Redirect two specific countries
-RewriteCond %{ENV:GEOIP_COUNTRY_CODE} ^(CA)$
-RewriteRule ^(.*)$ https://en.wikipedia.org/wiki/Canada [R,L]
-RewriteCond %{ENV:GEOIP_COUNTRY_CODE} ^(EU)$
-RewriteRule ^(.*)$ https://en.wikipedia.org/wiki/Europe [R,L]
-</code>
-====Log====
-<code> tail -f /PATH_TO_LSWS/log/error.log </code>
-When you are using CA IP:
-<code>
-[REWRITE] Rule: Match '/' with pattern '^(.*)$', result: 2
-[REWRITE] Cond: Match 'CA' with pattern '^(CA)$', result: 2
-[REWRITE] Source URI: '/' => Result URI: 'https://en.wikipedia.org/wiki/Canada'
-</code>
-When you are using Germany IP:
-<code>
-[REWRITE] Rule: Match '/' with pattern '^(.*)$', result: 2
-[REWRITE] Cond: Match 'EU' with pattern '^(EU)$', result: 2
-[REWRITE] Source URI: '/' => Result URI: 'https://en.wikipedia.org/wiki/Europe'
-</code>
-When you are using Netherlands IP:
-<code>
-[REWRITE] Rule: Match '/' with pattern '^(.*)$', result: 2
-[REWRITE] Cond: Match 'NL' with pattern '^(CA)$', result: -1
-[REWRITE] Rule: Match '/' with pattern '^(.*)$', result: 2
-[REWRITE] Cond: Match 'NL' with pattern '^(EU)$', result: -1
-</code>
-  * ''2'' is match, ''-1'' is not match
-===== Troubleshooting =====
-  * If the module is not working, make sure that the httpd user (e.g. ''nobody'') has read access to the GeoIP database file(s) you are using.
-  * If the GeoIP variables do not show up please make sure that the client IP address is not on a private network such as 10.0.0.0/8, 172.16.0.0/12 or 192.168.0.0/16. GeoIP can only look up public IP addresses.
-===== Update GeoIP Database through yum or manually download=====
-If you install GeoIP-data through yum, you can do upgrade through:
-  yum update GeoIP-data
-You can also download/update GeoIP database manually:
-Download new database from:
-<code> wget -N http://geolite.maxmind.com/download/geoip/database/GeoLiteCountry/GeoIP.dat.gz </code>
-Uncompress it:
-<code> gunzip GeoIP.dat.gz </code>
-Move the file in the right directory:
-<code> mv GeoIP.dat /usr/local/share/GeoIP/ </code>
-===== More Information =====
-  * [[http://www.ip2country.net/ip2country/country_code.html | IP Country Codes List:]]
-  * Rewrite rule: Blocking a client based on country example:<code>SetEnvIf GEOIP_COUNTRY_CODE DE BlockCountry
-Deny from env=BlockCountry</code>