For the complete documentation index, see llms.txt. This page is also available as Markdown.

Lightnet 소규모 네트워크 릴레이

Edgegap에서 자체 소형 네트워크 릴레이를 실행하는 방법을 살펴보세요. 이를 사용하는 Unity 게임 샘플은 다음을 통해 플레이합니다 Mirror, FishNet, PurrNet 또는 Netcode for GameObjects (NGO).

이 릴레이는 다음을 기반으로 구축된 작은 .NET 서버입니다. LightNet. Edgegap은 다른 서버와 마찬가지로 이를 호스팅하고 조율합니다: 하나의 배포가 플레이어 근처에서 시작됩니다. 한 플레이어가 방을 호스팅하고 6자리 코드가 발급되며, 다른 플레이어들은 그 코드로 참여합니다. 어떤 플레이어도 포트를 열지 않습니다: 호스트를 포함한 모두가 릴레이의 클라이언트입니다.

이 샘플은 다음을 보여줍니다:

  • 릴레이 서버 의 linux/amd64 포트에서 수신 대기하는 Docker 이미지 7777 TCP(신뢰할 수 있는 메시지)와 UDP(신뢰할 수 없는 메시지) 모두에 대해,

  • 조인 코드가 있는 방 - 여러 방이 하나의 릴레이 배포를 공유할 수 있습니다,

  • 네 가지 넷코드에서 실행되는 Tanks 샘플 - Mirror, FishNet, PurrNet, NGO를 하나의 Unity 프로젝트, 하나의 빌드에서,

  • 넷코드를 전환하는 하나의 설정 - 설정 에셋, 에디터 메뉴, 연결 전에 게임 내에서, 또는 명령줄에서,

  • 선택적 Edgegap 매치메이킹 - 기본적으로 꺼짐: 매치 찾기 근처 플레이어들을 하나의 릴레이에서 함께 묶고, 각 방마다 한 플레이어가 이를 호스팅하며, 나중에 검색한 플레이어들은 실행 중인 방에 참여하고, 방이 가득 찬 릴레이는 다른 릴레이가 시작되기 전에 새 방을 엽니다,

  • 선택적 암호화 연결 - wss:// Edgegap의 TLS 업그레이드를 통해, 일반 TCP 및 UDP 옆에서,

  • 자동화된 테스트 - 게임 클라이언트는 방 코드 또는 매치메이커를 통해 각 넷코드의 릴레이로 플레이합니다.

대안 - 전용 서버 호스트 플레이어의 이점을 방지하고 호스트가 나가도 매치가 유지됩니다.

✔️ 준비

시작하기 전에 다음이 필요합니다:

Docker Desktop(또는 Docker CLI) 설치

저장소는 네 부분으로 구성됩니다:

폴더
내용

LightNet

Unity 패키지로 제공되는 LightNet 네트워킹 코어와, 넷코드에 구애받지 않는 릴레이 프로토콜 및 클라이언트입니다.

relay-server

릴레이 서버 - 동일한 소스에서 빌드된 .NET 8 콘솔 앱과 해당 Dockerfile.

tanks

Unity 프로젝트: Mirror, FishNet, PurrNet, NGO에서의 Mirror의 Tanks 예제.

matchmaker-config.json

선택적 매치메이커 구성, 다음을 참조 선택적 매치메이킹.

🔀 넷코드 선택

넷코드는 넷코드 필드입니다 tanks/Assets/Tanks/Resources/TanksSettings.asset: Mirror, FishNet, PurrNet 또는 NGO. 동일한 에셋에 릴레이 주소와 포트도 들어 있습니다.

이렇게도 전환할 수 있습니다:

  • Unity Editor에서 다음을 사용하여 Tanks > Netcode 메뉴 - 이 메뉴는 해당 넷코드의 씬도 엽니다,

  • 게임 내에서, 화면 상단의 넷코드 버튼으로, 호스팅하거나 참여하기 전에,

  • 명령줄에서, 다음을 사용하여 -netcode FishNet.

넷코드
버전
탱크 동기화

Mirror

66.0.9

SyncVar, Command, ClientRpc, 클라이언트 권한 NetworkTransform

FishNet

4.7.4

SyncVar<int>, ServerRpc, ObserversRpc, 클라이언트 권한 NetworkTransform

PurrNet

1.24.1

SyncVar<int>, ServerRpc, ObserversRpc, 소유자 권한 NetworkTransform

NGO

1.13.0

NetworkVariable<int>, ServerRpc, ClientRpc, 소유자 권한 NetworkTransform

각 넷코드에는 동일한 릴레이 클라이언트(RelayPeer): MirrorRelayTransport, FishNetRelayTransport, PurrNetRelayTransport 및 NgoRelayTransport). 릴레이를 자신의 게임에서 사용하려면, LightNet 패키지와 해당 넷코드용 전송기를 복사하세요.

⚡ 배포 및 연결

1. 릴레이를 로컬에서 실행

☑️ 저장소 루트에서 릴레이 이미지를 빌드하고 실행합니다:

☑️ 열기 tanks Unity에서 넷코드를 선택하고 다음으로 빌드하세요: Tanks > Build Windows client, 또는 다음에서 Play를 누르세요 Assets/Tanks/Scenes/Boot.unity.

☑️ 첫 번째 게임에서 Host를 누르세요: 방 코드가 화면에 나타납니다. 두 번째 게임에서 코드를 입력하고 Join room.

✅ 이제 다음 단계로 진행할 수 있습니다.

2. 릴레이 이미지를 푸시

☑️ 시작하려면 다음이 필요합니다. Edgegap 무료 계정 생성하세요. 신용카드는 필요 없습니다.

☑️ 다음을 찾으세요: 컨테이너 레지스트리 프로젝트 이름과 자격 증명.

☑️ Docker로 Edgegap의 Container Registry에 로그인하고, 레지스트리 프로젝트 이름, 사용자 이름 및 토큰을 사용하세요:

☑️ 각 빌드마다 새 태그를 사용해 릴레이 이미지를 태그하고 푸시하세요:

✅ 이제 다음 단계로 진행할 수 있습니다.

3. 앱 버전 만들기

☑️ 애플리케이션 생성 이름: lightnet-relay, 그리고 다음 버전으로:

  • 이미지 registry.edgegap.com/<project>/lightnet-relay 및 태그,

  • Edgegap이 이미지를 가져올 수 있도록 컨테이너 레지스트리 사용자 이름과 토큰,

  • 리소스 0.25 vCPU와 512 MB 메모리,

  • 하나의 포트 7777, 이름: 릴레이, 프로토콜 TCP/UDP,

  • 선택 사항, 다음에 대해 암호화된 연결: 두 번째 포트 7778, 이름: relay-ws, 프로토콜 WS, TLS 업그레이드 켜기,

  • 최대 기간 테스트용 30분.

선택적 릴레이 설정은 다음과 같이 앱 버전의 환경 변수로:

변수
기본값
하는 일

RELAY_TCP_PORT

7777

신뢰할 수 있는 메시지용 포트

RELAY_UDP_PORT

7777

신뢰할 수 없는 메시지용 포트

RELAY_MAX_PEERS

256

모든 방 전체의 최대 동시 연결 수

RELAY_IDLE_EXIT_SECONDS

600

이 시간 동안 방이 없으면 릴레이를 중지합니다, 0 = 절대 아님(매치메이커가 시작한 릴레이는 마지막 방이 끝나면 중지됩니다)

RELAY_WS_PORT

7778

WebSocket 연결용 포트, 0 = 꺼짐

RELAY_MATCH_MAX_PLAYERS

4

매치메이커가 시작한 릴레이의 방당 플레이어 수; 백필은 이 값까지 채웁니다

RELAY_MAX_ROOMS

4

매치메이커가 시작한 릴레이의 방 수

RELAY_SOLO_ROOM_SECONDS

120

호스트가 이 시간 동안 혼자였던 방을 닫습니다. 그러면 게임이 다시 검색합니다

MATCHMAKER_URL

백필용 매치메이커 API URL, 백필

MATCHMAKER_TOKEN

백필용 매치메이커 인증 토큰

✅ 이제 다음 단계로 진행할 수 있습니다.

4. 배포하고 플레이

☑️ 새 앱 버전을 배포하세요 플레이어 근처에. 준비되면 호스트 이름(<id>.pr.edgegap.net)과 외부 포트를 기록하세요 릴레이.

☑️ 두 게임 모두에서, 연결 전에 화면에서 릴레이 주소와 포트를 설정하세요, 또는 명령줄에서 시작하세요(대안):

☑️ 첫 번째 게임에서 방을 호스팅하고 두 번째 게임의 코드로 참여하세요.

릴레이 로그에 배포가 시작되자마자 연결했다가 바로 나간 플레이어가 보인다면: 그것은 플레이어가 아니라 Edgegap의 준비 상태 확인입니다.

Edgegap 클라우드에서 배포의 외부 포트는 임의로 선택되어 잠재적 공격자(해커)가 피해를 일으키기 전에 속도가 느려지고 탐지되도록 합니다.

☑️ 배포에 문제없이 연결할 수 있음을 확인하고 테스트를 마쳤다면, 배포 중지 다음 빌드를 위해 계정의 용량을 확보하려면.

🙌 Edgegap에서의 첫 배포를 축하합니다! 더 알아보고 싶다면 계속 읽어보세요.

🎯 선택적 매치메이킹

방 코드는 친구들끼리는 잘 작동합니다. 서로 모르는 플레이어를 매칭하려면 Edgegap 매치메이킹을 켜세요: 플레이어가 매치 찾기를 누르면, 매치메이커가 서로 가까운 2~4명의 플레이어를 묶어 그들의 매치를 위한 릴레이를 근처에서 시작합니다. 그러면 릴레이가 한 명의 플레이어를 호스트로 선택하고 나머지에게 방 코드를 주므로 누구도 코드를 입력하지 않습니다. 나중에 매치 찾기 를 누른 플레이어는 빈 자리가 있는 방에 참여하고, 방이 가득 찬 릴레이는 매치메이커가 다른 릴레이를 시작하기 전에 새 방을 엽니다. 기본적으로 꺼져 있으며, 코드로 호스팅 및 참여하는 기능은 그 옆에서 계속 작동합니다.

매치가 시작되는 방식:

  1. 각 플레이어의 게임은 Edgegap 비콘에 대한 지연 시간을 측정하고 매치메이킹 티켓을 생성합니다.

  2. 매치메이커는 티켓을 묶고 앱 버전에서 릴레이를 배포합니다. Edgegap은 그 릴레이에 매칭된 티켓 목록(MM_TICKET_IDS).

  3. 각 게임은 자신의 티켓 ID로 릴레이에 연결합니다. 요청한 첫 번째 매칭 플레이어가 매치 방을 호스팅하고, 나머지는 참여합니다. 매치에 없는 티켓은 거부됩니다.

  4. 방에 빈 자리가 있는 동안 릴레이는 백필로 더 많은 플레이어를 매치메이커에 요청합니다. 모든 방이 가득 차면 대신 새 방을 제공합니다. 아래 3단계를 참조하세요.

  5. 마지막 방이 끝나면 릴레이는 백필을 삭제하고 자체 배포를 중지하므로 끝난 매치에는 비용이 들지 않습니다.

매치메이커 없이 배포된 릴레이는 이전과 같이 방 코드로 작동합니다.

1. 매치메이커 만들기

☑️ 열기 matchmaker-config.json 저장소에서 가져와 application.name 및 버전 을 3단계의 앱 버전으로 설정하세요:

처음 10초 동안 티켓은 자리가 있는 릴레이(min_team_size 9999 를 충족할 수 없음)에만 참여할 수 있습니다. 10초가 지나면 일반 규칙이 적용되고, 대기 중인 2~4명의 플레이어가 새 릴레이를 받습니다.

그 비콘 규칙은 플레이어들을 가까운 플레이어들과 함께 유지합니다: 플레이어의 지연 시간이 150ms 미만이면 비콘이 계산되며, 매칭된 플레이어들의 비콘에 대한 지연 시간은 서로 100ms 이내여야 합니다. 게임은 모든 티켓(Matchmaker Latency Beacons 의 TanksSettings.asset, 기본적으로 켜짐).

☑️ 대시보드에서 다음을 엽니다 매치메이커, 클릭 매치메이커 만들기, 파일을 업로드한 다음 생성 및 시작.

☑️ 매치메이커가 온라인, 해당 값을 복사하세요 API URL 및 Auth 토큰.

인증 토큰은 게임에 포함해 배포해도 안전합니다. 플레이어가 티켓을 만들 수 있게 할 뿐이며, Edgegap 계정에는 접근 권한을 주지 않습니다.

☑️ 앱 버전에 환경 변수로 추가하세요 MATCHMAKER_URL 및 MATCHMAKER_TOKEN, 그래야 릴레이가 빈 자리를 채울 수 있습니다(3단계).

✅ 이제 다음 단계로 진행할 수 있습니다.

2. 매치 찾기

☑️ 다음에서 tanks/Assets/Tanks/Resources/TanksSettings.asset, 다음을 켜세요 매치메이커 사용 를 켠 다음 매치메이커 URL 및 매치메이커 토큰. 프로필(캐주얼)과 포트 이름(릴레이)은 이미 위 구성과 일치합니다.

☑️ 게임을 빌드하고 두 개를 실행한 뒤 매치 찾기 둘 다에서 누르세요. 또는 명령줄에서 시작하세요:

☑️ 두 게임 모두 매치 상태를 보여주고, 그다음 한쪽이 호스팅하고 다른 쪽이 참여합니다: 두 게임 모두에 탱크 3대가 보입니다.

매치메이킹 클라이언트는 Assets/Tanks/Core/TanksMatchmaker.cs, 다음을 기반으로 구축되었습니다 Edgegap Unity SDK. 넷코드에 의존하지 않습니다. 설정에 릴레이 주소를 넣고 게임을 호스트 또는 플레이어로 시작하며, 다음과 같습니다 Host 및 Join room 버튼이 하는 것처럼.

✅ 이제 다음 단계로 진행할 수 있습니다.

3. 하나의 릴레이, 여러 방

매치메이커가 시작한 릴레이는 첫 매치가 시작된 뒤에도 백필을 통해 계속 작동합니다. 백필은 릴레이가 소유한 티켓으로, 자신의 주소를 담고 있습니다. 매치메이커가 플레이어의 티켓을 그 안에 넣으면, 그 플레이어는 릴레이 주소를 받게 되고 다른 플레이어들처럼 자신의 역할을 요청한 뒤 방에 참여하거나 호스팅합니다. 게임은 추가로 아무것도 필요하지 않습니다. 동일한 매치 찾기 흐름입니다.

  • 빈 자리가 있는 방이 먼저 옵니다. 방에 다음보다 적은 수의 플레이어가 있는 동안 RELAY_MATCH_MAX_PLAYERS (기본값 4)명의 플레이어가 방 안에 있거나 오는 중이면, 릴레이는 그 방에 대해 최대 3개의 백필을 열어 둡니다. 그곳에 배치된 플레이어는 그 방에 참여합니다.

  • 그다음 새 방입니다. 모든 방이 가득 차고 릴레이가 다음보다 적은 수의 RELAY_MAX_ROOMS (기본값 4)개의 방만 있으면, 새 방 하나를 제공합니다. 그곳에 배치된 플레이어가 이를 호스팅하고, 방은 다른 방처럼 채워집니다.

  • 가까운 플레이어만. 릴레이는 해당 방의 플레이어 티켓을 백필과 함께 보내므로, 비콘 규칙이 새 플레이어를 그들과 비교해 검사합니다.

  • 호스트가 혼자 남으면 동안 RELAY_SOLO_ROOM_SECONDS (기본값 120) 방이 닫혔다는 알림을 받고, 게임은 자동으로 다른 매치를 찾습니다.

  • 릴레이는 마지막 방이 끝나면 중지됩니다, 호스트 한 명이 나갈 때가 아닙니다. 먼저 백필을 삭제하므로 사라진 릴레이로 플레이어가 보내지지 않습니다.

  • 속도 제한. 릴레이당 최대 5개의 백필이 열리며, 생성 간격은 최소 0.3초입니다.

☑️ 두 게임 사이에서 매치가 진행 중일 때 매치 찾기 세 번째 게임에서 누르세요: 실행 중인 방에 참여하며, 세 게임 모두에 탱크 3대가 보입니다.

☑️ 4개의 게임으로 방을 채운 다음 매치 찾기 두 개의 추가 게임에서 누르세요: 첫 번째는 같은 릴레이에서 새 방을 호스팅하고, 두 번째는 그 방에 참여합니다.

해당 기능이 없으면 MATCHMAKER_URL 및 MATCHMAKER_TOKEN 앱 버전에 백필: 꺼짐: 해당 방들은 새 플레이어를 받지 않고 새 방도 열지 않습니다.

릴레이의 백필 코드는 다음에 있습니다 relay-server/MatchBackfill.cs 및 relay-server/RelayServer.cs.

🔒 암호화된 연결

기본적으로 릴레이를 통한 게임 트래픽은 암호화되지 않습니다: 일반 TCP와 UDP로 전송됩니다. 플레이어를 보호하는 것은 아무도 다른 플레이어의 IP 주소를 보지 못한다는 점이며, 매치메이커를 사용할 때는 매칭된 플레이어만 방 코드를 받는다는 점입니다. 매치메이커 호출은 HTTPS를 사용합니다.

암호화를 위해, 플레이어는 대신 WebSocket으로 연결할 수 있습니다. 다음을 사용하면 TLS 업그레이드 relay-ws relay-ws 포트(3단계)에서 Edgegap이 인증서를 보관하며 연결은 wss://: 각 플레이어와 Edgegap 간의 트래픽은 암호화되며, 릴레이에는 인증서가 필요하지 않습니다.

☑️ 게임에 wss:// 호스트 이름 대신 릴레이 주소를 사용하고, 외부 포트는 relay-ws: 화면에서, TanksSettings.asset, 또는 명령줄에서:

☑️ 매치메이커를 사용할 때는 다음을 켜세요 Matchmaker Web Socket 사용 의 TanksSettings.asset (또는 -matchmakerWebSocket): 게임이 매치 릴레이의 relay-ws 포트에 연결됩니다.

호스트 이름으로 연결(<id>.pr.edgegap.net), IP 주소가 아니라 호스트 이름을 사용하세요. 인증서는 호스트 이름용입니다. 암호화는 Edgegap에서 끝납니다. 릴레이와 호스트의 게임은 다른 릴레이와 마찬가지로 전달되는 내용을 계속 볼 수 있습니다.

🧪 자동 테스트

Windows 빌드와 실행 중인 릴레이(로컬 또는 Edgegap)로, e2e.sh 각 netcode에서 호스트와 클라이언트를 시작합니다:

클라이언트가 이동하고 발사합니다. 두 게임이 모두 두 대의 탱크를 보고, 둘 다 신뢰성 채널과 비신뢰성 채널에서 데이터를 수신하고, 둘 다 발사체 생성도 보고, 호스트가 클라이언트의 탱크 이동도 확인하면 해당 netcode는 통과합니다.

매치메이커를 사용하면, e2e-matchmaker.sh 이를 통해 동일한 테스트를 실행합니다: 각 netcode에서 두 게임이 매치 찾기 를 누르고, 매치메이커가 시작한 릴레이에서 매치를 플레이합니다. BACKFILL=1, 세 번째 게임이 매치 찾기 매치가 진행되면 이를 누르고 백필로 합류해야 합니다. MULTIROOM=1, 네 개의 게임이 한 방을 채우고, 다섯 번째는 같은 릴레이에서 새 방을 호스트해야 하며, 여섯 번째는 그 방에 합류해야 합니다. MM_WEBSOCKET=1, 게임은 다음을 통해 연결됩니다 wss://.

💡 알아두면 좋은 점

  • 릴레이가 데이터를 전달하는 방식 - 호스트의 메시지는 한 플레이어에게만 전달되고, 각 플레이어의 메시지는 호스트에게만 전달됩니다. 플레이어끼리는 직접 통신하지 않습니다. 신뢰성 메시지는 TCP로, 비신뢰성 메시지는 UDP로 전달되거나, 둘 다 하나의 WebSocket으로 전달됩니다.

  • 메시지 크기 - 비신뢰성 메시지당 최대 1,177바이트, 신뢰성 메시지당 최대 16KB입니다. 전송 계층은 이러한 제한을 해당 netcode에 보고합니다.

  • 호스트가 나가면 - 방이 닫히고 릴레이가 플레이어의 연결을 끊습니다. 이 샘플의 netcode는 호스트를 이전하지 않습니다.

  • 릴레이 하나 또는 여러 개 - 플레이어가 방 코드를 사용할 경우 하나의 배포가 여러 방을 처리합니다. 매치메이커, 각 릴레이는 플레이어 가까이에 있는 방을 최대 RELAY_MAX_ROOMS 개까지 호스팅하며, 가까운 릴레이가 모두 가득 찼을 때만 새 릴레이가 시작됩니다.

  • LightNet의 변경 사항 - 이 샘플의 LightNet은 NAT 뒤와 포트 매핑 환경에서도 작동합니다: 릴레이는 각 플레이어의 UDP 트래픽에 대해 그 트래픽이 들어온 주소로 응답합니다. 전체 목록은 저장소의 README를 참조하세요.

마지막 업데이트

도움이 되었나요?