Skip to main content

FAQ

Frequently asked questions about Diodos

Answers grouped by topic. If yours is missing, ask in the Telegram group or open a GitHub issue.

01

Project and platforms

What is Diodos?
Diodos is a network tool built on the Clash core, available as a desktop client and an Android client. It gives you a graphical interface for subscriptions, nodes, proxy modes and connection diagnostics. It does not provide nodes or subscriptions itself — you bring your own configuration.
Which operating systems are supported?
The desktop builds cover Windows x64 (installer and portable), macOS (Apple silicon and Intel) and Linux x64 (AppImage and deb). Android ships as APK builds covering arm64-v8a, armeabi-v7a, x86_64, x86 and universal. Every build is listed publicly on the GitHub Releases pages.
Does it cost anything?
No. Diodos is an open-source project and the installers are free to download. There are no accounts and no paid tier.
Is the current build stable?
The latest version is 0.3.5, marked Alpha. It iterates quickly, so you may hit interface or compatibility rough edges — the release notes are the best place to track changes.
02

Android client

How does Diodos Android relate to the desktop app?
Diodos Android is the Android client of Diodos, also built on the Clash core. It is developed and released in the separate Diodos-Android repository, with versioning and release cadence independent from the desktop builds. It shares the same design language: the componentized dashboard, subscription management and the AI assistant.
Where do I get the Android version, and which APK should I pick?
Open the Android channel page and tap “Download latest APK”, or pick an architecture build on the GitHub Releases page. Most phones released in recent years work with arm64-v8a; if unsure, choose the universal APK — it is larger but runs on every architecture.
Is my configuration shared between Android and desktop?
Both clients import subscriptions the same way: YAML / JSON config files, node links or Base64 subscription URLs. Configuration is stored locally on each device and does not sync automatically, so import it separately on every device.
03

Installation and system prompts

macOS says it cannot verify the developer. What now?
That is Gatekeeper blocking an app that has not been notarized by Apple. Open System Settings → Privacy & Security, find the blocked message and choose “Open Anyway”; alternatively right-click the app icon and select Open.
Windows shows a SmartScreen warning.
Unsigned installers trigger SmartScreen. Once you have confirmed the file came from the GitHub Releases page, choose “More info → Run anyway”. If the source is unclear, delete the file and download it again from the official release page.
The app will not open or crashes on launch.
First check that the build matches your system architecture (for example, Apple silicon needs the arm64 DMG). If it still fails, open a GitHub issue with your OS version and the app logs.
04

Profiles and subscriptions

How do I import a subscription?
There are four routes: import a YAML profile, import a JSON profile, paste a single node link, or paste a Base64 subscription URL. After importing, the subscription card shows usage and expiry where available.
Which protocols are supported?
Protocol support comes from the Clash core. Common profiles use Shadowsocks, VMess, VLESS, Trojan, Hysteria2, TUIC, WireGuard, SOCKS5 and HTTP, all of which can be loaded. Actual availability depends on your subscription and core version.
A subscription update keeps failing.
Diodos includes bounded retries and an alternate route. If it still fails, check that the URL is reachable and not expired, then read the error — the app wraps long errors and redacts credentials in addresses.
05

Features and usage

What does TUN mode require?
TUN creates a virtual interface to capture system traffic, so the first activation needs administrator (Windows) or root (macOS / Linux) permission. If you do not need system-wide capture, the system proxy alone is enough.
Can I customise the dashboard?
Yes. Preview the layouts a card supports before adding it, then drag to reorder, switch layouts or remove it. Preferences persist across sessions, and layouts from older versions migrate automatically.
How does route tracing work?
Open route tracing on the tools page, enter a target and start probing. You get per-hop latency and packet loss statistics, path nodes plotted on a rotatable globe, and a report you can copy in one action.
Where do I change the interface language?
You can switch the app language at any time; dates and durations reformat to match. This website is available in Simplified Chinese, English and Traditional Chinese via the selector at the far right of the navigation bar.
06

Privacy and compliance

Does Diodos upload my data?
Diodos runs locally as a desktop client. Profiles and logs stay on your machine and no account is required. Subscription updates and latency tests connect directly to the addresses you configured, not through project servers.
Is using Diodos legal?
Diodos is only a network client and provides no routes of its own. Follow the laws and regulations of your country or region, and use it only for lawful diagnostics and managing networks you own.
How do I report a problem or suggest a feature?
Open an issue on GitHub (include your OS version, app version and reproduction steps), or join the Telegram group to talk with other users.

Ready to try it?

Download the build for your platform — you will be running in minutes.

Windows macOS Linux Free & open source

This is an Alpha release. Things move quickly — feedback on GitHub or Telegram is welcome.