{"canonical_url":"https://engineer.company/uk/glossary/package/","content_markdown":"# Програмний пакет\n\n## Що це таке\n\nПрограмний пакет — це форма, у якій програмне забезпечення потрапляє від тих, хто його пише, на\nмашини, де воно працює: сам код у вигляді архіву чи каталогу разом із маніфестом, що вказує назву,\nверсію і все, без чого цей код не запрацює. Коротко кажуть просто пакет, у родовому відмінку —\nпакета. Кожна екосистема проводить межі по-своєму. Для npm пакет — це файл або каталог, який описує\nфайл package.json, і документація npm відрізняє його від модуля, тобто будь-чого, що Node.js може\nзавантажити через require() чи import; пакетами є лише ті модулі, які мають package.json. Python\nуживає це слово у двох значеннях, і [Python Packaging User Guide](https://packaging.python.org/) їх\nрозводить: пакет імпорту (import\npackage) — це каталог модулів, які імпортує код, а пакет розповсюдження (distribution package) —\nверсіонований архів, який користувач завантажує й установлює. У Rust пакет об'єднує один або кілька\nкрейтів (crate) і файл Cargo.toml, що описує, як їх зібрати. У Debian одиницею є бінарний пакет —\nфайл .deb, який система встановлює й відстежує.\n\nПакет — це одиниця розповсюдження, і найпростіше пояснити його через сусідні поняття. Бібліотека —\nце код; пакет — це спосіб доставити цей код, і одна бібліотека може водночас доходити до\nкористувачів як пакет npm, як wheel для Python і як пакет Debian. Менеджер пакетів — програма, яка\nчитає маніфести, завантажує все, що в них перелічено, і встановлює це в порядку, який справді\nпрацює: npm, pip, Cargo, apt. Реєстр або сховище — місце, де пакети чекають, поки їх заберуть:\nреєстр npm, PyPI, crates.io чи дзеркало Debian. Мовні менеджери пакетів установлюють код для одного\nпроєкту, зазвичай у каталог поруч із ним. Системні менеджери пакетів установлюють програми для всієї\nмашини й записують, який пакет поклав кожен файл і куди.\n\n## Чому це важливо\n\nЧужий код потрапляє в проєкт одним із трьох шляхів: через менеджер пакетів, копією в репозиторії\nразом із ліцензією та контрольною сумою, що називають вендорингом (vendoring), або збиранням із\nвихідного коду. Менеджер пакетів — звичний вибір, і недарма. Він розв'язує все дерево залежностей,\nоновлює його однією командою і записує, що встановив. Ціна — довіра: відтепер проєкт покладається на\nкожен маніфест у цьому дереві й на кожен реєстр, з якого воно прийшло. Вендоринг міняє цю довіру на\nроботу, бо скопійований код змінюється лише тоді, коли хтось свідомо копіює нову версію. Збирання з\nвихідного коду дає найбільше контролю й вимагає найбільше догляду.\n\nНайбільше компромісів видно в маніфесті. Зазвичай він називає не одну версію, а діапазон; у npm\nдіапазон із кареткою, як-от ^10.0.1, приймає будь-який пізніший випуск із тією самою мажорною\nверсією. Діапазони пропускають виправлення без жодних правок у файлі, але через них дві інсталяції з\nрізницею в тиждень можуть дати два різні дерева. Цю щілину закриває lock-файл. npm записує в\npackage-lock.json точне дерево, яке побудував, щоб наступні інсталяції його повторили, Cargo записує\nв Cargo.lock точну версію кожної залежності, і обидва розраховують, що файл зберігатимуть у\nрепозиторії. Маніфест каже, що проєкт готовий прийняти; lock-файл — що він отримав насправді.\n\nМаніфести також кажуть, наскільки сильно одному пакету потрібен інший. Debian Policy Manual описує\nцілу драбину. Depends — абсолютна вимога: пакет налаштовують лише після того, як налаштовано все,\nвід чого він залежить. Recommends — сильна, але не абсолютна залежність, для пакетів, які стоять\nпоруч із цим у всіх інсталяціях, крім незвичних. Suggests називає пакети, з якими цей стає\nкориснішим, але й без них інсталяція цілком розумна. Інсталяція без рекомендованого пакета коректна,\nа програмі всередині він усе одно може знадобитися для якоїсь із її задач.\n\nКожен інструмент, що міркує про пакети, довіряє їхнім метаданим. Перевірка ліцензій читає\nзадекларовану ліцензію, часто у вигляді виразу SPDX, як-от MIT OR Apache-2.0, де OR дає вибір, а AND\nвимагає всіх ліцензій одночасно. Сканер вразливостей зіставляє задекларовані назви й версії з\nопублікованими бюлетенями безпеки. Якщо декларація хибна, кожен інструмент, що її читає, помиляється\nоднаково, тому файли ліцензій усередині пакета, який іде до користувачів разом із продуктом, варто\nпрочитати окремо.\n\n## Як це виглядає на практиці\n\nПід час перевірки захисту робочого сервера з'ясувалося, що jail, який мав блокувати зловмисників, за\nвесь час не заблокував жодного, і одна з трьох окремих причин крилася у зв'язку між пакетами. Для\nсамого блокування jail звертався до зовнішньої програми брандмауера, яку пакетні декларації вважають\nрекомендованою, а не обов'язковою, і сервер зібрали без неї. Jail запускався, рахував невдалі входи\nй щоразу доходив до рішення, а ламався лише на останньому кроці, коли треба було власне заблокувати.\n[Перевірка трьох засобів захисту SSH](/uk/portfolio/three-locks-on-the-door-none-of-them-locked/)\nвиявила це, розглядаючи систему під час роботи, а не файли налаштувань, і залишила по собі правило:\nкожен засіб безпеки підкріплює автоматична перевірка, а не пояснення в коментарі.\n\nЯдро на Rust, скомпоноване із застосунком, який отримують користувачі, приносить у продукт увесь\nсвій граф залежностей — тут 644 крейти, кожен із власною декларацією ліцензії. Залежність кількома\nрівнями нижче може між двома версіями перейти на копілефтну ліцензію, і єдиним слідом стане змінений\nрядок у lock-файлі, який мало хто читає.\n[Аудит ліцензій 644 крейтів](/uk/portfolio/know-the-licence-of-everything-you-ship/)\nзапускається під час кожного збирання: він звіряє ліцензійний вираз кожного крейта зі списком\nдозволених, пропускає вибір між ліцензіями, якщо дозволена хоч одна, а поєднання — лише якщо\nдозволені всі, і зупиняє збирання на всьому іншому. Щоб показати, що перевірка здатна спрацювати, її\nдвічі зламали навмисно: раз — замінивши в одному крейті вираз ліцензії на неприйнятний, раз —\nперемістивши закріплену ревізію ядра й не згенерувавши аудит наново. Межу сторінка називає прямо:\nаудит читає задекларовані метадані, які самі можуть бути хибними, і юридичною порадою він не є.\n\nВласний git-сервер компанії\n[ставили пакетом зі сховища пакунків, яке веде сам постачальник](/uk/portfolio/your-code-on-your-own-hardware/),\nі працює він як одна програма, яку підтримує в робочому стані операційна система. Додати репозиторій\nпостачальника на сервер — окреме рішення, бо відтоді звичайні оновлення встановлюють усе, що цей\nпостачальник публікує й підписує.\n\nСам сайт не потребує Node для роботи. Його package.json позначено як приватний, тож npm відмовиться\nйого публікувати; у ньому лише інструменти розробки з діапазонами з кареткою, а поруч лежить\npackage-lock.json, внесений у репозиторій. Його pyproject.toml налаштовує лінтер, перевірку\nправопису й перевірку типів і не має таблиць [project] чи [build-system], бо пакета для збирання цей\nфайл не описує. Іконки вендорені: їх скопійовано разом з оригінальною ліцензією й контрольною сумою\nSHA-256 для кожного файлу.\n\n## Де виникають проблеми\n\n### Функція звітує, що все гаразд, і нічого не робить\n\nСервіс запускається, пише в журнал, що працює, і щоразу мовчки пропускає одну зі своїх задач.\nПрограма, яку він викликає, належить до рекомендованого чи запропонованого пакета, і інсталяція мала\nповне право його пропустити. Коли функція залежить від зовнішньої програми, перевіряйте її наявність\nпід час запуску й зупиняйтеся з чіткою помилкою, якщо її бракує, оголосіть її жорсткою вимогою у\nвласному розгортанні й тестуйте функцію від початку до кінця на сервері, зібраному так само, як\nробочий.\n\n### Дві машини встановлюють різний код з одного маніфесту\n\nЗбирання проходить на ноутбуці й падає в безперервній інтеграції або навпаки, хоча власний код\nпроєкту той самий. Маніфест задає діапазони версій, lock-файл так і не внесли в репозиторій, а між\nдвома інсталяціями одна із залежностей випустила нову версію. Внесіть lock-файл у репозиторій, в\nавтоматизації встановлюйте з нього командами, які відмовляються його змінювати, як-от npm ci чи\ncargo build --locked, і оновлюйте його окремою зміною, яку хтось переглядає.\n\n### Ліцензія змінюється всередині знайомої залежності\n\nПродукт, що торік пройшов перевірку ліцензій, тепер постачає код на умовах, на які ніхто не\nпогоджувався, хоча перелік залежностей виглядає так само. Одна з наявних залежностей змінила\nліцензію між версіями, а звичайне оновлення підтягнуло нову версію через lock-файл. Перевіряйте\nзадекларовані ліцензії за явним списком дозволених під час кожного збирання, щоб така зміна зупиняла\nзбирання того ж дня, коли з'являється.\n\n## Що почитати далі\n\n- [npm Docs: About packages and modules](https://docs.npmjs.com/about-packages-and-modules) — власне\n  визначення пакета від npm і пояснення, чому модуль не завжди є пакетом.\n- [Debian Policy Manual: Declaring relationships between packages](https://www.debian.org/doc/debian-policy/ch-relationships.html)\n  — Depends, Recommends, Suggests та інші поля і що з кожним із них робить менеджер пакетів.\n- [Python Packaging User Guide: Writing your pyproject.toml](https://packaging.python.org/en/latest/guides/writing-pyproject-toml/)\n  — три таблиці pyproject.toml і метадані, які декларує пакет розповсюдження Python.\n- [The Cargo Book: Cargo.toml vs Cargo.lock](https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html)\n  — чому маніфест описує, що проєкт приймає, lock-файл фіксує точні версії, і коли його вносити в\n  репозиторій.\n- [SPDX Specification 2.3.1: License expressions](https://spdx.github.io/spdx-spec/v2.3.1/SPDX-license-expressions/)\n  — синтаксис, яким пакети декларують одну ліцензію, вибір із кількох або набір, що діє разом.\n\n\u003chttps://engineer.company/uk/glossary/package/\u003e\n","date_modified":"2026-10-20T21:59:50Z","description":"Що містить програмний пакет, як маніфест, lock-файл і задекларовані залежності визначають установлення і чому чиста інсталяція буває зламаною.","formats":{"gemtext":"https://engineer.company/uk/glossary/package/index.gmi","gopher":"https://engineer.company/uk/glossary/package/gophermap","html":"https://engineer.company/uk/glossary/package/","json":"https://engineer.company/uk/glossary/package/index.json","markdown":"https://engineer.company/uk/glossary/package/index.md","pdf":"https://engineer.company/uk/glossary/package/index.pdf"},"kind":"page","language":"uk","title":"Що таке програмний пакет?","url":"https://engineer.company/uk/glossary/package/","version":1}