문서 설정 Tailscale

Tailscale

코어에는 tsnet 인스턴스가 내장되어 있어, Tailscale/Headscale 네트워크 내의 특정 노드(또는 exit node)를 별도의 Tailscale 클라이언트 설치 없이 바로 아웃바운드 프록시로 사용할 수 있습니다.

설정 예시

config.yaml YAML

proxies:
  - name: "tailscale"
    type: tailscale
    hostname: mihomo
    auth-key: tskey-auth-xxxx
    udp: true
    accept-routes: true
    exit-node: 100.64.0.1
    exit-node-allow-lan-access: true
    ip-version: ipv4-prefer

필드 설명

hostname선택

Tailscale 기기 이름으로, 비워두면 tsnet이 자동으로 처리합니다.

auth-key선택

Tailscale 또는 Headscale의 로그인 키로, 비워두면 처음 시작할 때 로그에 대화형 로그인 링크가 출력됩니다.

control-url / state-dir선택

control-url은 사용자 지정 control server 또는 Headscale 주소이며, state-dir은 tsnet 상태 디렉터리로 기본값은 tailscale입니다.

accept-routes선택

Tailnet에 게시된 서브넷 라우팅을 받을지 여부입니다.

exit-node / exit-node-allow-lan-access선택

exit-node는 사용할 출구 노드를 지정합니다(IP를 입력하거나 auto:any로 자동 선택). exit-node-allow-lan-access는 출구 노드를 사용할 때도 로컬 LAN 접근을 계속 허용할지 결정합니다.

dialer-proxy / interface-name / routing-mark선택

다른 프로토콜과 의미가 동일합니다: dialer-proxy는 Tailscale 컨트롤 플레인과 DERP/STUN 연결이 거칠 아웃바운드 프록시를 지정하며, interface-name/routing-mark는 다중 네트워크 인터페이스/정책 라우팅 환경에 사용됩니다.

대상이 Tailscale 라우팅 범위 밖에 있으면 연결이 바로 오류를 반환하며 자동으로 직접 연결로 전환되지 않습니다. 공용 네트워크에 접근하려면 사용 가능한 exit-node를 설정하거나 대상 대역을 포함하는 서브넷 라우팅을 받아야 합니다. 또한 모든 프록시는 처음 매칭될 때만 실제로 연결을 맺으므로, Tailscale 노드에 처음 접속할 때 간혹 타임아웃이 발생하는 것은 정상이며 몇 번 더 시도하면 됩니다.