Собственный .deb нужен, когда программу или внутреннюю утилиту надо ставить одинаково, учитывать через dpkg и обновлять штатным пакетным менеджером. Архив, распакованный в /usr/local, не даёт такого учёта. Ниже мы создадим небольшой пакет avg-healthcheck: исполняемый shell-скрипт показывает hostname и заполнение корневой файловой системы. Он не меняет конфигурацию и не запускает службу. Это законченный учебный проект для Debian 13 и Ubuntu 24.04; сборка выполняется обычным пользователем в отдельной VM, установка — в одноразовой тестовой машине. Не собирайте неизвестные исходники на production-сервере.
Различайте binary package .deb и source package .dsc с исходными архивами. В инструкции сначала собираем бинарный пакет для локальной лаборатории, затем объясняем, что добавить для воспроизводимого выпуска. Полноценный процесс сопровождается лицензией исходников, историей версий и тестом обновления. Руководство сопровождающего Debian.
1. Подготовить окружение и узнать архитектуру
На машине сборки нужны dpkg-dev, debhelper и средства проверки. sudo применяется для установки инструментов, но не для dpkg-buildpackage. Файлы проекта должны принадлежать обычному пользователю. Запишите выпуск ОС и версии инструментов в журнал сборки.
cat /etc/os-release
dpkg --print-architecture
sudo apt update
sudo apt install build-essential dpkg-dev debhelper lintian fakeroot
mkdir -p "$HOME/deb-lab/avg-healthcheck-1.0.0/debian/source"
cd "$HOME/deb-lab/avg-healthcheck-1.0.0"
dpkg-query -W dpkg-dev debhelper lintianЭтот скрипт не содержит скомпилированных объектов, поэтому Architecture: all подходит. Для C/C++ программы используйте Architecture: any и полноценную систему сборки; нельзя переименовать amd64-бинарник в arm64-пакет. Проверяйте зависимости для каждого целевого выпуска ОС: сборка на новой системе не гарантирует установку на старой.
2. Написать программу с корректным кодом возврата
Создайте avg-healthcheck в корне проекта. Команда df вызывается с конкретным путём; проверка команды учитывает недоступную файловую систему. Код 0 означает успешное получение отчёта, 1 — ошибку использования, 2 — ошибку сбора. Мы не превращаем любую заполненность в отказ без согласованного порога.
cat > avg-healthcheck <<'SH'
#!/bin/sh
set -eu
case "${1:-}" in
--version) printf '%s\n' 'avg-healthcheck 1.0.0'; exit 0 ;;
'') ;;
*) printf '%s\n' 'Usage: avg-healthcheck [--version]' >&2; exit 1 ;;
esac
printf 'host=%s\n' "$(hostname)"
if ! df -P /; then
printf '%s\n' 'Cannot read filesystem statistics' >&2
exit 2
fi
SH
chmod 0755 avg-healthcheck
./avg-healthcheck --version
./avg-healthcheckОжидаемый version — avg-healthcheck 1.0.0; основной запуск показывает root mount. Команды hostname и df предоставляет пакет coreutils в используемых системах. Не добавляйте в программу скрытое sudo: права оператора и права установленной утилиты должны быть понятны.
3. Описать control и зависимости
debian/control содержит source stanza и binary stanza, разделённые пустой строкой. Build-Depends — инструменты сборки; Depends — зависимости установленной программы. Современный debhelper compatibility задаём через debhelper-compat (= 13), без параллельного debian/compat.
cat > debian/control <<'CONTROL'
Source: avg-healthcheck
Section: admin
Priority: optional
Maintainer: AVG IT Packaging <packaging@example.com>
Build-Depends: debhelper-compat (= 13)
Standards-Version: 4.7.0
Rules-Requires-Root: no
Package: avg-healthcheck
Architecture: all
Depends: ${misc:Depends}, coreutils
Description: Small host and root-filesystem report
Prints the hostname and root-filesystem usage.
Does not alter system settings or start services.
CONTROLMaintainer с example.com — учебный адрес, для выпуска подставьте настоящий адрес ответственного. Продолжение Description начинается пробелом. Standards-Version не является версией Debian и не выбирает репозиторий: это заявленный уровень соблюдения Policy. Перед реальным распространением проверьте текущую Policy и весь пакет. debian/control исходного пакета.
4. Создать changelog и правила сборки
Версия 1.0.0-1 означает upstream 1.0.0 и первую Debian-редакцию. Дата changelog должна быть валидной RFC-подобной датой; используем date -R. Создайте rules через printf: перед dh нужен настоящий TAB, не набор пробелов.
{
printf '%s\n' 'avg-healthcheck (1.0.0-1) unstable; urgency=medium' ''
printf '%s\n' ' * Initial laboratory package.' ''
printf ' -- AVG IT Packaging <packaging@example.com> %s\n' "$(LC_ALL=C date -R)"
} > debian/changelog
printf '#!/usr/bin/make -f\n%%:\n\tdh $@\n' > debian/rules
chmod 0755 debian/rules
printf '%s\n' '3.0 (quilt)' > debian/source/format
cat -A debian/rules
dpkg-parsechangelog -S Versioncat -A должен показывать ^I перед dh; вывод версии — 1.0.0-1. Для quilt source build понадобится upstream orig.tar, хотя binary-only сборка из текущего дерева не требует выпускать source artifacts. dh выполняет последовательность debhelper; это не магическая замена тестов программы. debhelper.
5. Определить устанавливаемые пути и документацию
Программа помещается в /usr/bin. /etc предназначен для конфигурации, /var/lib — для изменяемого состояния; не записывайте runtime-данные в /usr/share. debian/install задаёт исходник и каталог назначения. Добавим README и минимальную man page, чтобы пакет не оставлял пользователя без описания.
printf '%s\n' 'avg-healthcheck usr/bin' > debian/install
cat > README.md <<'README'
# avg-healthcheck
Run avg-healthcheck to print the hostname and root-filesystem usage.
Use avg-healthcheck --version to print the version.
Exit codes: 0 success, 1 usage error, 2 collection error.
README
printf '%s\n' 'README.md' > debian/docs
cat > avg-healthcheck.1 <<'MAN'
.TH AVG-HEALTHCHECK 1 "October 2026" "1.0.0" "User Commands"
.SH NAME
avg-healthcheck \- print host and filesystem information
.SH SYNOPSIS
.B avg-healthcheck
.RI [ --version ]
.SH DESCRIPTION
Print the hostname and root-filesystem usage. No settings are changed.
.SH EXIT STATUS
0 for success, 1 for invalid arguments, 2 for collection failure.
MAN
printf '%s\n' 'avg-healthcheck.1' > debian/manpagesВыполняемые файлы должны иметь ожидаемый режим, документация — обычный read-only для пользователей. Не используйте chmod -R 777 для обхода ошибок сборки: это меняет модель безопасности и маскирует неверные владельцы.
6. Добавить лицензию и собрать binary package
Для учебного кода ниже используется короткая разрешительная лицензия в machine-readable copyright. Для сторонних компонентов не копируйте эту лицензию поверх их условий. Пакет должен указывать действительных правообладателей.
cat > debian/copyright <<'COPYRIGHT'
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: avg-healthcheck
Source: Local educational example
Files: *
Copyright: 2026 AVG IT
License: MIT
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files, to deal in
the Software without restriction, including without limitation the
rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:
.
The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.
.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
COPYRIGHT
dpkg-buildpackage -us -uc -b-us -uc отключают подписи создаваемых файлов, -b выбирает binary-only build. Это удобно в лаборатории, но не делает пакет доверенным для пользователей. Успешная сборка создаёт ../avg-healthcheck_1.0.0-1_all.deb и служебные .changes/.buildinfo. Если ошибка возникает на dh_auto_build, проверьте обнаруженную систему сборки и лишние Makefile в дереве, а не отключайте все проверки сразу.
7. Проверить состав, метаданные и lintian
До установки прочитайте .deb как архив. В нём должны присутствовать /usr/bin/avg-healthcheck, man page и документация; не должно быть домашних путей сборщика, приватных ключей, секретов и необъяснимых maintainer scripts.
cd "$HOME/deb-lab"
dpkg-deb --info avg-healthcheck_1.0.0-1_all.deb
dpkg-deb --contents avg-healthcheck_1.0.0-1_all.deb
lintian avg-healthcheck_1.0.0-1_all.deb
sha256sum avg-healthcheck_1.0.0-1_all.deb > SHA256SUMSLintian может сообщить о политике, лицензиях, документации или стандартах. Разберите каждое предупреждение; успешный exit не заменяет проверку runtime. SHA256SUMS обнаруживает изменение файла, но не подтверждает авторство, если сумма получена из того же недоверенного места. Для распространения нужны защищённый канал, а для APT-репозитория — подпись метаданных и ограниченный signed-by keyring. dpkg-buildpackage.
8. Установить пакет в чистую VM и проверить результат
Сначала симуляция, затем установка локального файла через apt: она учитывает зависимости, в отличие от простого распаковывания архива. Передайте .deb в лабораторную VM и работайте в каталоге, где он находится. Тест не должен использовать бинарник из исходного дерева по случайному PATH.
sudo apt install --simulate ./avg-healthcheck_1.0.0-1_all.deb
sudo apt install ./avg-healthcheck_1.0.0-1_all.deb
command -v avg-healthcheck
dpkg-query -W -f='${Package} ${Version} ${Status}\n' avg-healthcheck
dpkg -L avg-healthcheck
/usr/bin/avg-healthcheck --version
/usr/bin/avg-healthcheck
man avg-healthcheckОжидаемый путь — /usr/bin/avg-healthcheck, статус — install ok installed. Если apt пытается удалить неожиданные пакеты, остановитесь и исправьте control. Если ошибка только при установке, изучите зависимости и содержимое пакета: sudo не лечит неверный Depends.
9. Проверить обновление и удаление
Следующий выпуск должен иметь увеличенную версию программы и changelog. Соберите 1.0.1-1, установите поверх 1.0.0-1 и проверьте version, dpkg status и пользовательский результат. Снижение версии — отдельный согласованный сценарий, который не возвращает автоматически данные приложения.
sudo apt remove --simulate avg-healthcheck
sudo apt remove avg-healthcheck
dpkg-query -W avg-healthcheck
command -v avg-healthcheck || trueДля нашего пакета conffiles отсутствуют, поэтому различие remove/purge почти не заметно. У реального сервиса remove обычно сохраняет системную конфигурацию, purge удаляет зарегистрированные conffiles; резервируйте их заранее. Избегайте postinst, который скачивает и запускает произвольный код: пакет должен быть проверяемым до установки, а не собирать неизвестное окружение в процессе.
10. Сделать выпуск воспроизводимым
Зафиксируйте исходный commit, build dependencies, целевую ОС и результат чистой сборки. Для полноценного source package сформируйте upstream archive с именем avg-healthcheck_1.0.0.orig.tar.gz и используйте dpkg-buildpackage -S. Проверяйте clean-room build через sbuild или другой согласованный изолированный процесс; перенос .deb между случайными VM не является доказательством воспроизводимости.
Приёмка внутреннего пакета включает установку на пустой машине, обновление с предыдущей версии, штатное удаление, понятные владельцы файлов и отсутствие секретов. Для сервиса добавляются systemd unit, ограниченный пользователь, права на данные, миграция и откат. Документация sbuild и формат copyright. Скачать полный учебный проект. В архиве все исходники и файлы debian; он служит основой лабораторной сборки, а не готовым бинарным пакетом для production.