VPS에 서버 설치하기
Linux x86-64 VPS에 PostgreSQL과 TLS를 갖춘 평가 환경을 구성합니다. 호환 클라이언트는 별도로 준비하세요. 명령어는 Debian 또는 Ubuntu 예시이며 선택한 패키지의 요구 사항을 확인해야 합니다.
-
VPS와 비공개 네트워크 준비
sudo 권한이 있는 일반 SSH 계정을 사용하세요. x86_64와 glibc를 확인하고 PostgreSQL과 필요한 라이브러리를 설치합니다. PostgreSQL, API, WebAdmin은 로컬에 유지합니다. 두 테스트 기기에서 접근할 수 있는 사설망이나 VPN을 준비하세요.
uname -m getconf GNU_LIBC_VERSION sudo apt update sudo apt install postgresql libpq5 openssl ca-certificates pg_isready -
다운로드, 검증, 압축 풀기
릴리스 페이지에서 Linux x86-64 아카이브와 .sha256 파일을 받으세요. 예시 파일명을 실제 이름으로 바꾸고 공식 페이지의 체크섬도 비교하세요. 다르면 중단하세요. 압축을 푼 폴더에 들어가 누락된 라이브러리가 있는지 확인합니다.
서버 다운로드archive=ultimate-odycer-server-dev-20261106.2-linux-x86_64.tar.gz sha256sum -c "$archive.sha256" && tar -xzf "$archive" && cd "${archive%.tar.gz}" && ldd ./bin/mmorpg-server && ldd ./bin/login-server -
전용 데이터베이스 생성
평가용 PostgreSQL에 전용 역할과 데이터베이스를 만듭니다. 메시지가 표시되면 고유한 비밀번호를 설정합니다. 마지막 명령으로 로컬 TCP 로그인을 확인합니다.
sudo -u postgres createuser --pwprompt odycer_test sudo -u postgres createdb --owner=odycer_test ultimate_odycer_test psql -h 127.0.0.1 -U odycer_test -d ultimate_odycer_test -c "SELECT current_user;" -
서버와 TLS 설정
config.example.json을 config.json으로 복사하고 접근을 제한합니다. server의 db_host, db_port, db_name, db_user, db_password를 설정합니다. network.enable_tls는 true로 두고 network.tls_cert_path와 tls_key_path에 인증서와 키를 둡니다. 클라이언트가 인증서를 신뢰해야 하며 접속 이름이나 IP가 일치해야 합니다. Game과 Login에서 동일한 JWT_SECRET을 사용합니다. 실행 계정으로 압축을 풀거나 필요한 파일에 접근할 권한을 부여하세요. 별도로 시작하는 서비스에는 TLS 절대 경로를 쓰고 두 프로세스가 인증서와 키를 읽을 수 있는지 확인하세요.
cp -n config.example.json config.json chmod 600 config.json (umask 077; set -C; printf "JWT_SECRET=%s " "$(openssl rand -hex 32)" > .odycer-runtime.env) -
Game을 먼저 시작하고 마이그레이션 후 Login 실행
압축을 푼 폴더에서 두 SSH 세션을 열고 같은 환경 파일을 표시하지 않고 불러옵니다. 빈 데이터베이스에서는 Game만 시작합니다. PostgreSQL 마이그레이션이 끝나고 Game과 WebAdmin이 수신 대기하는지 확인한 뒤 두 번째 세션에서 Login을 시작하세요. 동시에 시작하면 릴레이션 중복 오류가 발생하고 SQLite로 대체될 수 있습니다. 로그에 대체가 표시되면 PostgreSQL부터 수정하세요.
Game
set -a; . ./.odycer-runtime.env; set +a ./bin/mmorpg-serverss -ltnLogin
set -a; . ./.odycer-runtime.env; set +a ./bin/login-server -
WebAdmin 열기 및 테스트 클라이언트 허용
마이그레이션 후 bootstrap-admin을 실행하고 SSH 터널을 통한 첫 로그인에서 임시 비밀번호를 바꿉니다. server.login_ip와 server.server_ip를 테스트 기기에서 접근할 수 있는 사설 IP로 설정하고 재시작한 뒤 TCP 2106과 7777을 테스트 망에만 허용합니다. Login이 알려 주는 Game 주소가 연결 가능하고 TLS 인증서에 포함되는지 확인하세요. 5432, 8080, 8082는 공개하지 않습니다. 부트스트랩은 Game과 동일한 시스템 계정, 작업 폴더, PostgreSQL 설정으로 실행하세요. 사용자를 바꿀 때는 서비스 계정의 홈 디렉터리를 사용합니다.
VPS
set -a; . ./.odycer-runtime.env; set +a ./bin/bootstrap-adminSSH → WebAdmin
ssh -N -L 8082:127.0.0.1:8082 operator@vps.example.com # http://127.0.0.1:8082/ -
결과 기록과 백업
테스트 기기에서 Login과 월드 입장을 확인합니다. 입장이 실패하면 Game 주소, 방화벽, 인증서 신뢰 여부부터 확인합니다. 데이터베이스, 설정, 릴리스를 백업하고 공개 전에 격리된 인스턴스로 복원하세요.
umask 077 pg_dump -h 127.0.0.1 -U odycer_test -Fc -f odycer-test.dump ultimate_odycer_test pg_restore --list odycer-test.dump