본문으로 건너뛰기

공급자 가이드

포트 포워딩

공통 절차 · 개념 그림(제조사별 화면은 후속). 루프백 주의

고객은 인터넷에서 서버의 공인 IP와 포트로 인스턴스에 접속합니다. 서버가 공유기 뒤에 있다면 공유기가 그 연결을 서버로 넘기도록 규칙을 만들어야 합니다. 공유기 설정은 설치 스크립트가 할 수 없어 공급자가 직접 합니다.

1. 열어야 하는 포트 — 둘

확인 범위

이 절차는 Ubuntu 24.04 판정 환경(GPU 없음)에서 확인했습니다. 실제 GPU 서버에서의 확인은 진행 중입니다.

공유기가 바깥에서 들어온 연결을 같은 포트 번호로 서버에 넘깁니다. 규칙은 인스턴스 범위(기본 30000-31000)와 노드 HTTPS 30443 두 개입니다. 같은 내부망에서 공인 IP로 접속하면 공유기에 따라 되지 않을 수 있습니다.
  • TCP 인스턴스 포트 범위 — 기본 30000-31000. 설치할 때 --port-range로 다른 범위를 줬다면 그 범위입니다. 인스턴스의 SSH · HTTP 접속에 씁니다.
  • TCP 30443 — 노드 HTTPS입니다. 이 포트는 인스턴스에 배정되지 않습니다.

범위 안에서 어느 포트를 어느 인스턴스에 줄지는 WattWorks 서버가 고릅니다. 그래서 공급자는 범위 전체를 열어 둡니다. 서버의 방화벽은 이 범위와 30443을 같은 포트 번호로 받으므로, 공유기의 바깥 포트와 서버 쪽 포트를 같은 번호로 맞춥니다.

범위에는 GPU 1장당 3개 이상의 포트가 있어야 합니다. 이보다 적으면 설치 스크립트가 등록 전에 멈추고, 이미 등록됐다면 등록이 보류되어 판매를 시작할 수 없습니다. 이때 콘솔에는 아래 안내가 보입니다.

포트 범위 부족

포트 범위를 GPU 수 × 3 이상으로 늘리고 콘솔에서 등록 토큰을 재발급받아 최신 설치 스크립트로 다시 실행해 주세요. 이전 버전 에이전트로는 풀리지 않습니다.

범위를 바꾸려면 새 등록 토큰으로 다시 실행해야 합니다. 토큰 없이 실행하는 업데이트로는 범위를 바꿀 수 없습니다.

2. 공유기에서 설정하기

공유기 관리 화면의 메뉴 이름과 모양은 제조사마다 다릅니다. 어느 공유기든 할 일은 같습니다.

  1. 서버의 내부 IP를 고정합니다. 공유기의 고정 할당(DHCP 예약) 기능이나 서버의 네트워크 설정을 씁니다. 내부 IP가 바뀌면 규칙이 엉뚱한 기기를 가리킵니다.
  2. 포트 포워딩 규칙을 만듭니다. 프로토콜 TCP · 바깥 포트 = 인스턴스 포트 범위 · 내부 IP = 서버 · 내부 포트 = 같은 범위.
  3. 규칙을 하나 더 만듭니다. 프로토콜 TCP · 바깥 포트 30443 · 내부 IP = 서버 · 내부 포트 30443.
  4. 저장한 뒤 두 규칙이 모두 켜져 있는지 목록에서 다시 확인합니다.

고정 공인 IP

고객은 공인 IP로 접속하므로 공인 IP가 바뀌면 접속할 수 없습니다. 고정 공인 IP가 필요합니다 — 인터넷 회선 계약에서 확인하세요.

3. 클라우드 서버라면 — 보안 그룹

공유기 대신 클라우드 제공자의 보안 그룹(인바운드 방화벽 규칙)에서 같은 두 규칙을 허용합니다 — TCP 인스턴스 포트 범위와 TCP 30443. 공인 IP는 고정 IP로 받아 둡니다.

4. 같은 내부망에서는 접속이 안 될 수 있습니다

서버와 같은 공유기에 연결된 PC에서 공인 IP로 접속하면, 공유기가 루프백(NAT 루프백)을 지원해야만 연결됩니다. 지원하지 않는 공유기가 많습니다. 그래서 같은 내부망에서 접속이 안 된다고 규칙이 틀린 것은 아닙니다.

라우터 루프백 주의

접속을 시험할 때는 같은 내부망이 아니라 휴대폰 테더링이나 외부 네트워크에서 테스트하세요.

5. 열렸는지 확인하기

설치 직후에는 인스턴스가 없어 인스턴스 포트와 30443에서 연결을 받는 프로그램이 서버에 아직 없습니다. 그래서 첫 대여 전에는 외부에서 확인할 수단이 없습니다.

  1. 공유기(또는 보안 그룹)에 규칙 두 개 — 인스턴스 포트 범위와 30443 — 가 있는지 다시 봅니다.
  2. 두 규칙의 내부 IP가 지금 서버의 내부 IP와 같은지 확인합니다.
  3. 인스턴스 포트 범위가 설치할 때 쓴 범위(기본 30000-31000)와 같은지 확인합니다.

아직 실제 GPU 서버에서 확인하지 않았습니다. 설치 직후 연결을 받는 프로그램이 없다는 것은 판정 환경에서 확인한 사실입니다.

가이드 목록으로