Vylos 파일 형식
.vylos 형식을 사용하여 표준 WireGuard 구성과 Vylos의 분할 DNS, 온디맨드 및 킬 스위치 설정을 함께 보관합니다.
| settings.conf | 아니요 | INI 형식의 UTF-8 텍스트로 된 Vylos [SplitDNS], [OnDemandRule], [Routing] 섹션. |
아카이브 구조
.vylos 파일은 필수 파일 하나와 선택 파일 하나가 들어 있는 ZIP 아카이브입니다.
| 아카이브 항목 | 필수 | 내용 |
|---|---|---|
wireguard.conf | 예 | 수정하지 않은 WireGuard [Interface] 및 [Peer] 섹션을 UTF-8 텍스트로 저장합니다. |
settings.conf | 아니요 | Vylos [SplitDNS] 및 [OnDemandRule] 섹션을 INI와 유사한 UTF-8 텍스트로 저장합니다. |
아카이브에 wireguard.conf가 없거나 항목 중 하나라도 UTF-8 텍스트가 아니면 Vylos가 아카이브를 거부합니다. settings.conf가 없는 아카이브는 그 안의 WireGuard 구성과 동일하게 동작합니다.
파일 확장자는 WireGuard 구성 문법을 바꾸지 않습니다. wireguard.conf의 압축을 풀어 다른 WireGuard 호환 클라이언트에서 사용할 수 있으며, Vylos 전용 설정은 settings.conf에 별도로 유지됩니다.
wireguard.conf
필수 항목에는 일반 .conf 가져오기에서 Vylos가 허용하는 것과 동일한 wg-quick 필드를 사용합니다. [Peer] 섹션이 없어도 유효하며, 하나의 터널에 여러 피어가 포함될 수도 있습니다.
[Interface]
PrivateKey = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=
Address = 10.0.0.2/32
DNS = 10.0.0.1
[Peer]
PublicKey = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB=
AllowedIPs = 0.0.0.0/0
Endpoint = vpn.example.com:51820
PersistentKeepalive = 25
예제 키와 엔드포인트를 WireGuard 서버에서 제공한 값으로 바꾸십시오. 기본 구성 형식은 WireGuard 프로젝트의 wg-quick 문서를 참조하십시오.
settings.conf
섹션과 키 이름은 대소문자를 구분하지 않습니다. 빈 줄과 # 뒤의 텍스트는 무시됩니다. 알 수 없는 섹션이나 키, 잘못된 형식의 줄, 지원하지 않는 동작 또는 인터페이스 유형이 있으면 가져오기가 실패합니다.
분할 DNS
하나의 [SplitDNS] 섹션에 다음 키 중 하나 또는 둘 다를 추가합니다.
| 키 | 값 |
|---|---|
Domains | DNS 쿼리에 터널의 DNS 서버를 사용할 도메인을 쉼표로 구분한 목록입니다. |
SearchDomains | 도메인 부분이 없는 호스트 이름 쿼리를 다시 시도할 때 사용할 접미사를 쉼표로 구분한 목록입니다. |
도메인 레이블에는 문자, 숫자 및 레이블 안쪽의 하이픈을 사용할 수 있습니다. Vylos는 선택적 선행 와일드카드(예: *.example.com)와 정규화된 전체 이름을 나타내는 후행 마침표도 허용합니다.
Vylos는 분할 DNS 일치 도메인을 Apple 네트워크에 적용하기 전에 정규화합니다. 유효하지 않은 도메인 항목은 터널의 도메인 목록에 추가되지 않고 무시됩니다.
온디맨드 규칙
네트워크 조건마다 [OnDemandRule] 섹션을 하나씩 추가합니다. 여러 섹션은 OR 논리로 처리되므로 일치하는 규칙 하나만 있어도 터널을 활성화할 수 있습니다.
| 키 | 필수 | 허용되는 값 |
|---|---|---|
InterfaceType | 예 | cellular, ethernet 또는 wifi. |
Action | 아니요 | connect. 생략해도 기본값은 connect입니다. |
SSIDs | 아니요 | Wi-Fi의 경우 쉼표로 구분한 포함 목록이나, 각 항목이 !로 시작하는 제외 목록입니다. 생략하면 모든 Wi-Fi 네트워크와 일치합니다. |
같은 규칙에서 일반 SSID와 !로 시작하는 SSID를 함께 사용하지 마십시오. 셀룰러 규칙은 iOS, 이더넷 규칙은 macOS, Wi-Fi 규칙은 Vylos가 지원하는 모든 플랫폼에 적용됩니다.
Vylos는 터널을 가져오고 다시 내보낼 때 현재 플랫폼이 지원하지 않는 규칙 값도 유지합니다. 따라서 하나의 휴대용 파일에 iOS, macOS 및 visionOS용 동작을 함께 보관할 수 있습니다.
킬 스위치
준비된 온디맨드 터널을 사용할 수 없을 때 대부분의 네트워크 트래픽을 차단하려면 [Routing] 섹션을 추가합니다.
[Routing]
KillSwitch = true
KillSwitch에는 true 또는 false를 사용할 수 있습니다. true에는 하나 이상의 [OnDemandRule]이 필요합니다. 자동 활성화 규칙 없이 킬 스위치를 켠 파일은 Vylos가 거부합니다.
이 설정은 WireGuard 구성을 다시 작성하지 않습니다. 모든 피어의 AllowedIPs를 합친 결과가 VPN 경로를 갖는 목적지를 계속 결정합니다. 앱은 유효한 경로에 따라 전체 터널 보호, 제한된 네트워크 접근, 또는 나가는 경로 없음을 표시하고 DNS 서버가 모든 경로 밖에 있으면 경고합니다.
일반 .conf 파일에는 킬 스위치 선택을 저장할 곳이 없습니다. 온디맨드 및 킬 스위치 설정을 터널과 함께 옮겨야 할 때는 .vylos를 사용하십시오.
전체 예제
아카이브의 settings.conf에는 두 기능을 함께 넣을 수 있습니다.
[SplitDNS]
Domains = corp.example.com, *.internal.example.com
SearchDomains = example.com
[OnDemandRule]
InterfaceType = cellular
Action = connect
[OnDemandRule]
InterfaceType = wifi
Action = connect
SSIDs = !HomeWifi, !HomeWifi-5G
[Routing]
KillSwitch = true
이 구성은 셀룰러 네트워크와 지정한 두 홈 네트워크를 제외한 모든 Wi-Fi 네트워크에서 연결합니다. 일치하는 회사 및 내부 DNS 이름은 터널을 통해 라우팅됩니다.
앱에서 이 설정이 동작하는 방식은 분할 DNS 설정 및 온디맨드 연결 설정을 참조하십시오.
또한 준비된 터널을 사용할 수 없게 되면 나머지 트래픽 대부분을 차단합니다.
가져오기, 내보내기 및 QR 코드
Vylos는 .vylos 파일을 직접 가져오거나 일괄 .zip 아카이브에서 가져올 수 있습니다. 전체 구성 또는 둘 다를 선택하면 Vylos가 각 터널을 .vylos 아카이브로 내보냅니다.
iOS에서 QR 코드는 Base64로 인코딩된 .vylos 아카이브를 최대 16KB까지 포함할 수 있습니다. Base64는 인코딩일 뿐이며 wireguard.conf의 개인 키를 암호화하지 않습니다.
일반 파일 가져오기 한도는 2MB입니다. 내보낸 파일에는 개인 키가 포함되므로 민감한 자격 증명처럼 보관하고 공유하십시오.