import

Import a subscription URL, file, or raw text into the database.

xrat import <input> [--name <name>]

Arguments

Argument	Description
`input`	Subscription source: a URL, local file path, or raw subscription text

Option	Description
`-n`, `--name <name>`	Name for the imported subscription source

xrat automatically detects the input format:

Format	Detection
Subscription URL	Starts with `http://` or `https://`
Local file	Path to an existing file on disk
Single share link	Single line starting with a supported protocol scheme
Base64 subscription	Multi-line or single-line base64-encoded text
Plain link list	Multiple lines, each a valid share link
SIP008 JSON	JSON with `"servers"` array
Xray JSON	JSON with `"version"` or `"inbounds"` fields

Import from a subscription URL:

xrat import https://example.com/sub.txt

Import and name a subscription:

xrat import https://example.com/sub.txt --name "Work VPN"

Import from a local file:

xrat import ./nodes.txt

Import raw base64 subscription text:

xrat import "dmxlc3M6Ly91dWlkQGV4YW1wbGUuY29tOjQ0Mw=="

Import a single share link:

xrat import "vless://uuid@example.com:443?type=ws&security=tls#MyNode"

Reads input from the specified source
Detects format automatically
Parses and normalizes each node
Deduplicates against existing configs using a versioned key
Persists new configs to the database
Creates or updates the subscription source record and applies --name when provided
Reconciles the source: configs attached to the same subscription that are absent from this payload are soft-deleted (recoverable). A later import that brings them back restores them. An empty payload removes nothing.
Prints an import summary, including the count of removed configs

Add a single config URI directly to the database.

xrat add <input>

Argument	Description
`input`	Config URI: `vless://...`, `vmess://...`, `ss://...`, `trojan://...`, `hysteria2://...`, etc.

xrat add "vless://uuid-123@example.com:443?type=ws&security=tls&sni=cdn.example.com#Node"

xrat add "ss://YWVzLTI1Ni1nY206c2VjcmV0@example.com:8388#SS%20Node"

Unlike import, add does not create a subscription source record. It parses the single URI, normalizes it, deduplicates, and persists directly.

For the full config-management command set, see config management.