Repository navigation
nl BINARIES
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Tiếng Việt | 中文
Privacy en beveiliging zijn niet optioneel in VDBackup. Een back-uptool draait als root over je meest persoonlijke gegevens, dus je moet precies kunnen zien wat erin wordt meegeleverd. Deze pagina documenteert elke voorgebouwde binary en bibliotheek die de module meedraagt, waar elke vandaan komt en hoe je kunt verifiëren dat er niets ondoorzichtigs is binnengeslopen.
- Niets ondoorzichtigs. Elke meegeleverde binary en bibliotheek is te herleiden tot een benoemde, publieke upstream op een vastgezette versie, met een vastgelegde SHA-256. Geen enkele blob wordt meegeleverd zonder een vermelding die je kunt controleren.
-
Opgehaald van de upstream, nooit van een apparaat. Native tools komen uit het officiële
Termux-pakketrepository (de ondertekende
.deb-bestanden oppackages.termux.dev/apt), nooit gekopieerd uit een Termux die op een of andere telefoon is geïnstalleerd. De build faalt luidruchtig, hij improviseert nooit. - Reproduceerbaar. Voer de build opnieuw uit en je krijgt dezelfde bestanden; haal de vastgezette bronnen opnieuw op en de SHA-256-waarden komen overeen.
- Het auditspoor wordt met de module meegeleverd. Het staat niet alleen op de website - het reist mee binnen de geïnstalleerde module, op je apparaat, zodat je offline kunt auditen.
| Artefact | Bron | Hoe het wordt gebouwd |
|---|---|---|
bin/<abi>/ native tools (tar, zstd, gzip, lz4, jq, rclone, restic, rsync, ssh/scp/sftp, age, age-keygen, script, sqlite3) + hun lib/-closure |
Officiële Termux apt-repo (packages.termux.dev/apt), officiële .deb-pakketten |
.github/scripts/build_bin.sh downloadt de .deb-bestanden + hun transitieve afhankelijkheden, pakt ze uit en kopieert de binaries plus alleen de gedeelde bibliotheken die elk nodig heeft |
bin/<abi>/abx2xml, bin/<abi>/xml2abx (ABX-converter-terugval) |
GitHub-release van rhythmcache/android-xml-converter (ABX_RELEASE, statische ELF) |
gedownload van de vastgezette release door build_bin.sh
|
companion.apk (optionele Google Drive-metgezel) |
Deze repository, companion/ (Gradle/Kotlin) |
gebouwd vanuit de bron door de CI en ondertekend met de projectsleutel (VD_Key); geen voorgebouwde blob |
vdbhelper.dex (framework-helper) |
Deze repository, dex/src/ (Java) |
gecompileerd vanuit de bron door de CI met javac + d8
|
Alleen de eerste twee rijen zijn voorgebouwde binaries van derden; de laatste twee worden gebouwd vanuit broncode die in deze repository leeft en gelezen en herbouwd kan worden.
Full- versus lite-edities. De lite-edities laten alleen
rcloneenrestic(de twee grootste binaries) weg om klein te blijven;rsyncenssh/scp/sftpzijn nog steeds aanwezig, en elke andere hierboven genoemde binary is er ook. De Full-edities voegenrclone(cloudproviders) enrestic(snapshots) toe.
build_bin.sh schrijft één bin/<abi>/PROVENANCE.json per ABI. Bij installatie houdt de module
alleen de ABI van je apparaat, zodat dat bestand op het apparaat blijft op
/data/adb/modules/vdbackup/bin/<abi>/PROVENANCE.json. Het legt vast:
-
sources: elke upstream-.deb(pakket, versie, volledige URL, SHA-256 van de.deb) en de ABX-release (URL, SHA-256 van het archief). -
files: elk bestand dat daadwerkelijk onderbin/<abi>/wordt meegeleverd (pad, grootte, SHA-256).
Je kunt het lezen in de WebUI (het tabblad Over linkt ernaar) of via de agent-API:
sh /data/adb/modules/vdbackup/helper.sh provenance '' | jq .-
Controleer de meegeleverde bestanden. Hash elk bestand onder
bin/<abi>/op je apparaat en vergelijk metfiles[].sha256inPROVENANCE.json:cd /data/adb/modules/vdbackup/bin/<abi> sha256sum tar zstd jq rclone ... lib/*
-
Controleer de bestanden tegen de upstream. Download voor elke
sources[]-vermelding de vastgezette.debvan zijn URL, bevestig dat de SHA-256 overeenkomt metdeb_sha256, pak hem uit en bevestig dat de binaries/bibliotheken die hij bevat naar dezelfde meegeleverde waarden hashen. De.deb-bestanden in de Termux-repo worden zelf geserveerd vanuit Termux' ondertekende apt-repository. -
Herbouw vanaf nul. Voer zelf
.github/scripts/build_bin.shuit (heeft alleencurl,ar,tar,xz,zstd,readelfnodig) en vergelijk de uitvoer met wat is meegeleverd. -
Metgezel en dex. Herbouw
companion/endex/vanuit de bron; de handtekening van de metgezel is de projectsleutelVD_Key(SHA-256F3:F8:2B:B9:2F:2C:69:A1:75:90:1D:40:BD:65:DD:A6:8F:2B:B5:88:69:77:F5:EA:8B:BA:AA:51:40:E5:25:2B).
Als een meegeleverd bestand niet overeenkomt met de vastgelegde bron, behandel het dan als een beveiligingsprobleem en meld het (zie SECURITY.md). Dit is precies het soort discrepantie dat dit manifest bestaat om zichtbaar te maken.