서버 브라우저

Edgegap 서버 브라우저 오픈 베타에 오신 것을 환영합니다. 새 서비스를 미리 체험하고 Discord의 원탁 토론을 통해 향후 방향을 함께 만들어 가시길 바랍니다.

서버 브라우저는 다음을 위한 관리형 서비스입니다 배포 및 영구적인 서버:

• 플레이어가 적합한 서버를 목록화하고 참여하도록 돕습니다 용량, 지연 시간 또는 게임 매개변수를 기반으로;

• 새 서버를 미리 준비 전세계 수요를 대규모로 처리하고 답답한 대기열을 방지하기 위해;

• 📢 서버 운영을 간소화 업데이트, 재시작, 영속성, 메싱 등 포함.

📢 아이콘으로 표시된 항목은 초기 출시 및 그 이후에 계획된 기능입니다(아직 사용 불가).

서버 선택 없이 엄격한 규칙으로 플레이어를 매칭하려면 다음을 고려하세요 매치메이킹.

✔️ 준비

네트워킹 흐름

서버 브라우저 - 네트워킹 흐름

서버 브라우저 사용 시 네 가지(4)의 중요한 데이터 흐름이 있습니다:

1. 배포 API 전용 서버를 배포, 스케일링 및 관리하는 데 사용됩니다.

   1. 사용하세요 v2/deploy API 다음을 위해 매치 기반 세션 24시간 미만 지속되는 세션.

   2. 사용하세요 프라이빗 플릿 배포 API 다음을 시작하려면 대기(스탠바이) 서버 와 함께 영속성.

   3. 📢 규칙 기반 자동 스케일링 및 메싱 지원을 위해 핫 스탠바이를 사용하세요.

2. 서버 API 전용 서버가 가용성을 알리고 용량을 관리하는 데 사용됩니다.

3. 좌석 예약 API 게임 클라이언트가 전용 서버를 검색하고 연결하는 데 사용됩니다.

4. 넷코드 전송은 게임 클라이언트와 전용 서버 간 통신에 사용됩니다.

출시 후에는, 서버 브라우저는 연중무휴 24시간 실행되어야 합니다 전 세계 플레이어가 서버에 참여할 수 있도록 보장하려면.

▶️ 탐색 시작

효율적인 서버 사용을 보장하기 위한 서버/플레이어 수명 주기와 책임에 대해 알아보세요.

인증

서버 브라우저는 자동으로 두 가지 유형의 토큰을 생성합니다:

• 서버 토큰 - 다음에 필요합니다 서버 API 메서드, 다음과 같이 앱 버전 변수로 주입될 수 있습니다.

  • 모든 API 메서드에 대한 액세스 권한을 부여하며 테스트, 데브옵스 또는 맞춤형 오케스트레이터에 유용합니다.

• 클라이언트 토큰 - 다음에 필요합니다 모니터 및 좌석 예약 API 게임 클라이언트에서 사용하는 메서드입니다.

  • 토큰 회전을 더 쉽게 하려면 이 토큰을 타사 비밀 저장소에 보관하는 것을 권장합니다.

인스턴스 검색

배포 API 전용 서버를 배포, 스케일링 및 관리하는 데 사용됩니다.

• 사용하세요 v2/deploy API 다음을 위해 매치 기반 세션 24시간 미만 지속되는 세션.

• 사용하세요 프라이빗 플릿 배포 API 다음을 시작하려면 대기(스탠바이) 서버 와 함께 영속성.

• 📢 규칙 기반 자동 스케일링 및 메싱 지원을 위해 핫 스탠바이를 사용하세요.

새로운 배포, 를 시작할 때 서버 브라우저에 새 인스턴스를 알리고 플레이어 필터링, 정렬 및 탐색에 유용한 임의의 선택적 메타데이터 매개변수를 설정하세요 다음과 같은:

• 슬롯 정보 - 팀 수용 인원 및 팀별 메타데이터(예: 팀 이름),

  • 인스턴스당 최소 하나의 슬롯이 플레이어 수용을 관리하는 데 필요합니다;

• 이름 및 태그 - 사용자 정의 가능하고 고유하며 사람이 읽을 수 있고 검색 가능한 라벨;

• 연결 세부정보 - URL, IP, 외부 포트 또는 기타 매개변수;

• 호환성 데이터 - 서버 버전 또는 지원되는 클라이언트 버전;

• 지연 시간 한정자 - 도시 및 지역 식별자, 그리고 할당된 핑 비콘 세부정보;

• 게임 매개변수 - 레벨/장면/맵, 게임 모드, 난이도, 사용된 모드;

• 플레이어가 필터링하고 적합한 서버를 찾는 데 도움이 되는 기타 모든 사용자 정의 매개변수.

위의 메타데이터 매개변수는 예시일 뿐이며 위의 항목을 포함해 원하는 매개변수를 정의할 수 있습니다. 모든 메타데이터 매개변수는 선택 사항이며 일부 인스턴스는 모든 매개변수를 정의할 필요가 없습니다.

메타데이터는 문자열 키와 문자열, 숫자, 부울 또는 문자열 배열을 값으로 지원합니다.

중첩된 객체를 직렬화하려면 키에 접근자 경로를 다음과 같이 인코딩해 보세요 "object.child.property".

서버는 언제든 인스턴스 또는 슬롯 메타데이터를 업데이트할 수 있습니다 검색 가능성 기준을 수정하기 위해.

서버 인스턴스는 지속적인 가용성을 확인하고 충돌 또는 오프라인 서버에 플레이어가 접속을 시도하지 않도록 하기 위해 주기적으로 유지 활성(킵얼라이브) 하트비트를 전송해야 합니다 하트비트를 30초 동안 받지 못하면 인스턴스와 모든 보류 중인 좌석 예약이 자동으로 제거됩니다.

📢 서버는 축소(중지)되기 전에 추가 하트비트 요청을 보내지 않고도 검색 가능하도록 인스턴스를 "최소화(히버네이션) 모드"로 업데이트할 수 있습니다. 플레이어가 히버네이션된 인스턴스에 대해 서버 브라우저 요청하면 서버 브라우저가 서버를 자동으로 재배포합니다.

다음을 참조하세요 영속성 영구 세계 상태 관리를 위해 및 앱 및 버전 더 빠른 배포를 위해.

검색 및 탐색

플레이어는 서버 인스턴스를 목록화하고 결과를 페이지네이션하여 참여하고 싶은 서버를 찾을 수 있습니다. 핑(지연 시간) 데이터를 표시하려면 각 인스턴스의 핑 비콘 세부정보를 읽고 지연 시간을 측정하세요.

인스턴스와 슬롯은 참여 가능한 좌석 또는 인덱싱된 메타데이터 매개변수로 필터링할 수 있습니다.

매개변수	연산자	예시 필터(간단한 예시 기준)
"joinable_seats"	eq 또는 ne 또는 lt 또는 le 또는 gt 또는 ge	?filter=joinable_seats gt 0 &orderby=joinable_seats desc
"문자열" (메타데이터)	eq 또는 ne 또는 lt 또는 le 또는 gt 또는 ge 또는 포함	?filter=metadata.custom_name contains 'my game' 및 metadata.server_version le '1.1.0' 및 metadata.server_version ge '1.0.0' &orderby=metadata.custom_name asc
"정수" , 또는 "부동" (메타데이터)	eq 또는 ne 또는 lt 또는 le 또는 gt 또는 ge	?filter=metadata.xp_multiplier gt 1.0 &orderby=metadata.xp_multiplier desc
"불린" (메타데이터)	eq 또는 ne	?filter=metadata.allows_new_connections eq true

서버까지의 지연 시간을 측정하기 전에 지역 및/또는 도시로 필터링하여 선택 범위를 좁히세요.

커서 기반에 대해 알아보세요 서버 브라우저 사용자가 더 많은 결과를 가져올 수 있도록 합니다.

좌석 예약

서버에 접속하기 전에 인스턴스가 충분한 가용 용량을 제공하는지 확인하기 위해 좌석 예약이 필요합니다. 예약은 그룹 또는 개인을 포함할 수 있습니다.

슬롯의 참여 가능한 좌석 용량을 초과하는 예약은 자동으로 거부됩니다 (409 충돌). 참여 가능한 좌석은 아직 다른 플레이어가 예약하지 않은 사용 가능한 모든 좌석입니다.

연합 신원: 플레이어는 예약 시 고유한 타사 플레이어 ID를 제공해야 합니다. 같은 ID를 보내면 그들이 서버 브라우저 서버가 그들의 신원을 확인할 수 있게 됩니다.

예약이 성공적으로 이루어지면 (200 확인) 플레이어는 즉시 연결을 시도해야 합니다. 보류 중인 예약은 서버가 확인하지 않으면 30초 후에 만료됩니다 서버에 의해 확인됩니다.

서버는 어떤 슬롯의 용량을 강제로 변경하거나 슬롯을 추가, 삭제 또는 업데이트할 수 있습니다. 주어진 슬롯에 대한 모든 예약은 보류 중인 예약이 새로운 사용 가능한 슬롯 용량을 초과하면 제거됩니다.

서버에 접속

플레이어가 적합한 인스턴스를 찾으면 그들은 메타데이터에서 필요한 연결 세부정보를 가져올 수 있습니다 (URL, IP, 외부 포트). 좌석 예약이 이루어지는 즉시 플레이어는 배포된 게임 서버에 연결하고 그들의 플레이어 ID를 전달할 수 있습니다.

언리얼 엔진

다음으로 PIE(에디터)에서 연결하려면 개발 및 테스트 중에 틸드(~) 키를 누르고 ~ 입력하세요 open {URL}:{port} 에디터가 맵을 로드할 때까지 기다리세요.

연결 실패나 검은 화면이 발생하면 우리의 문제 해결 가이드를 참조하세요.

유니티

새 연결을 인증하기 위해, 서버는 모든 신규 플레이어 ID와 함께 일괄 예약 확인 요청을 보내야 합니다 확인 응답에서 다음 정보를 받습니다:

• 수락된 플레이어 예약을 선호 슬롯에 할당한 정보,

• 만료된 플레이어 예약을 선호 슬롯에 할당한 정보,

• 알 수 없는 플레이어 ID 목록.

귀하의 서버는 각 플레이어 그룹을 처리하는 방법을 결정할 수 있으며 만료되었거나 거부된 사용자를 허용할지 또는 강제로 퇴장/차단할지 여부를 결정할 수 있습니다. 각 인스턴스의 슬롯은 새로운 사용 가능한 좌석 수로 즉시 업데이트되어야 합니다 새 예약이 용량을 초과하지 않도록 보장하기 위해.

서버 포기

플레이어가 떠날 때 서버는 할당된 슬롯을 업데이트하여 새로운 사용 가능한 좌석 수를 반영해야 합니다.

게임 설계가 재접속 시간을 허용한다면 서버는 좌석을 해제하기 전에 기다릴 수 있습니다.

호스팅 비용을 최적화하기 위해 플레이어가 없는 서버는 중지하는 것을 권장합니다. 잠깐의 유휴 기간 동안 재시작 횟수를 줄이려면 중지하기 전에 몇 분 정도 기다리는 것이 도움이 될 수 있습니다.

다음을 읽어보세요 영속성 답답한 영구 서버 롤백을 방지하기 위해.

⚙️ 구성

서버 브라우저 API는 새 서버 브라우저를 생성(또는 빠른 재시작)할 때 지정된 JSON 구성에서 생성됩니다. 서버 및 슬롯 만료 기간과 사용자 정의 메타데이터를 지정할 수 있습니다:

🍀 간단한 예시

{
  "version": "0.0.5",
  "server_instances": {
      "expiration_period": "30s",
      "indices": {
        "custom_id": "string",
        "custom_name": "string",
        "server_version": "string",
        "allows_new_connections": "bool",
        "xp_multiplier": "float",
        "beacon_ip": "string",
        "beacon_port_udp": "int",
        "beacon_port_tcp": "int"
      }
  },
  "server_instance_slots": {
    "indices": {
      "custom_team_name": "string",
      "average_team_skill_rating": "float"
    }
  },
  "seat_reservations": {
    "expiration_period": "30s"
  }
}

최상의 성능을 위해 필터링 또는 정렬에 사용되지 않는 메타데이터에 대해 인덱스를 지정하지 마세요. 비인덱스 매개변수는 여전히 서버 인스턴스 또는 슬롯 세부정보 API 메서드로 설정 및 읽을 수 있습니다, 참조하세요 📗 API.

☁️ 호스팅 클러스터

서버 브라우저는 Edgegap에서 연중무휴 24시간 편리하게 호스팅 및 관리됩니다.

목표에 가장 적합한 호스팅 옵션을 선택하세요:

프라이빗 클러스터 티어

한 번의 클릭으로 프라이빗 클러스터로 업그레이드하여 Edgegap 팀이 유지 관리하는 고가용성 호스팅과 공개 출시된 게임에 대한 연중무휴 실시간 지원을 누리세요.

인스턴스의 리소스 요구사항은 다음 요인에 따라 달라집니다:

• 플레이어 수 - 플레이어 수가 많을수록 더 많은 API 요청이 발생합니다,

• 플레이어당 요청 수 - 더 빠른 재시도는 서비스 부하를 증가시키고 리소스를 소비합니다,

• 서버 수 - 서버 수가 많을수록 저장되는 데이터와 API 요청이 증가합니다,

• 클라이언트 재시도 폴백 로직 - 지터 백오프로 재시도하면 트래픽 급증을 분산시키는 데 도움이 됩니다,

• 평균 매치 지속 시간 - 세션이 짧을수록 서버 브라우저와의 상호작용이 더 자주 필요합니다.

📗 API

게임 클라이언트와 전용 서버는 수명 주기 전반에 걸쳐 서버 브라우저에 API 요청을 전송합니다.

57KB

sb-openapi-open-beta.json

열기

API 명세를 가져오려면 Scalar API 웹 클라이언트 또는 Swagger 편집기 에서 세부 정보를 검사하세요.

페이지네이션

서버 브라우저는 특정 순서로 필터된 데이터를 점진적으로 가져오기 위해 커서 기반 페이지네이션을 제공합니다. 이 접근법은 더 많은 결과를 가져올 때마다 커서(시작 지점)와 페이지 크기(응답 항목 수)를 전송해야 하며, 전통적인 limit-offset 페이지네이션과는 다릅니다.

게임 서버 메타데이터를 위해 개발된 당사 고유의 데이터베이스 인덱싱 시스템과 결합된 커서 페이지네이션은 매우 동적인 데이터를 필터링하는 데 있어 빠르고 일관되며 유연한 사용자 경험을 제공합니다.

목표는 사용자가 첫 페이지에서 적합한 서버를 찾는 것입니다. 최상의 경험을 위해 이전 페이지의 캐시된 결과를 표시하고 사용자가 검색 버튼을 클릭할 때만 결과를 새로 고치는 것을 권장합니다.

🔖 변경 로그

서버 브라우저의 최신 버전은 0.0.4 입니다. 업데이트 및 공지에 주목하세요.

0.0.4 (2026년 1월 5일)

• 오픈 베타 진입, 다음 소개: 서버 인스턴스 및 슬롯에 대한 필터링 및 정렬!

0.0.3 (2025년 11월 28일)

• 서버 브라우저 서비스의 초기 릴리스가 클로즈드 베타로 출시되었습니다.

• 서버 목록화, 용량 관리 및 연결 세부정보 가져오기.

• 클라우드 배포와의 매치 세션 지원 및 프라이빗 플릿으로 항상 온라인 상태 제공.