Как скачать INCY с GitHub — официальный репозиторий INCY-DEV/incy-platforms

INCY распространяется с открытым исходным кодом, и единственный официальный источник сборок — репозиторий INCY-DEV/incy-platforms на GitHub. Именно оттуда берут файлы страница скачивания на этом сайте и встроенное автообновление приложения. Разберём, как устроен репозиторий, где лежат релизы, какой файл нужен для вашей платформы, как проверить контрольную сумму и что делать, если нашли ошибку.

Официальный репозиторий INCY на GitHub и как отличить подделку

Адрес репозитория один: github.com/INCY-DEV/incy-platforms. Организация называется INCY-DEV, а «incy-platforms» — общее название проекта, в котором собраны клиенты для всех платформ. Краткая карточка репозитория с актуальными ссылками есть и на нашей странице INCY на GitHub.

• Организация INCY-DEV. Репозитории пользователей с похожими именами (incy-dev, incydev, incy-vpn) не имеют отношения к проекту.
• История релизов. У оригинала десятки тегов с подписанными файлами; у форка обычно один-два «релиза» с exe без контрольных сумм.
• Ссылки с сайта. Все кнопки на странице скачивания ведут в раздел Releases именно этого репозитория.

Где раздел Releases и что значит Latest

На главной странице репозитория справа есть блок Releases с пометкой Latest — это последняя стабильная версия. Полный список открывается по ссылке /releases, а прямая ссылка /releases/latest всегда ведёт на актуальный релиз, поэтому её удобно сохранить в закладки. Внутри каждого релиза три части: описание изменений (changelog), список файлов Assets и автоматически созданные архивы исходного кода.

Архивы Source code (zip) и Source code (tar.gz) — это исходники, а не программа. Их скачивают разработчики для сборки; пользователю нужны только файлы из списка Assets.

Как узнавать о новых версиях

Без аккаунта GitHub подойдёт RSS-лента релизов по адресу /releases.atom — её понимает любая читалка новостей. С аккаунтом нажмите Watch → Custom → Releases, и уведомления о стабильных версиях будут приходить на почту. Установленное приложение проверяет обновления само, так что подписка нужна в основном тем, кто ставит портативные или Linux-сборки вручную.

Какой файл скачать с GitHub: Windows, macOS, Linux, Android

Чаще всего с GitHub качают именно версию для Windows: установщик весит около 45 МБ, портативный архив — чуть больше, и оба обновляются одновременно с остальными платформами. Если в списке Assets нет файла для вашей системы, значит релиз ещё выкладывается — подождите несколько минут и обновите страницу, а не берите файл из предыдущей версии.

Подробные инструкции по каждой платформе есть в отдельных статьях: INCY на ПК, INCY APK для Android и INCY на Linux. Для iPhone и Apple TV репозиторий не нужен — приложение ставится из App Store.

Проверка SHA256SUMS: зачем и как

В каждом релизе лежит файл SHA256SUMS.txt со строками вида <хеш> <имя файла>. Сравнение хеша гарантирует, что файл не был повреждён при загрузке и не подменён по дороге. Это занимает десять секунд:

cd ~/Downloads
sha256sum -c SHA256SUMS.txt --ignore-missing
# macOS: shasum -a 256 -c SHA256SUMS.txt --ignore-missing

Get-FileHash .\incy-windows-setup.exe -Algorithm SHA256
Select-String "incy-windows-setup.exe" .\SHA256SUMS.txt

Если хеши совпали — устанавливайте. Если нет, удалите файл и скачайте заново: чаще всего причина в оборванной загрузке, но при повторном несовпадении стоит проверить, с того ли адреса вы качали.

Pre-release и стабильные версии: что выбрать

Часть релизов помечена серым бейджем Pre-release — это бета-версии с новыми функциями, которые ещё не прошли полное тестирование. Автообновление в INCY их не предлагает, а ссылка /releases/latest их пропускает. Ставить пре-релиз имеет смысл, если в changelog заявлено исправление именно вашей проблемы или поддержка нового протокола, который уже включил ваш провайдер. В остальных случаях держитесь стабильных версий: подписки и профили маршрутизации сохраняются при откате, а вот отладка бета-багов отнимет время.

Как читать номер версии

Теги вида v2.4.1 — стабильные, v2.5.0-beta.3 — пре-релизы. Первое число меняется при несовместимых изменениях формата настроек, второе — при новых функциях, третье — при исправлениях. Перед крупным обновлением сделайте копию папки с настройками: на Windows это %APPDATA%\INCY.

Как сообщить об ошибке через Issues

Раздел Issues — единственный канал, где разработчики отслеживают баги. Перед созданием обращения пройдитесь по типовым проблемам на странице INCY не работает: половина вопросов решается сменой сервера или профиля маршрутизации.

1. 01

   Поищите похожий issue

   Введите текст ошибки в поиск по Issues, включая закрытые. Если нашли — добавьте комментарий с вашей версией и системой, а не создавайте дубликат.

2. 02

   Соберите данные

   Версия INCY, версия ОС, протокол (VLESS Reality, Trojan, VMess), режим (TUN или прокси) и лог из «Настройки → Диагностика → Экспорт лога».

3. 03

   Заполните шаблон

   Нажмите New issue, выберите Bug report и опишите шаги воспроизведения: что нажали, что ожидали, что получили.

Что дальше после скачивания

Установка занимает пару минут, а дальше нужен ключ: подписка стороннего провайдера с готовыми серверами — на странице тарифов есть пробный доступ на 1 день бесплатно — либо собственный VPS. Пошаговая первичная настройка описана в разделе как настроить INCY.