ClashBox

ClashBox/ClashNEXT is the first proxy software based on the Navigation framework for HarmonyOS NEXT(OpenHarmony) platform, using a modified Mihomo(ClashMeta) kernel.

Welcome to the 2025 ClashBox/ClashNEXT usage tutorial

Note

ClashBox is not yet open source, please use with caution.

Available on Overseas AppGallery

https://appgallery.huawei.com/app/detail?id=org.xbgroup.clashbox

Software Features

ArkTS Development: The frontend is developed using ArkTS, more fluid with richer animations;

Cool Interface: Uses HarmonyOS NEXT design style, adopts UI layout design similar to Surfboard, supports dark mode, blur effects, etc., providing a further improved user experience;

Multi-device Adaptation: UI has been adapted for phones, tablets, foldable screens, HarmonyOS computers and even PuraX outer screen*;

Stable Kernel: Uses the widely praised Mihomo(ClashMeta) kernel, with functions basically aligned with Mihomo(ClashMeta), stable and reliable;

Core Recovery: Due to HarmonyOS NEXT's background scheduling mechanism not being mature yet, the software may have background processes killed by the system, so ClashBox has built-in core recovery functionality. After the system kills the process, the core process will be automatically restored (this function will be automatically enabled after turning on "Background Running - Simulate Picture-in-Picture").

Outer Screen Note

PuraX outer screen currently only displays apps in Huawei's whitelist. It is temporarily unavailable until this software is added to the whitelist.

Get ClashBox/ClashNEXT

Download from Huawei AppGallery by changing regions

• Another HarmonyOS 4.2 device changes region in Huawei AppGallery, then HarmonyOS 5.0 logs into Huawei AppGallery to search for ClashBox

• Side-load clashbox, open global mode and select Hong Kong node, then open Huawei AppGallery to search for ClashBox

• Download FlClash to Zhuoyitong, then open global mode and select Hong Kong node, then search for ClashBox in AppGallery

• Re-register a Huawei Hong Kong region account, domestic mobile number can register. After registration, go to settings to exit the original Huawei mainland account and switch to the newly registered Hong Kong region. Finally go to App Gallery to search for ClashBox

Download from Github repository, then use developer tools for installation

• Github download: https://github.com/xiaobaigroup/ClashBox/releases
• Then use Auto-installer for installation
• Or use DevEcho Testing for installation

Regional Restrictions

Huawei's signing server blocks IP addresses from outside mainland China. To side-load software for HarmonyOS NEXT in countries/regions outside mainland China, please use proxy or other methods to use mainland China IP addresses.

Validity Period Note

Apps side-loaded on HarmonyOS NEXT using self-signing method have a default validity period of only 14 days. After completing Developer Real-name Verification, the validity period can be extended to 180 days.

Add Subscription

In the Jego - Control Panel, click on Subscription Nodes in the left navigation bar, find the Mihomo subscription address and click Copy.

Jego subscription service mobile panel: https://jego.us

ClashBox/ClashNEXT Usage Tutorial

Configure Subscription

Open ClashBox, go to the Configuration page, then click the + in the bottom right corner to add subscription

Start Proxy

Open ClashBox, on the Home page directly click the ▶ in the bottom right corner to start and bypass restrictions.

Switch Nodes

Open ClashBox, go to the Proxy page, then select according to your needs.

The usage method is similar to other similar software, you can refer to FlClash, or refer to the original product Clash for Android