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`

必要項目使用的 wg-quick 欄位，與 Vylos 一般 .conf 匯入所接受的欄位相同。沒有任何 [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

請將範例金鑰與端點替換為 WireGuard 伺服器提供的值。如需瞭解底層設定格式，請參閱 WireGuard 專案的 wg-quick 文件。

`settings.conf`

區段名稱與鍵名不分大小寫。空白行與 # 之後的文字會被忽略；未知區段、未知鍵、格式錯誤的行、不支援的動作或不支援的介面類型都會使匯入失敗。

分割 DNS

加入一個 [SplitDNS] 區段，並提供下列一個或兩個鍵：

鍵	值
`Domains`	以逗號分隔的網域；這些網域的 DNS 查詢會使用通道的 DNS 伺服器。
`SearchDomains`	以逗號分隔的尾碼，用於重新嘗試不含網域部分的主機名稱查詢。

網域標籤可包含字母、數字，以及標籤內部的連字號。Vylos 也接受選用的前置萬用字元（例如 *.example.com），以及表示完整網域名稱的結尾句點。

Vylos 會先正規化分割 DNS 比對網域，再套用至 Apple 網路。無效的網域項目會被忽略，不會加入通道的網域清單。

隨選規則

為每個網路條件加入一個 [OnDemandRule] 區段。多個區段採用「或」邏輯，因此任何一條相符規則都能啟用通道。

鍵	必要	可接受的值
`InterfaceType`	是	`cellular`、`ethernet` 或 `wifi`。
`Action`	否	`connect`；省略時也會預設為 `connect`。
`SSIDs`	否	若為 Wi-Fi，可使用以逗號分隔的包含清單，或每個項目都以 `!` 開頭的排除清單。省略時會比對所有 Wi-Fi 網路。

同一條規則中不要混用一般 SSID 與以 ! 開頭的 SSID。行動網路規則適用於 iOS，乙太網路規則適用於 macOS，Wi-Fi 規則則適用於 Vylos 支援的所有平台。

Vylos 在匯入和重新匯出通道時，會保留目前平台不支援的規則值。因此，一個可攜式檔案可以同時保留針對 iOS、macOS 與 visionOS 的預期行為。

終止開關

新增 [Routing] 區段，以便在已啟用的隨選通道無法使用時封鎖大多數網路流量：

ini

[Routing]
KillSwitch = true

KillSwitch 接受 true 或 false。值為 true 時必須至少有一個 [OnDemandRule]；如果檔案在沒有自動啟用規則的情況下開啟終止開關，Vylos 會拒絕該檔案。

此設定不會改寫 WireGuard 設定。所有對等端合併後的 AllowedIPs 仍會決定哪些目的地具有通過 VPN 的路由。App 會依據有效路由顯示全通道保護、受限的網路存取或沒有對外路由，並在 DNS 伺服器不屬於任何路由時提出警告。

一般 .conf 檔案沒有儲存終止開關選項的位置。當隨選和終止開關設定需要跟隨通道一起移動時，請使用 .vylos。

完整範例

封存檔中的 settings.conf 可以同時包含兩類功能：

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

這項設定會在行動網路，以及指定的兩個家用網路以外的所有 Wi-Fi 網路上連線。相符的公司與內部 DNS 名稱會經由通道路由。

如需瞭解這些設定在 App 中的行為，請參閱設定分割 DNS和設定隨選連線。

如果已啟用的通道無法使用，此設定也會封鎖大多數其他流量。

匯入、匯出與 QR Code

Vylos 可以直接匯入 .vylos 檔案，也可以從批次 .zip 封存檔匯入。選擇完整設定或兩者時，Vylos 會為每個通道匯出一個 .vylos 封存檔。

在 iOS 上，QR Code 最多可包含 16 KB 的 Base64 編碼 .vylos 封存檔。Base64 只是編碼方式，不會加密 wireguard.conf 中的私密金鑰。

一般檔案匯入上限為 2 MB。匯出的檔案包含私密金鑰，因此請將其視為敏感憑證來儲存和分享。