GUIDE
Why Vinipuch works only with official sing-box
Published: 2026-09-18 · Updated: 2026-09-18
Vinipuch deliberately runs only the official SagerNet sing-box client: SFA, SFM and desktop. 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”. On phones that is SFA, on Mac it is SFM, on computers it is the Windows and Linux desktop builds. iPhone installs the client from the App Store.
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.
SFA, SFM, desktop
Phone: the app store when it is available. Computer: an installer from the Vinipuch download page. The files are official builds. We do not rebuild them.
You do not need the GitHub catalog in a browser. The download page already picks the store or the file for your system.
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: App Store, Google Play and computer installers.
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)