# SagerNet/sing-box

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/sagernet-sing-box).**

30,696 stars · 3,587 forks · Go · other

## Links

- GitHub: https://github.com/SagerNet/sing-box
- Homepage: https://sing-box.sagernet.org/
- awesome-repositories: https://awesome-repositories.com/repository/sagernet-sing-box.md

## Description

Sing-box is a universal proxy engine and traffic router designed to manage complex network connectivity across multiple operating systems. It functions as a configuration-driven core that intercepts system-level traffic, allowing for transparent proxying through encrypted tunnels. By normalizing diverse network protocols into a unified interface, the engine enables consistent traffic forwarding and protocol translation regardless of the underlying environment.

The project distinguishes itself through a declarative configuration pipeline that validates and merges modular settings into a unified internal state before execution. It employs a rule-based traffic dispatcher that evaluates incoming packets against hierarchical criteria to determine optimal routing paths dynamically. This is complemented by an asynchronous domain name resolution pipeline, which provides granular control over how network requests are mapped and filtered, ensuring that traffic handling remains both accurate and performant.

Beyond its core routing capabilities, the platform includes a comprehensive security layer for managing encrypted connections, including support for advanced handshake options and certificate validation. It also provides tools for monitoring real-time traffic and connection status, alongside flexible management of routing rule sets that can be sourced from local or remote locations. The software is designed to be installed as a background service, providing a stable and scalable infrastructure for controlled network communication.

## Tags

### Networking & Communication

- [Proxy Engines](https://awesome-repositories.com/f/networking-communication/proxy-engines.md) — Manages complex traffic forwarding, protocol translation, and secure tunnel establishment across operating systems.
- [Network Traffic Routers](https://awesome-repositories.com/f/networking-communication/network-traffic-routers.md) — Directs traffic through multiple protocols and configurations using a universal engine designed for flexible connectivity. ([source](https://sing-box.sagernet.org/))
- [Network Tunnels](https://awesome-repositories.com/f/networking-communication/network-tunnels.md) — Intercepts and redirects device traffic through encrypted proxy protocols for private connectivity.
- [Traffic Routing Engines](https://awesome-repositories.com/f/networking-communication/traffic-routing-engines.md) — Evaluates network packets against custom rules to determine optimal paths and connection handling.
- [System Tunneling](https://awesome-repositories.com/f/networking-communication/system-tunneling.md) — Routes device traffic through secure remote tunnels to provide transparent proxying for all applications. ([source](https://sing-box.sagernet.org/clients/android/))
- [Traffic Dispatchers](https://awesome-repositories.com/f/networking-communication/traffic-dispatchers.md) — Evaluates incoming network packets against hierarchical criteria to determine the optimal outbound path dynamically.
- [Advanced Traffic Routing](https://awesome-repositories.com/f/networking-communication/advanced-traffic-routing.md) — Directs network requests to specific destinations based on complex domain and protocol rules.
- [Cross-Platform Tunneling](https://awesome-repositories.com/f/networking-communication/cross-platform-tunneling.md) — Implements transparent proxying across mobile and desktop platforms to secure device traffic.
- [DNS Pipelines](https://awesome-repositories.com/f/networking-communication/dns-pipelines.md) — Processes domain name resolution requests through a non-blocking chain of filters and caches to optimize lookup performance.
- [DNS Resolution Managers](https://awesome-repositories.com/f/networking-communication/dns-resolution-managers.md) — Defines servers, routing rules, and caching strategies to map domain names to IP addresses effectively. ([source](https://sing-box.sagernet.org/configuration/dns/))
- [DNS Query Routers](https://awesome-repositories.com/f/networking-communication/dns-query-routers.md) — Directs domain name queries to specific servers while applying caching and timeout rules to optimize resolution. ([source](https://sing-box.sagernet.org/configuration/dns/rule_action/))
- [Inbound Connection Managers](https://awesome-repositories.com/f/networking-communication/inbound-connection-managers.md) — Sets up network protocols to receive and process incoming traffic through proxy, tunnel, or direct connections. ([source](https://sing-box.sagernet.org/configuration/inbound/))
- [Outbound Connection Managers](https://awesome-repositories.com/f/networking-communication/outbound-connection-managers.md) — Defines proxy protocols and routing rules for traffic leaving the local environment to ensure correct pathing. ([source](https://sing-box.sagernet.org/configuration/outbound/))
- [Proxy Abstractions](https://awesome-repositories.com/f/networking-communication/proxy-abstractions.md) — Normalizes diverse network protocols into a unified internal interface to enable seamless switching between tunneling methods.
- [DNS Query Evaluators](https://awesome-repositories.com/f/networking-communication/dns-query-evaluators.md) — Sends domain name queries to servers and stores responses for rule matching without terminating the evaluation process. ([source](https://sing-box.sagernet.org/configuration/dns/rule_action/))
- [DNS Resolution](https://awesome-repositories.com/f/networking-communication/dns-resolution.md) — Controls domain resolution through custom servers, caching strategies, and traffic filtering.
- [DNS Responders](https://awesome-repositories.com/f/networking-communication/dns-responders.md) — Answers domain name queries with predefined records and custom response codes to control how clients resolve addresses. ([source](https://sing-box.sagernet.org/configuration/dns/rule_action/))
- [DNS Rule Engines](https://awesome-repositories.com/f/networking-communication/dns-rule-engines.md) — Creates routing rules that match specific traffic patterns and apply custom actions to manage network requests. ([source](https://sing-box.sagernet.org/configuration/dns/rule/))
- [Default Routing Managers](https://awesome-repositories.com/f/networking-communication/default-routing-managers.md) — Sets default network parameters including interface binding and routing marks for traffic that does not match specific rules. ([source](https://sing-box.sagernet.org/configuration/route/))
- [DNS Query Filters](https://awesome-repositories.com/f/networking-communication/dns-query-filters.md) — Drops domain name queries or returns specific error codes based on defined policies to block unwanted traffic. ([source](https://sing-box.sagernet.org/configuration/dns/rule_action/))
- [Routing Rules](https://awesome-repositories.com/f/networking-communication/routing-rules.md) — Defines traffic routing criteria to ensure data flows through intended network paths. ([source](https://sing-box.sagernet.org/configuration/route/))

### Security & Cryptography

- [Encrypted Connection Handlers](https://awesome-repositories.com/f/security-cryptography/encrypted-connection-handlers.md) — Manages TLS handshakes and certificate validation to protect data transit between endpoints.
- [Secure Proxy Infrastructure](https://awesome-repositories.com/f/security-cryptography/secure-proxy-infrastructure.md) — Manages encrypted proxy connections with support for multiple protocols and advanced TLS configurations.
- [TLS Management](https://awesome-repositories.com/f/security-cryptography/tls-management.md) — Configures security policies and TLS handshake options to ensure encrypted traffic remains secure.

### DevOps & Infrastructure

- [Virtual Network Tunnels](https://awesome-repositories.com/f/devops-infrastructure/virtual-network-tunnels.md) — Intercepts system-level traffic by routing packets through a virtual network interface to enable transparent proxying.

### Development Tools & Productivity

- [Configuration Managers](https://awesome-repositories.com/f/development-tools-productivity/configuration-managers.md) — Validates and formats complex network settings to maintain scalable proxy infrastructure.
- [Proxy Profile Managers](https://awesome-repositories.com/f/development-tools-productivity/proxy-profile-managers.md) — Syncs proxy settings from local or remote sources to maintain consistent network behavior. ([source](https://sing-box.sagernet.org/clients/general/))
- [Configuration Management](https://awesome-repositories.com/f/development-tools-productivity/configuration-management.md) — Merges and validates multiple configuration files into a unified operational structure.

### Software Engineering & Architecture

- [Configuration Pipelines](https://awesome-repositories.com/f/software-engineering-architecture/configuration-pipelines.md) — Parses and validates structural settings into a unified internal state to ensure consistent network behavior.

### Testing & Quality Assurance

- [Configuration Validators](https://awesome-repositories.com/f/testing-quality-assurance/configuration-validators.md) — Checks settings for syntax and structural integrity before runtime to prevent service failures.