35 lines
2.3 KiB
Markdown
35 lines
2.3 KiB
Markdown
# 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 中下载。 |
|