Percent-encoding proxy URLs without double decoding

Core idea

In a URI, @ and colon delimit userinfo, host, and port, while percent encoding represents data. Double decoding or manual concatenation can alter a password or turn part of it into a hostname.

For Percent-encoding proxy URLs without double decoding, separate the protocol specification from product features. A standard defines message formats and required behavior; a service separately defines geography, rotation, duration, and supported commands. This explains why clients accept different connection formats or omit an optional protocol capability.

What the primary source establishes

Round-trip synthetic credentials containing @, colon, percent, Unicode, and spaces without exposing real access data.

The primary source, RFC 3986 — URI Syntax, WHATWG URL Standard, curl manual, MDN URL, MDN URLSearchParams, defines the technical baseline but not every client and provider configuration. Read the normative behavior with its version and then verify your implementation. Treat anything beyond the source as a product feature that needs separate confirmation.

Controlled lab

Generate ten synthetic pairs, serialize and parse each, and call an owned proxy-auth echo returning only field hashes. Add a malformed escape and double-encoded %2540. Require validation errors or distinguishable hashes rather than silent alternate credentials.

Step-by-step verification

Use canary credentials containing reserved characters. Build the URL with a standard API, parse it, decode each field once, and compare bytes. Treat host:port:login:password as a separate non-URI format.

Build a capability matrix for address syntax, TCP or UDP, DNS location, authentication, and IPv6. Fill it from client and service documentation. Test one capability at a time on an endpoint you control, starting with basic TCP before DNS, TLS, and the application flow.

Record whether failure occurred during address parsing, authentication choice, tunnel creation, TLS, or the origin response. SOCKS errors, HTTP CONNECT rejection, and an origin 403 need different remedies even though all can look like an unopened page.

• Build a canary set
• Serialize with a URL API
• Compare field hashes
• Reject malformed and double encoding

Evidence to retain

Keep case ID, safe character set, masked serialized value, parser version, decoded hashes, status, and error category.

Capture the protocol version, client command, masked destination, intermediary code, and origin code. State who resolved DNS. Packet captures belong only on an isolated test setup and should omit payload; a sanitized verbose client log is usually sufficient.

Define report columns and time format before the run. A result without context becomes a guess: the address, cache state, and changed condition are unknown. Record controlled failures as well as successes so the check proves that it can distinguish states.

Interpreting the result

Mask userinfo before parser errors are logged. Avoid shell interpolation because a valid URL can be interpreted before the client receives it.

WHATWG and generic RFC URI parsers can differ. Some proxy tools accept proprietary non-URI formats requiring separate rules.

One successful run confirms only one client, route, and moment. Repeat while changing one variable and state the limits. When observation conflicts with documentation, rule out cache, client version, and intermediaries before creating a reproducible support case.

Worked decision process

For Percent-encoding proxy URLs without double decoding, use a matrix with capability, specification, proxy service, client, and verified behavior. Remote DNS or UDP may exist in a standard yet be unavailable in one library. Only the intersection is a supported workflow.

Capture the smallest useful trace: intermediary address, command, masked destination, intermediary result, TLS state, origin result, and DNS resolver. This separates syntax, policy, network, and origin failures without retaining payload or credentials.

Verify a second client version, one alternative address form, and a controlled failure. Publish version and platform limits beside connection examples. One successful implementation is not evidence for every client.

Common mistakes

Do not equate SOCKS5 with encryption, expect UDP from every client, omit brackets around IPv6 plus port, or treat HTTP/2 as a speed guarantee. Verify the implementation: a standardized command may be intentionally unsupported by the product or library.

Stop when errors rise, a source returns a limit, the task would require bypassing protection, or secrets enter logs. Save sanitized diagnostics and correct the cause first. More concurrency or another IP can hide the fault and add load without improving evidence.

Rollout and maintenance criteria

Define the decision boundary before rollout: which observation permits continuation, which requires review, and which stops the workflow. Record acceptable error ratio, maximum wait, and the owner of every exception so a temporary failure cannot silently become permanent configuration.

Review real load, cost, and quality after the first week. Schedule a small control after client, proxy-service, or network changes. Archive outdated instructions with their replacement date and reason so operators do not follow conflicting configurations.

Operational checklist

Turn the successful experiment into a short procedure covering owner, safe configuration, limits, and stop conditions. Every run needs a terminal status. After browser, library, or network changes, run a small control before the main queue.

• Protocol version is named
• Client capabilities are verified
• DNS path is explicit
• Proxy and origin codes differ
• The first test is minimal
• Unsupported features are not promised