What is shadowsocks-ohos?

shadowsocks/shadowsocks-ohos — explained in plain English

Analysis updated 2026-07-25

★ 12RustAudience · developerComplexity · 4/5Setup · hard

Mindmap

mindmap
  root((repo))
    What it does
      Encrypted proxy client
      Bypass network restrictions
      Import ss links
    Tech stack
      Rust
      ArkTS
      ArkUI
    Use cases
      Private web browsing
      Access restricted content
      Secure traffic routing
    Audience
      HarmonyOS users
      Privacy conscious users
    Limitations
      Needs Huawei app approval
      Limited plugin support
      No UDP via plugins

mindmap root((repo)) What it does Encrypted proxy client Bypass network restrictions Import ss links Tech stack Rust ArkTS ArkUI Use cases Private web browsing Access restricted content Secure traffic routing Audience HarmonyOS users Privacy conscious users Limitations Needs Huawei app approval Limited plugin support No UDP via plugins

What do people build with it?

USE CASE 1

Route your device's internet traffic through an encrypted connection to bypass network restrictions.

USE CASE 2

Import a Shadowsocks connection profile via an ss:// link and connect on a HarmonyOS NEXT device.

USE CASE 3

Run the app in a HarmonyOS emulator for testing using the included debug signing script.

What is it built with?

RustArkTSArkUIHarmonyOS NEXTshadowsocks-rust

How does it compare?

	shadowsocks/shadowsocks-ohos	0xdea/ttyinject-rs	bigsaltyfishes/wallpaper-engine-for-macos
Stars	12	12	12
Language	Rust	Rust	Rust
Setup difficulty	hard	moderate	hard
Complexity	4/5	4/5	4/5
Audience	developer	researcher	developer

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Huawei DevEco Studio, HarmonyOS NEXT SDK, and the Rust compiler configured for HarmonyOS targets.

So what is it?

This project builds a Shadowsocks client for HarmonyOS NEXT, which is Huawei's operating system version 5.x. Shadowsocks is a tool that helps people route their internet traffic through an encrypted connection to a remote server, commonly used to bypass network restrictions. Older HarmonyOS devices (versions 2 through 4) can run Android apps, so they use a different version of this tool. This one is specifically for HarmonyOS NEXT, which no longer supports Android apps at all. The app is written in two layers. The user interface uses ArkTS and ArkUI, which are HarmonyOS's native programming tools. The networking core, however, is written in Rust and comes from a shared codebase called shadowsocks-rust that the Android version also uses. A bridge layer connects the two so the same core logic runs on both platforms. The interface lets users import connection profiles from ss:// links, fill out a form, and connect. Building the project requires Huawei's DevEco Studio with the HarmonyOS NEXT SDK, plus the Rust compiler configured for HarmonyOS targets. The build process compiles the Rust core into a static library, then links it into a HarmonyOS app package. A provided script can sign the app for debug testing without a Huawei developer account. Running it on the emulator requires installing the app with Huawei's hdc tool. The project includes several layers of testing. Host-based tests run without any HarmonyOS SDK and check the Rust core, the C bridge, and a full encrypted round-trip using a virtual network interface. There are also unit tests for URL parsing and on-device tests that run against a HarmonyOS emulator. A tun mode routes all device traffic through the encrypted tunnel using a built-in network stack. Some limitations exist. Third-party VPN apps need Huawei's approval before they can be distributed through the app store. SIP003 plugins, which add extra obfuscation to traffic, run inside the process because HarmonyOS cannot launch external plugin programs. Only specific plugins are supported, and UDP traffic does not work through them. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1

Help me set up the HarmonyOS NEXT SDK and Rust compiler targets so I can build the shadowsocks-ohos project in DevEco Studio.

Prompt 2

Write a script to automate building the Rust core into a static library and linking it into the HarmonyOS app package for shadowsocks-ohos.

Prompt 3

Explain how to use the hdc tool to install and run the shadowsocks-ohos app on a HarmonyOS emulator for debug testing.

Prompt 4

Help me parse an ss:// link into the connection form fields required by this Shadowsocks HarmonyOS client.

Frequently asked questions