Skip to main content

NekoBox Configuration Guide (Android)

If you already have a working overseas network environment, follow the "NekoBox Configuration" section. If you do not have one, follow the "Chain Proxy" section first.

IPWeb provides 70 million+ clean residential IPs worldwide across 220+ countries/regions, supporting HTTP, HTTPS, and SOCKS5 for use cases such as data collection, account operations, and ad verification. This guide walks you through registering, purchasing, and configuring proxies in NekoBox (Android).

Need help? Contact us anytime: Telegram t.me/ipwebadmin | Phone 13064703052 | QQ (scan QR code) | WeChat (scan QR code)

QQ QR code WeChat QR code

Getting Started

1. Create an Account

Step 1: Open the IPWeb website at https://ipweb.cc and click Sign Up in the top navigation bar (existing users can click Log In).

IPWeb homepage

Step 2: On the registration page, enter your email address and password; or use Sign up with Gmail (recommended) to skip setting a separate password.

IPWeb sign up / log in

Step 3: Check your inbox for a verification email and click the confirmation link. If you do not see the email, check your spam folder. (Some providers may delay delivery—wait a few minutes.)

2. Claim Trial Traffic

After registration, log in to the IPWeb dashboard at https://user.ipweb.cc for the first time and contact support to receive free trial traffic for all proxy types.

New users can test proxy performance with complimentary traffic before choosing a paid plan.

3. Purchase a Static Residential Proxy Plan

After logging in, select the static residential proxy product from the left dashboard.

Static residential proxies are billed by IP count and subscription duration. After purchase, you receive fixed residential IP addresses.

Step 1: In the left navigation bar, click Static Residential ProxyPurchase Proxy.

Step 2: Configure the following parameters:

ParameterDescription
Country / RegionPrecise targeting by country / city
IP Quality & Use CaseMatch IP quality to your workload (Basic / Standard / Premium)
Protocol & FeaturesSOCKS5 / HTTP by default; IPs are dedicated for isolation
Subscription DurationFrom 7 days to 1 year as needed
QuantityNumber of fixed IPs to purchase

Static proxy parameter configuration

Step 3: Confirm the order total and complete payment with a supported method.

4. Retrieve Proxy Connection Details

After purchase, open Purchased Line Details in the left navigation bar to view:

  • Static IP address
  • Port number
  • Credentials (username / password)

Use these details directly in your client configuration.

Purchased line details

NekoBox Configuration

This section covers the NekoBox client on Android. NekoBox has a clean UI and supports SOCKS5 / HTTP, making it suitable for quick residential proxy setup.

Before configuring, complete the purchase flow above, have your connection details (server, port, username, password), and install NekoBox on Android.

1. Prepare Proxy Connection Details

Confirm you have:

  • Proxy server address
  • Port number
  • Username
  • Password

2. Add an IPWeb Proxy Node

Open NekoBox and follow these steps:

① Tap the add button

On the main screen, tap the file icon with + in the top-right corner to open the node type menu.

Tap the add button in the top-right corner of NekoBox

② Select the proxy protocol

Choose the protocol that matches what you obtained from IPWeb. Screenshots in this guide use HTTP, so tap HTTP.

Select HTTP in the node type menu

⚠️ The protocol must match IPWeb: choose HTTP for HTTP proxies, or SOCKS for SOCKS5. A mismatch will prevent connection.

③ Fill in server settings

On the Server Configuration page:

FieldValue
Profile nameproxy1 or any recognizable name
ServerYour proxy server address
Server portYour port (e.g. 7778)
Username (optional)Your proxy username
Password (optional)Your proxy password

IPWeb static proxies usually require authentication, so fill in username and password even if the UI marks them optional. Leave other options at defaults; unless required, keep Transport encryption and Multiplexing off.

When finished, tap in the top-right corner to save.

Enter HTTP server, port, and credentials

3. Start the Node and Establish a VPN Connection

After saving, the node appears on the main screen. Tap it so a pink selection mark appears on the left, then tap the paper airplane button at the bottom center to connect.

On first launch, Android will request VPN permission—tap OK / Allow. When connected:

  • A VPN icon appears in the status bar
  • Latency shows on the right of the node (e.g. 292ms)
  • The bottom of the screen shows Connected and handshake time
  • The paper airplane indicates connected state

Start the node and confirm connection

Open a browser and visit https://ipinfo.io or another IP lookup site. Confirm the IP and region match the proxy you purchased. If correct, setup succeeded.

Check proxy exit IP

If the check shows your local IP, verify in order:

  1. NekoBox shows Connected and the status bar has a VPN icon
  2. The selected node is the IPWeb node you just added
  3. Server, port, username, and password match IPWeb exactly
  4. Protocol (SOCKS / HTTP) matches the dashboard
  5. You allowed the Android VPN permission prompt

4. Add or Switch Multiple Nodes (Optional)

If you have multiple IPWeb proxies, repeat the steps above for each one. Use distinct names such as proxy0 and proxy1.

Add a second HTTP proxy node

To switch nodes, disconnect first, tap the target node (pink mark on the left), then tap the paper airplane again.

Chain Proxy

If your local network cannot reach the target country/region proxy directly, configure a chain proxy in NekoBox: first connect through a reachable overseas upstream proxy, then to the target downstream proxy.

Path:

Device -> Upstream proxy (overseas) -> Downstream proxy (target country/region) -> Target website

For example, use a Hong Kong proxy as upstream and a US static residential proxy as downstream. The final egress should be the US downstream IP, not your local public IP or the Hong Kong upstream IP.

1. Prepare Two Proxy Nodes

Prepare address, port, username, and password for:

RolePurposeExample name
Upstream proxyFirst hop reachable from your current networkproxy0
Downstream proxyFinal business egress in the target country/regionproxy1

Prefer a nearby, low-latency, stable node as upstream; choose downstream by business location needs.

This section uses two HTTP nodes. For SOCKS5, select SOCKS and keep the protocol consistent with your provider.

2. Add Upstream and Downstream Nodes Separately

Using the earlier “Add an IPWeb Proxy Node” steps, create upstream proxy0 and downstream proxy1. Fill each node’s server, port, username, and password, then tap to save.

Both nodes should appear on the main screen. Optionally start each alone first to verify credentials and protocol.

Upstream is the first hop. If it fails or is too slow, downstream will also fail. Confirm upstream works in your current network first.

3. Create the Chain Proxy

On the main screen, tap the top-right + file icon, scroll the type list, and select Chain Proxy.

Select Chain Proxy in the add menu

On the Chain Settings page:

  1. Set Profile name to chain proxy (or another clear name)
  2. Tap Add server profile
  3. Add upstream and downstream nodes in order
  4. Confirm order is proxy0 → proxy1 (upstream above, downstream below)
  5. Tap to save

Add two nodes and set chain order

⚠️ Keep order as upstream → downstream, with downstream as final egress. proxy0 / proxy1 are only example names—follow your actual node roles to avoid wrong exit IP or connection failure.

4. Start the Chain Proxy

On the main screen, select chain proxy (pink mark on the left), then tap the bottom paper airplane button.

When connected, latency appears next to chain proxy, the bottom shows Connected, and the status bar shows VPN.

Select and start chain proxy

Start the chain proxy entry itself—not standalone proxy0 or proxy1. NekoBox calls both nodes in the chain order automatically.

5. Verify Final Egress IP

Visit https://ipinfo.io or another trusted IP checker and confirm:

  • Displayed IP matches the downstream proxy IP
  • Country/region matches your purchased target line
  • Result is neither your local public IP nor the upstream egress IP

Chain proxy exit IP check example

If the result matches the downstream target IP, chain proxy is working. Extra hop latency is normal.

6. Troubleshooting

IssueWhat to check
Chain fails to startRecheck both nodes’ server/port/protocol/credentials; test upstream alone first
Downstream always times outConfirm upstream is reachable; try a lower-latency overseas upstream
Detected IP is upstreamCheck whether downstream is missing or order is reversed; must be upstream → downstream
Detected IP is still localConfirm chain proxy is selected and started, VPN permission is granted, and VPN icon is visible
Connected but slowOne extra hop adds latency; shorten upstream distance and avoid stacking extra proxies

Button names, layout, and VPN prompts may vary by NekoBox or Android version. Use proxies only for lawful purposes and follow target site terms and local laws.


If you run into issues not covered above, contact us for technical support:

QQ QR code
  • WeChat: (scan QR code to add)
WeChat QR code

For more client configuration guides (Clash Verge, v2rayN, etc.), visit IPWeb Proxy Configuration Tutorials.