Pouyan.SingBox 1.0.0.7

<div align="center">

Pouyan.SingBox

Configure and run sing-box with ease.
Based on sing-box's official documentation.

</div>

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://[email protected]: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://[email protected]: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);