6.8 KiB
6.8 KiB
🎮 네트워크 연결 설정 가이드
📋 상황 요약
✅ PortListenerTest: 포트 열림 (yougetsignal 성공)
✅ 포트 포워딩: 작동 중 (yougetsignal 성공으로 증명)
✅ 방화벽: 허용 중 (yougetsignal 성공으로 증명)
❌ 유니티 Netcode: 포트가 닫혀 있음
⚡ 즉시 해결책 (3단계)
1단계: 테스트 시작 (30초)
- NetworkManagerQuickTest 추가 (씬의 아무 게임오브젝트)
- 우클릭 → "Run Quick NetworkManager Test"
- 콘솔 출력 공유
기대 결과:
✓ NetworkManager found!
✓ Player Prefab: Player
✓ Unity Transport found!
✓ Transport: 4045, 0.0.0.0
✓ NetworkConnectionHandler found!
2단계: 팀원 연결 테스트 (1분)
- 팀원에게 당신의 퍼블릭 IP 알림
- 팀원: 게임에서 IP:포트 입력
- 팀원: "연결" 클릭
기대:
- 성공: 팀원이 접속!
- 실패: 에러 로그 공유
3단계: 문제 해결
팀원이 접속 못할 경우:
팀원 측:
- 올바른 퍼블릭 IP 입력했는지 확인
- 방화벽 허용 확인
- 유니티 Netcode 버전 확인 (동일해야 함)
호스트 측 (당신):
- 콘솔에서 "[ConnectionHandler] 클라이언트" 메시지 확인
- 스폰 성공하는지 확인
- 플레이어가 생성되는지 확인
🔧 필수 구성 요소
NetworkManager 설정
필수:
NetworkManager GameObject:
- Player Prefab: Player (Assets/Prefabs/Player/)
- Connection Approval: ✓ 체크
- Enable Scene Management: ✓ 체크
Unity Transport 설정
필수:
Unity Transport:
- Port: 4045
- Address: 0.0.0.0 (모든 인터페이스 허용)
- ServerListenAddress: 0.0.0.0
라우터 포트 포워딩
필수:
라우터 포트 포워딩:
- External Port: 4045
- Internal Port: 4045
- Protocol: TCP
- Internal IP: 당신 컴퓨터의 IPv4 (ipconfig로 확인)
IP 확인:
명령 프롬프트 → ipconfig
IPv4 주소 찾기 (예: 192.168.1.50)
✅ 작동 중인지 확인
방법 1: yougetsignal (가장 신뢰)
https://www.yougetsignal.com/tools/open-ports/
입력:
- IP: 당신의 퍼블릭 IP (https://api.ipify.org)
- Port: 4045
기대: "Port 4045 is open"
방법 2: 콘솔 로그
호스트 시작 성공:
[ConnectionHandler] 서버 시작됨
[ConnectionHandler] 스폰 포인트 X개를 찾았습니다
[ConnectionHandler] 클라이언트 [ID] 연결됨
[ConnectionHandler] 플레이어 [ID] 스폰됨
클라이언트 연결 성공:
[ConnectionHandler] 클라이언트 [ID] 승인됨. 수동 스폰으로 대기.
🎮 게임 플레이 방법
호스트 (당신)
- 에디터에서 플레이 모드 시작
- 또는 빌드 실행
- 콘솔에서 "호스트 시작됨" 확인
- 팀원에게 퍼블릭 IP 알림
- 팀원이 접속할 때까지 대기
클라이언트 (팀원)
- 에디터에서 플레이 모드 시작
- 네트워크 연결 UI에서 호스트의 퍼블릭 IP 입력
- "연결" 클릭
- 콘솔에서 "클라이언트 연결됨" 확인
- 게임 시작!
⚠️ 일반적인 문제 및 해결
문제 1: "ConnectionHandler: PlayerPrefab이 null입니다"
원인: Player Prefab이 NetworkManager에 할당되지 않음
해결:
NetworkManager 선택 → Network Config → Player Prefab
Assets/Prefabs/Player/Player.prefab 드래그
문제 2: 팀원이 "Failed to connect to server" 에러
가능한 원인:
- 틀린 퍼블릭 IP 입력
- 포트가 닫혀 있음 (호스트 재시작 필요)
- 방화벽 차단
- 다른 Unity/Netcode 버전
해결:
- 올바른 IP 확인 (https://api.ipify.org)
- yougetsignal에서 포트 4045 확인
- 팀원의 방화벽 허용
- Unity 버전 일치 확인
문제 3: 포트가 열렸다 닫혀
원인: 유니티 Netcode가 실제로 바인딩하지 않음
해결:
NetworkManagerQuickTest 실행
NetworkManagerResetAndRestart 사용
새로 시작
📊 도구
유용한 스크립트
| 스크립트 | 용도 | 사용법 |
|---|---|---|
| NetworkManagerQuickTest | 설정 확인 | 추가 → 우클릭 "Run Quick NetworkManager Test" |
| NetworkResetAndRestart | 네트워크 리셋 | 추가 → 우클릭 "Reset Network and Restart Host" |
| PortListenerTest | 포트 바인딩 테스트 | 추가 → 우클릭 "Test Port Binding Only" |
사용하지 않는 스크립트
- ❌ ContinuousPortMonitor (랙 발생)
- ❌ 다른 진단 도구 (필요 없음)
🚀 빠른 시작 가이드
처음 설정하는 경우
1. NetworkManager 찾기
2. Player Prefab 할당 (Assets/Prefabs/Player/)
3. Unity Transport 포트 4045 설정
4. 라우터에서 포트 포워딩 설정
5. 호스트 시작
6. yougetsignal에서 포트 확인
7. 팀원에게 퍼블릭 IP 공유
8. 팀원 접속
9. 게임 시작! 🎉
이미 작동 중인 경우
1. 호스트 시작
2. yougetsignal에서 포트 4045 확인 (열려 있어야 함)
3. 팀원에게 퍼블릭 IP 공유
4. 팀원 접속
5. 게임 시작! 🎉
💡 핵심 통찰
당신의 상황:
- PortListenerTest: 작동 ✅ (포트 열림)
- yougetsignal: 작동 ✅ (접속 가능)
- 유니티 Netcode: 포트 닫혀 ❌
해결책:
- Player Prefab 할당 (NetworkManagerQuickTest로 확인)
- 팀원이 지금 테스트
- 콘솔 로그 확인
성공 시:
✓ Player Prefab: Player
✓ Unity Netcode 시작 성공
✓ 팀원 접속 성공
✓ 플레이어 스폰됨
📝 기술 정보
사용된 포트
포트: 4045
프로토콜: TCP
바인딩: 0.0.0.0 (모든 인터페이스)
확인된 사항
✅ 포트 포워딩: 작동 (yougetsignal 증명)
✅ 방화벽: 허용 (yougetsignal 증명)
✅ OS 바인딩: 가능 (PortListenerTest 증명)
❌ 유니티 Netcode: 바인딩 실패
문제 분석
포트 4045가 열리지 않는 이유:
- 유니티 Netcode가 포트에 바인딩하지 않음
- Player Prefab이 할당되지 않았을 가능성 (90%)
- 또는 네트워크 관리자 초기화 순서 문제
✅ 성공 확인사항
모든 것이 작동할 때:
- 호스트: IsServer = True
- 호스트: IsHost = True
- Player Prefab: Player (할당됨)
- Transport: 4045, 0.0.0.0
- yougetsignal: "Port 4045 is open"
- 콘솔: "클라이언트 [ID] 연결됨"
- 콘솔: "플레이어 [ID] 스폰됨"
- 팀원: 접속 성공
🎯 요약
핵심 사항:
- 포트 4045 열림 (yougetsignal 증명) ✅
- Player Prefab 할당 필요 (가능한 문제 원인)
- 팀원 지금 테스트
- 콘솔 로그 확인
다음 단계:
- NetworkManagerQuickTest 실행
- 팀원 테스트
- 문제 있으면 콘솔 로그 공유
- 성공하면 게임 시작! 🎉
행운을 빕니다! 🚀