Lazy loaded image
Tech Sharing
Guide to Setting Up an Accelerated IP for Any Minecraft Server
Words 881Read Time≈ 3 min
2026-1-17
2026-1-19
type
status
date
slug
summary
tags
category
icon
password
😀
A complete tutorial on using Minecraft-Speed-Proxy to set up an accelerated IP for any Minecraft server, including server preparation, program upload, config.json configuration (LocalPort 25565, Remote target server, whitelist, etc.), and launch testing, designed to help reduce network latency issues.

Video Tutorial

📋 Preparation

Before starting, you need to prepare the following:
  • A cloud server: It is recommended to choose a provider with good network quality (for example, if you want to accelerate a Minecraft server in the US, you should get a server located in the US with a high-quality network).
If you’re not sure which cloud server provider to choose, you can consider Rainyun. It’s relatively affordable — the entry-level plan costs about 20 RMB per month, and in practice the network performance is decent, more than sufficient for use as a Minecraft acceleration node.
By registering through the link below, you can get a discount, bringing the cost down to around 15 RMB:
https://www.rainyun.com/NjQ3MjM=_
  • Server OS: Linux is recommended (Ubuntu 20.04 or later).
  • Basic Linux command knowledge.
  • Your Minecraft server address and port.

🚀 Step 1: Prepare the Server

First, connect to your cloud server. You can use a tool like FinalShell for the connection.

📦 Step 2: Obtain and Upload the Program

Clone the Minecraft-Speed-Proxy project from GitHub. Beginners can also download the ZIP file to their local machine and extract it.
You can place minecraftspeedproxy on the server using either of the following methods:
  • Drag and drop it from your local machine into the server directory in FinalShell, preferably into the home directory.
  • Or use your cloud provider’s built-in file management tool to upload it.
After uploading, give the binary file execution permissions (first navigate to the project root directory using cd):

⚙️ Step 3: Generate and Edit the Configuration File

After uploading the project to the server, navigate to the project root directory and use the built-in command to generate the default configuration file:
Once generated, open config.json with an editor (in FinalShell, you can simply double-click the config.json file in the directory to open it).
Replace or verify that the core configuration roughly matches the following:

▶️ Step 4: Start the Proxy Service

After configuring, start the proxy directly in the project root directory:

Core Field Explanations

Proxy Listening Settings
  • "LocalAddress": "::": Listens on all IPv6/IPv4 addresses, generally fine. If you want to use IPv4 only, change it to "0.0.0.0".
  • "LocalPort": 25565: Local port 25565. The client connects to your VPS IP:25565.
Remote Target Server
  • "Address": "mc.hypixel.net", "RemotePort": 25565: These are already set for Hypixel. To accelerate another server, replace them with the target server’s domain/IP and port.
Whitelist and Player Limit
  • "MaxPlayer": -1: No limit; the actual limit depends on your machine and bandwidth.
  • "DefaultEnableWhitelist": true: Whitelist is enabled by default; accounts not on the list cannot connect.
  • "WhiteBlcakListPath": "./WhiteBlackList.json": Path to the whitelist/blacklist file; make sure your UUID is included.
Logs and WebAPI
  • "LogDir": "./logs": Directory for logs.
  • "ShowLogLevel": 0 / "SaveLogLevel": 0: Display and save normal logs; sufficient for basic debugging.
  • "WebAPIEnable": true: WebAPI enabled.
  • "WebAPIAddress": "127.0.0.1", "WebAPIPort": 20220: Only accessible locally, enhancing security.
  • "WebAPIPassword": "admin": Fine for personal use, but it’s recommended to set a stronger password.

Recommended Adjustments by Use Case

If it’s just for yourself or a few friends, you can adjust the settings for convenience:
  • Relax connection restrictions for testing:
    • Change "DefaultEnableWhitelist": true to false, save, and restart the program. This allows connections without configuring the whitelist first.
  • Use IPv4 only (optional):
    • If your environment is mainly IPv4, change "LocalAddress" to:
      • "LocalAddress": "0.0.0.0"
If everything is correct, you’ll see terminal output similar to:
Listening on 0.0.0.0:25565 / ::25565, forwarding to mc.hypixel.net:25565
At this point, add the server in your Minecraft client:
Connect to it and monitor the latency and stability. You can further adjust parameters in config.json based on your experience.

Running the Minecraft Project in the Background with screen

When the SSH window is closed, the terminal session will end, so you need to use screen to run the program in the background.

1. Install screen

Run the command corresponding to your system:
  • Ubuntu / Debian:
  • CentOS / RHEL：
  • Fedora：
  • Arch Linux：
After installation, check the version to confirm:

2. Create and Enter a Screen Session

Create a named session (e.g., minecraft):
After running the command, you will enter the screen session window, which is essentially a fresh terminal interface.
⚠️ Tip: You can name the session whatever you like, which makes managing multiple background programs easier.

3. Start the Project

In the screen window, run the command to start the project:
The program will run in the current window.

4. Detach the Session (Run the Program in the Background)

Once the program has started, you can press:
This will detach the session, allowing the program to continue running in the background while you safely close the SSH window.

5. Reattach the Session

If you want to return to the running screen session:
After reattaching, you can see the program’s real-time output and interact with it.

6. Manage Multiple Screen Sessions

  • List all screen sessions:
  • Force attach to a session (if it’s already attached or detached):
  • Exit and close a session:
      • Inside the screen session, press:
The program will stop, and the window will close.
Catalog