# OneXray > Configuration and VPN Tunnel guide for people and AI assistants. OneXray is a client; it supplies no servers or credentials. Read the complete guide before producing configuration. Follow the documented field and platform constraints without silently dropping conditions. Choose outbound, Custom Routing, or Raw JSON before generating a document. VPN Tunnel settings are separate UI operations, not importable JSON fields. Never invent credentials or claim an untested template is a working VPN. ## Complete guide - [Complete configuration and platform guide](https://onexray.com/zh/llms-full.txt): all essential chapters in reading order, including full JSON examples. Language: zh. - [Example manifest](https://onexray.com/examples/manifest.json): import type, dependencies, and required replacements for each downloadable JSON. ## Chapters - [使用 AI 生成 Xray 配置](https://onexray.com/zh/docs/ai/index.md): 把需求交给 AI，生成可导入 OneXray 的节点、自定义路由或 Raw JSON。复制提示词、提供服务器参数，并完成配置校验。 - [Xray 配置格式与版本兼容性](https://onexray.com/zh/docs/configuration/compatibility/index.md): 导入前核对 OneXray 支持的 JSON 与分享链接格式、路由限制和内置 Xray-core 的配置要求。 - [Xray JSON 导入格式与配置规范](https://onexray.com/zh/docs/configuration/index.md): 区分 OneXray 节点、常规与高级自定义路由、完整 Raw JSON 的导入入口，了解必需字段以及 App 接管的设置。 - [Xray outbound 节点 JSON 配置](https://onexray.com/zh/docs/configuration/outbound/index.md): 为 OneXray 编写 VLESS、VMess、Trojan、Shadowsocks 或 SOCKS 节点 JSON，保留服务器的传输、TLS 和 REALITY 参数。 - [Xray 路由 JSON：常规自定义规则](https://onexray.com/zh/docs/configuration/custom-routing/index.md): 使用空接入槽、有序域名与 IP 规则、本地 DNS、FakeDNS 和 Geodata 依赖，生成可导入 OneXray 的自定义路由。 - [高级路由 JSON](https://onexray.com/zh/docs/configuration/advanced-routing/index.md): 复用 App 节点，自行编写 DNS、嗅探、额外入站和完整规则顺序。 - [Xray Raw JSON 配置规范](https://onexray.com/zh/docs/configuration/raw-json/index.md): 生成完整用户配置，并避免与 OneXray 接管的运行字段冲突。 - [Xray DNS、本地 DNS 与 FakeDNS](https://onexray.com/zh/docs/configuration/dns/index.md): 配置 OneXray 路由 DNS 与 FakeDNS，区分代理解析、直连解析、内网域名和 IPv6 策略，了解它们与 TUN DNS 的区别。 - [路由中的 GeoIP 与 Geosite 依赖](https://onexray.com/zh/docs/configuration/geodata/index.md): 在 OneXray 路由中使用真实的 GeoIP、Geosite 分类，声明自定义 DAT 文件依赖，处理缺失文件，不猜测地区规则名称。 - [场景配置方案](https://onexray.com/zh/docs/recipes/index.md): 完整示例覆盖地区分流、公司 DNS、多条代理路径、协议匹配和 FakeDNS。 - [智能路由](https://onexray.com/zh/docs/connect/smart-routing/index.md): 设置直连地区、自定义本地 DNS、局域网和服务直连、接入节点数量与可选的 VPN 最终出口。 - [按需求配置 VPN 隧道](https://onexray.com/zh/docs/tunnel-guide/index.md): 将平台需求转换为明确 UI 操作，而不是虚构可导入 JSON。 - [验证与排错](https://onexray.com/zh/docs/troubleshooting/index.md): 区分 JSON 语法、导入兼容、内核构造、平台启动与真实连通性。 - [Xray TUN 模式与 VPN 隧道设置](https://onexray.com/zh/docs/advanced/vpn-tunnel/index.md): 了解 OneXray 的 TUN 模式，配置隧道 DNS、IPv6 与 Windows/Linux 出口网卡，并核对各平台专属选项。 - [Apple 系统 VPN](https://onexray.com/zh/docs/advanced/apple/index.md): 配置始终开启、Wi-Fi 按需连接与断开、蜂窝或 Ethernet 动作，以及接管全部流量的排除选项。 - [Android 系统 VPN](https://onexray.com/zh/docs/advanced/android/index.md): 通过应用图标和搜索选择哪些 Android App 经过 VPN，包含和排除列表分别保存。 - [Windows VPN 模式](https://onexray.com/zh/docs/advanced/windows/index.md): 对比 EXE/ZIP 原生 TUN 与 Microsoft Store MSIX 系统 VPN 的权限、网卡、数据、启动和退出行为。 - [导入与分享格式](https://onexray.com/zh/docs/sharing/index.md): 区分标准分享链接、OneXray URL、完整 JSON 与 GeoData 依赖，避免误导入或分享 age 私钥。 - [备份与恢复](https://onexray.com/zh/docs/backup/index.md): 使用 iCloud、Android 系统文件选择器或 OneDrive 文件夹保存一份可覆盖的连接配置备份，恢复无需等待 GeoData 下载。 ## Optional - [Proxy protocols and transports](https://onexray.com/zh/docs/protocols/index.md): client import guides for VLESS/REALITY, XHTTP and VMessAEAD; SS, Trojan and SOCKS overview. Follow the authoritative contracts above for generated JSON. - [All documentation](https://onexray.com/zh/docs/index.md): installation, interface guides, privacy, and support. - [Privacy](https://onexray.com/zh/docs/privacy/index.md): review before sharing credentials with an external AI service.