uVersion
Русский
Скачать →

Wiki

Установка uVersion Server

Выберите свой путь: Ubuntu / Debian (пакет .deb), Windows (PowerShell) или Docker.

Сервер uVersion устанавливается одной командой в Ubuntu/Debian, в Windows или через Docker. Установщик задаёт несколько вопросов, настраивает PostgreSQL, базу данных, системную службу и сертификат HTTPS, после чего показывает ваш пароль администратора. Рассчитывайте на десять минут.

Термины

Шесть слов встречаются на этих страницах повсюду. Если какое-то из них вам незнакомо, этого раздела достаточно: ничего другого знать не предполагается.

  • Каталог данных: каталог, куда сервер записывает всё, что принадлежит вам, а именно содержимое ваших версионируемых файлов, свой сертификат и свою идентичность. Вы выбираете его при установке. Это тот каталог, который следует резервировать.
  • Кластер PostgreSQL: экземпляр базы данных со своим каталогом и своим портом. Одна и та же машина может размещать несколько таких кластеров, не видящих друг друга. uVersion использует системный либо свой собственный, в зависимости от вашего ответа.
  • Системная служба: программа, которая работает в фоне и сама перезапускается при загрузке машины. В Windows её называют «службой Windows», в Linux «юнитом systemd».
  • Отпечаток TLS: строка из 64 символов, идентифицирующая сертификат сервера. Вы подтверждаете его один раз на каждом рабочем месте, как при первом подключении по SSH к машине.
  • Код активации: код UV-XXXX-XXXX-XXXX, полученный по электронной почте. Установщик обменивает его на вашу полную лицензию. Он используется только один раз.
  • Очистка (purge): полное удаление пакета, включая его ответы в конфигурации. В Debian apt remove удаляет программу, а apt purge удаляет вдобавок её настройки.

Требования

  • Машина (VPS, мини-ПК, офисный сервер) под управлением Ubuntu 24.04+, Debian 13+ или Windows 10, 11, Server 2019+. Прочие дистрибутивы покрывает контейнер Docker.
  • Права администратора на этой машине: root в Linux, на практике через sudo, либо PowerShell «Запуск от имени администратора» в Windows. Без них установщик отказывается запускаться.
  • Ваш код активации uVersion (формат UV-XXXX-XXXX-XXXX), полученный по электронной почте при выпуске лицензии или доступный в вашем личном кабинете. Этот код одноразовый: после обмена он больше не может быть использован на другой машине.
  • Исходящий доступ в Интернет к licence.uversion.io (HTTPS) на время обмена кода. В сети без доступа в Интернет см. раздел «Неинтерактивная и автономная установка» на странице Ubuntu: установщик принимает также полный лицензионный ключ, который вы получаете в личном кабинете на другом рабочем месте.
  • PostgreSQL. В Ubuntu и Debian он устанавливается автоматически как зависимость пакета, вам ничего делать не нужно. В Windows установщик ставит его через winget, отсутствующий в Windows Server 2019 и 2022: в этих двух версиях установите PostgreSQL 16 вручную перед запуском скрипта.
  • Место на диске. Сам сервер и база данных занимают мало: доминирует хранилище фрагментов (содержимое ваших файлов по всем ревизиям вместе), поэтому рассчитывайте объём исходя из размера ваших проектов Unreal и их истории. Если вы разместите базу данных также в каталоге данных, установщик дополнительно записывает туда балластный файл размером 1 ГБ, который следует удалить при переполнении диска.
  • Открытый на вход TCP-порт 8443, именно через него подключаются ваши рабочие места. Установщик Windows создаёт правило брандмауэра сам. Пакет Debian не открывает ни одного порта: сделайте это сами, например sudo ufw allow 8443/tcp.

Выберите свой путь

Ubuntu / Debian

Ubuntu 24.04+, Debian 13+. Установка через пакет .deb.

sudo apt install ./uversion-server_*.deb

Windows

Windows 10, 11, Server 2019+. Одна строка PowerShell от имени администратора.

iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing | iex

Docker

Сервер и база данных в контейнерах. Единственный поддерживаемый путь в семействе Red Hat (RHEL, Rocky, AlmaLinux, Fedora).

docker compose up -d

HTTPS и сертификат

Сервер говорит только по HTTPS, на порту 8443. Настраивать нечего, и никакое доменное имя не нужно: при первом запуске сервер сам генерирует свой сертификат, называемый самоподписанным, и в конце установки показывает его отпечаток SHA-256. Каждое рабочее место подтверждает этот отпечаток один раз, при первом подключении, и затем отклоняет любой другой отпечаток.

Видимое следствие: браузер, открывающий https://<ip-сервера>:8443, показывает предупреждение безопасности, потому что этот сертификат не подписан ни одним публичным центром. Это ожидаемо. Убедитесь, что показанный отпечаток действительно тот, что был записан при установке, затем продолжайте.

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

Подробности процедуры на стороне рабочих мест: Отпечаток TLS. Если у вашего сервера есть доменное имя и у вас уже есть сертификат, вы можете разместить свой вместо него: см. раздел 2 эксплуатационного руководства (docs/operations.md), поставляемого вместе с сервером.

Что дальше?

Установка показывает в рамке имя пользователя admin, временный пароль и адрес сервера. Запишите их. Затем вы подключаетесь с любого рабочего места в сети, из браузера или десктоп-клиента, по адресу https://<ip-сервера>:8443, где <ip-сервера> это адрес машины, которую вы только что установили.