shadowsocks / shadowsocks/shadowsocks-org

Deprecation of legacy ss:// link format

Open
#167 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
HTML
Stars
1k
Forks
694
PR merge metrics
No merged PRs in 30d

Description

SIP002 has been the standard of ss:// URL scheme for over 3 years. During the period, almost all Shadowsocks clients have added support for SIP002 URLs. Many implementations now actually default to SIP002 URLs when exporting as links. This includes Outline server and Qv2ray. Some new implementations like shadowsocks-rust only support SIP002 URLs.

Shadowsocks-windows has been using SIP002 as the default ss:// URL scheme since v4.2.0. Support for the legacy ss:// link format has effectively been dropped in v5 by the reimplementation of the URL parser and generator.

We are looking to get other implementations to work together with us to deprecate the legacy link format, and towards the ultimate goal of completely dropping support for it.

To begin with, I'm proposing that all client implementations should remove the ability to export links in the legacy link format. Our website should be updated to reflect the deprecation status.

Related issue: #152.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Read related issue #152, then inspect the website content that describes ss:// links and current compatibility. The requested result is updated website wording that reflects legacy-format deprecation; the broader client-implementation coordination is outside this repository's stated scope.

Written by the indexing model from the issue text.

Assessment

Tech stack
html
Domain
documentation
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.