Встановлення Aggrega
Aggrega потребує двох речей: установленого бінарного файлу aggrega і — щоб створювати файли за допомогою ШІ-асистента — клієнта вашого асистента, підключеного до MCP-сервера, який містить бінарний файл. Спершу наведено команди; що робить кожна з них, а також інші способи встановлення описано після них.
Встановлення бінарного файлу
У Linux і macOS, у терміналі:
curl -fsSL https://aggrega.ai/install.sh | shУ Windows, у PowerShell:
irm https://aggrega.ai/install.ps1 | iexЗа допомогою Homebrew, у macOS і Linux:
brew install aggrega-ai/tap/aggregaЗа допомогою Scoop, у Windows:
scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucketscoop install aggregaЗа допомогою winget, у Windows:
winget install Cognitio.AggregaПотім перевірте, що він запускається:
aggrega versionРядок із версією означає, що бінарний файл знайдено і його можна запустити. Це все, що потрібно MCP-серверу. Розділ Кожен спосіб установлення докладно пояснює, що робить кожна команда, куди вона кладе бінарний файл і як установити його інсталятором Windows або вручну.
Підключення клієнта MCP
Клієнт вашого ШІ-асистента запускає MCP-сервер Aggrega, виконуючи aggrega mcp, а сторінка Підключення сервера MCP наводить для кожного клієнта команду або запис, що його додає. В асистенті, який встановлює плагіни, плагін Aggrega додає сервер і навичку Aggrega за один крок: див. Встановлення плагіна.
Кожен спосіб установлення докладно
Aggrega постачається як один виконуваний файл. Одна команда встановлює його; ручні кроки після неї роблять те саме вручну. Обидва способи розміщують його в одній вашій власній теці, щоразу в тій самій, і жоден не потребує прав адміністратора: ~/.local/bin/aggrega у Linux і macOS та %LOCALAPPDATA%\Programs\aggrega\aggrega.exe у Windows. У Windows інсталятор Windows і winget встановлюють його в ту саму теку, теж без прав адміністратора, і додають до списку встановлених застосунків: див. Установлення за допомогою інсталятора Windows і Установлення за допомогою winget. Homebrew у macOS і Linux та Scoop у Windows теж встановлюють його, кожен у власні теки: див. Установлення за допомогою менеджера пакетів.
Установлення однією командою
Команда встановлення — це curl -fsSL https://aggrega.ai/install.sh | sh у Linux і macOS та irm https://aggrega.ai/install.ps1 | iex у PowerShell у Windows, перші дві команди з розділу Установлення двійкового файлу. Ці дві адреси переспрямовують на скрипти встановлення, долучені до останнього випуску, тож ті самі команди працюють і з власними адресами випуску:
curl -fsSL https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.sh | shirm https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.ps1 | iexЩо робить команда:
- Вона вибирає бінарний файл за замовчуванням для вашої машини з останнього релізу: Linux і macOS на 64-бітній x86 або 64-бітній ARM, Windows на 64-бітній x86. Будь-яку іншу систему чи процесор вона відхиляє з повідомленням про те, що виявила, або до чого звернутися натомість. На Mac з Apple silicon вона вибирає бінарний файл для Apple silicon, навіть з оболонки, що працює через Rosetta 2.
- Вона перевіряє бінарний файл за
SHA256SUMSрелізу, перш ніж щось установлювати. Завантажений файл, SHA-256-дайджест якого відрізняється від наведеного в списку, видаляється, нічого не встановлюється, і команда зупиняється з повідомленням, у якому наведено обидва дайджести. - Вона встановлює бінарний файл лише для вас: як
~/.local/bin/aggregaу Linux і macOS та як%LOCALAPPDATA%\Programs\aggrega\aggrega.exeу Windows, створюючи теку, якщо її немає, і замінюючи наявну там попередню копію за один крок, тож повторний запуск команди оновлює вашу копію. Вона ніколи не використовуєsudo. У Windows вона також знімає позначку, яку може мати файл, завантажений з інтернету, як це робитьUnblock-Fileу ручних кроках. У macOS вона завантажує файл за допомогоюcurl, тож бінарний файл, який вона встановлює, не має позначки карантину (див. Готовий бінарний файл для macOS). - Вона робить команду доступною. У Linux і macOS, якщо теки немає у вашому
PATH, вона виводить команду, яка додає теку до файлу, що його ваша оболонка читає під час запуску:~/.zshrcдля zsh,~/.bashrcдля bash (~/.bash_profileу macOS),~/.config/fish/config.fishдля fish, з рядкомfish_add_path, і~/.profileдля будь-якої іншої оболонки. Сама вона цю команду не виконує: виконайте її й відкрийте новий термінал. У Windows вона додає теку до вашого користувацькогоPATH, якщо її там немає, а також доPATHвікна PowerShell, у якому працює, тожaggregaзапускається в цьому вікні та в кожному терміналі, відкритому після нього, і повідомляє, що додала теку. - Вона перевіряє, що встановлений бінарний файл запускається, і, якщо він не запускається, зупиняється з повідомленням, перш ніж налаштовувати щось інше. Вона додає примітку, якщо у вашому
PATHперед установленим нею файлом стоїть іншийaggrega. - Вона виводить установлену версію, запускаючи встановлений бінарний файл за його повним шляхом, тож версію видно ще до того, як ваш
PATHохопить цю теку. - Наприкінці вона виводить наступні кроки, під
Next:, по одному рядку на кожен: команду, що запускає швидкий старт зі ШІ, як описано на сторінці Початок роботи;aggrega skills install --global, що додає навичку Aggrega до ШІ-асистентів на вашій машині, як описано в розділі Додавання навички асистента під час установлення; і адресу цієї сторінки — для автодоповнення в оболонці та розділу Підключення клієнта MCP вище. Якщо певна опція вже встановила навичку, рядок про навичку пропускається.
Виводить вона небагато: версію та систему, для якої встановлює, рядок, щойно завантажений файл збіжеться зі своєю контрольною сумою, і шлях, куди встановила. Сторінка Початок роботи показує повний запуск. --verbose, переданий після sh -s --, як і опції нижче, також виводить адресу списку контрольних сум, назву файлу випуску та адресу, з якої його завантажує; install.ps1 має той самий перемикач як -Verbose, для запуску скрипту з аргументами, яких irm … | iex передати йому не може. Коли команда відмовляє або крок завершується невдало, вона повідомляє про це одним рядком: у стандартний потік помилок у install.sh і як помилку чи попередження, які показує PowerShell, у install.ps1:
aggrega install: error: <what went wrong> - <what to do>Скрипту для Linux і macOS, install.sh, потрібні curl або wget, uname, а також sha256sum або shasum. Скрипт для Windows, install.ps1, працює у Windows PowerShell 5.1 і в PowerShell 7.
Два налаштування змінюють те, що вона встановлює; кожне читається із середовища, у якому виконується скрипт:
AGGREGA_VERSIONзадає реліз для встановлення, наприклад0.8.7, з початковоюvабо без неї. Якщо змінну не задано, команда встановлює останній реліз — той, який GitHub позначає як останній (latest); він ніколи не буває попереднім релізом, тож попередній реліз установлюється, лише якщо вказати його тут.AGGREGA_INSTALL_DIRзадає теку для встановлення замість теки за замовчуванням. Бінарний файл у ній називаєтьсяaggrega, у Windows —aggrega.exe, і команда робить цю теку доступною, як описано вище.
У Linux і macOS ставте налаштування перед sh, а не перед curl, щоб його отримав скрипт:
curl -fsSL https://aggrega.ai/install.sh | AGGREGA_VERSION=<version> shУ PowerShell спершу задайте його у вікні; воно залишається заданим там, доки ви не видалите його командою Remove-Item Env:AGGREGA_VERSION:
$env:AGGREGA_VERSION = "<version>"irm https://aggrega.ai/install.ps1 | iexНалаштування автодоповнення в оболонці під час установлення
З --completion скрипт install.sh також налаштовує автодоповнення в оболонці, щоб клавіша Tab доповнювала команди й прапорці aggrega. Опції ставлять після sh -s --, що передає їх скрипту, який sh читає з конвеєра:
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completionirm … | iex не передає скрипту жодної опції. У PowerShell налаштуйте автодоповнення після завершення встановлення за допомогою скрипту, який записує aggrega completion powershell, як описано в розділі Автодоповнення в оболонці. install.ps1 також приймає -Completion для запуску скрипту з аргументами.
Вона налаштовує автодоповнення лише для вас, без прав адміністратора, для оболонки, яку називає ваш параметр SHELL, а в PowerShell — для того PowerShell, у якому працює. Вона використовує скрипт, який записує власна команда aggrega completion встановленого бінарного файлу, і називає кожен файл, який записує або змінює:
- bash: записує скрипт у
~/.local/share/bash-completion/completions— теку, з якої пакет bash-completion читає ваші власні доповнення. Автодоповнення Bash дляaggregaпотребує цього пакета. - zsh: записує
_aggregaу~/.local/share/zsh/site-functionsі додає до~/.zshrcтри рядки, які додають цю теку до шляху функцій zsh і завантажують її, запускаючиcompinit, якщо ніщо у файлі не запустило його раніше. - fish: записує
aggrega.fishу~/.config/fish/completions, яку fish читає самостійно. - PowerShell: записує скрипт як
%LOCALAPPDATA%\aggrega\completion.ps1і додає два рядки, що його завантажують, до вашого профілю для всіх хостів того PowerShell, у якому працює, —$PROFILE.CurrentUserAllHosts. Windows PowerShell і PowerShell 7 мають окремі профілі, тож запустіть команду з кожного, яким користуєтеся. Профіль виконується лише тоді, коли політика виконання, яку отримує нове вікно, —RemoteSigned,UnrestrictedабоBypass; за будь-якої іншої, як-отRestricted, вона нічого не записує й повідомляє, яку політику знайшла. Політику вона ніколи не змінює.
XDG_DATA_HOME, XDG_CONFIG_HOME, BASH_COMPLETION_USER_DIR і ZDOTDIR переміщують ці теки й файли так, як їх читає кожна оболонка. Автодоповнення завантажується в новому терміналі чи вікні. Повторний запуск команди переписує скрипт лише тоді, коли встановлений aggrega записує інший, і додає рядки до ~/.zshrc або профілю лише один раз; так само можна додати автодоповнення до вже наявного встановлення, адже команда принагідно знову встановлює бінарний файл.
Додавання навички асистента під час встановлення
З --skills (-Skills у PowerShell) команда встановлення також установлює навичку Aggrega — інструкції, які навчають AI-асистента встановлювати й використовувати Aggrega, — у всіх ваших проєктах для AI-асистентів на вашому комп’ютері. Обидва параметри можна вказати разом:
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion --skillsУ PowerShell, де irm … | iex не передає жодної опції, після завершення встановлення виконайте aggrega skills install --global: саме цю команду запускає -Skills.
Вона запускає власну команду встановленого двійкового файлу aggrega skills install --global, яка шукає асистентів на вашому комп’ютері — кожного, чия тека конфігурації розташована у вашому домашньому каталозі або чия команда є у вашому PATH, — і виводить кожного знайденого асистента та те, за чим його знайдено. Потім:
- У терміналі вона спершу запитує. Натисніть Enter, щоб установити навичку для знайдених асистентів, або введіть ідентифікатори інших, щоб додати їх, розділяючи пробілами чи комами; ідентифікатори виводить
aggrega skills list. У разіcurl … | shскрипт читає сам себе з каналу, тому запитує натомість через ваш термінал. - Коли немає термінала, через який можна запитати, як у скрипті, вона встановлює навичку для знайдених асистентів.
- Щоб вибрати асистентів самостійно, вкажіть їх після параметра через кому:
--skills claude-code,cursorабо--skills=claude-code,cursor, а в PowerShell —-Skills claude-code,cursor. Тоді вона встановлює навичку для них і не шукає інших.
Вона виводить кожну теку навички, яку записує, наприклад ~/.claude/skills/aggrega для Claude Code; усі вони розташовані у вашому домашньому каталозі. Повторний запуск команди замінює копії, записані попереднім запуском, — так навичка слідує за двійковим файлом до новішої версії. aggrega skills описує команду, теку, яку читає кожен асистент, і те, за чим знаходять кожного з них.
Коли крок не вдається виконати
Коли не вдається налаштувати автодоповнення — оболонка, яку вона не налаштовує, як-от dash, тека, у яку вона не може записувати, або політика виконання PowerShell, за якої не запускається жоден профіль, — або не вдається встановити навичку — не знайдено й не вказано жодного асистента, невідомий їй ідентифікатор або файл у теці навички, який записало не встановлення, — двійковий файл однаково встановлено, і він працює. Команда повідомляє, чому крок не вдався, виводить подальші кроки й завершується зі статусом, що вказує, який крок не вдався. Статуси такі:
| Статус | Значення |
|---|---|
0 | aggrega встановлено, і кожен крок, якого вимагав параметр, виконано успішно |
1 | нічого не встановлено, або встановлений aggrega не запустився |
2 | команді передано параметр, якого вона не приймає, або список, що не називає жодного асистента; вона нічого не зробила |
3 | aggrega встановлено, і він працює, але налаштувати автодоповнення оболонки не вдалося |
4 | aggrega встановлено, і він працює, але встановити навичку не вдалося |
5 | aggrega встановлено, і він працює, але обидва ці кроки не вдалися |
Скрипт PowerShell ніколи не закриває вікно, у якому працює, тому залишає статус у $LASTEXITCODE, і кожен статус, крім 0, завершується помилкою, яку powershell -Command і pwsh -Command повідомляють як код виходу 1.
Установлення за допомогою інсталятора Windows
Кожен реліз містить інсталятор Windows, aggrega-<version>-windows-amd64-setup.exe, на сторінці релізів https://github.com/aggrega-ai/aggrega-cli/releases. Завантажте та запустіть його. Він установлює aggrega.exe за замовчуванням лише для вас, без прав адміністратора і не запитуючи їх, за допомогою короткого майстра:
- Сторінка привітання, потім ліцензія Aggrega, Apache License 2.0: нічого не встановлюється, доки ви не натиснете I Agree. Потім компоненти: сама Aggrega, що встановлюється завжди, і Add to PATH, який позначено.
- Тека встановлення,
%LOCALAPPDATA%\Programs\aggrega, якщо ви не виберете іншу; це тека, яку використовує команда встановлення. - Хід встановлення, потім завершальна сторінка, яка називає теку й повідомляє, чи додало це встановлення її до вашого
PATH, з наступними кроками: встановити навичку Aggrega за допомогоюaggrega skills install --globalі підключити ваш AI-клієнт, як описано в розділі Підключення клієнта MCP.
Що він робить:
- Якщо Add to PATH позначено, він додає теку встановлення до вашого користувацького
PATH, хіба що вона вже там є. Термінал, відкритий після встановлення, знаходитьaggrega; уже відкритий термінал зберігаєPATH, з яким його було запущено. Якщо позначку знято, до вашогоPATHнічого не додається, і термінал запускаєaggrega.exeза повним шляхом; запис, доданий попереднім встановленням, залишається як є. - Він додає Aggrega до списку встановлених застосунків з видавцем Cognitio s.r.l., тож видаляється вона через Параметри → Програми, як будь-який інший застосунок. Програма видалення просить підтвердження, а потім вилучає файли, які інсталятор поклав до теки, запис у
PATHі запис у цьому списку, а також видаляє теку, якщо в ній більше нічого не залишилося. - Під час повторного запуску він установлюється поверх наявного, пропонуючи теку, у яку встановлювався востаннє, тож інсталятор пізнішого релізу оновлює вашу копію, зберігаючи один запис у вашому
PATH. - Поруч із
aggrega.exeтека міститьuninstall.exe,LICENSEз текстом ліцензії таEnVar.dll— компонент, за допомогою якого інсталятор і програма видалення редагують вашPATH.
Коли aggrega.exe запущено — редактором або AI-клієнтом, — інсталятор не може його замінити й зупиняється з відповідним повідомленням; закрийте те, що його запустило, і запустіть інсталятор знову. Програма видалення зупиняється так само, ще нічого не видаливши.
Щоб установити без вікна, зі скрипту або з інструмента, що встановлює програми на багато машин, запустіть інсталятор із ключем /S, записаним великою літерою; тоді він установлює без вікна й без запитань у теку, яку використало попереднє встановлення, а інакше в теку за замовчуванням, з Add to PATH, і повідомляє про збій кодом виходу, відмінним від 0. Програма видалення приймає той самий ключ:
.\aggrega-<version>-windows-amd64-setup.exe /S& "$env:LOCALAPPDATA\Programs\aggrega\uninstall.exe" /SІнсталятор підписано так само, як виконувані файли, з видавцем Cognitio S.r.l. і міткою часу: перевірки з розділу Готовий бінарний файл для Windows застосовуються до нього так само, як до aggrega.exe, як і сказане там про запити, які Windows може показати для завантаженого файлу. SHA256SUMS містить його дайджест, як і дайджест кожного іншого файлу релізу.
Якщо інсталятор не підходить, наведена вище команда встановлення та ручні кроки встановлюють той самий aggrega.exe у ту саму теку.
Установлення за допомогою менеджера пакетів
Кожен реліз також оновлює формулу Homebrew і маніфест Scoop, тож менеджер пакетів, яким ви вже користуєтеся, може встановити Aggrega й підтримувати її в актуальному стані. Кожен із них установлює той самий бінарний файл за замовчуванням, що й команда встановлення, перевіряючи його за SHA-256-дайджестом, який для нього наводить SHA256SUMS релізу.
У macOS і Linux brew install aggrega-ai/tap/aggrega встановлює його за допомогою Homebrew. Homebrew під час першого запуску додає tap aggrega-ai/tap і встановлює бінарний файл для вашої системи та процесора: macOS на Apple silicon або Intel, Linux на 64-бітній x86 або 64-бітній ARM. Після нового релізу brew upgrade оновлює його разом з усіма іншими встановленими формулами.
У Windows за допомогою Scoop один раз додайте bucket Aggrega командою scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket і встановлюйте з нього командою scoop install aggrega. Scoop установлює бінарний файл для Windows як aggrega.exe і робить його доступним як aggrega через теку shim-файлів, яку тримає у вашому PATH. Після нового релізу scoop update оновлює bucket’и, а scoop update aggrega оновлює Aggrega.
Homebrew і Scoop установлюють кожен у власні теки, а не в ~/.local/bin чи %LOCALAPPDATA%\Programs\aggrega, і оновлюють лише встановлену ними копію. Використовуйте на машині один спосіб установлення: копія, встановлена командою встановлення або вручну, і копія, встановлена Homebrew чи Scoop, — це дві копії, і яка з них запускається, визначає тека, що стоїть у вашому PATH першою.
Установлення за допомогою winget
У Windows winget install Cognitio.Aggrega встановлює його за допомогою winget, диспетчера пакетів Windows. winget завантажує інсталятор Windows релізу з його сторінки релізу, перевіряє його за SHA-256-дайджестом, наведеним у маніфесті пакета, і запускає в автоматичному режимі. Результат той самий, що й у самого інсталятора: aggrega.exe у %LOCALAPPDATA%\Programs\aggrega або в теці, яку використало попереднє встановлення, ця тека у вашому користувацькому PATH і Aggrega у списку встановлених застосунків — усе без прав адміністратора. winget не змінює PATH термінала, у якому працює, тож перед запуском aggrega version відкрийте новий термінал.
winget upgrade Cognitio.Aggrega встановлює поверх неї пізніший реліз, а winget uninstall Cognitio.Aggrega запускає її програму видалення. winget, інсталятор і команда встановлення встановлюють в одну й ту саму теку, якщо ви не виберете іншу в інсталяторі, тож aggrega.exe у ній залишає той, що запущений останнім.
Установлення вручну
Кожен реліз містить готові бінарні файли для Linux на 64-бітній x86 і на 64-бітній ARM, для Windows на 64-бітній x86 і для macOS на Apple silicon та Intel на сторінці релізів https://github.com/aggrega-ai/aggrega-cli/releases. Завантажте виконуваний файл для своєї операційної системи та процесора — кожен із них названо нижче в розділі Вибір файлу — і перевірте його за SHA256SUMS релізу, як там описано. Потім позначте його як виконуваний і перемістіть до ~/.local/bin/aggrega. У Linux, з каталогу із завантаженим файлом, замінивши <version> на завантажену версію, а на 64-бітній ARM — amd64 на arm64:
chmod +x aggrega-<version>-linux-amd64mkdir -p ~/.local/binmv aggrega-<version>-linux-amd64 ~/.local/bin/aggregaДля Windows див. Готовий бінарний файл для Windows нижче; для macOS див. Готовий бінарний файл для macOS.
Якщо ~/.local/bin немає у вашому PATH, додайте цей рядок до файлу, який ваша оболонка читає під час запуску, — ~/.zshrc для zsh, ~/.bashrc для bash (~/.bash_profile у macOS), — і відкрийте новий термінал:
export PATH="$HOME/.local/bin:$PATH"З вихідного коду: маючи встановлений інструментарій Go, зберіть команду aggrega з дерева вихідного коду та покладіть отриманий бінарний файл у ту саму теку.
Перевірте встановлення командою aggrega version, як наприкінці розділу Установлення двійкового файлу.
Вибір файлу
Реліз називає кожен виконуваний файл aggrega-<version>-<system>-<processor>, з .exe у Windows:
| Система | Процесор | Файл |
|---|---|---|
| Linux | 64-бітна x86 (uname -m виводить x86_64) | aggrega-<version>-linux-amd64 |
| Linux | 64-бітна ARM (uname -m виводить aarch64) | aggrega-<version>-linux-arm64 |
| Windows | 64-бітна x86 | aggrega-<version>-windows-amd64.exe |
| macOS | Apple silicon | aggrega-<version>-darwin-arm64 |
| macOS | Intel | aggrega-<version>-darwin-amd64 |
Саме цей файл установлює команда встановлення, і саме його слід завантажувати вручну. Поруч із ним лежать два його варіанти; команда встановлення не встановлює жодного з них, і кожен установлюється вручну так само:
aggrega-debug-<version>-…— та сама програма з налагоджувальною інформацією, яку читає налагоджувач або профайлер. Вона працює й повідомляє свою версію точно так само, як файл за замовчуванням, і має більший розмір.aggrega-light-<version>-…зібрано без вбудованих плагінів: він розв’язує кожен плагін через каскад плагінів, як його налаштовує робочий простір, а не знаходить основні плагіни всередині себе.
Для Windows реліз також містить aggrega-<version>-windows-amd64-setup.exe — інсталятор Windows, який установлює для вас файл за замовчуванням.
Кожен реліз також містить SHA256SUMS — SHA-256-дайджест кожного іншого долученого до нього файлу, зокрема обох скриптів установлення, у форматі, який читає sha256sum. Команда встановлення виконує цю перевірку сама. Щоб перевірити завантажений файл вручну в Linux, коли SHA256SUMS лежить у тому самому каталозі:
sha256sum --check --ignore-missing SHA256SUMSДля завантаженого файлу виводиться OK; будь-який інший результат означає, що це не той файл, який опубліковано в релізі.
Готовий бінарний файл для Windows
Виконуваний файл для Windows — aggrega-<version>-windows-amd64.exe (налагоджувальний і полегшений варіанти поруч із ним у релізі встановлюються так само). Перейменуйте його на aggrega.exe, перемістіть до %LOCALAPPDATA%\Programs\aggrega — теки, яку використовує команда встановлення, — і додайте цю теку до вашого користувацького PATH: Windows запускає файл із розширенням .exe, не вимагаючи позначати його як виконуваний, і знаходить його як команду aggrega під цим ім’ям. Наприклад, у PowerShell, замінивши <version> на завантажену версію:
$dir = "$env:LOCALAPPDATA\Programs\aggrega"New-Item -ItemType Directory -Force $dir | Out-NullMove-Item ".\aggrega-<version>-windows-amd64.exe" "$dir\aggrega.exe"Unblock-File "$dir\aggrega.exe"[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$dir", "User")Термінал, відкритий після цього, знаходить aggrega; уже відкритий термінал зберігає PATH, з яким він запустився.
Виконувані файли підписані. Кожен має підпис Authenticode — підпис коду, який перевіряє Windows, — і Windows показує для нього видавця Cognitio S.r.l. Кожен підпис також містить позначку часу: сертифікат, на якому ґрунтується підпис, дійсний лише кілька днів, і саме позначка часу зберігає дійсність підпису після закінчення терміну дії сертифіката. Щоб перевірити завантажений файл перед запуском:
-
У Провіднику відкрийте Властивості файлу та вкладку Цифрові підписи. У списку підписів зазначено Cognitio S.r.l.; виберіть його, а потім Докладно — там буде повідомлення Цей цифровий підпис дійсний.
-
У PowerShell, з
$dir, як у прикладі вище:Terminal window $signature = Get-AuthenticodeSignature "$dir\aggrega.exe"$signature.Status$signature.SignerCertificate.SubjectStatusповідомляєValid, а суб’єкт починається зCN=Cognitio S.r.l..NotSignedабоHashMismatchозначає, що файл не той, який опубліковано в релізі, або його змінено після підписання.
Підпис називає видавця, але не усуває всіх попереджень. Те, з яким ви зіткнетеся, залежить від того, як файл потрапив до вас і як ви його запускаєте:
- Під час завантаження браузер може попередити, що цей файл завантажують нечасто, і запитати, чи зберегти його. Якщо зберегти, файл буде збережено в завантаженому вигляді.
- Під час запуску з Провідника або з браузера Windows може показати Windows захистила ваш ПК. Це повідомлення надходить від Microsoft Defender SmartScreen, який зважає на репутацію, набуту файлом і його видавцем, тож нова версія, навіть підписана, може його викликати, доки не набуде власної репутації. Для підписаного файлу повідомлення називає видавця: виберіть Докладніше, переконайтеся, що зазначено Cognitio S.r.l. і ім’я завантаженого файлу, а потім виберіть Усе одно запустити. Якщо запустити той самий файл із PowerShell або командного рядка, він може запуститися без цього повідомлення; це залежить від версії Windows та її налаштувань.
Unblock-Fileзаздалегідь відповідає на це повідомлення. Завантажений файл позначається як отриманий з інтернету, і саме на цю позначку реагує перевірка Windows захистила ваш ПК.Unblock-Fileу PowerShell, як у прикладі вище, видаляє позначку; те саме робить прапорець Розблокувати на вкладці Загальні у Властивостях файлу в Провіднику.- Якщо ввімкнено Smart App Control (Windows 11), він перевіряє програму під час її запуску. За описом Microsoft, Smart App Control спочатку запитує хмарну службу безпеки Microsoft, чи безпечна програма; якщо служба не може зробити впевнений прогноз, він перевіряє підпис, дозволяючи запуск програми з дійсним підписом і блокуючи непідписану програму або програму з недійсним підписом. Чи ввімкнено його, показано в розділі Керування програмами та браузером у Безпеці Windows.
Готовий бінарний файл для macOS
Виконувані файли для macOS — aggrega-<version>-darwin-arm64 для Mac з Apple silicon і aggrega-<version>-darwin-amd64 для Mac із процесором Intel; пункт Про цей Mac у меню Apple показує, який у вас. Налагоджувальний і полегшений варіанти поруч із ними в релізі встановлюються так само. Mac з Apple silicon також запускає файл для Intel через Rosetta 2, якщо її встановлено, але саме файл для Apple silicon зібрано для нього.
Перейменуйте файл на aggrega, позначте його як виконуваний і перемістіть до ~/.local/bin — теки, яку використовує команда встановлення. Наприклад, у Терміналі, у каталозі із завантаженням, замінивши <version> на завантажену версію, а arm64 — на amd64 на Mac з Intel:
chmod +x aggrega-<version>-darwin-arm64mkdir -p ~/.local/binmv aggrega-<version>-darwin-arm64 ~/.local/bin/aggregamkdir створює теку, якщо її ще немає. ~/.local/bin не входить до PATH, який macOS надає новому терміналу, тож додайте рядок із розділу Установлення вручну до ~/.zshrc або, для bash, до ~/.bash_profile, якщо його там ще немає.
Виконувані файли підписано й нотаризовано. Кожен має підпис коду, зроблений за допомогою Developer ID компанії Cognitio s.r.l. — сертифіката, який Apple видає розробникові для програм, що поширюються поза Mac App Store, — із захищеним середовищем виконання (hardened runtime) і захищеною міткою часу, а служба нотаризації Apple перевірила й нотаризувала кожен із них. Gatekeeper, перевірка macOS для програм з інтернету, оцінює програму з позначкою карантину — позначкою, яку веббраузер додає до завантаженого файлу, — і приймає програму, нотаризовану Apple, тож файл, завантажений зі сторінки релізів, запускається як є. Квиток нотаризації не можна долучити до окремого виконуваного файлу, тож Gatekeeper знаходить квиток онлайн під час першого запуску файлу; на Mac, який у цей момент не під’єднано до мережі, Gatekeeper може блокувати файл, доки Mac не зможе зв’язатися з Apple.
Щоб перевірити завантажений файл перед запуском, виконайте в Терміналі, вказавши ім’я завантаженого файлу:
codesign --verify --strict --verbose=2 aggrega-<version>-darwin-arm64codesign --display --verbose=2 aggrega-<version>-darwin-arm64Перша команда повідомляє, що файл valid on disk і satisfies its Designated Requirement. Друга перелічує центри сертифікації підпису, перший із яких — Developer ID Application: COGNITIO SRL з ідентифікатором команди в дужках, а також Timestamp. Файл, що не проходить будь-яку з перевірок, — не той, який опубліковано в релізі, або його змінено після підписання.
Файл, отриманий за допомогою curl, не має позначки карантину, тож Gatekeeper його взагалі не оцінює: curl не додає позначку, яку додає браузер. Із цієї самої причини бінарний файл, який розміщує команда встановлення, запускається без цієї оцінки.