How To Get Client IP Address In Java Servlets


A quick guide how to get the client ip address in java using servlets. You can use HttpServletRequest.getRemoteAddr() method or "x-forwarded-for".

1. Overview

In this quick tutorial, you'll learn how to get the client ip address when a request comes to server. But, this can be done only in the java servlet application.

Simply, you can call directly on the request object as "request.getRemoteAddr()" on the javax.servlet.http.HttpServletRequest object.

How To Get Client IP Address In Java Servletsq

2. Example to get the client ip address

let us create a simple web application that gets the request and repose objects but we are interested in only request object. 

Because, all the values from client are part of HTTP request.

Actually, calling getRemoteAddr() method does not get the correct ip address of client in some cases.

In those scenarios might be client ip address is forwarded by the proxies. Mostly the client ip is present in the http header property "X-FORWARDED-FOR". we need to just get this property. If this value is null then get the value from getRemoteAddr() method.

This way gives the right ip address always. 

Created a separate method that to fetch the client ip address.

private static String getClientIpAddress(HttpServletRequest request) {

String remoteAddress = "";

if (request != null) {
    remoteAddr = request.getHeader("X-FORWARDED-FOR");
    if (remoteAddr == null || "".equals(remoteAddr)) {
        remoteAddress = request.getRemoteAddr();

return remoteAddress;

3. "X-FORWARDED-FOR" and getRemoteAddr() are not working

There are some cases where the combination of these two "X-FORWARDED-FOR" and getRemoteAddr() method does work.

To correct the property, first need to look into the all properties of HTTP header. 

First, use request.getHeaderNames() method to get all header properties or keys.

Next, take each header key and get the corresponding values from the header using request.getHeader(headerKey) method.

Finally, print all the key and value pairs are in HTTP header.

private void printRequestHeadersKeyValues(HttpServletRequest request) {

    Map<String, String> result = new HashMap<>();

    Enumeration headerNames = request.getHeaderNames();
    while (headerNames.hasMoreElements()) {
        String headerKey = (String) headerNames.nextElement();
        String headerValue = request.getHeaderheaderKey;
        System.out.println(headerKey+" : "+headerValue)



referer : https://www.google.com/,
cf-ipcountry : US,
cf-ray : 348c7acba8a02210-EWR,
x-forwarded-proto : https,
accept-language : en-US,en;q=0.8,
cookie : __cfduid=d39823749ksjfksdf90823r3298; _ga=GA1.2.450731937.1490726069,

x-forwarded-for :,  // <------ This is client real IP

accept : text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8,

x-real-ip : 187.343.987.123,  // <------ This is proxy IP

x-forwarded-server : testing.com,
x-forwarded-host : testing.com,
 cf-visitor : {\scheme\:\https\},
host :,
upgrade-insecure-requests : 1,
connection : close,
cf-connecting-ip : 102.81.315.51,
accept-encoding : gzip,
user-agent :  Mozilla/24.0 (Macintosh; Intel Mac OS X 13_09_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3030.99 Safari/789.98

You can pick the right property from the above list which is having the correct client ip address.

4. Check for all Header Possible Candidates

Another way is get the all possible candidates that may get the client ip address
Just loop over this list and get values if any one is present in the header.

If nothing is having the value then take the value from getRemoteAddr() method.

Sample code but these header values can be modified with fake values.

private static final String[] VALID_IP_HEADER_CANDIDATES = { 
    "REMOTE_ADDR" };

public static String getClientIpAddress(HttpServletRequest request) {
    for (String header : VALID_IP_HEADER_CANDIDATES) {
        String ipAddress = request.getHeader(header);
        if (ipAddress != null && ipAddress.length() != 0 && !"unknown".equalsIgnoreCase(ipAddress)) {
            return ipAddress;
    return request.getRemoteAddr();

5. Conclusion

In this short article, you've seen how to get the actual client ip address in java servlet application using getRemoteAddr() method and header keys.


HTTP Header

HTTP X header

how to set servlet session timeout?



About Us

Author: Venkatesh - I love to learn and share the technical stuff.

accumulo,1,ActiveMQ,2,Adsense,1,API,37,ArrayList,18,Arrays,24,Bean Creation,3,Bean Scopes,1,BiConsumer,1,Blogger Tips,1,Books,1,C Programming,1,Collection,8,Collections,37,Collector,1,Command Line,1,Comparator,1,Compile Errors,1,Configurations,7,Constants,1,Control Statements,8,Conversions,6,Core Java,149,Corona India,1,Create,2,CSS,1,Date,3,Date Time API,38,Dictionary,1,Difference,2,Download,1,Eclipse,3,Efficiently,1,Error,1,Errors,1,Exceptions,8,Fast,1,Files,17,Float,1,Font,1,Form,1,Freshers,1,Function,3,Functional Interface,2,Garbage Collector,1,Generics,4,Git,9,Grant,1,Grep,1,HashMap,2,HomeBrew,2,HTML,2,HttpClient,2,Immutable,1,Installation,1,Interview Questions,6,Iterate,2,Jackson API,3,Java,32,Java 10,1,Java 11,6,Java 12,5,Java 13,2,Java 14,2,Java 8,128,Java 8 Difference,2,Java 8 Stream Conversions,4,java 8 Stream Examples,12,Java 9,1,Java Conversions,14,Java Design Patterns,1,Java Files,1,Java Program,3,Java Programs,114,Java Spark,1,java.lang,4,java.util. function,1,JavaScript,1,jQuery,1,Kotlin,11,Kotlin Conversions,6,Kotlin Programs,10,Lambda,2,lang,29,Leap Year,1,live updates,1,LocalDate,1,Logging,1,Mac OS,3,Math,1,Matrix,6,Maven,1,Method References,1,Mockito,1,MongoDB,3,New Features,1,Operations,1,Optional,6,Oracle,5,Oracle 18C,1,Partition,1,Patterns,1,Programs,1,Property,1,Python,2,Quarkus,1,Read,1,Real Time,1,Recursion,2,Remove,2,Rest API,1,Schedules,1,Serialization,1,Servlet,2,Sort,1,Sorting Techniques,8,Spring,2,Spring Boot,23,Spring Email,1,Spring MVC,1,Streams,31,String,61,String Programs,28,String Revese,1,StringBuilder,1,Swing,1,System,1,Tags,1,Threads,11,Tomcat,1,Tomcat 8,1,Troubleshoot,26,Unix,3,Updates,3,util,5,While Loop,1,
JavaProgramTo.com: How To Get Client IP Address In Java Servlets
How To Get Client IP Address In Java Servlets
A quick guide how to get the client ip address in java using servlets. You can use HttpServletRequest.getRemoteAddr() method or "x-forwarded-for".
Loaded All Posts Not found any posts VIEW ALL Readmore Reply Cancel reply Delete By Home PAGES POSTS View All RECOMMENDED FOR YOU LABEL ARCHIVE SEARCH ALL POSTS Not found any post match with your request Back Home Sunday Monday Tuesday Wednesday Thursday Friday Saturday Sun Mon Tue Wed Thu Fri Sat January February March April May June July August September October November December Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec just now 1 minute ago $$1$$ minutes ago 1 hour ago $$1$$ hours ago Yesterday $$1$$ days ago $$1$$ weeks ago more than 5 weeks ago Followers Follow THIS PREMIUM CONTENT IS LOCKED STEP 1: Share to a social network STEP 2: Click the link on your social network Copy All Code Select All Code All codes were copied to your clipboard Can not copy the codes / texts, please press [CTRL]+[C] (or CMD+C with Mac) to copy Table of Content