문서 설정 WireGuard

WireGuard

WireGuard 터널을 하나의 아웃바운드 노드로 사용하는 방식으로, 자체 구축 WARP/WireGuard 중계나 회사 내부망 접속 등에 흔히 사용됩니다.

단일 peer 간소화 작성법

원격 노드가 하나뿐일 때는 server/port/public-key를 노드 최상위에 바로 펼쳐 쓸 수 있습니다:

config.yaml YAML

proxies:
  - name: "wg"
    type: wireguard
    private-key: eCtXsJZ27+4PbhDkHnB923tkUn2Gj59wZw5wFA75MnU=
    server: 162.159.192.1
    port: 2480
    ip: 172.16.0.2
    ipv6: fd01:5ca1:ab1e:80fa:ab85:6eea:213f:f4a5
    public-key: Cr8hWlKvtDt7nrvf+f0brNQQzabAqrjfBvas9pmowjo=
    allowed-ips: ['0.0.0.0/0']
    udp: true

다중 peer 전체 작성법

여러 원격 노드에 연결하려면 peers 목록으로 변경합니다. 이때 최상위의 server/port/public-key/pre-shared-key/reserved는 무시됩니다(private-key는 여전히 최상위에 작성). 각 peer의 allowed-ips는 서로 중복되지 않아야 합니다.

config.yaml YAML

proxies:
  - name: "wg"
    type: wireguard
    ip: 172.16.0.2
    ipv6: fd01:5ca1:ab1e:80fa:ab85:6eea:213f:f4a5
    private-key: eCtXsJZ27+4PbhDkHnB923tkUn2Gj59wZw5wFA75MnU=
    peers:
      - server: 162.159.192.1
        port: 2480
        public-key: Cr8hWlKvtDt7nrvf+f0brNQQzabAqrjfBvas9pmowjo=
        allowed-ips: ['0.0.0.0/0']
    udp: true

필드 설명

private-key필수

로컬 WireGuard 클라이언트 개인키로, wg genkey | tee privatekey | wg pubkey > publickey로 사용 가능한 공개키/개인키 쌍을 생성할 수 있습니다.

ip / ipv6선택

WireGuard 가상 네트워크 내에서 로컬의 주소입니다. IPv6 주소가 없다면 이 줄을 그냥 삭제하세요.

allowed-ips선택

WireGuard 레벨의 라우팅 범위로, 라우팅 분기는 이미 Clash가 처리하므로 일반적으로 바로 ['0.0.0.0/0']을 입력하면 됩니다.

pre-shared-key / reserved선택

사전 공유 키와 예약 바이트로, 서비스 제공자의 요구사항에 맞게 입력하세요. reserved는 "U4An"과 같은 문자열 형식도 지원합니다.

mtu / persistent-keepalive선택

필요에 따라 MTU 크기와 유지 간격을 조정하며, 일반적으로 수정할 필요가 없습니다.

amnezia-wg-option 계열 파라미터(jc/jmin/jmax 등)도 지원하며, WireGuard 트래픽을 난독화해 차단을 방지하는 고급 사용법입니다. 필요하지 않다면 기본값을 수정하지 않는 것을 권장합니다.