Wiki
uVersion Server 설치
설치 방식을 선택하세요: Ubuntu / Debian(.deb 패키지), Windows(PowerShell) 또는 Docker.
uVersion 서버는 Ubuntu/Debian, Windows 또는 Docker에서 명령 한 줄로 설치됩니다. 설치 프로그램이 몇 가지 질문을 한 뒤 PostgreSQL, 데이터베이스, 시스템 서비스, HTTPS 인증서를 설정하고, 관리자 비밀번호를 표시합니다. 약 10분 정도 걸립니다.
용어
이 문서 전반에 여섯 개의 단어가 반복해서 나옵니다. 그중 하나라도 낯설다면 이 섹션만으로 충분합니다: 그 외에 알아야 할 전제 지식은 없습니다.
- 데이터 폴더: 서버가 여러분에게 속한 모든 것, 즉 버전 관리되는 파일의 내용, 인증서, 그리고 서버의 신원을 기록하는 폴더입니다. 설치 시 직접 선택합니다. 백업해야 할 폴더가 바로 이것입니다.
- PostgreSQL 클러스터: 자체 폴더와 자체 포트를 가진 데이터베이스 인스턴스입니다. 한 대의 머신이 서로를 보지 못한 채 여러 개를 호스팅할 수 있습니다. uVersion은 여러분의 응답에 따라 시스템의 것을 쓰거나 자체 클러스터를 사용합니다.
- 시스템 서비스: 백그라운드에서 실행되며 머신이 부팅될 때 스스로 다시 시작하는 프로그램입니다. Windows에서는 "Windows 서비스", Linux에서는 "systemd 유닛"이라고 부릅니다.
- TLS 지문: 서버의 인증서를 식별하는 64자 문자열입니다. 머신에 처음 SSH로 접속할 때처럼, 각 워크스테이션에서 한 번씩 확인합니다.
- 활성화 코드: 이메일로 받는
UV-XXXX-XXXX-XXXX코드입니다. 설치 프로그램이 이 코드를 전체 라이선스로 교환합니다. 단 한 번만 사용됩니다. - 퍼지(purge): 구성 응답까지 포함한 패키지의 완전한 제거입니다.
Debian에서
apt remove는 프로그램을 제거하고,apt purge는 그 설정까지 추가로 제거합니다.
사전 요구 사항
- 머신 한 대(VPS, 미니 PC, 사무실 서버 등). Ubuntu 24.04+, Debian 13+ 또는 Windows 10, 11, Server 2019+에서 동작하는 것. 다른 배포판은 Docker 컨테이너가 지원합니다.
- 해당 머신에 대한 관리자 권한: Linux에서는
root(실제로는sudo를 통해), Windows에서는 PowerShell "관리자 권한으로 실행". 이것이 없으면 설치 프로그램은 시작을 거부합니다. - uVersion 활성화 코드(형식
UV-XXXX-XXXX-XXXX). 라이선스 발급 시 이메일로 받거나 계정 페이지에서 가져올 수 있습니다. 이 코드는 일회용입니다: 한 번 교환하면 다른 머신에서는 더 이상 사용할 수 없습니다. licence.uversion.io로의 아웃바운드 인터넷 접속(HTTPS). 코드를 교환하는 동안만 필요합니다. 인터넷 접속이 없는 네트워크에서는 Ubuntu 페이지의 "비대화형 및 오프라인 설치" 섹션을 참고하세요: 설치 프로그램은 전체 라이선스 키도 받아들이며, 이는 다른 워크스테이션에서 계정 페이지를 통해 가져옵니다.- PostgreSQL. Ubuntu와 Debian에서는 패키지의 의존성으로 자동으로 함께
설치되므로 별도로 할 일이 없습니다. Windows에서는 설치 프로그램이
winget을 통해 설치하는데, 이는 Windows Server 2019 및 2022에는 없습니다: 이 두 버전에서는 스크립트를 실행하기 전에 PostgreSQL 16을 직접 설치하세요. - 디스크 공간. 서버 자체와 데이터베이스는 용량이 작습니다: 지배적인 것은 청크 저장소(모든 리비전을 합친 파일 내용)이므로, Unreal 프로젝트의 크기와 그 이력을 기준으로 산정하세요. 데이터베이스도 데이터 폴더에 두는 경우, 설치 프로그램은 그곳에 1 GB짜리 예비(밸러스트) 파일을 추가로 기록합니다. 디스크가 가득 찼을 때 삭제하기 위한 것입니다.
- 인바운드로 열린 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와 인증서
서버는 포트 8443에서 HTTPS만 사용합니다. 설정할 것이 없고 도메인 이름도 필요 없습니다: 첫 시작 시 서버는 자체 서명(self-signed)이라 불리는 인증서를 스스로 생성하고, 설치 마지막에 그 SHA-256 지문을 표시합니다. 각 워크스테이션은 첫 접속 시 이 지문을 한 번 확인하며, 이후로는 다른 지문을 모두 거부합니다.
눈에 보이는 결과: https://<서버-IP>:8443을 여는 브라우저는
보안 경고를 표시합니다. 이 인증서가 어떤 공인 기관에 의해서도 서명되지
않았기 때문입니다. 이는 예상된 동작입니다. 표시된 지문이 설치 시 적어 둔 것과
일치하는지 확인한 뒤 계속 진행하세요.
워크스테이션 쪽 절차의 자세한 내용:
TLS 지문.
서버에 도메인 이름이 있고 이미 인증서를 보유하고 있다면, 대신 여러분의 인증서를 넣을 수
있습니다: 서버와 함께 제공되는 운영 런북(docs/operations.md)의 섹션 2를 참고하세요.
다음 단계
설치가 끝나면 상자 안에 admin 아이디, 임시 비밀번호, 그리고 서버 주소가
표시됩니다. 이것들을 적어 두세요. 그런 다음 네트워크의 어느 워크스테이션에서든
브라우저나 데스크톱 클라이언트로 https://<서버-IP>:8443 주소에 접속합니다.
여기서 <서버-IP>는 방금 설치한 머신의 주소입니다.