문서 설정 프록시 그룹 공통 필드

프록시 그룹 공통 필드

프록시 그룹(proxy-groups)은 여러 노드를 하나로 묶은 것으로, 규칙에서 마치 단일 노드처럼 참조할 수 있습니다. 6가지 유형(select/url-test/fallback/load-balance/relay 등)이 이 필드 세트를 모두 공유합니다.

설정 예시

config.yaml YAML

proxy-groups:
  - name: "proxy"
    type: select
    proxies:
      - DIRECT
      - ss
    use:
      - provider1
    url: 'https://www.gstatic.com/generate_204'
    interval: 300
    lazy: true
    filter: "(?i)港|hk|hongkong|hong kong"
    exclude-filter: "美|日"
    exclude-type: "Shadowsocks|Http"

기본 필드

name필수

프록시 그룹 이름으로, 특수 문자가 포함될 경우 인용 부호로 감싸야 합니다.

type필수

프록시 그룹 유형: select/url-test/fallback/load-balance/relay.

proxies선택

아웃바운드 프록시나 다른 프록시 그룹을 배열 순서대로 가져옵니다.

use선택

하나 이상의 프록시 프로바이더(proxy-providers)를 가져옵니다.

헬스체크

url선택

헬스체크 테스트 주소입니다. 주의: proxies 필드의 프록시만 검사하며, use로 가져온 프록시 프로바이더 노드는 검사하지 않습니다(그것들은 프로바이더 자체의 health-check가 담당합니다).

interval선택

헬스체크 간격으로, 0이 아니면 정기 테스트가 활성화됩니다(단위: 초).

lazy기본값 true

지연 검사 상태로, 현재 선택되지 않거나 사용되지 않을 때는 테스트하지 않아 리소스를 절약합니다.

timeout선택

헬스체크 타임아웃(단위: 밀리초)입니다.

max-failed-times기본값 5

최대 실패 횟수로, 초과하면 강제 헬스체크가 한 번 실행됩니다.

expected-status기본값 *

기대하는 HTTP 응답 상태 코드로, 설정하면 응답 코드가 일치할 때만 노드가 사용 가능한 것으로 간주됩니다. 여러 상태 코드를 매칭하는 /와 범위를 매칭하는 -를 지원하며 혼용해서 작성할 수 있습니다. 예: 200/302/400-503.

일괄 가져오기와 필터링

include-all / include-all-proxies / include-all-providers선택

모든 아웃바운드 프록시와/또는 모든 프록시 프로바이더를 일괄로 가져옵니다(이름순 정렬), 프록시 그룹 자체는 포함하지 않습니다. include-all-providers를 사용하면 use 필드는 무효화됩니다.

filter / exclude-filter선택

키워드/정규식으로 노드를 필터링하거나 제외하며, 가져온 프록시 프로바이더와 일괄로 가져온 모든 프록시에만 적용됩니다. 여러 정규식은 `로 구분합니다.

exclude-type선택

정규식을 지원하지 않으며 |로 구분해 유형별로 제외하며, 가져온 아웃바운드 프록시에만 적용됩니다.

기타 필드

필드	설명
`default-selected`	기본으로 선택할 노드로, 비어있거나 노드가 존재하지 않으면 기본적으로 첫 번째를 선택합니다
`empty-fallback`	그룹 내 노드가 없을 때의 폴백 아웃바운드로, 기본값은 `COMPATIBLE`이며 프록시 이름만 입력할 수 있고 프록시 그룹은 입력할 수 없습니다
`disable-udp`	이 프록시 그룹의 UDP를 비활성화합니다
`hidden`	API가 hidden 상태를 반환하도록 하여, 프런트엔드가 이를 지원하면 해당 프록시 그룹 표시를 숨길 수 있습니다
`icon`	API가 사용자 지정 아이콘 문자열을 반환하도록 하여, 지원하는 대시보드에서 표시할 수 있습니다

수동 선택 select 자동 선택 url-test 자동 폴백 fallback 로드 밸런싱 load-balance 체인 프록시 relay