Format file Vylos

Gunakan format .vylos untuk membawa konfigurasi WireGuard standar bersama pengaturan Split DNS, Sesuai Permintaan, dan Kill Switch Vylos. | settings.conf | Tidak | Bagian [SplitDNS], [OnDemandRule], dan [Routing] Vylos dalam teks UTF-8 bergaya INI. |

Struktur Arsip

File .vylos adalah arsip ZIP yang memuat satu file wajib dan satu file opsional:

Entri arsip	Wajib	Isi
`wireguard.conf`	Ya	Bagian WireGuard `[Interface]` dan `[Peer]` yang tidak diubah, sebagai teks UTF-8.
`settings.conf`	Tidak	Bagian Vylos `[SplitDNS]` dan `[OnDemandRule]`, sebagai teks UTF-8 mirip INI.

Vylos menolak arsip jika wireguard.conf tidak ada atau jika salah satu entri bukan teks UTF-8. Arsip tanpa settings.conf berperilaku sama seperti konfigurasi WireGuard di dalamnya.

Ekstensi file tidak mengubah sintaks konfigurasi WireGuard. Anda dapat mengekstrak wireguard.conf dan menggunakannya di klien WireGuard lain yang kompatibel, sementara pengaturan khusus Vylos tetap tersimpan terpisah di settings.conf.

`wireguard.conf`

Entri wajib menggunakan bidang wg-quick yang sama dengan yang diterima Vylos dalam impor .conf biasa. Konfigurasi tanpa bagian [Peer] tetap valid, dan satu tunnel dapat memuat beberapa peer.

ini

[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

Ganti kunci dan endpoint contoh dengan nilai yang diberikan server WireGuard Anda. Untuk format dasarnya, lihat dokumentasi wg-quick dari proyek WireGuard.

`settings.conf`

Nama bagian dan kunci tidak peka huruf besar-kecil. Baris kosong dan teks setelah # diabaikan. Bagian atau kunci yang tidak dikenal, baris berformat salah, tindakan yang tidak didukung, atau jenis antarmuka yang tidak didukung menyebabkan impor gagal.

DNS Terpisah

Tambahkan satu bagian [SplitDNS] dan salah satu atau kedua kunci berikut:

Kunci	Nilai
`Domains`	Domain yang dipisahkan koma, yang kueri DNS-nya menggunakan server DNS tunnel.
`SearchDomains`	Sufiks yang dipisahkan koma untuk mencoba ulang kueri nama host tanpa bagian domain.

Label domain dapat berisi huruf, angka, dan tanda hubung di dalam label. Vylos juga menerima wildcard awal opsional, seperti *.example.com, dan titik akhir untuk nama domain yang sepenuhnya memenuhi syarat.

Vylos menormalkan domain pencocokan DNS terpisah sebelum menerapkannya ke jaringan Apple. Entri domain yang tidak valid diabaikan dan tidak ditambahkan ke daftar domain tunnel.

Aturan Sesuai Permintaan

Tambahkan satu bagian [OnDemandRule] untuk setiap kondisi jaringan. Beberapa bagian menggunakan logika “atau”, sehingga aturan mana pun yang cocok dapat mengaktifkan tunnel.

Kunci	Wajib	Nilai yang diterima
`InterfaceType`	Ya	`cellular`, `ethernet`, atau `wifi`.
`Action`	Tidak	`connect`; jika dihilangkan, nilai bawaannya juga `connect`.
`SSIDs`	Tidak	Untuk Wi-Fi, daftar penyertaan yang dipisahkan koma atau daftar pengecualian dengan setiap entri diawali `!`. Jika dihilangkan, semua jaringan Wi-Fi akan cocok.

Jangan mencampur SSID biasa dengan SSID yang diawali ! dalam aturan yang sama. Aturan seluler berlaku untuk iOS, Ethernet untuk macOS, dan Wi-Fi untuk semua platform yang didukung Vylos.

Vylos mempertahankan nilai aturan yang tidak didukung platform saat ini ketika mengimpor dan mengekspor ulang tunnel. Satu file portabel dapat menyimpan perilaku yang dimaksudkan untuk iOS, macOS, dan visionOS.

Kill Switch

Tambahkan bagian [Routing] untuk memblokir sebagian besar lalu lintas jaringan saat terowongan Sesuai Permintaan yang disiagakan tidak tersedia:

ini

[Routing]
KillSwitch = true

KillSwitch menerima true atau false. Nilai true memerlukan setidaknya satu bagian [OnDemandRule]; Vylos menolak file yang mengaktifkan Kill Switch tanpa aturan aktivasi otomatis.

Pengaturan ini tidak menulis ulang konfigurasi WireGuard. Gabungan AllowedIPs dari semua peer tetap menentukan tujuan yang memiliki rute melalui VPN. App menampilkan Perlindungan Tunnel Penuh, Akses Jaringan Terbatas, atau Tidak Ada Rute Keluar sesuai rute efektif dan memperingatkan jika server DNS berada di luar semua rute.

File .conf biasa tidak memiliki tempat untuk menyimpan pilihan Kill Switch. Gunakan .vylos saat pengaturan Sesuai Permintaan dan Kill Switch harus ikut bersama terowongan.

Contoh Lengkap

settings.conf di dalam arsip dapat memuat kedua jenis fitur:

ini

[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

Konfigurasi ini menyambung di jaringan seluler dan semua jaringan Wi-Fi selain dua jaringan rumah yang ditentukan. Nama DNS perusahaan dan internal yang cocok dirutekan melalui tunnel.

Lihat Menyiapkan DNS terpisah dan Menyiapkan Sambungan Sesuai Permintaan untuk perilaku pengaturan ini di aplikasi.

Konfigurasi ini juga memblokir sebagian besar lalu lintas lain jika terowongan yang disiagakan tidak tersedia.

Impor, Ekspor, dan Kode QR

Vylos dapat mengimpor file .vylos secara langsung atau dari arsip .zip massal. Saat Anda memilih Konfigurasi Lengkap atau Keduanya, Vylos mengekspor setiap tunnel sebagai arsip .vylos.

Di iOS, kode QR dapat memuat arsip .vylos yang dienkode Base64 hingga 16 KB. Base64 hanya merupakan pengodean dan tidak mengenkripsi kunci privat dalam wireguard.conf.

Batas impor file biasa adalah 2 MB. File yang diekspor memuat kunci privat, jadi simpan dan bagikan seperti kredensial sensitif.