Windows에 설치

Windows 10, 11 또는 Windows Server 2019+ (x64). PowerShell 한 줄로 설치합니다.

설치

1. PowerShell을 관리자 권한으로 열기

   PowerShell 아이콘을 마우스 오른쪽 버튼으로 클릭 → 관리자 권한으로 실행.

2. 명령 붙여넣기

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

   스크립트는 다음을 수행합니다:

   • 활성화 코드(UV-XXXX-XXXX-XXXX)를 입력받습니다
   • 바이너리를 다운로드하고 아카이브를 검증합니다
   • PostgreSQL이 없으면 winget으로 설치합니다(새 환경에서 약 2분)
   • 데이터베이스, 역할, Windows 서비스를 만들고 방화벽을 엽니다(8443 + 8080 폴백)
   • 프로그램 및 기능 항목을 등록합니다
   • 서비스를 시작하고 자체 서명 TLS 인증서를 생성하며, 관리자 비밀번호와 인증서의 SHA-256 지문을 모두 표시합니다

   모든 작업은 PowerShell 창에서 이루어지며 각 단계를 볼 수 있습니다. Linux의 sudo apt install에 해당하는 Windows 방식입니다.

3. 비밀번호를 기록해 두세요. 설치가 끝날 때 표시됩니다(또는 Get-Content "C:\ProgramData\uVersion\initial-admin-password"로 가져올 수 있습니다).

그런 다음 첫 로그인을 따라 진행할 수 있습니다.

비대화형 방식(CI, 스크립트 배포)

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

사용 가능한 모든 매개변수: -LicenceKey, -InstallDir, -DataDir, -Port, -BindAddress, -DownloadUrl, -Reconfigure.

설치 확인

Get-Service uVersionServer                                          # Status: Running
Get-NetTCPConnection -LocalPort 8443 -State Listen                  # HTTPS auto-signe
Get-Content "C:\ProgramData\uVersion\data\tls\fingerprint"        # empreinte TLS
Get-EventLog -LogName Application -Source uVersionServer -Newest 20 # logs recents

제거

동등한 두 가지 방법이 있습니다. 둘 다 동일한 스크립트(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"가 표시되어야 합니다.

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[]] 확인이 필요합니다: 제공되는 Content-Type에 따라 Invoke-WebRequest -UseBasicParsing이 본문을 바이트 배열 또는 문자열로 반환할 수 있습니다. 위 패턴은 두 경우 모두에서 작동합니다.