Установка в Windows

Windows 10, 11 или Windows Server 2019+ (x64). Установка одной строкой PowerShell.

Установить

1. Откройте PowerShell от имени администратора

Щёлкните правой кнопкой по значку PowerShell → Запуск от имени администратора. Иначе скрипт отказывается запускаться и сообщает вам об этом.

2. Вставьте команду установки

Одна строка, которую нужно вставить как есть в только что открытое окно:

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

Затем скрипт выполняет у вас на глазах:

• запрос кода активации, единственный заданный вопрос: см. следующий шаг
• загрузку бинарного файла и проверку архива
• установку PostgreSQL через winget, если его нет (около 2 минут)
• создание базы данных, роли и службы Windows и открытие брандмауэра (8443, плюс 8080 в качестве запасного)
• регистрацию записи в разделе «Программы и компоненты»
• запуск службы, генерацию самоподписанного сертификата TLS, затем отображение пароля администратора и отпечатка SHA-256 сертификата

Всё происходит в вашем окне PowerShell, вы видите каждый шаг. Это Windows-аналог команды sudo apt install в Linux.

3. Введите код активации

Это единственный заданный вопрос: все остальные решения задаются параметрами, описанными ниже. Поле принимает три формы: короткий код UV-XXXX-XXXX-XXXX, путь к файлу, содержащему ваш полный лицензионный ключ, или этот ключ, вставленный напрямую. Только при первой форме скрипт обращается к licence.uversion.io, чтобы обменять код на ключ.

4. Запишите итоговую сводку

Установка завершается рамкой: имя пользователя admin, временный пароль, адрес сервера и отпечаток сертификата. Запишите их.

Если окно было закрыто слишком быстро, пароль всё ещё находится на диске, пока он не был изменён:

Get-Content "C:\ProgramData\uVersion\initial-admin-password"

Этот файл исчезает, как только вы меняете пароль: поэтому ошибка "Cannot find path" означает, что изменение уже произошло.

Затем вы можете перейти к Первый вход.

Windows Server 2019 и 2022: сначала PostgreSQL

Неинтерактивный вариант (CI, скриптовое развёртывание)

& ([scriptblock]::Create((iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing).Content)) `
    -LicenceKey "UV-XXXX-XXXX-XXXX" -DataDir "D:\uVersion" -DbOnDataDir

Девять принимаемых параметров:

Куда попадают файлы

Всё живёт в папке данных, по умолчанию C:\ProgramData\uVersion: конфигурация (config.toml), содержимое ваших версионируемых файлов (data\chunks), сертификат TLS и его отпечаток (data\tls) и начальный пароль администратора.

После любого ручного изменения config.toml перезапустите службу, чтобы оно вступило в силу:

Restart-Service uVersionServer

Проверьте установку

Четыре независимые проверки. Замените C:\ProgramData\uVersion на вашу папку данных, если вы выбрали другую.

1. Служба работает

Get-Service uVersionServer

Ожидается: Status: Running.

2. Сервер слушает HTTPS на 8443

Get-NetTCPConnection -LocalPort 8443 -State Listen

Должна появиться одна строка. Полное отсутствие вывода при работающей службе обычно означает, что TLS был отключён в конфигурации: сервер тогда переходит на простой HTTP, и 8443 больше не слушает.

3. Снова показать отпечаток сертификата

Get-Content "C:\ProgramData\uVersion\data\tls\fingerprint"

Это отпечаток, который каждое рабочее место подтверждает при первом подключении.

4. Перечитать активную конфигурацию

Get-Content "C:\ProgramData\uVersion\config.toml"

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

$env:CONFIG_PATH = 'C:\ProgramData\uVersion\config'
& 'C:\Program Files\uVersion\uversion-server.exe'

Затем остановите с помощью Ctrl+C, потом Start-Service uVersionServer. Если служба даже не запускается достаточно, чтобы выдать ошибку, средство просмотра событий Windows (eventvwr.msc) записывает её в журнал Система, источник Service Control Manager. Не ищите там журнал приложения с именем uVersion: сервер пишет в свой стандартный вывод, он не регистрирует источник событий Windows, поэтому команда вроде Get-EventLog -Source uVersionServer никогда ничего не вернёт.

Удаление

Два равнозначных способа. Оба выполняют один и тот же скрипт (uninstall.ps1), который управляет службой, брандмауэром, системной переменной среды, папкой данных, бинарным файлом, записью в разделе «Программы и компоненты» и базой данных PostgreSQL.

Способ 1: через «Программы и компоненты»

1. Win+R → appwiz.cpl → Enter
2. Найдите uVersion Server в списке
3. Щёлкните правой кнопкой → Удалить
4. Откроется окно PowerShell с правами администратора и выполнит скрипт в видимом режиме

Способ 2: через PowerShell от имени администратора

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

Скрипт показывает ваши два пути при запуске, а в конце — блок проверки: для службы, каталога установки, папки данных и записи в разделе «Программы и компоненты» вы должны увидеть зелёное "OK absent".

$body = (iwr "https://uversion.io/downloads/server/uninstall.ps1" -UseBasicParsing).Content
if ($body -is [byte[]]) { $body = [Text.Encoding]::UTF8.GetString($body) }
& ([scriptblock]::Create($body)) -InstallDir "D:\uVersion\bin" -DataDir "D:\uVersion"

Удалить также PostgreSQL?

По умолчанию uninstall.ps1 не трогает PostgreSQL: его могут использовать другие приложения. Чтобы удалить и его:

$body = (iwr "https://uversion.io/downloads/server/uninstall.ps1" -UseBasicParsing).Content
if ($body -is [byte[]]) { $body = [Text.Encoding]::UTF8.GetString($body) }
& ([scriptblock]::Create($body)) -RemovePostgreSQL

Проверка [byte[]] необходима: в зависимости от типа отдаваемого содержимого Invoke-WebRequest -UseBasicParsing может вернуть тело ответа как массив байт или как строку. Приведённый выше шаблон работает в обоих случаях.