Skip to content

Latest commit

 

History

21 Commits

Folders and files

Repository files navigation

⚠️ Security notice

Malicious clones of this project exist on GitHub. They copy the source code but replace the README with links to a ZIP archive hosted inside the repository tree. These archives are not mine. Do not download or run them.

This repository is the only official source. Builds are published exclusively via the Releases page - this project never distributes ZIP archives from the repo tree, and never asks you to run a loose .exe from an extracted folder.

If you arrived here from a search engine, check the account name in the URL above.

TunnelCrab 🦀

A friendly Windows client for VLESS/Reality with a reactive crab UI.

TunnelCrab is built around one idea: connecting should not require users to understand Reality, SNI, connection modes or technical logs. Add a link or subscription, choose a server and press one button.

The crab reacts to the connection state, errors are explained in plain language, and the technical details stay out of the way.

Download

Русская версия ниже

Screenshots

TunnelCrab main screen TunnelCrab servers screen TunnelCrab about screen

Download

TunnelCrab is distributed as a ready-to-use Windows installer through the official GitHub Releases page. Download the latest installer there — the source code is not required to run the app.

This repository is published for transparency and review. It is not currently a full developer SDK or a reproducible build environment, and it intentionally omits build, signing and packaging tooling.

Supported

  • VLESS + Reality over TCP
  • VLESS + Reality over XHTTP / SplitHTTP
  • HTTP(S) subscriptions (plaintext, base64, or mixed content)

Not supported yet

  • Hysteria2
  • Shadowsocks
  • Trojan
  • VMess
  • VLESS over TLS / WebSocket / gRPC import

Links for unsupported modes are recognized and politely refused with a plain-language explanation, rather than failing silently.

Requirements

  • Windows 10 / 11
  • Microsoft Edge WebView2 Runtime (preinstalled on most modern Windows)

Platforms

TunnelCrab is currently focused on Windows 10 / 11.

Other platforms may be considered later if there is enough interest. If you would like to see TunnelCrab on macOS, Linux, Android, or iOS, feel free to share feedback through GitHub or the Telegram channel.

Troubleshooting

  • Blank white window on Windows 10 usually means the Microsoft Edge WebView2 Runtime is missing. Install the Evergreen Runtime from https://developer.microsoft.com/microsoft-edge/webview2/ and restart TunnelCrab.
  • SmartScreen / "this app may harm your device" is usually a reputation warning for early or low-reputation builds — not a guaranteed malware verdict. Windows may warn until the app and publisher build more reputation. Choose "Keep" / "More info → Run anyway" only if you trust the source.
  • Uninstalling removes the app but keeps your data (profiles, settings, logs) under %APPDATA%\TunnelCrab, so reinstalling picks up where you left off. For a full cleanup, delete that folder manually. Logs live in %APPDATA%\TunnelCrab\logs.

Release integrity

  • Each installer on GitHub Releases is published together with a SHA256 checksum file (<installer>.exe.sha256). The in-app updater verifies this checksum before installing and refuses to run a download that doesn't match.
  • Download TunnelCrab only from the official GitHub Releases page.

License

MIT — see LICENSE.


⚠️ Предупреждение о безопасности

На GitHub существуют вредоносные клоны этого проекта. Они копируют исходный код, но подменяют README ссылками на ZIP-архив, лежащий прямо в дереве репозитория. Эти архивы не мои. Не скачивайте и не запускайте их.

Единственный официальный источник - этот репозиторий. Сборки публикуются только на странице Releases - проект никогда не раздаёт ZIP-архивы из дерева репозитория и никогда не просит запускать .exe из распакованной папки.

Если вы пришли сюда из поисковика - проверьте имя аккаунта в ссылке выше.

TunnelCrab 🦀 — RU

Удобный Windows-клиент для VLESS/Reality с живым крабиком в интерфейсе.

TunnelCrab сделан вокруг простой идеи: подключение не должно требовать от пользователя разбираться в Reality, SNI, режимах подключения и технических логах. Достаточно добавить ссылку или подписку, выбрать сервер и нажать одну кнопку.

Крабик реагирует на состояние подключения, ошибки объясняются понятным языком, а сложная техническая часть остаётся в фоне

Download

Загрузка

TunnelCrab распространяется как готовое приложение для Windows через официальные GitHub Releases. Большинству пользователей достаточно скачать оттуда последнюю версию — исходный код для запуска приложения не нужен.

Исходный код в этом репозитории опубликован для прозрачности и ревью. Сейчас это не полный developer SDK и не воспроизводимая сборочная среда; инструменты сборки, подписи и упаковки сюда сознательно не входят.

Поддерживается

  • VLESS + Reality поверх TCP
  • VLESS + Reality поверх XHTTP / SplitHTTP
  • Подписки по HTTP(S) (обычный текст, base64 или смешанное содержимое)

Пока не поддерживается

  • Hysteria2
  • Shadowsocks
  • Trojan
  • VMess
  • Импорт VLESS поверх TLS / WebSocket / gRPC

Ссылки на неподдерживаемые режимы распознаются и вежливо отклоняются с понятным объяснением, а не ломаются молча.

Требования

  • Windows 10 / 11
  • Microsoft Edge WebView2 Runtime (предустановлен в большинстве современных Windows)

Платформы

Сейчас TunnelCrab сфокусирован на Windows 10 / 11.

Другие платформы могут появиться позже, если будет достаточно интереса. Если тебе хотелось бы увидеть TunnelCrab на macOS, Linux, Android или iOS — можно написать об этом через GitHub или Telegram-канал.

Устранение неполадок

  • Пустое белое окно на Windows 10 обычно значит, что не установлен Microsoft Edge WebView2 Runtime. Установите Evergreen Runtime с https://developer.microsoft.com/microsoft-edge/webview2/ и перезапустите TunnelCrab.
  • SmartScreen / «приложение может навредить устройству» — обычно это предупреждение о репутации для новых или малоизвестных сборок, а не гарантированный вердикт о вирусе. Windows может предупреждать, пока приложение и издатель не накопят больше репутации. Нажмите «Сохранить» / «Подробнее → Выполнить в любом случае», только если доверяете источнику.
  • Удаление убирает приложение, но сохраняет ваши данные (профили, настройки, логи) в %APPDATA%\TunnelCrab, чтобы после переустановки всё продолжило работать с того же места. Для полной очистки удалите эту папку вручную. Логи лежат в %APPDATA%\TunnelCrab\logs.

Целостность релиза

  • Каждая сборка в GitHub Releases публикуется вместе с файлом контрольной суммы SHA256 (<имя-файла>.exe.sha256). Встроенный апдейтер проверяет эту сумму перед установкой и отказывается запускать файл, если контрольная сумма не совпадает.
  • Скачивайте TunnelCrab только со страницы официальных GitHub Releases.

Лицензия

MIT — см. LICENSE.

Releases

Packages

Contributors

Languages