Xray 资源下载配置
对应 download.toml 和 XrayAssetSettings，在“下载”页显示。
| 设置 |
UI |
默认值 |
可选值 |
作用 |
什么时候修改 |
directory |
下载页 |
data/xray；Docker 中通常为 /config/xray |
路径 |
Xray 资源保存目录。 |
Docker 部署保持 /config/xray；本机运行可用默认值。 |
version |
下载页 |
首次打开时优先使用最新 release；获取失败回退 v26.5.9 |
Xray release tag |
官方 release 版本。 |
需要固定或升级 Xray 版本时修改。 |
archive_url |
下载页 |
"" |
URL |
自定义 Xray release zip 地址；为空时用官方地址。 |
官方下载慢或使用镜像时修改。 |
geoip_url |
下载页 |
"" |
URL |
自定义 geoip.dat 下载地址。 |
需要替换 geoip 数据源时修改。 |
geosite_url |
下载页 |
"" |
URL |
自定义 geosite.dat 下载地址。 |
需要替换 geosite 数据源时修改。 |
proxy_url |
下载页 |
"" |
HTTP/HTTPS 代理 URL |
下载资源时使用的代理。 |
服务器直连 GitHub 慢或失败时修改。 |
target |
下载页 |
all |
all / xray / geoip / geosite |
本次下载目标。 |
只更新某个资源时修改。 |
force |
下载页 |
false |
bool |
已存在文件是否覆盖。 |
要强制重新下载时开启。 |
必需文件
| 文件 |
作用 |
xray / xray.exe |
Xray 可执行文件；Windows 下为 xray.exe，其它平台为 xray。 |
geoip.dat |
IP 地理库，用于 geoip:* 规则。 |
geosite.dat |
域名分类库，用于 geosite:* 规则。 |
下载行为
| 条件 |
行为 |
target = all |
确保三个必需文件都存在。 |
首次无 download.toml |
尝试在 5 秒内获取 Xray-core 最新 release tag；失败则使用内置回退版本。 |
force = false 且文件存在 |
跳过已有文件。 |
force = true |
覆盖目标文件。 |
archive_url 为空 |
按当前平台选择官方 release zip；Windows x64 使用 Xray-windows-64.zip，Linux x64 使用 Xray-linux-64.zip。 |
geoip_url / geosite_url 非空 |
对应 dat 文件使用自定义 URL，优先于 release zip 内置版本。 |
| Docker 部署 |
资源仍由 Web 下载页处理，不在 Dockerfile 中下载。 |
