
РазборЕвгений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.3 | Git-тег, привязанный к коммиту |
| Текст под заголовком | Release notes, описание изменений от автора |
Файлы вроде gh_2.103.3_macOS_arm64.zip | Сборки, которые автор загрузил сам |
| Source code (zip), Source code (tar.gz) | Снимок репозитория, GitHub создаёт его сам |
Как убедиться, что репозиторий настоящий
На GitHub обнаруживали поддельные проекты. В феврале 2025 года «Лаборатория Касперского» сообщила о двухстах с лишним репозиториях с фальшивыми проектами, через которые распространяли стилеры, клипперы и бэкдоры. Там же отмечено, что подробная документация и множество коммитов создают иллюзию настоящего и безопасного кода. Аккуратный вид репозитория поэтому ничего не доказывает.
Перед скачиванием проверьте три вещи:
- Переходите на GitHub с официального сайта или из документации программы, а не из поисковой выдачи, рекламы или описания под видео.
- Сравните имя владельца и репозитория со ссылкой на сайте посимвольно. В адресе
github.com/cli/cliпервое слово означает аккаунт или организацию, второе название репозитория. - Если сайт ведёт сразу на файл, посмотрите адрес ссылки: он должен вести в тот же репозиторий, а не в чужой аккаунт с похожим названием.
Звёзды, длинный 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.zip | macOS |
gh_2.103.3_windows_386.msi, _amd64.msi, _arm64.msi и такие же .zip | Windows |
.deb, .rpm и .tar.gz с linux в имени: 386, amd64, arm64, armv6 | Linux |
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 в имя входит номер версии, и если в следующем релизе файла с таким именем не будет, ссылка перестанет его находить.
Чек-лист перед установкой
- Репозиторий открыт по ссылке с официального сайта, имя владельца и проекта совпадает посимвольно.
- Релиз отмечен Latest или стоит последним среди релизов без пометки Pre-release.
- Скачан файл под вашу систему и процессор из прикреплённых автором, если вам нужна готовая сборка, а не исходники.
- SHA256 файла совпадает с суммой на странице релиза или в файле checksums.
- Если релиз отмечен Immutable,
gh release verify-assetпишет Verification succeeded. - Если проект публикует записи о сборке,
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 в час. Хватит ли его, зависит от того, сколько запросов делает ваш скрипт.
Читайте также
- Codex на Windows: установка, вход и песочница. Как я запустил его на своём ПК
- Docker Compose: compose.yaml, несколько сервисов и основные команды
- VPS-сервер: как выбрать ресурсы под n8n, бота и ИИ-агента
- Нейросеть для написания текста: черновик по источникам и проверка
- ИИ для создания приложений: как работать с агентами и проверять результат
Источники
- About releases - GitHub Docs
- Linking to releases - GitHub Docs
- REST API endpoints for releases - GitHub Docs
- Managing releases in a repository - GitHub Docs
- Downloading source code archives - GitHub Docs
- Update on the future stability of source code archives and hashes - The GitHub Blog
- Immutable releases are now generally available - GitHub Changelog
- GitHub CLI | Take GitHub to the command line
- GitHub CLI | Take GitHub to the command line
- Verifying the integrity of a release - GitHub Docs
- Releases now expose digests for release assets - GitHub Changelog
- Using artifact attestations to establish provenance for builds - GitHub Docs
- GitHub CLI | Take GitHub to the command line
- About commit signature verification - GitHub Docs
- Displaying verification statuses for all of your commits - GitHub Docs
- GitHub CLI | Take GitHub to the command line
- GitHub CLI | Take GitHub to the command line
- GitHub CLI | Take GitHub to the command line
- Rate limits for the REST API - GitHub Docs
- Semantic Versioning 2.0.0 | Semantic Versioning
- Malicious code in fake GitHub repositories | Kaspersky official blog
- Get-FileHash (Microsoft.PowerShell.Utility)
- sha2 utilities (GNU Coreutils 9.12)
- Immutable releases