Lightnet 소규모 네트워크 릴레이
Edgegap에서 자체 소형 네트워크 릴레이를 실행하는 방법을 살펴보세요. 이를 사용하는 Unity 게임 샘플은 다음을 통해 플레이합니다 Mirror, FishNet, PurrNet 또는 Netcode for GameObjects (NGO).
이 릴레이는 다음을 기반으로 구축된 작은 .NET 서버입니다. LightNet. Edgegap은 다른 서버와 마찬가지로 이를 호스팅하고 조율합니다: 하나의 배포가 플레이어 근처에서 시작됩니다. 한 플레이어가 방을 호스팅하고 6자리 코드가 발급되며, 다른 플레이어들은 그 코드로 참여합니다. 어떤 플레이어도 포트를 열지 않습니다: 호스트를 포함한 모두가 릴레이의 클라이언트입니다.
이 샘플은 다음을 보여줍니다:
릴레이 서버 의
linux/amd64포트에서 수신 대기하는 Docker 이미지7777TCP(신뢰할 수 있는 메시지)와 UDP(신뢰할 수 없는 메시지) 모두에 대해,조인 코드가 있는 방 - 여러 방이 하나의 릴레이 배포를 공유할 수 있습니다,
네 가지 넷코드에서 실행되는 Tanks 샘플 - Mirror, FishNet, PurrNet, NGO를 하나의 Unity 프로젝트, 하나의 빌드에서,
넷코드를 전환하는 하나의 설정 - 설정 에셋, 에디터 메뉴, 연결 전에 게임 내에서, 또는 명령줄에서,
선택적 Edgegap 매치메이킹 - 기본적으로 꺼짐: 매치 찾기 근처 플레이어들을 하나의 릴레이에서 함께 묶고, 각 방마다 한 플레이어가 이를 호스팅하며, 나중에 검색한 플레이어들은 실행 중인 방에 참여하고, 방이 가득 찬 릴레이는 다른 릴레이가 시작되기 전에 새 방을 엽니다,
선택적 암호화 연결 -
wss://Edgegap의 TLS 업그레이드를 통해, 일반 TCP 및 UDP 옆에서,자동화된 테스트 - 게임 클라이언트는 방 코드 또는 매치메이커를 통해 각 넷코드의 릴레이로 플레이합니다.
✔️ 준비
시작하기 전에 다음이 필요합니다:
Unity
6000.0.54f1, 게임을 열고 빌드하려면,.NET 8 SDK (선택 사항), Docker 외부에서 릴레이를 실행할 때만 필요합니다.
저장소는 네 부분으로 구성됩니다:
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_TOKEN
백필용 매치메이커 인증 토큰
✅ 이제 다음 단계로 진행할 수 있습니다.
4. 배포하고 플레이
☑️ 새 앱 버전을 배포하세요 플레이어 근처에. 준비되면 호스트 이름(<id>.pr.edgegap.net)과 외부 포트를 기록하세요 릴레이.
☑️ 두 게임 모두에서, 연결 전에 화면에서 릴레이 주소와 포트를 설정하세요, 또는 명령줄에서 시작하세요(대안):
☑️ 첫 번째 게임에서 방을 호스팅하고 두 번째 게임의 코드로 참여하세요.

☑️ 배포에 문제없이 연결할 수 있음을 확인하고 테스트를 마쳤다면, 배포 중지 다음 빌드를 위해 계정의 용량을 확보하려면.
문제가 발생한 경우, 배포의 대시보드 로그를 검사하세요.
문제를 해결할 수 없다면, 저희는 커뮤니티 디스코드 에서 도와드릴 수 있으며 기꺼이 지원하겠습니다.
🙌 Edgegap에서의 첫 배포를 축하합니다! 더 알아보고 싶다면 계속 읽어보세요.
🎯 선택적 매치메이킹
방 코드는 친구들끼리는 잘 작동합니다. 서로 모르는 플레이어를 매칭하려면 Edgegap 매치메이킹을 켜세요: 플레이어가 매치 찾기를 누르면, 매치메이커가 서로 가까운 2~4명의 플레이어를 묶어 그들의 매치를 위한 릴레이를 근처에서 시작합니다. 그러면 릴레이가 한 명의 플레이어를 호스트로 선택하고 나머지에게 방 코드를 주므로 누구도 코드를 입력하지 않습니다. 나중에 매치 찾기 를 누른 플레이어는 빈 자리가 있는 방에 참여하고, 방이 가득 찬 릴레이는 매치메이커가 다른 릴레이를 시작하기 전에 새 방을 엽니다. 기본적으로 꺼져 있으며, 코드로 호스팅 및 참여하는 기능은 그 옆에서 계속 작동합니다.
매치가 시작되는 방식:
각 플레이어의 게임은 Edgegap 비콘에 대한 지연 시간을 측정하고 매치메이킹 티켓을 생성합니다.
매치메이커는 티켓을 묶고 앱 버전에서 릴레이를 배포합니다. Edgegap은 그 릴레이에 매칭된 티켓 목록(
MM_TICKET_IDS).각 게임은 자신의 티켓 ID로 릴레이에 연결합니다. 요청한 첫 번째 매칭 플레이어가 매치 방을 호스팅하고, 나머지는 참여합니다. 매치에 없는 티켓은 거부됩니다.
방에 빈 자리가 있는 동안 릴레이는 백필로 더 많은 플레이어를 매치메이커에 요청합니다. 모든 방이 가득 차면 대신 새 방을 제공합니다. 아래 3단계를 참조하세요.
마지막 방이 끝나면 릴레이는 백필을 삭제하고 자체 배포를 중지하므로 끝난 매치에는 비용이 들지 않습니다.
매치메이커 없이 배포된 릴레이는 이전과 같이 방 코드로 작동합니다.
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 토큰.
☑️ 앱 버전에 환경 변수로 추가하세요 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개의 게임으로 방을 채운 다음 매치 찾기 두 개의 추가 게임에서 누르세요: 첫 번째는 같은 릴레이에서 새 방을 호스팅하고, 두 번째는 그 방에 참여합니다.
릴레이의 백필 코드는 다음에 있습니다 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 포트에 연결됩니다.
🧪 자동 테스트
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를 참조하세요.
마지막 업데이트
도움이 되었나요?

