Light-weight Clash/Mihomo proxy client for Steam OS
为 Steam OS 设计的轻量的 Clash/Mihomo 代理客户端

EN | 中文

Features

• ✅ Full featured: Mihomo core included
• 🚀 Blazing fast: optimized frontend and backend
• 📦 Easy to use: out of the box, with subscriptions importer and installation guide, etc.
• 🔒 Focus on security: random controller password, controllable outside access, etc.
• ⚙️ Friendly to maintain: written by Python and Node.js (React & Vite)
• 💡 Keep update: built-in upgrade tool to keep 3rd-party resources update
• 🌍 I18n ready: currently with Chinese (Simplified) and English support

Screenshots

License

This project is licensed by BSD 3-Clause License .

Install

Prerequisite

Install Decky Loader

curl -L https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/install_release.sh | sh

Online Install Script (Recommended)

curl -L https://github.com/chenx-dust/DeckyClash/raw/refs/heads/main/install.sh | bash

The installation script will download the latest release from Github, as well as necessary third-party resources such as the latest Mihomo core, the latest yq processor, recommended Dashboards, and the Geo files required by the core.

The script includes functions to download nightly versions and update third-party resources, which can be viewed through the -h parameter:

curl -L https://github.com/chenx-dust/DeckyClash/raw/refs/heads/main/install.sh | bash -s -- -h

Offline Installer

Note

This offline installer includes all necessary third-party resources. However, it may not be up-to-date as the online installer.

1. Go to Latest Release and download Installer-DeckyClash.sh

2. Use any method to send the installer to your target device, e.g. USB, SCP, etc.

3. Grant executable permission to the installer

   chmod +x Installer-DeckyClash.sh

4. Run the installer and follow the instructions

   ./Installer-DeckyClash.sh

Upgrade

Plugin will automatically check for updates every time you enter the Steam interface. If there is a new version, a toast will be shown.

Built-in upgrade

1. Enter the Quick Access Menu and select DeckyClash
2. Find the Version column and click the Manage Upgrades button
3. The program will automatically check for updates, and the Latest Version row will display
4. If Latest Version and Installed Version are different, an upgrade button will be shown, click to start

Full upgrade

(Same as the installation step)

Upgrade Third-Party Resources

Execute the following command:

curl -L https://github.com/chenx-dust/DeckyClash/raw/refs/heads/main/install.sh | bash -s -- --without-plugin --without-restart --yes

Uninstall

Caution

The script uninstalls DeckyClash, which will delete all files, including settings, subscriptions, downloaded Dashboards, etc. Please use with caution.

curl -L https://github.com/chenx-dust/DeckyClash/raw/refs/heads/main/install.sh | bash -s -- --clean-uninstall

Development Guide

See DEV_GUIDE.md for details.

Acknowledge

• MetaCubeX/mihomo: DeckyClash is powered by Mihomo.
• mikefarah/yq DeckyClash uses yq as its YAML processor.
• YukiCoco/ToMoon: DeckyClash is inspired by To Moon.