Skip to content

TUN Mode

Jump to bottom
Loren Eteval edited this page Dec 5, 2025 · 17 revisions

Supported platform

  • Windows
  • macOS
  • Linux (since version 0.6.0)

How to use

Windows

  • Download wintun.dll from here and put it in C:\Windows\System32\.
  • Launch application with Adminstrator privilege. Enable TUN Mode in settings.

Note

Since version 0.6.0:

You can use built-in "Restart The Application As Administrator" entry in "Tools" menu which is much more convenient.

macOS

  • No other dependency required. Launch application via sudo Furious-GUI. Enable TUN Mode in settings.

Note

Since version 0.6.0:

You can use built-in "Restart The Application As Superuser" entry in "Tools" menu which is much more convenient.

Warning

After launching the application as Superuser on macOS, some shortcuts are not working, e.g. copy & paste config.

Linux (since version 0.6.0)

  • TUN mode is available in non-superuser mode, but requires privileged script execution during connection process. You need to enter the superuser password as prompted to connect successfully in TUN mode.

Choose Routing Option

Warning

Under TUN mode, current routing option should not contain direct rules, otherwise a connection loop would occur:

traffic -> TUN -> Core -> direct rules -> TUN -> Core -> direct rules -> ...

You can use:

  • Built-in Global routing option, meaning it does not have direct rules and will proxy all traffic.

Note

Since version 0.6.0:

The application will ask if you want to switch to global mode and reconnect.

Verify

To verify that TUN mode is working properly, try initiating direct connection from your apps or games.

Here are some basic examples using curl:

Example A

curl icanhazip.com

Verify that you get your server IP as response.

Customize TUN Settings

Prior to version 0.5.0, the TUN settings needed to properly configure the system were automatically set by the application in a hard-coded manner. Now, I have designed them to be configurable through a GUI window to provide more flexibility.

Note

In most cases the automatic settings will work just fine

However, there are some situations that the automatic settings cannot handle. I will list some of them below:

Multiple network cards installed

You have more than one network card installed on your computer and the application cannot determine which one should be used as the primary interface. In this case, you need to provide the correct settings manually.

Automatic settings failed

The automatic settings will fail on some older operating systems, such as Windows 7. By manually providing the TUN settings, I was able to run TUN mode successfully during win7 testing.

Example custom settings

image

Memory Optimization

Optimize the memory usage for best performance. See https://github.com/xjasonlyu/tun2socks/wiki/Memory-Optimization

Clone this wiki locally
⚡