Skip to content

Tutorial for FoXray app

This page shows you how to add your Hiddify subscription to the FoXray app on iPhone and iPad and how to use its main settings. FoXray comes from the team behind the WingsX app, and replaced WingsX after WingsX was removed from the App Store.

FoXray is no longer on the App Store

As of October 2026, FoXray's App Store page (id6448898396) no longer exists, so you can't install it any more. If you already have it, the steps below still describe how it works. For a new install, use the Hiddify App (App Store, see How to install Hiddify App) or another app from the iOS client list.

Before you start

  • FoXray already installed on your iPhone or iPad.
  • Your user page link. This is the link your server admin sent you. It opens your personal Hiddify page.

A subscription link is one link that holds all your connection settings (configs). FoXray can refresh it later to get new settings from the server.

  1. Open your user page link.
  2. Open the menu and tap All Configs.
  3. In the Subscription Links section, find Subscription link b64 and tap Get Link.
  4. Tap Copy Link.

    FoXray section on an older version of the user page

The screenshot shows an older version of the user page, which had an **iOS** tab. The current page looks different.
  1. Open FoXray and tap Subscriptions in the bottom menu.
  2. Tap the + button.

    The + button in Subscriptions

  3. Type any name you like.

  4. Paste the link into the URL field.
  5. Tap Subscribe. Your configs are added to the app.

    Name and URL fields

Update your subscription

In the Subscriptions menu, tap the ↪️ icon. Your links are updated.

Update icon

Add a subscription with a QR code

  1. In the FoXray menu, tap the QR code button.
  2. Point the camera at the QR code of the link or config. It is added to the app.

QR code button

If the QR code is saved as a photo on your phone:

  1. In the FoXray menu, tap the photo button.
  2. Choose the photo. The configs are added.

Photo button

Add a single config

We don't recommend this, because a single config can't be updated. Use it only if you need to.

  1. On your user page, open All Configs and copy one config from Individual Configs.
  2. In FoXray, tap the Clipboard icon in the FoXray menu. The copied config is added.

Clipboard icon

Test the connections

First choose the test type:

  1. Go to Setting, then the Speed Test section.
  2. Under PingType, choose TCPPing, TLSPing or RealPing. RealPing gives the most realistic result.

PingType setting

Then, on the main page of the app, tap the connection test icon.

Connection test icon

Limit memory use

Go to Setting, then ToolBox, and turn on Limit Memory Usage.

Limit Memory Usage

Add a DNS server

A DNS server turns website names into IP addresses.

  1. In the FoXray menu, open the DNS section.
  2. Tap +.
  3. Type any name.
  4. Enter the DNS address you want in the Default DNS Address field.
  5. Leave the other fields as they are and save.

Default DNS Address field

Premium features

The following features are only available if you bought the premium version of the app.

Update subscriptions automatically

Go to Setting and turn on Auto Update Subscription.

Auto Update Subscription

Always On

Go to Setting, then Pro ToolBox, and turn on Always On. Your VPN then stays on all the time.

Pro ToolBox options

Show the server location

In Setting → Pro ToolBox, turn on Show Location. After you connect, the app shows where the server is.

Pin the connected config

In Setting → Pro ToolBox, turn on Pin Outbound. The connected config is pinned to the top of the main page.

Test configs before connecting

In Setting → Pro ToolBox, turn on Test Outbound before Start. The app tests the configs before it connects.

Turn on fragment

Fragment splits the first TLS packet into small pieces, which can help get past filtering. Read more in How the TLS trick works.

  1. Tap the connection in the app.
  2. Turn on Fragment.
  3. Enter these suggested values:

    packets: tlshello
    length: 100-200
    interval: 10-20
    

Fragment settings in FoXray

Depending on your internet provider, you may need other values. You can also change the packet type from tlshello to TCP segments 1-3, although filtering may detect this mode sooner:

packets: 1-3

Last update: February 26, 2026

Comments