# Установка и обновление Railbase на Linux с помощью apt или dnf

> Railbase публикует подписанный лицензированный репозиторий пакетов, поэтому сервер Linux устанавливает и обновляет его так же, как он обновляет все остальное на компьютере.

_Updated: 2026-08-19_

На Linux Railbase является пакетом. Вы можете загрузить `.deb` или `.rpm` из своей учетной записи и установить его вручную, но на сервере вы обычно хотите противоположного: Railbase должен обновляться вместе с остальной частью машины, в соответствии с той же политикой и тем же периодом обслуживания, что и любой другой пакет, который вы запускаете.

Для этого и нужен репозиторий пакетов Railbase.

## Что это такое

Подписанный репозиторий apt и dnf, опубликованный по адресу `railbase.app`, содержащий те же пакеты, которые ваша учетная запись может загрузить с веб-сайта. Прежде чем настраивать его, стоит знать две вещи.

**Подписано.** Метаданные репозитория подписаны ключом упаковки Railbase. Вашей машине говорят доверять этому ключу один раз, и с этого момента apt или dnf отказываются от всего, что не было подписано им — что делает автоматический `apt upgrade` безопасным для запуска без присмотра.

**Он лицензируется.** В отличие от зеркала распространения, этот репозиторий не является общедоступным. Каждый запрос содержит учетные данные, привязанные к вашей учетной записи, и право проверяется при каждом запросе, а не один раз при настройке. Если срок действия учетной записи истекает, обновления прекращаются; они не продолжают тихо течь.

## Получение учетных данных

Войдите в свою учетную запись, откройте раздел **Deployments** и создайте учетные данные репозитория Linux. Вы увидите точные команды для запуска с уже заполненными учетными данными — скопируйте их на компьютер и запустите там.

Учетные данные отображаются один раз. Если вы потеряете это, создайте другое; Если машина выведена из эксплуатации или вы подозреваете, что произошла утечка учетных данных, отзовите их на той же странице. Отзыв вступает в силу при следующем запросе и не затрагивает другие машины.

Дайте каждому учетным данным метку («производственные серверы», «промежуточный»), чтобы список в вашей учетной записи оставался читаемым через год.

## Дебиан и Убунту

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

```
sudo apt update
sudo apt install railbase
```

и с этого момента `sudo apt upgrade` обновляет Railbase со всем остальным. Поскольку ключ закреплен с помощью `signed-by`, это доверие применяется только к репозиторию Railbase — оно не дает ключу Railbase полномочий над любым другим пакетом в вашей системе.

## RHEL, Федора и Рокки

Установка dnf записывает один файл `.repo`. Оба `gpgcheck` и `repo_gpgcheck` включены: пакеты **и** метаданные репозитория проверяются по ключу Railbase.

```
sudo dnf install railbase
```

## После установки

Пакет устанавливает Railbase как службу systemd с данными в `/var/lib/railbase`. Обновления заменяют программу и оставляют данные в покое — ваш файл `.vault`, загруженные файлы и конфигурация сохраняются при обновлении, как и должно быть.

Чтобы проверить, что вы используете:

```
railbase --version
systemctl status railbase
```

## Автоматические обновления

Если вы используете `unattended-upgrades` (Debian/Ubuntu) или `dnf-automatic`, Railbase можно включить, как и любой другой источник. Решение о том, *должны ли вы* делать это, зависит от вашей среды: автоматические обновления обеспечивают обновление исправлений безопасности, и никто не забывает об этом, а запланированное обновление вручную дает вам время сначала прочитать примечания к выпуску. Railbase поддерживает оба варианта; это не решает за вас.

## Если что-то пойдет не так

**`apt update` сообщает об ошибке учетных данных.** Учетные данные были отозваны или права учетной записи истекли. Проверьте раздел «Развертывания» вашего аккаунта; новые учетные данные исправляют первый случай, а во втором требуется разобраться с лицензией.

**`NO_PUBKEY` или ошибка подписи.** Доверенный ключ не установлен или установлен где-то, откуда apt его не читает. Повторно запустите ключевой шаг со страницы своей учетной записи.

**Отсутствует ожидаемая версия.** Репозиторий публикует то, на что имеет право ваша учетная запись. Если релиз вышел и ваша машина его не видит, сначала проверьте учетную запись — репозиторий намеренно не более либерален, чем страница загрузки.