undercode_
  1. Главная
  2. Блог
  3. GitHub Releases: как найти нужную версию программы и проверить файл
Человек через лупу сверяет скачанную коробку с карточкой релиза, робот рядом держит список с галочками

Разбор15 мин чтения

GitHub Releases: как найти нужную версию программы и проверить файл

Как найти Releases в репозитории GitHub, выбрать файл под свою систему, отличить Latest от Pre-release и проверить загрузку по SHA256 и attestation.

Содержание · 15 разделов

Многие программы для разработчиков, утилиты и open source приложения выкладывают свои сборки на GitHub, на странице Releases. Там лежат файлы от самих авторов проекта. На этой же странице есть ловушки: метка Latest иногда стоит не у самой свежей версии, архивы «Source code» оказываются снимком исходников, а не установщиком, а репозиторий, найденный через поиск, может оказаться подделкой.

Ниже порядок действий: как найти релиз, выбрать файл под свою систему и проверить скачанное тремя способами, от контрольной суммы до подписанной записи о сборке. Скачивание, проверка суммы через shasum, а также gh release verify, gh release verify-asset и gh attestation verify прогнаны на релизе GitHub CLI (cli/cli, версия v2.103.3) на macOS с gh 2.102.0, дата сверки 4 ноября 2026 года. Команды sha256sum, Get-FileHash и gh release download --archive приведены по документации, локально мы их не запускали. Определения и правила взяты из документации GitHub, ссылки стоят у соответствующих разделов. Вывод команд в блоках ниже местами сокращён: длинные хэши заменены многоточием, часть служебных строк убрана. Интерфейс GitHub и вывод команд со временем меняются, поэтому сверяйтесь с текущей справкой.

Коротко

  • Релизы лежат по адресу github.com/ВЛАДЕЛЕЦ/РЕПОЗИТОРИЙ/releases, последний стабильный открывается по /releases/latest.
  • Метку Latest автор назначает сам, иначе GitHub ставит её по семантическому версионированию. Запрос «последний релиз» в API черновики и pre-release не возвращает.
  • «Source code (zip)» и «Source code (tar.gz)» это снимок репозитория на момент тега, а не гарантированно готовый установщик. Готовую сборку ищите среди прикреплённых автором файлов, её в релизе может и не быть.
  • Для каждого загруженного файла GitHub считает SHA256 и показывает его рядом с файлом. Посчитайте сумму у себя и сравните.
  • Если релиз неизменяемый (Immutable), gh release verify-asset проверит, что файл входит в этот релиз. Если проект дополнительно публикует записи о сборке, gh attestation verify покажет, где и как файл собран.
  • Совпавшая сумма означает только одно: у вас тот же файл, что в релизе. Если сам репозиторий поддельный, сумма тоже совпадёт, поэтому начинать нужно с проверки репозитория. Отсутствия уязвимостей или вредоносного кода не гарантирует ни одна из этих проверок.

Что такое релиз, тег и файлы релиза

Релиз на GitHub строится на Git-теге, метке, которая фиксирует определённую точку в истории проекта. К тегу автор добавляет описание изменений (release notes) и прикладывает файлы: установщики, архивы с программой, пакеты для Linux. В документации GitHub их называют binary files, в интерфейсе они собраны в блок Assets.

Кроме файлов автора, GitHub сам добавляет в каждый релиз два архива: zip и tarball с содержимым репозитория на момент создания тега. Это снимок исходников, а не гарантированно готовый установщик. Если нужна готовая сборка, ищите её среди прикреплённых файлов и сверяйтесь с инструкцией проекта: готовых сборок в релизе может и не быть.

Что видно на странице релизаЧто это на самом деле
Номер версии, например v2.103.3Git-тег, привязанный к коммиту
Текст под заголовкомRelease notes, описание изменений от автора
Файлы вроде gh_2.103.3_macOS_arm64.zipСборки, которые автор загрузил сам
Source code (zip), Source code (tar.gz)Снимок репозитория, GitHub создаёт его сам

Как убедиться, что репозиторий настоящий

На GitHub обнаруживали поддельные проекты. В феврале 2025 года «Лаборатория Касперского» сообщила о двухстах с лишним репозиториях с фальшивыми проектами, через которые распространяли стилеры, клипперы и бэкдоры. Там же отмечено, что подробная документация и множество коммитов создают иллюзию настоящего и безопасного кода. Аккуратный вид репозитория поэтому ничего не доказывает.

Перед скачиванием проверьте три вещи:

  1. Переходите на GitHub с официального сайта или из документации программы, а не из поисковой выдачи, рекламы или описания под видео.
  2. Сравните имя владельца и репозитория со ссылкой на сайте посимвольно. В адресе github.com/cli/cli первое слово означает аккаунт или организацию, второе название репозитория.
  3. Если сайт ведёт сразу на файл, посмотрите адрес ссылки: он должен вести в тот же репозиторий, а не в чужой аккаунт с похожим названием.

Звёзды, длинный README и сотни коммитов не заменяют этих проверок.

Где найти Releases в репозитории

Путей три:

  • справа от списка файлов есть блок Releases, ссылка в нём открывает список релизов;
  • допишите /releases к адресу репозитория: https://github.com/cli/cli/releases;
  • допишите /releases/latest, и откроется последний релиз.

Ссылка /releases/latest перенаправляет на конкретный тег. На 4 ноября 2026 года для GitHub CLI это выглядело так:

curl -sI https://github.com/cli/cli/releases/latest | grep -i ^location
location: https://github.com/cli/cli/releases/tag/v2.103.3

Что значат Latest и Pre-release

Метку Latest на странице релизов назначает автор (документация GitHub о релизах): при публикации он может выбрать Set as latest release. Если он этого не сделал, GitHub ставит метку автоматически по семантическому версионированию. Поэтому Latest иногда оказывается не у того релиза, что стоит в списке первым.

У API своё правило для запроса «последний релиз» (/repos/ВЛАДЕЛЕЦ/РЕПОЗИТОРИЙ/releases/latest, описание в REST API): это самый свежий релиз, который не помечен как черновик или pre-release, с сортировкой по полю created_at. Это поле хранит дату коммита, из которого сделан релиз, а не дату публикации.

Pre-release автор ставит, чтобы предупредить, что сборка не готова для рабочего использования и может быть нестабильной. По правилам семантического версионирования такие версии помечают суффиксом через дефис, например 1.0.0-alpha или 2.0.0-rc.1, и они младше финальной: 1.0.0-alpha меньше 1.0.0. Если программа нужна для работы, берите релиз с меткой Latest или последний без пометки Pre-release.

Найти и скачать релиз можно в браузере, а сумму для проверки 1 считают стандартной командой системы. Командам gh из этой статьи нужен GitHub CLI, установленный по официальной инструкции, и вход командой gh auth login. Из терминала список релизов смотрят командой gh release list. Метка Latest стоит в отдельной колонке:

gh release list -R cli/cli --limit 3
GitHub CLI 2.103.3  Latest  v2.103.3  2026-10-26T19:20:08Z
GitHub CLI 2.103.2          v2.103.2  2026-10-23T20:24:12Z
GitHub CLI 2.103.1          v2.103.1  2026-10-23T16:24:01Z

Флаг --exclude-pre-releases убирает из списка предварительные версии. Черновики релизов посторонний пользователь не увидит: в списках они появляются только у тех, у кого есть право записи в репозиторий.

Какой файл скачать

В одном релизе часто лежат сборки под разные системы и процессоры. У GitHub CLI в версии 2.103.3 в релизе 22 файла:

Файлы в релизе v2.103.3Для какой системы
gh_2.103.3_macOS_amd64.zip, gh_2.103.3_macOS_arm64.zipmacOS
gh_2.103.3_windows_386.msi, _amd64.msi, _arm64.msi и такие же .zipWindows
.deb, .rpm и .tar.gz с linux в имени: 386, amd64, arm64, armv6Linux
gh_2.103.3_checksums.txtконтрольные суммы, это не программа

Система и процессор здесь указаны в самом имени: macOS, windows, linux и amd64, arm64, 386. Расширение само по себе систему не определяет. Архив .zip в этом релизе есть и для macOS, и для Windows, .tar.gz для Linux, а GitHub ещё и выдаёт архивы исходников в тех же форматах. Ориентируйтесь на полное имя файла. Единого правила имён у проектов нет, поэтому сверяйтесь с разделом установки в README: там обычно сказано, какой файл брать.

Если не знаете архитектуру своего процессора, посмотрите сведения о системе в настройках ОС или в инструкции проекта. На Mac с чипом Apple, где мы проверяли, команда uname -m вывела arm64, и этому соответствует файл gh_2.103.3_macOS_arm64.zip. Рядом с нужным файлом сразу скачайте файл контрольных сумм, если автор его выкладывает. Если в релизе есть подписи (.sig, .asc и подобные), способ их проверки описан в инструкции проекта: у каждого он свой.

Скачивать можно и из терминала. Команда gh release download с флагом --pattern берёт только файлы, подходящие под шаблон, а не весь релиз:

gh release download v2.103.3 -R cli/cli -p "*macOS_arm64.zip" -p "*checksums.txt"

Проверка 1. Контрольная сумма SHA256

GitHub сам считает SHA256 (в интерфейсе это digest) для всех загруженных в релиз файлов в момент загрузки и показывает его рядом с каждым файлом. Речь о файлах, загруженных автором, архивов Source code это не касается.

Посчитайте сумму скачанного файла. На macOS:

shasum -a 256 gh_2.103.3_macOS_arm64.zip
d700207eae9ae98fe2b89535c2c087c07823d4628c56364695a5a07ef311c062  gh_2.103.3_macOS_arm64.zip

На Linux то же делает sha256sum из coreutils, в Windows команда PowerShell Get-FileHash, у неё SHA256 стоит по умолчанию:

sha256sum gh_2.103.3_linux_amd64.tar.gz
Get-FileHash .\gh_2.103.3_windows_amd64.zip

Сравните результат с суммой рядом с файлом на странице релиза. Всё 64-символьное значение должно совпасть полностью, иначе файл не тот. Изменение даже одного символа в содержимом файла меняет хэш.

Если автор выложил файл с суммами, как у GitHub CLI, можно проверить сразу всё скачанное. Флаг --ignore-missing пропускает строки для файлов, которых у вас нет:

shasum -a 256 -c --ignore-missing gh_2.103.3_checksums.txt
gh_2.103.3_macOS_arm64.zip: OK

Тот же digest отдаёт API без входа в аккаунт: в ответе https://api.github.com/repos/cli/cli/releases/latest у каждого файла есть поле digest со значением вида sha256:d700207e….

Совпадение суммы доказывает одно: у вас тот же файл, что лежит в релизе. Если репозиторий поддельный, сумма тоже совпадёт, ведь злоумышленник выложил файл сам.

Проверка 2. Файл точно из этого релиза

У неизменяемых (immutable) релизов GitHub автоматически создаёт release attestation, криптографически проверяемую запись с тегом релиза, SHA коммита и файлами релиза. По ней можно убедиться, что ваш файл в точности совпадает с опубликованным. Проверку делает GitHub CLI (справка gh release verify-asset). Без входа в аккаунт gh эту команду не выполняет и просит gh auth login (так было в нашем прогоне), поэтому сначала выполните gh auth login:

gh release verify-asset v2.103.3 gh_2.103.3_macOS_arm64.zip -R cli/cli
Calculated digest for gh_2.103.3_macOS_arm64.zip: sha256:d700207e…c062
Resolved tag v2.103.3 to sha1:63837fb778d6a39f02be0ce76ff89f2bc8d74bdc
Loaded attestation from GitHub API

✓ Verification succeeded! gh_2.103.3_macOS_arm64.zip is present in release v2.103.3

Команда посчитала SHA256 файла, нашла коммит, на который указывает тег, загрузила запись релиза и нашла в ней этот файл. Для проверки мы дописали в копию архива один байт и запустили ту же команду:

gh release verify-asset v2.103.3 tampered.zip -R cli/cli
attestation for v2.103.3 does not contain subject sha256:90b12bf4…71fb

Код выхода в этом случае был 1, так что проверку можно ставить в скрипт.

Команда gh release verify v2.103.3 -R cli/cli проверяет, что у релиза есть действительная подписанная запись. Она выводит ✓ Release v2.103.3 verified! и список файлов из этой записи с их SHA256. Конкретный файл у вас на диске проверяет verify-asset. Архивы Source code через verify-asset проверить нельзя: GitHub создаёт их только в момент запроса на скачивание.

Проверка 3. Где и как файл собран

Отдельная проверка отвечает на вопрос, откуда файл взялся. Artifact attestations, по документации GitHub, позволяют установить, где и как собрано программное обеспечение. В нашем примере запись указывает на сборку через GitHub Actions. Проверка (справка gh attestation verify):

gh attestation verify gh_2.103.3_macOS_arm64.zip --repo cli/cli
Loaded 1 attestation from GitHub API

The following policy criteria will be enforced:
- Predicate type must match:................ https://slsa.dev/provenance/v1
- Source Repository URI must match:......... https://github.com/cli/cli
- OIDC Issuer must match:................... https://token.actions.githubusercontent.com

✓ Verification succeeded!

- Attestation #1
  - Build repo:..... cli/cli
  - Build workflow:. .github/workflows/deployment.yml@refs/heads/trunk

Это значит, что файл собран в репозитории cli/cli сценарием deployment.yml. В подробном выводе (--format json) видно и остальное: сборка шла на сервере GitHub (github-hosted), из коммита 63837fb…, на который указывает тег v2.103.3. Для изменённой копии архива ответ другой:

gh attestation verify tampered.zip --repo cli/cli
Error: no attestations found

Команде обязательно нужен флаг --repo или --owner: вы сами указываете, из какого репозитория или организации ждёте файл. Поэтому подлинность репозитория снова остаётся на вас.

Если gh attestation verify ничего не находит у файла, скачанного со страницы настоящего релиза, это само по себе не признак подделки: проект мог не публиковать записи о сборке. Тогда остаются контрольная сумма, инструкция проекта по его подписям и проверка репозитория.

Неизменяемые релизы: что защищено

Когда автор публикует неизменяемый релиз, на нём фиксируются две вещи. Тег привязывается к конкретному коммиту: его нельзя передвинуть и нельзя удалить, пока существует релиз. Прикреплённые файлы нельзя изменить или удалить. Если репозиторий удалят и создадут заново с тем же именем, теги неизменяемых релизов из старого репозитория использовать не получится.

Неизменяемые релизы стали общедоступными 28 октября 2025 года. Включает их автор в настройках репозитория или организации. После этого неизменяемыми становятся все новые релизы, а уже существующие остаются изменяемыми, пока их не опубликуют заново. Если настройку потом выключить, релизы, созданные при включённой, останутся неизменяемыми. У релиза без метки Immutable главными остаются контрольная сумма и инструкция проекта.

Признак виден на странице релиза: под заголовком стоит Immutable. Из терминала так:

gh release view v2.103.3 -R cli/cli --json tagName,isImmutable,isPrerelease
{"isImmutable":true,"isPrerelease":false,"tagName":"v2.103.3"}

Заголовок, описание и пометки Latest и pre-release автор может менять и у неизменяемого релиза.

Что значит Verified у тегов и коммитов

Если коммит или тег подписан ключом GPG, SSH или S/MIME и подпись проверяется, GitHub ставит рядом отметку Verified или Partially verified. Есть и режим строгой проверки (vigilant mode): после его включения неподписанные коммиты и теги, которые пользователь создаёт у себя и отправляет на GitHub, помечаются как Unverified.

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

Архивы Source code: почему сумма может не совпасть

Архивы исходников GitHub собирает командой git archive в момент запроса. Настройки сжатия со временем меняются: содержимое при неизменном теге остаётся тем же, но байты архива могут стать другими. В 2023 году такое изменение уже было, и вместе с архивами поменялись все их контрольные суммы.

Старый SHA256 автоматически созданного архива поэтому нельзя считать гарантированно стабильным: несовпадение может быть вызвано сменой упаковки, а не содержимого (документация GitHub об архивах). Чтобы зафиксировать версию исходников, сохраните полный SHA коммита, на который указывает тег, и берите исходники именно этого коммита. Клонировать по тегу удобно для выбора версии. Тег неизменяемого релиза закреплён за конкретным коммитом, а для остальных релизов надёжнее сохранить SHA. Архив конкретного коммита всегда имеет одно и то же содержимое, пока коммит есть в репозитории и имя репозитория не менялось. Скачать архив релиза из терминала можно так:

gh release download v2.103.3 -R cli/cli --archive zip

Прямая ссылка на файл последней версии

Для файла, который автор загрузил вручную, GitHub поддерживает ссылку вида /releases/latest/download/ИМЯ_ФАЙЛА. Она ведёт на файл с этим точным именем в релизе, на который указывает latest. 4 ноября 2026 года ссылка на gh_2.103.3_checksums.txt через latest/download у GitHub CLI открывалась. Постоянной ссылкой на обновления она служит, только если автор сохраняет имя файла: у GitHub CLI в имя входит номер версии, и если в следующем релизе файла с таким именем не будет, ссылка перестанет его находить.

Чек-лист перед установкой

  1. Репозиторий открыт по ссылке с официального сайта, имя владельца и проекта совпадает посимвольно.
  2. Релиз отмечен Latest или стоит последним среди релизов без пометки Pre-release.
  3. Скачан файл под вашу систему и процессор из прикреплённых автором, если вам нужна готовая сборка, а не исходники.
  4. SHA256 файла совпадает с суммой на странице релиза или в файле checksums.
  5. Если релиз отмечен Immutable, gh release verify-asset пишет Verification succeeded.
  6. Если проект публикует записи о сборке, gh attestation verify ПУТЬ_К_ФАЙЛУ --repo ВЛАДЕЛЕЦ/РЕПОЗИТОРИЙ проходит.

Эти шесть пунктов подтверждают совпадение с опубликованным файлом и заявленное происхождение. Отсутствия уязвимостей или вредоносного кода они не гарантируют даже у настоящего проекта.

Если что-то не совпало, не запускайте файл. Скачайте его заново со страницы релиза, а при повторном расхождении спросите авторов проекта в Issues.

Частые вопросы

Нужен ли аккаунт GitHub, чтобы скачать релиз? Нет. Опубликованные релизы доступны всем, файлы скачиваются со страницы без входа. Вход нужен для команд gh, которыми мы проверяли файлы: без него gh release verify-asset и gh attestation verify просят выполнить gh auth login.

Как скачать последнюю версию по постоянной ссылке? Страница последнего релиза открывается по /releases/latest. Для файла есть ссылка /releases/latest/download/ИМЯ_ФАЙЛА: она находит файл, пока в последнем релизе есть файл с таким точным именем.

Совпала сумма SHA256. Значит, программа безопасна? Нет. Сумма подтверждает только совпадение с файлом релиза, а поддельный репозиторий проходит эту проверку так же.

Почему Latest стоит не у самой новой версии? Метку назначает автор вручную, а если не назначил, GitHub выбирает её по семантическому версионированию.

Сколько запросов к API можно сделать без входа? Основной лимит REST API GitHub для запросов без авторизации составляет 60 в час. Хватит ли его, зависит от того, сколько запросов делает ваш скрипт.

Читайте также

Источники

  1. About releases - GitHub Docs
  2. Linking to releases - GitHub Docs
  3. REST API endpoints for releases - GitHub Docs
  4. Managing releases in a repository - GitHub Docs
  5. Downloading source code archives - GitHub Docs
  6. Update on the future stability of source code archives and hashes - The GitHub Blog
  7. Immutable releases are now generally available - GitHub Changelog
  8. GitHub CLI | Take GitHub to the command line
  9. GitHub CLI | Take GitHub to the command line
  10. Verifying the integrity of a release - GitHub Docs
  11. Releases now expose digests for release assets - GitHub Changelog
  12. Using artifact attestations to establish provenance for builds - GitHub Docs
  13. GitHub CLI | Take GitHub to the command line
  14. About commit signature verification - GitHub Docs
  15. Displaying verification statuses for all of your commits - GitHub Docs
  16. GitHub CLI | Take GitHub to the command line
  17. GitHub CLI | Take GitHub to the command line
  18. GitHub CLI | Take GitHub to the command line
  19. Rate limits for the REST API - GitHub Docs
  20. Semantic Versioning 2.0.0 | Semantic Versioning
  21. Malicious code in fake GitHub repositories | Kaspersky official blog
  22. Get-FileHash (Microsoft.PowerShell.Utility)
  23. sha2 utilities (GNU Coreutils 9.12)
  24. Immutable releases
Консультация · 60 минут · 6 000 ₽Обсудить свою задачуОпишите задачу в Telegram-боте, разберём её на созвоне.