Skip to content

mirror.md

Latest commit

 

History

History
68 lines (45 loc) · 3.86 KB

mirror.md

File metadata and controls

68 lines (45 loc) · 3.86 KB
Raw

GitHub mirror

中文 | English

Foojay links the JDKs of most distributions to GitHub Releases, so vfox install java@21-tem downloads from github.com. If github.com is slow or unreachable where you are, set VFOX_JAVA_GITHUB_MIRROR and the plugin sends these downloads through a GitHub mirror.

The value is a URL prefix. The plugin puts it in front of the GitHub URL, and adds a / if the value does not end in one. For Temurin 21.0.8 on Linux x64:

VFOX_JAVA_GITHUB_MIRROR vfox downloads
not set https://github.com/adoptium/temurin21-binaries/releases/download/jdk-21.0.8%2B9/OpenJDK21U-jdk_x64_linux_hotspot_21.0.8_9.tar.gz
https://gh-proxy.org/ https://gh-proxy.org/https://github.com/adoptium/temurin21-binaries/releases/download/jdk-21.0.8%2B9/OpenJDK21U-jdk_x64_linux_hotspot_21.0.8_9.tar.gz

gh-proxy takes URLs in this form, and so does any service that takes the GitHub URL after its own address. The plugin does not run any of them and cannot vouch for them. The value must start with http:// or https://. vfox takes any other address for a file on disk, so a download from GitHub stops with VFOX_JAVA_GITHUB_MIRROR must start with http:// or https:// instead.

Set it

In bash or zsh, for the current shell:

export VFOX_JAVA_GITHUB_MIRROR=https://gh-proxy.org/

Put the same line in ~/.bashrc or ~/.zshrc to keep it. In PowerShell:

$env:VFOX_JAVA_GITHUB_MIRROR = "https://gh-proxy.org/"

To set it for every terminal opened afterwards:

[Environment]::SetEnvironmentVariable('VFOX_JAVA_GITHUB_MIRROR', 'https://gh-proxy.org/', 'User')

Then install as usual, vfox install java@21-tem. To go back to github.com, unset the variable.

What goes through the mirror

Only downloads from https://github.com/. A JDK on any other host downloads from there as before, and the requests to Foojay do not change.

Where Foojay links each distribution (2026-10-21):

Short names Download from
tem, librca, sem, semcrt, sapmchn, kona, albba, mandrel, trava, adpt, adptj9, eliya, ojdkbld, gln, grl8, grl11, grl16, grl17, grl19 GitHub
graalce GitHub, except the monthly feature releases that java@25-graalce installs, which come from Oracle's GraalVM Download Service. java@25.4.4.1-graalce is the same file from GitHub
nik GitHub for the newer releases, BellSoft's server for the older ones
open jdk.java.net, except JDK 8 and most 11.x builds, which come from GitHub
zulu, amzn, ms, oracle, graal, jb, bsg, opnlgc, rdht the vendor's server or a CDN, not GitHub

Loongnix (lnxabi1, lnxabi2) downloads from ftp.loongnix.cn and is not mirrored.

To see where one release downloads from, ask Foojay for its package and read direct_download_uri. It is mirrored if it starts with https://github.com/. foojay.md has the queries for other platforms.

curl -s 'https://api.foojay.io/disco/v3.0/packages/jdks?distribution=temurin&version=21.0.8&architecture=amd64&operating_system=linux&lib_c_type=glibc&archive_type=tar.gz&directly_downloadable=true' \
  | jq -r '.result[0].links.pkg_info_uri' | xargs curl -s | jq -r '.result[0].direct_download_uri'
https://github.com/adoptium/temurin21-binaries/releases/download/jdk-21.0.8%2B9/OpenJDK21U-jdk_x64_linux_hotspot_21.0.8_9.tar.gz

Notes

  • The plugin gives vfox no checksum, so vfox does not verify the download (WARNING: Checksum is not provided, skip verify..., see foojay.md). Through a mirror, the archive is whatever the mirror serves. Use one you trust.
  • The variable only changes where vfox install downloads a JDK from. vfox add java does not use it. For a proxy that covers all of vfox, see Network.