🌐 English | 中文 | 한국어

HY2 SCALE은 단일 Docker 컨테이너로 실행됩니다. 모든 설정은 웹 UI에서 관리하며, 별도의 설정 파일을 편집할 필요가 없습니다.

• Docker (Docker를 지원하는 모든 Linux 호스트)
• NET_ADMIN 권한 (VPN 프로토콜 및 라우팅 규칙)
• --network host (L2TP/IPsec 및 IKEv2에 필요)

docker run -d --name hy2scale \
  --network host --privileged \
  -v hy2scale-data:/data \
  --restart unless-stopped \
  frankoong/hy2scale:latest

http://<호스트>:5565/scale/ 접속 — 기본 로그인: admin / admin.

경고: 설정 → 시스템에서 기본 비밀번호를 즉시 변경하세요.

--network host를 사용할 수 없을 때는 명시적인 포트 매핑으로 실행합니다. L2TP / IKEv2 / WireGuard는 모두 호환 모드를 통해 작동하며, 규칙 엔진만 사용할 수 없습니다.

docker run -d --name hy2scale \
  --cap-add NET_ADMIN --cap-add NET_RAW \
  -p 5565:5565/tcp -p 5565:5565/udp \
  -p 500:500/udp -p 4500:4500/udp -p 1701:1701/udp -p 51820:51820/udp \
  -v hy2scale-data:/data \
  --restart unless-stopped \
  frankoong/hy2scale:latest

사이드바의 버전 배지는 자동 감지된 런타임 모드를 표시합니다: Normal, Bridge, Compat, Limited — Settings를 참고하세요.

services:
  hy2scale:
    image: frankoong/hy2scale:latest
    container_name: hy2scale
    restart: unless-stopped
    network_mode: host
    privileged: true
    volumes:
      - hy2scale-data:/data

volumes:
  hy2scale-data:

브리지 모드의 경우:

services:
  hy2scale:
    image: frankoong/hy2scale:latest
    container_name: hy2scale
    restart: unless-stopped
    cap_add: [NET_ADMIN, NET_RAW]
    devices: ["/dev/net/tun"]
    ports:
      - "5565:5565/tcp"
      - "5565:5565/udp"
      - "500:500/udp"
      - "4500:4500/udp"
      - "1701:1701/udp"
      - "51820:51820/udp"
    volumes:
      - hy2scale-data:/data

volumes:
  hy2scale-data:

--network host에서는 모든 포트가 자동으로 사용 가능합니다. 포트 매핑을 사용하는 경우 각 포트를 개별적으로 매핑하세요:

docker run -d --name hy2scale \
  --cap-add NET_ADMIN \
  -p 5565:5565/tcp -p 5565:5565/udp \
  -p 1701:1701/udp \
  -p 500:500/udp -p 4500:4500/udp \
  -p 51820:51820/udp \
  -v hy2scale-data:/data \
  frankoong/hy2scale:latest

참고: L2TP와 IKEv2가 작동하려면 --network host가 필요합니다. IPsec ESP 패킷은 Docker에서 NAT 처리될 수 없으므로 포트 매핑만으로는 충분하지 않습니다.

그 외 필요한 환경 변수는 없습니다. 모든 설정은 웹 UI에서 관리되며 /data/config.yaml에 저장됩니다.

모든 상태는 /data 볼륨에 영속 저장됩니다:

/data/
├── node-id          # 고유 노드 식별자 (8자리 16진수)
├── config.yaml      # 설정 (자동 생성, 원자적 쓰기)
└── tls/             # TLS 인증서 (PEM 형식)
    ├── default.crt
    ├── default.key
    └── default.name

참고: 최초 시작 시 자체 서명 TLS 인증서가 자동 생성됩니다.

바이너리는 다음 플래그를 지원합니다 (Docker로 실행할 때는 일반적으로 필요하지 않습니다):

git clone https://github.com/FrankoonG/hy2scale.git
cd hy2scale
docker build -t hy2scale .

이미지 (~73MB) 포함 내용:

• Go 바이너리 (정적 컴파일)
• strongSwan 5.8.4 (소스에서 컴파일)
• xl2tpd, pppd, iptables-legacy
• Alpine 3.19 베이스

docker pull frankoong/hy2scale:latest
docker stop hy2scale
docker rm hy2scale
# 동일한 docker run 명령으로 다시 실행

설정은 데이터 볼륨에 보존됩니다.