Перейти к основному содержанию Перейти к навигации Перейти к нижнему колонтитулу

Локальная установка

Развёртывание сервера учётных записей и дистрибуции CLI на собственной инфраструктуре.

Rediacc может работать полностью на собственной инфраструктуре. Автономный Docker-образ включает сервер учётных записей, веб-портал, маркетинг-сайт и точку распределения CLI. Внешние зависимости от размещённых на Rediacc сервисов не требуются.

Установка через rdc

rdc server install устанавливает сервер учётных записей как репозиторий на машине, до которой CLI доходит по SSH. Одна команда охватывает проверку машины, настройку renet, DNS, TLS, генерацию ключей, лицензирование, запуск и учётную запись владельца. У каждого значения есть флаг. В терминале недостающее значение запрашивается; с --yes ничего не спрашивается, а недостающее значение приводит к отказу. Каждый шаг фиксируется, поэтому повторный запуск пропускает уже выполненное.

Шаги по порядку: preflight (sudo без пароля, архитектура, порты 80 и 443, место на диске, расхождение часов), setup (rdc machine setup, только если renet отсутствует), dns, tls, repo, keys, licence, image, up и owner.

Сначала существующие машины

Установка нацелена на уже существующую машину: сервер в дата-центре или устройство в локальной сети. Настроенная машина указывается аргументом. Ещё не зарегистрированная машина добавляется по адресу:

rdc server install --ip 203.0.113.10 --user admin --domain accounts.example.com
rdc server install server-1 --domain accounts.example.com --owner owner@example.com --yes

--port и --name задают SSH-порт и имя, под которым машина регистрируется. Облачная виртуальная машина создаётся заранее командой rdc machine provision; сама установка её никогда не создаёт.

DNS

Установка выводит A- и AAAA-записи для домена сервера и домена его хранилища резервных копий (--store-domain, по умолчанию <имя>-store.<остальная часть домена>) и ждёт, пока оба домена начнут указывать на машину. Записи в зону никогда не вносятся. --no-dns-wait выводит записи и продолжает, что подходит для имени в локальной сети, которое обслуживает локальный резолвер.

TLS

--tls выбирает один из трёх способов:

СпособТребуетсяПримечания
letsencryptПорты 80 и 443, доступные из интернетаПроверка HTTP-01. --cert-email получает уведомления об истечении срока; по умолчанию это владелец.
cloudflare--cf-tokenПроверка DNS-01 через API-токен Cloudflare.
byo--tls-cert и --tls-keyГотовый PEM-сертификат, покрывающий оба домена. --tls-ca указывает центр сертификации, которому доверяет проверка работоспособности.
rdc server install lab --domain lab.example.internal --tls byo \
  --tls-cert host.crt --tls-key host.key --tls-ca ca.crt \
  --licence free --no-dns-wait --yes

Образ

Шаг образа по умолчанию загружает ghcr.io/rediacc/server:latest на машину. --image выбирает другую ссылку. --image-file передаёт tar-архив, созданный командой docker save, а --local-image сохраняет --image из локального Docker и передаёт его. Оба варианта обходятся без доступа машины к реестру.

Лицензирование и бесплатный тариф

--licence auto (по умолчанию) берёт сертификат делегирования из вошедшей учётной записи или запускается на бесплатном тарифе, если сертификата нет. --licence free всегда запускается на бесплатном тарифе. Учётной записи, вошедшей до появления команды установки, нужно снова выполнить rdc subscription login, чтобы получить нужный scope.

Для машины без пути до сервера учётных записей --cert <file> принимает сертификат делегирования, полученный в другом месте. Сертификат должен называть ключ, созданный на машине, поэтому обычный порядок такой: сначала установка на бесплатном тарифе, затем сертификат:

rdc server install server-1 --domain accounts.example.com --licence free --yes
rdc server licence accounts.example.com --cert delegation-cert.json

rdc server licence переводит сервер с бесплатного тарифа на сертификат вошедшей учётной записи или из --cert. Что проверяет сервер, описывает шаг 3 в разделе о лицензировании ниже.

Пакет восстановления

Все ключи создаются на машине и записываются только в secrets.env репозитория. В терминале установка завершается однократным выводом пакета восстановления: делегированная пара ключей, ключ сервера конфигурации учётных записей и учётные данные объектного хранилища. Пакет никогда не попадает в журнал и не входит в --output json. Без терминала он не выводится, а в заключительной строке названа команда rdc server backup.

rdc server backup accounts.example.com --out elite-recovery.env

--out записывает файл с режимом 0600; без него пакет уходит в stdout. --bws-project <id> при установке дополнительно копирует ключи в проект Bitwarden Secrets Manager, а --rotate заменяет отличающееся сохранённое значение. Без --bws-project ключи покидают сервер только в пакете восстановления, который выводит установка, и в том, который создаёт rdc server backup, в файле --out или в stdout.

Состояние

rdc server status accounts.example.com

Состояние показывает работоспособность, тариф, сертификат и образ сервера. --machine и --repo указывают цель, когда на устройстве нет записи об установке для этого домена.

Обновления

КомпонентКоманда
CLIrdc update
renet на машинеrdc machine setup <machine>
Образ и шаблон сервераrdc server upgrade <domain>

rdc server upgrade создаёт форк репозитория как точку отката, размещает новый образ, повторно применяет шаблон, когда встроенный новее, и перезапускает сервер. Команда принимает --image, --image-file и --local-image так же, как установка, поэтому изолированная машина обновляется из сохранённого tar-архива образа.

Docker образ

Загрузите автономный образ:

docker pull ghcr.io/rediacc/server:stable

Запустите со стандартными параметрами:

docker run -p 80:80 -p 443:443 ghcr.io/rediacc/server:stable

Образ предоставляет доступ к:

  • Account API по адресу /account/api/v1/
  • Веб-портал по адресу /account/
  • Маркетинг-сайт по адресу /
  • Артефакты CLI по адресу /releases/
  • Бинарные файлы Renet по адресу /bin/

Установка CLI с вашего сервера

Установите CLI непосредственно с вашего локального сервера. Скрипт установки автоматически определяет канал обновлений и направляет CLI на ваш сервер для получения обновлений.

curl -fsSL https://account.example.com/install.sh | \
  REDIACC_SERVER_URL=https://account.example.com bash

Эта одиночная команда:

  1. Загружает бинарный файл CLI из конечной точки /releases/ вашего сервера
  2. Запрашивает /account/api/v1/.well-known/server-info для обнаружения канала обновлений
  3. Записывает конфигурацию по умолчанию (rediacc.json) с URL вашего сервера, каналом обновлений и ключами шифрования в полях account.*
  4. Настраивает rdc update для проверки обновлений на вашем сервере

Переменная REDIACC_CHANNEL не требуется. Скрипт установки автоматически читает канал из конфигурации вашего сервера.

Конфигурация CLI с именованными конфигурациями

Если вы подключаетесь к нескольким серверам (локально, production, edge), именованные конфигурации держат каждое окружение изолированным:

# Создайте конфигурацию для вашего локального сервера
rdc config init myserver --server https://account.example.com

# Выполните вход, используя эту конфигурацию
rdc --config myserver subscription login

# Все команды с --config используют локальный сервер
rdc --config myserver machine status prod-1

Каждая именованная конфигурация хранит собственный URL сервера учётных записей (в полях account.*) и собственный API-токен аккаунта, который хранится рядом с конфигурацией в файле api-token-<name>.json. Переключение конфигураций переключает весь контекст сервера.

Окружения без доступа в сеть

Для окружений без доступа в интернет установите как URL сервера, так и пользовательский URL релизов:

curl -fsSL https://account.example.com/install.sh | \
  REDIACC_SERVER_URL=https://account.example.com \
  REDIACC_RELEASES_URL=https://account.example.com/releases \
  bash

CLI будет проверять account.example.com/releases/cli/stable/manifest.json на наличие обновлений вместо общедоступной CDN релизов.

Если сервер полностью в автономном режиме, установите CLI через npm из упакованного архива:

npm install -g https://account.example.com/npm/rediacc-cli-latest.tgz

Справочник переменных окружения

ПеременнаяИспользуетсяНазначение
REDIACC_SERVER_URLСкрипт установкиURL сервера учётных записей. Автоматически обнаруживает канал и ключи шифрования.
REDIACC_RELEASES_URLСкрипт установки, обновитель CLIПользовательская конечная точка релизов для бинарных файлов CLI. По умолчанию: https://releases.rediacc.com
REDIACC_CHANNELСкрипт установкиПереопределить канал обновлений. Автоматически определяется с сервера, если не установлено.
REDIACC_ACCOUNT_SERVERСреда выполнения CLIПереопределить URL сервера учётных записей для всех команд CLI.
REDIACC_UPDATE_CHANNELСреда выполнения CLIПереопределить канал обновлений для rdc update.

Конфигурация сервера

Docker-образ локального сервера использует ту же переменную ENVIRONMENT, что и размещённый сервис. Установите её в переменных окружения Docker или конфигурации оркестрации:

  • ENVIRONMENT=production (по умолчанию): стандартные ограничения ресурсов; CLI, подключающиеся к этому серверу, по умолчанию используют канал обновлений stable. Имя значения production это устаревший идентификатор развёртывания. Оба режима production и edge имеют качество production.
  • ENVIRONMENT=edge: 2X Community лимиты; CLI по умолчанию используют канал обновлений edge

См. Каналы релизов для подробностей о том, что предоставляет каждое окружение.

Что сервер сообщает CLI

Когда CLI подключается к вашему серверу, он запрашивает /.well-known/server-info для обнаружения:

  • Открытый ключ E2E шифрования: для хранения конфигурации с нулевым знанием
  • Минимальная версия CLI: блокирует подключение устаревших CLI
  • Канал обновлений: сообщает CLI, какой канал релизов использовать для обновлений
  • Окружение: какой профиль развёртывания использует сервер (standard-limits vs. edge-with-2X-limits)

Эта автоматическая конфигурация означает, что вам нужен только URL сервера. Всё остальное определяется автоматически.

Лицензирование для изолированных развёртываний

Изолированные и самостоятельно размещённые локальные серверы выдают лицензии локально, используя сертификат делегирования, подписанный главным ключом. Сертификат ограничивает локальный сервер лимитами его плана и создаёт цепь с очевидными следами изменений. См. Цепь лицензий и делегирование для криптографического дизайна (целостность цепи, обнаружение форков, доказательства аудита).

Этот раздел охватывает оперативную настройку: генерирование ключей, запрос сертификата, настройка автоматического обновления и процесс обновления в автономном режиме (изолированный от сети).

Одна подписка, одна локальная установка

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

Если вам нужны отдельные окружения (production, staging, DR, multi-region), купите одну подписку на установку. Применение единого активного сертификата кодифицирует этот договор: попытка создать второй активный сертификат возвращает 409 DELEGATION_CERT_ALREADY_ACTIVE с id существующего сертификата и инструкциями по обновлению (предпочтительно, сохраняет цепь) или отзыву и созданию (сбрасывает цепь).

1. Сгенерируйте пару ключей Ed25519 локального сервера

Локальный сервер использует отдельную пару ключей Ed25519 для подписи лицензий. Сертификат делегирования в вышестоящей системе авторизует этот конкретный открытый ключ.

# Сгенерируйте новую пару ключей
openssl genpkey -algorithm Ed25519 -out onprem-private.pem
openssl pkey -in onprem-private.pem -pubout -out onprem-public.pem

# Преобразуйте в base64 (формат, который ожидает локальный сервер в переменных окружения)
ON_PREMISE_PRIVATE_KEY=$(openssl pkey -in onprem-private.pem -outform DER | base64 -w 0)
ON_PREMISE_PUBLIC_KEY=$(openssl pkey -in onprem-private.pem -pubout -outform DER | base64 -w 0)

Сохраните приватный ключ вместе с другими секретами (например, в Docker secret или Kubernetes Secret). Он никогда не покидает локальный сервер.

2. Запросите сертификат делегирования из вышестоящей системы

Вы можете запросить сертификат из портала учётных записей вышестоящей системы тремя способами:

Вариант A: Самообслуживание клиента (рекомендуется). Войдите на портал вышестоящей системы как владелец организации или администратор и перейдите на /account/delegation-certs. Нажмите Create New, вставьте открытый ключ локального сервера (base64 SPKI), выберите срок действия (или примите значение по умолчанию для плана) и загрузите полученный файл .json.

Вариант B: Администратор (кросс-клиент). Поддержка Rediacc или администратор вышестоящей системы могут вызвать POST /admin/delegation-certs с теми же параметрами.

Вариант C: rdc CLI (планируется). Будущая команда CLI обернёт процесс портала.

Возвращённый .json выглядит так:

{
  "payload": "eyJ2ZXJzaW9uIjoxLCJzdWJzY3JpcHRpb25JZCI6...",
  "signature": "...",
  "publicKeyId": "..."
}

Срок действия сертификата регулируется политикой валидности (значения по умолчанию и потолки для каждого плана, переопределение для каждой подписки, ограничено концом подписки + 3-дневный льготный период). Ответ также включает effectiveDays и reason, поэтому вы можете видеть, почему он выбрал это значение. См. Цепь лицензий - Политика валидности для полных правил.

3. Установите сертификат на локальный сервер

Сервер читает свой делегированный сертификат из одного файла на томе данных, /data/delegation-cert.json (путь задаёт DELEGATION_CERT_PATH). Ни одна переменная окружения не содержит сам сертификат. rdc server install кладёт туда скачанный сертификат, а rdc server licence позже заменяет его:

rdc server install <domain> --cert delegation-cert.json
rdc server licence <domain> --cert delegation-cert.json
rdc server status <domain>

Обе команды передают сертификат работающему серверу через его почтовый ящик сертификатов (data/web/cert-inbox/new.json). Сервер проверяет его и отвечает файлом applied.json или rejected.json, а команда подтверждает id нового сертификата через rdc server status (те же данные cert-status, что и в шаге 6). rdc server upgrade использует тот же ящик. Сервер больше не читает DELEGATION_CERT_BASE64: один из шагов обновления переносит оставшееся в secrets.env значение в ящик, так что машина, установленная до появления ящика, сохраняет свой сертификат.

Сервер загружает сертификат при запуске и сверяет его с ключом, которым подписывает лицензии: отпечаток ключа подписи должен совпадать с отпечатком delegatedPublicKey сертификата, потому что лицензии, подписанные ключом, которого сертификат не разрешает, нельзя было бы проверить ни на одной машине. Держите пару ключей подписи и delegatedPublicKey сертификата согласованными.

Сертификат, который сервер отклоняет при запуске (неверная подпись, не тот ключ, отсутствующий UPSTREAM_PUBLIC_KEY или повреждённый файл), не останавливает его. Сервер запускается на бесплатном тарифе и переносит плохой файл в delegation-cert.rejected.json рядом с исходным. Подпись лицензий репозиториев отвечает 503 DELEGATION_CERT_REFUSED, пока не появится действительный сертификат, а rdc server status показывает cert REFUSED (reason). Чтобы исправить, выполните rdc server licence с действительным сертификатом. Просроченный сертификат по-прежнему загружается: он мягко деградирует, а не отклоняется.

Если ваш локальный сервер имеет исходящий HTTPS доступ к вышестоящей системе, установите автоматическое обновление, чтобы сертификат обновлялся перед истечением без ручного вмешательства:

# Требуется для /onprem/cert-upload для проверки загруженных сертификатов против главного ключа вышестоящей системы.
# Быстро падает при запуске, если UPSTREAM_API_KEY установлен без этого.
UPSTREAM_PUBLIC_KEY="<upstream master Ed25519 SPKI public key, base64>"

# Требуется для цикла автоматического обновления. Создайте через портал:
#   Владелец организации/администратор → /account/delegation-certs → "Get auto-renew token"
# Это ЕДИНСТВЕННЫЙ способ получить api token с областью delegation:renew.
UPSTREAM_URL="https://www.rediacc.com"
UPSTREAM_API_KEY="rdt_..."

# Опциональная настройка (показаны значения по умолчанию).
AUTO_RENEW_INTERVAL_HOURS=24
RENEW_THRESHOLD_DAYS=14

Цикл автоматического обновления локального сервера запускается один раз при запуске, а затем в установленном интервале. Он использует адаптивный порог (min(env.RENEW_THRESHOLD_DAYS, ceil(certValidityDays / 3))), поэтому 15-дневный сертификат COMMUNITY обновляется за 5 дней до истечения вместо срабатывания обновления на день 1. 90-дневный сертификат BUSINESS обновляется за 14 дней до истечения (потолок, установленный в окружении).

Если обновление не удаётся, сертификат остаётся в использовании до естественного истечения. Ошибка откатывается на 1 час и записывается в ${DELEGATION_CERT_PATH}.status.json плюс открывается через GET /onprem/cert-status.

5. Обновление без выхода в сеть (нет исходящего HTTPS)

Если ваш локальный сервер не может связаться с вышестоящей системой, используйте ручной процесс передачи:

  1. Загрузите запрос обновления из портала администратора локального сервера. Как администратор локальной системы, обратитесь к GET /onprem/renewal-request. Это возвращает манифест JSON, содержащий голову локальной цепи, делегированный открытый ключ и подпись Ed25519 с очевидным следом изменений из вашего приватного ключа локального сервера.
  2. Передайте манифест вышестоящей системе через USB, зашифрованную электронную почту или любой внеполосный канал. Манифест небольшой (несколько КБ) и не содержит секретов.
  3. Обработайте манифест вышестоящей системе. Владелец организации/администратор открывает /account/delegation-certs → Upload renewal request → выбирает файл манифеста. Вышестоящая система проверяет подпись манифеста против delegatedPublicKey активного сертификата (доказывает, что она пришла от держателя приватного ключа локального сервера), проверяет защиту от повторов (манифесты старше 7 дней отклоняются), затем выдаёт свежий сертификат.
  4. Загрузите новый сертификат с портала вышестоящей системы в виде файла .json.
  5. Передайте сертификат обратно на локальный сервер.
  6. Загрузите на локальный сервер через портал администратора (POST /onprem/cert-upload). Локальный сервер проверяет новый сертификат против UPSTREAM_PUBLIC_KEY и валидирует, что genesisSequence сертификата всё ещё связана с записью цепи в локальном реестре выдачи (продвижение последовательности во время передачи поддерживается - цепь расширяется естественно).

Этот весь цикл никогда не требует исходящего трафика сети с локального сервера.

Режимы отказа манифеста

КодПричинаИсправление
NO_ACTIVE_CERTВышестоящая система не имеет активного сертификата для этой подпискиВыдайте новый сертификат через процесс создания вместо обновления
DELEGATED_KEY_MISMATCHМанифестный delegatedPublicKey отличается от активного сертификатаМанифест может быть повтором с другой установки локального сервера
MANIFEST_SIGNATURE_INVALIDПодпись не проверяется против делегированного открытого ключаМанифест был изменён при передаче, или вы сгенерировали его на другом локальном сервере
MANIFEST_EXPIREDМанифест старше 7 днейСоздайте свежий запрос обновления с локального сервера

Режимы отказа загрузки сертификата

POST /onprem/cert-upload при успехе отвечает {uploaded: true, bootstrap, certId}. Отклонённый сертификат получает ответ {error, code}: в error подробности, а code это одна из причин в таблице ниже. Каждый применённый или отклонённый сертификат записывается в журнал и отправляется по почте владельцу машины.

rdc server licence по SSH кладёт сертификат во входящую папку машины (data/web/cert-inbox) и считывает обратно applied.json или rejected.json. Затем он подтверждает идентификатор нового сертификата через cert-status. Отказ содержит те же причины, а также not-a-regular-file и too-large, которые выдаёт сама входящая папка.

КодHTTPПричина
malformed400Загруженный файл не является корректным сертификатом
bad-signature400Сертификат не подписан настроенным UPSTREAM_PUBLIC_KEY
wrong-key400Сертификат выпущен для другого ключа, не для этой локальной установки
expired400Срок validUntil сертификата уже истёк
not-newer409Сертификат не новее действующего
other-subscription409Сертификат относится к другой подписке
chain-ahead409genesisSequence сертификата опережает голову локальной цепи
chain-fork409Хеш цепи в genesisSequence сертификата не совпадает с локальным реестром
no-upstream-key500UPSTREAM_PUBLIC_KEY не настроен
write-failed500Не удалось записать сертификат на диск
adoption-failed500Сервер не смог загрузить записанный сертификат

При bad-signature проверьте, что UPSTREAM_PUBLIC_KEY совпадает с главным открытым ключом вышестоящей системы. При no-upstream-key задайте UPSTREAM_PUBLIC_KEY.

6. Состояние и мониторинг

Запросите состояние локального сертификата локального сервера в любое время:

curl https://onprem.example.com/account/api/v1/onprem/cert-status \
  -H "Cookie: <admin session>"

Возвращает subscriptionId, planCode, validUntil, daysUntilExpiry загруженного сертификата, плюс блок autoRenew (enabled, lastSuccessAt, lastErrorAt, lastError). Подключите это в стек мониторинга, чтобы предупредить о устаревшем lastSuccessAt или ненулевом lastError.

Для резервного копирования и аудита администратор локального сервера может также загрузить текущий загруженный подписанный сертификат через GET /onprem/cert-current (требуется повышенная сессия).

Справочник переменных окружения сертификата делегирования

ПеременнаяТребуется?Назначение
ON_PREMISE_MODEДаУстановите на true для включения подмножества маршрутов локального сервера
ON_PREMISE_PRIVATE_KEYДаПриватный ключ Base64 PKCS8 Ed25519 для делегированной подписи
ON_PREMISE_PUBLIC_KEYДаОткрытый ключ Base64 SPKI Ed25519 (должен совпадать с delegatedPublicKey сертификата)
DELEGATION_CERT_PATHОпциональноПуть в файловой системе к подписанному сертификату JSON. По умолчанию /data/delegation-cert.json на томе данных. Заменяйте сертификат командой rdc server licence, а не вручную.
UPSTREAM_PUBLIC_KEYТребуется, если установлен UPSTREAM_API_KEY, или для работы /onprem/cert-uploadBase64 SPKI главного открытого ключа вышестоящей системы. Без него сервер при запуске отклоняет любой сертификат (no-upstream-key) и работает на бесплатном тарифе, как описано в шаге 3.
UPSTREAM_URLДля автоматического обновленияБазовый URL сервера учётных записей вышестоящей системы, например https://www.rediacc.com
UPSTREAM_API_KEYДля автоматического обновленияAPI-токен с областью delegation:renew. Создайте через портал - см. Шаг 4.
AUTO_RENEW_INTERVAL_HOURSОпциональноПо умолчанию 24. Как часто проверять нужно ли обновление сертификата.
RENEW_THRESHOLD_DAYSОпциональноПо умолчанию 14. Действует как потолок для адаптивного порога 1/3 валидности.

Резюме модели угроз

Модель делегированного сертификата защищает от:

  • Поддельные лицензии: локальный сервер может подписывать только в пределах своих лимитов плана; renet отклоняет всё выходящее за границы сертификата.
  • Совместное использование сертификата между развёртываниями: расхождение цепи обнаруживается при обновлении (возвращает CHAIN_FORK_DETECTED).
  • Обход квоты через мультиустановку: применяется вышестоящей системой через одиночный активный (один сертификат на подписку).
  • Откат цепи: renet хранит самую высокую последовательность для каждой подписки и отклоняет любые данные с более низкой последовательностью.
  • Скомпрометированные учётные данные вышестоящей системы: токен bootstrap delegation:renew может быть создан только через выделенную конечную точку портала и контролируется администратором. Токен предоставляет только обновление - он не может читать или изменять какой-либо другой ресурс.
  • Атаки повтора на манифесты: манифесты старше 7 дней отклоняются.

От чего это не защищает:

  • Скомпрометированный приватный ключ локального сервера: утёкший приватный ключ позволяет злоумышленнику подписывать лицензии до validUntil сертификата. Смягчение: ротируйте пару ключей (отозовите старый сертификат + создайте новый с новым ключом) и обращайтесь со всеми лицензиями, подписанными старым ключом, как с подозрительными.
  • Скомпрометированный главный ключ вышестоящей системы: это корень доверия. Процедуры ротации находятся вне области видимости здесь.