ip2location / ip2proxy-java

IP2Proxy Java Component.It can be used to find the IP addresses which are used as VPN anonymizer, open proxies, web proxies and Tor exits.

IP2Proxy Java Component

This component allows user to query an IP address if it was being used as VPN anonymizer, open proxies, web proxies, Tor exits, data center, web hosting (DCH) range, search engine robots (SES), residential proxies (RES), consumer privacy networks (CPN), and enterprise private networks (EPN). It lookup the proxy IP address from IP2Proxy BIN Data file. This data file can be downloaded at

• Free IP2Proxy BIN Data: https://lite.ip2location.com
• Commercial IP2Proxy BIN Data: https://www.ip2location.com/database/ip2proxy

Developer Documentation

To learn more about installation, usage, and code examples, please visit the developer documentation at https://ip2proxy-java.readthedocs.io/en/latest/index.html.

Proxy Type

Proxy Type	Description
VPN	Anonymizing VPN services
TOR	Tor Exit Nodes
PUB	Public Proxies
WEB	Web Proxies
DCH	Hosting Providers/Data Center
SES	Search Engine Robots
RES	Residential Proxies [PX10+]
CPN	Consumer Privacy Networks. [PX11+]
EPN	Enterprise Private Networks. [PX11+]

Usage Type

Usage Type	Description
COM	Commercial
ORG	Organization
GOV	Government
MIL	Military
EDU	University/College/School
LIB	Library
CDN	Content Delivery Network
ISP	Fixed Line ISP
MOB	Mobile ISP
DCH	Data Center/Web Hosting/Transit
SES	Search Engine Spider
RSV	Reserved

Threat Type

Threat Type	Description
SPAM	Spammer
SCANNER	Security Scanner or Attack
BOTNET	Spyware or Malware

ip2proxy-java's Issues

Error on replacing the database file

We use Ip2proxy where we load database using IP2Proxy.IOModes.IP2PROXY_MEMORY_MAPPED mode.
When a background process replaces database file (using cp command) we receive one of the following errors when calling GetProxyType() method.

See stacktrace:

java.lang.InternalError: a fault occurred in a recent unsafe memory access operation in compiled Java code
	at com.ip2proxy.IP2Proxy.Read128(IP2Proxy.java:1210)
	at com.ip2proxy.IP2Proxy.Read32Or128(IP2Proxy.java:1202)
	at com.ip2proxy.IP2Proxy.ProxyQuery(IP2Proxy.java:800)
	at com.ip2proxy.IP2Proxy.GetProxyType(IP2Proxy.java:256)

and

java.lang.IllegalArgumentException: newPosition < 0: (-1157713828 < 0)
	at java.base/java.nio.Buffer.createPositionException(Buffer.java:341)
	at java.base/java.nio.Buffer.position(Buffer.java:316)
	at java.base/java.nio.ByteBuffer.position(ByteBuffer.java:1516)
	at java.base/java.nio.MappedByteBuffer.position(MappedByteBuffer.java:321)
	at java.base/java.nio.MappedByteBuffer.position(MappedByteBuffer.java:73)
	at com.ip2proxy.IP2Proxy.ReadStr(IP2Proxy.java:1255)
	at com.ip2proxy.IP2Proxy.ProxyQuery(IP2Proxy.java:837)
	at com.ip2proxy.IP2Proxy.GetProxyType(IP2Proxy.java:256)

We are running openjdk version "17.0.8.1" 2023-08-24 and Ubuntu 22.04.3 LTS.

Any help would be welcome.

Is IP2Proxy class thread-safe?

Hello, team,

Is IP2Proxy thread-safe? Is it safe to call public methods to retrieve information about IP in multiple threads for the same instance of IP2Proxy?

Thanks.