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 창에서 이루어지며 각 단계를 볼 수 있습니다. Linux의 sudo apt install에 해당하는 Windows 방식입니다.

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. 서버가 8443에서 HTTPS로 수신 중

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이 응답 본문을 바이트 배열 또는 문자열로 반환할 수 있습니다. 위 패턴은 두 경우 모두에서 작동합니다.