Skip to content

README_en.md

Latest commit

 

History

History
58 lines (35 loc) · 3.41 KB

README_en.md

File metadata and controls

58 lines (35 loc) · 3.41 KB

ClashBox

DownloadsLast VersionLicense

Channel

Note

This document is machine translated and may contain errors.
If you find a bug, you can report it on the Issues page.

Most of the code of this project is open source. To view it, please go to the Master branch.

Introduction

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

Please read the disclaimer and FAQ carefully before use.

Software Features

  • 💻 Native development: The front-end is developed using the HarmonyOS native language ArkTS, offering smoother performance and richer animations.
  • ✨ Cool interface: Built with HarmonyOS NEXT’s native design style, using a Surfboard-like layout. Supports dark mode, blur effects, and more for an enhanced experience.
  • 📱 Multi-device adaptation: Optimized UI for phones, tablets, foldables, HarmonyOS PCs, and even PuraX external screens*.
  • 🚀 Stable kernel: Powered by the well-regarded Mihomo (ClashMeta) core, with feature parity and reliable stability.
  • 🔄 Core recovery: Because HarmonyOS NEXT’s background scheduling is still immature, background processes may be killed by the system. ClashBox includes a built-in recovery mechanism that automatically restarts the core process if it’s terminated (this is automatically enabled when “Background Run – Simulated Picture-in-Picture” is turned on).

*The PuraX external screen currently only displays Huawei-whitelisted apps. This app will not be available until it is whitelisted.

How to Use

You can install ClashBox using Auto-installer or DevEcho Testing.

Important

Huawei’s signing server blocks IP addresses outside mainland China. To sideload HarmonyOS NEXT apps outside of mainland China, please use a proxy or other methods to obtain a mainland China IP address.

Note

Apps sideloaded with self-signed certificates on HarmonyOS NEXT are only valid for 14 days by default. After developer real-name authentication, the validity period can be extended to 180 days.

Real-name authentication may require a Chinese resident ID card.

Sponsorship & Contact

We are now on Afdian! If you’d like to support our project, you can sponsor us here:
https://afdian.com/a/ClashBox

Thank you for your support ❤️