Configuration examples

for more configuration examples, including Route Rules or Dns configuration, please refer to sing-box's official documentation.

Mixed inbound:

var mixedInbound = Pouyan.SingBox.Inbound.CreateMixedInbound( listen:"127.0.0.1", listenPort: 3080 );

Tun inbound:

• Please note that tun inbound requires your app to have administrator privileges.

var tunInbound = Pouyan.SingBox.Inbound.CreateTunInbound();

Parse outbound profiles:

var myProfileUrl = "trojan://myLovelyPassword@myserver.server:443?security=tls&sni=mySni&type=grpc&serviceName=myGrpcPath#MyTrojanServer"; var myProfile = ProfileParser.ParseProfileUrl(myProfileUrl);

Additionally you can convert parsed profiles back to string url:

var myProfileUrl = myProfile.ToProfileUrl();

Running

• In order to use this library for running sing-box you first need to obtain it's executable from its original repository.
• You need to have the path to this executable and pass it to Tunnel's constructor.

var singbox = new Pouyan.SingBox.Tunnel("sing-box.exe", [mixedInbound]);

• you can pass a CancellationToken to the SingBoxWrapper.StartAsync method, if you cancel it, the sing-box proccess will end. this parameter is optional.
• if you need sing-box's logs, you need to subscribe to the Onlog event (optional).

var cts = new CancellationTokenSource(); singbox.StartAsync(myProfile, cts, (sender , log) => { Console.WriteLine(log); });

Take outbounds from subscribe:

var profiles = SingBox.GetProfile.GetProfilesFromSubscribe(url);

Url testing

You can use UrlTestAsync classes to easily test if the proxies are healthy and valid

var myProfileUrl = "trojan://myLovelyPassword@myserver.server:443?security=tls&sni=mySni&type=grpc&serviceName=myGrpcPath#MyTrojanServer"; var myProfile = ProfileParser.ParseProfileUrl(myProfileUrl); var profileTester = new ProfileTester("sing-box.exe"); var test = await profileTester.UrlTestAsync(myProfile, 7087); Console.WriteLine($"Success: {test.Result.Success}, Delay: {test.Result.Delay}");

List<ProfileItem>:

var test = await profileTester.UrlTestAsync(profiles);