GUIDE
Why Vinipuch works only with official sing-box
Published: 2026-09-18 · Updated: 2026-09-20
Vinipuch deliberately runs only the official SagerNet sing-box client: SFI, SFA, SFW, SFM and SFL. Third-party shells are not supported. That keeps core compatibility, a predictable remote-profile import and a support path we can actually follow. Download the client from the Vinipuch download page; the profile link comes from the bot or the cabinet.
What “official sing-box” means here
The official client is SagerNet’s builds, not “any app that accepts a link”. iPhone installs SFI from the App Store. Android uses SFA from Google Play or an APK. Windows is SFW, macOS is SFM, Linux is SFL from the download page.
The service protocol is VLESS with Reality on that same core. Setup for you is one remote profile link, not a hand-edited JSON file.
SFI / SFA / SFW / SFM / SFL
iPhone: SFI from the App Store, listing "sing-box MT". Android: SFA from Google Play, otherwise an APK. Windows: the SFW installer. macOS: SFM via Universal pkg or Homebrew — it is no longer on the Mac App Store. Linux: the SFL package for your distro.
You do not need the GitHub catalog in a browser. The download page already picks the store or the file for your system. The files are official builds. We do not rebuild them.
Why we do not support third-party shells
Compatibility and core updates
A shell lives on its own clock. The core updates on another. The gap produces failures that support cannot reproduce. The official client removes that layer.
A predictable profile import
A remote profile is the supported path: paste the link, the client pulls servers and refreshes them when they change. In an arbitrary shell the import may be named differently or need a manual edit.
The risk of a random installer
A third-party APK or a “handy client” from a chat is someone else’s code, updates and data policy. We do not claim every shell is malware. We claim something else: we do not support that path and we do not recommend it.
The right path: download, import, turn on
Download the official client for your system. In the bot or cabinet open Connect and copy the personal link. In the client create a Remote profile and paste the link. Turn the profile on and accept the system permission for network configuration if the OS asks.
Common mistakes
Wrong client: an app that is not from the stores and not from the Vinipuch download page. Stale link: open Connect again; you do not need to reinstall. Missing OS permission: the tunnel will not come up without it. Profile not refreshed after a server change: that is what a remote profile is for.
Short answers
Can I use another shell?
You can paste a link into many apps. Officially Vinipuch supports original sing-box only. We do not recommend or support third-party shells.
Where do I get the client?
On the Vinipuch download page: SFI from the App Store, SFA from Google Play, SFW / SFM / SFL as installers on the same page.
Do I have to build the config by hand?
No. You need the personal remote profile link from the bot or the cabinet.
sing-box documentation (SagerNet)