SingLinkLabs · Protocol Paper 01
SingLink Protocol Technical Whitepaper
SingLink 2.0 architecture, complete connection life cycle and protocol boundaries
SingLink 2.0 is a formal network transmission protocol independently developed by SingLinkVPN, not a client software version. This article takes the control plane, data plane and complete connection life cycle as the main lines to explain the protocol's public capabilities, reference implementation model, test data boundaries and external protocol differences.
- Document
- SLP-WP-01
- Revision
- 1.0
- Published
- 2026-07-29
- Language
- English
Protocol generations and client versions are managed independently. Node availability is subject to the real-time status of the client.
Subscribe to whitepaper updatesScope and evidence
Scope, Conclusions and Evidence Boundaries
This is not a marketing page, but a system description from configuration acquisition to connection cleanup. Each item distinguishes between confirmed capabilities, public design descriptions, and reference implementation models.
SingLink 2.0 is the official network transmission protocol generation independently developed by SingLinkVPN. "2.0" represents the protocol name and protocol generation, not the software version number of Windows, macOS, Android, iOS or other clients.
The product boundary of the protocol is not just a byte format from client to server, but also involves account and node permissions, DNS processing, intelligent offloading, node selection, session health detection, network switching and failure recovery.
From the product page, client capabilities and official public caliber.
Describe the problem that the protocol needs to solve and the currently exposed system boundaries.
Used to explain possible implementations, not equivalent to a published binary specification.
Versioning
Protocol generations are not software versions
Protocol
SingLink 2.0
Represents the overall evolution of transport protocol generations, capability negotiation, session models, and compatibility policies.
Client software
Each platform has its own number
Windows, macOS, Android, iOS, Linux and TV clients are managed according to their respective release rhythms and will not be mixed with protocol 2.0.
System architecture
Separation of control plane and data plane
The control plane is responsible for permissions, configuration and node scheduling; the data plane is responsible for the channels that actually carry user traffic. Separating the two helps limit the scope of sensitive data and isolate failures.
Control plane
control surface
- 01 Account and package permissions
- 02 Node and protocol capability list
- 03 Short-term configuration, strategy and revocation
- 04 Node health and scheduling information
Data plane
Data plane
- 01 Traffic taking over and forwarding
- 02 TCP, UDP and logical flow bearer
- 03 Session status and health detection
- 04 Return data decapsulation
Connection lifecycle
22 processing stages
From account permissions, system network entrance to return data decapsulation and security cleanup, the following process retains complete technical links and marks the evidence status for each step.
- 01
Account login and permission confirmation
Confirmed capabilitiesThe client obtains the available packages, nodes and protocol permissions of the current account. Authentication credentials should be short-lived, revocable, and decoupled from subsequent data forwarding status.
- 02
Node and protocol configuration delivery
Public design descriptionThe control plane returns the node address, port, available protocols and necessary policies, and should not directly deliver long-term master keys or unnecessary sensitive fields to the client.
- 03
Establish system network entrance
Confirmed capabilitiesThe client receives the traffic that needs to be processed through TUN mode, system proxy or platform network extension. The specific entrance depends on the capabilities of the operating system.
- 04
DNS resolution and domain name determination
Confirmed capabilitiesConsistent policies must be used for DNS requests and subsequent connections to avoid domain names going through proxies while DNS is still leaking from the local network or causing erroneous diversion.
- 05
Intelligent traffic distribution and routing judgment
Confirmed capabilitiesDetermines connections as direct, proxy, or blocked based on rules, application, target domain name, IP, and network status.
- 06
Node selection
Confirmed capabilitiesThe manual mode uses user-specified nodes; the intelligent mode can select candidate nodes based on latency, availability, load, region and package permissions.
- 07
Protocol capability negotiation
Public design descriptionThe client and server confirm the protocol generations and capabilities supported by both parties. The old client should not silently enable incompatible behaviors when it cannot recognize new capabilities.
- 08
Authentication and anti-replay
Reference implementation modelNodes verify that the account or session is valid and should prevent old authentication data from being reused through aging, randomization, or equivalent mechanisms.
- 09
Key exchange and session keys
Reference implementation modelThe protocol requires establishing a separate encryption context for the current connection. The specific cipher suites, handshake fields and rotation periods must be subject to future public specifications.
- 10
Create Session
Reference implementation modelSession represents the transmission session between the client and the node, which can carry connection status, capability information, heartbeats, and one or more logical flows.
- 11
Establish a Stream or independent proxy connection
Reference implementation modelEach application request can be mapped to a logical Stream within the Session, or an independent connection can be established; the final method depends on the public implementation.
- 12
Data frame encapsulation
Reference implementation modelDestination information, stream identification, payload length, control commands, and data are required to form a parsable frame; this page does not invent undocumented binary fields.
- 13
TCP traffic processing
Public design descriptionTCP byte streams need to maintain order, handle half-closes and abnormal closes, and pass application-side backpressure to the transport side.
- 14
UDP and QUIC traffic processing
Public design descriptionUDP datagrams need to retain message boundaries and manage session timeouts; UDP-type services such as QUIC also need to avoid unnecessary head-of-line blocking.
- 15
Flow control and backpressure
Reference implementation modelWhen the consumption speed of the client, node or target service slows down, the buffer growth should be limited to prevent a single Stream from bringing down the entire Session.
- 16
Subpackaging, Padding and traffic appearance
Reference implementation modelPacketization and padding can only be used as part of the transmission strategy and cannot be described as absolute stealth; its enabling conditions and overhead require testing and verification.
- 17
MTU and packet size handling
Public design descriptionTunnel overhead will reduce the available MTU, and large packet failures need to be reduced through fragmentation avoidance, MSS adjustment, or equivalent mechanisms.
- 18
Delay, packet loss and congestion handling
Reference implementation modelThe protocol should control the sending rhythm and retransmission based on network feedback, and distinguish between real packet loss, queuing delay and short-term network jitter.
- 19
Heartbeat and health detection
Confirmed capabilitiesContinuously monitor session and node status to avoid relying solely on the operating system's long timeouts to detect dead connections.
- 20
Network switching and session recovery
Confirmed capabilitiesAfter switching between Wi-Fi and mobile networks, the client re-confirms the network entrance, DNS, routing and transmission sessions, and resumes the connection according to its capabilities.
- 21
Node failure and automatic switching
Confirmed capabilitiesIn the case of a soft failure, the session can be rebuilt first, and in the case of a hard failure, available nodes can be switched. During the switching process, system routing must be restored and traffic should be avoided from unexpected direct connections.
- 22
Return data, decapsulation and security cleanup
Public design descriptionThe client verifies and decapsulates the returned data, and clears temporary session status, cache keys, routing and DNS changes after the connection is completed.
Traffic entry and routing
Traffic takeover, DNS and intelligent offloading
System network entry, domain name resolution and routing judgment must share the same context to avoid DNS leaks, error exits and unexpected direct connections.
Desktop systems can use TUN mode or system proxy; mobile and TV platforms use their respective network expansion capabilities. Different platforms have different APIs, but the policy goals are the same: traffic that requires a proxy enters the tunnel, and traffic that does not require a proxy is directly connected according to rules.
Proxying only application traffic and allowing DNS to continue to go through the local network may expose the domain name or obtain resolution results that are not suitable for the current exit. Therefore, domain name matching, DNS query, IP caching and connection establishment must use the same routing context.
direct connection
Local services or targets that explicitly do not require a proxy use the local network.
agent
After permission verification, the connection is established through the selected SingLink node.
block
Denied connection when security rule is hit or target without permission is hit.
Authentication
Authentication and encrypted sessions
Permission confirmation answers "Can this account use this node and protocol"; Transmission authentication answers "Whether the current connection is from a valid client". Both should use short-lived, revocable session state and prevent old authentication information from being replayed.
The client and node also need to confirm the protocol generations and capabilities supported by both parties. A side that does not recognize the new capabilities must safely downgrade or refuse the connection and cannot enable incompatible behavior without confirmation.
Disclosure boundary
Unpublished cryptographic details
Existing information is insufficient to identify specific handshake fields, cipher suites, key derivation functions, rotation periods, and binary packet formats. This article only describes security goals and does not write AES, TLS versions, certain curves, or fixed field lengths as fait accompli.
Session model
Session, Stream and Data Frame
Use a hierarchical session model to explain the relationship between application connections, logical flows, and node transport contexts while clarifying undisclosed format boundaries.
Session
The transport context between the client and the node can carry authentication results, capabilities, heartbeats, and connection-level flow control.
Stream
A Logic App connection. Whether multiple Streams share Sessions depends on the final public implementation and platform policy.
The data frame needs to express at least control commands, logic flow, load boundaries and error status; before the official format is made public, this page will not give an unverified field table.
Transport
TCP, UDP and QUIC
TCP
ordered byte stream
Maintain byte order, handle half-close, abnormal close, back pressure and target connection errors, and prevent slow connections from filling up the Session buffer.
UDP
datagram boundaries
Preserve datagram boundaries and maintain target and timeout status; if UDP-over-TCP is used, head-of-line blocking and packet loss amplification need to be evaluated.
QUIC
Reliable transport over UDP
Try to retain QUIC's own congestion and retransmission advantages to avoid repeated recovery caused by additional reliability layers.
Reliability
Flow control, MTU, heartbeat and recovery
Stable connection is not an automatic reconnect button, but a state machine composed of buffering, packet packaging, health detection, route recovery and node switching.
flow control
Adjust the sending window according to the consumption speed to avoid blocking the entire session with a single stream.
MTU handling
Consider the additional overhead of tunnels to reduce the risk of fragmentation and black holes.
health check
Determine the connection based on heartbeat, delay, packet loss and real forwarding status.
network recovery
After the network is cut off, the portal, DNS, routing and sessions are rebuilt to prevent traffic from being accidentally directly connected.
Product comparison
SingLink 2.0 and Beta
| indicator | SingLink 2.0 | SingLink Beta |
|---|---|---|
| Positioning | formal agreement between generations | Speed-first preview protocol |
| Internal A/B testing stability rate | 99.5% | Up to about 97% |
| Speed focus | Balance of speed, stability and compatibility | Peak value exceeds 1Gbps under suitable conditions |
| Protocol node permissions | Pro, Max and Rich | All packages |
| change strategy | Focus on long-term compatibility and recovery | Used for new capability and performance verification |
External protocols
Boundary comparison with VLESS and AnyTLS
The basis for comparison is the official public documents of each project. Here we compare positioning, system boundaries and disclosure capabilities, and do not mix marketing numbers into the underlying protocol conclusions.
| Dimensions | SingLink White Paper Scope | VLESS public scope | AnyTLS public scope |
|---|---|---|---|
| public positioning | The overall system of product control plane and transmission data plane | Stateless, lightweight client and server transport protocol | TLS-based proxy protocol and reference implementation |
| Identity and Purpose | Account, node permissions, session and routing collaboration | UUID, command, port and target address | TLS post-authentication, then establish session |
| Session/Stream | Reference model explanation, precise format not yet disclosed | Support Mux, the details are determined by implementation and configuration | Expose session frames, Stream multiplexing and commands |
| traffic appearance | Transmission strategy to be verified, does not claim absolute invisibility | Official documents describe optional Flow and other mechanisms | Disclosure of subcontracting, padding plans and update mechanisms |
| Resilience | Health detection, network cut-off, session reconstruction and node switching | Responsible for Xray ecology and specific transmission combination | Protocol v2 exposes SYNACK, heartbeat and server negotiation |
| product system | DNS, intelligent offloading, package permissions and node scheduling | Not equivalent to a complete VPN product control surface | Not equivalent to a complete VPN product control surface |
This table does not represent code compatibility, performance rankings, or security audit conclusions.
Platforms and openness
Cross-platform compatibility and open source boundaries
Platform consistency
SingLinkVPN covers iOS, Android, Windows, macOS, Linux and TV devices. Cross-platform consistency does not mean that each platform uses the exact same system API, but maintains the same set of permissions, routing, node and protocol selection logic, and adheres to the network expansion limitations of each operating system.
Public scope
The SingLink 2.0 core protocol source code has not yet been fully disclosed. Published directions include technical documentation, architecture descriptions, research data, reproducible testing methods, data formats, verification tools, and responsible vulnerability disclosure infrastructure.
Frequently asked questions
FAQ
Q01What is SingLink 2.0?
SingLink 2.0 is a formal network transmission protocol generation independently developed by SingLinkVPN. It is used to organize identity and authority verification, traffic routing, transmission sessions, TCP and UDP processing, health detection and exception recovery.
Q02Is SingLink 2.0 the client software version?
No. SingLink 2.0 is the protocol name and protocol generation. Windows, macOS, Android, iOS and other clients use independent software version systems.
Q03What is the difference between SingLink Beta and SingLink 2.0?
Beta is a preview protocol for speed and new capability verification; SingLink 2.0 is the official protocol generation, paying more attention to stability, cross-platform consistency, connection recovery and long-term compatibility.
Q04What is the stability rate of SingLink 2.0?
SingLinkVPN’s internal A/B testing record in designated testing environments is 99.5%, with a Beta peak of approximately 97%. These are not guarantees for all regions and time periods, and actual results will be affected by network operators, node loads, equipment and testing methods.
Q05How does SingLink handle network traffic?
The client first establishes a system network entrance, completes DNS and intelligent distribution, then selects nodes, verifies permissions, establishes a transmission session, and encapsulates TCP or UDP data before sending it to the node.
Q06How does SingLink handle disconnections and network switches?
The client continuously monitors session and node status. When an exception occurs, the session will be rebuilt, DNS and routing restored, or switched to other available nodes based on capabilities.
Q07What is the difference between SingLink and VLESS?
VLESS is officially positioned as a stateless, lightweight client and server transmission protocol. The scope described in the SingLink white paper is wider and also covers the product control plane, node permissions, intelligent routing, health detection and recovery processes; the two should not be compared based on a single frame format.
Q08What is the difference between SingLink and AnyTLS?
The AnyTLS public specification focuses on describing authentication, Session, Stream reuse, Padding and heartbeat over TLS. The SingLink white paper also describes client traffic entry, DNS, routing, package permissions and node scheduling, so the comparison is based on system boundaries rather than claiming that the underlying implementation is the same.
Q09Who can use SingLink 2.0?
Currently, SingLink 2.0 protocol nodes are mainly open to Pro, Max and Rich packages; SingLink Beta protocol nodes are open to all packages. The actual available nodes are subject to real-time display on the client.
Q10Is SingLink 2.0 fully open source?
At present, the source code of the core protocol has not been fully disclosed. Technical documents, research data, test methods, data formats, verification tools and vulnerability disclosure mechanisms have been included in the continuous open source plan. The disclosure scope is subject to the SingLinkLabs warehouse and official announcements.
References and revision
Data, internal links and change records
External protocol information
Next step
Experience SingLink 2.0 protocol
SingLink 2.0 nodes are mainly open to Pro, Max and Rich packages. The number of nodes and protocol availability are subject to real-time display on the client.