Using Warp+ in Surge

Warp+ is a service launched by CloudFlare that can be used to protect user privacy. It is based on the WireGuard protocol and uses UDP to transmit data. Due to its relatively pure IP address, it can be used to unlock streaming media, Google Scholar, and more.

Surge is a network proxy tool for macOS and iOS.

Today, I tried configuring Warp+ in Surge and successfully achieved proxy functionality.

Below, I will share the specific steps I took.

Step 1: Install Homebrew

⚠️ To use Warp+ on Surge, you need to confirm that Homebrew is installed on macOS because it calls the GitHub project "wgfc" through Homebrew.

First, open Terminal on macOS and enter the following code to check the version of Homebrew on your computer.

brew --version

As shown in the red box in the image below, the version of Homebrew on my computer is 4.0.14. If the content in the red box is not displayed, it means Homebrew is not installed on your computer.

Homebrew Version

To install Homebrew, enter the following code in Terminal:

/bin/bash -c "$(curl -fsSL"

Wait for the installation to complete.

If the following code appears after the installation, it means Homebrew has been successfully installed on your macOS. However, since the "/opt/homebrew/bin" directory has not been added to your PATH environment variable, you need to configure your shell to use Homebrew by following the steps below.

Homebrew Configuration

At this point, you need to enter the following code in Terminal:

(echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> /Users/username/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

❗ Please replace "username" in the code with your computer username.

After that, Homebrew has been installed and can run normally on your macOS.

Step 2: Obtain Warp+ Key

You can obtain a Key with a total of 24 PB of traffic by using the "Warp+ Bot" on Telegram

If you need to verify whether the obtained Key is valid, you need to install Cloudflare WARP on macOS or on iOS. Then, you can verify the obtained Key's validity and check the remaining traffic balance in the app.

Step 3: Get Configuration through wgcf

Open Terminal and enter "brew install wgcf" to start installing wgcf.

After the code runs and the installation is complete, enter "wgcf register" to obtain the file named "wgcf-account.toml". This file can be found in "/Users/username/" (shortcut: shift+cmd+h).

Next, open this file with a text editor, replace the license key with the Key you obtained in Step 2, and save the file.


After saving, enter "wgcf update" in Terminal and run it. The configuration file will be updated.

Step 4: Generate Surge-Compatible Configuration File

Exit Surge, AdGuard, or any other software that may affect the network. Then, run "wgcf generate" in Terminal. A file named "wgcf-profile.conf" will be generated in "/Users/username/".

Step 5: Configure Warp+ in Surge

Open Surge and use a text editor to open the "wgcf-profile.conf" file generated in Step 4.

Fill in Surge according to the image below using the contents of "wgcf-profile.conf".

Surge Configuration

Ownership of this post data is guaranteed by blockchain and smart contracts to the creator alone.