From 6694aa5d2ec9c611ff6af3dd90db7097f1718155 Mon Sep 17 00:00:00 2001 From: Carsten Abele Date: Fri, 14 Aug 2026 10:09:17 +0200 Subject: [PATCH] docs: Go-Version korrigiert und Installation auf dem Zielhost beschrieben Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01NBHF4R9EAejDJUMdwr6C68 --- README.md | 26 +++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0f786e8..cc135f9 100644 --- a/README.md +++ b/README.md @@ -362,7 +362,7 @@ Log. Es lädt nichts herunter und installiert nichts. ## Bauen aus dem Quelltext -Voraussetzung: Go 1.26 oder neuer. Keine CGO-Abhängigkeiten, kein npm, +Voraussetzung: **Go 1.25 oder neuer**. Keine CGO-Abhängigkeiten, kein npm, kein Build-Step für das Frontend — Templates und Assets liegen per `go:embed` im Binary. @@ -374,6 +374,30 @@ make build # Binary nach dist/ make release # Archive für linux-amd64 und linux-arm64 inkl. SHA256SUMS ``` +### Go auf dem Zielhost installieren + +Die Go-Pakete der Distributionen sind für dieses Projekt zu alt (Debian 12: +1.19, Ubuntu 24.04: 1.22, Raspberry Pi OS: 1.19). `apt install golang` genügt +also nicht — Go kommt aus dem offiziellen Tarball: + +```bash +uname -m # x86_64 -> amd64, aarch64 -> arm64 + +# Aktuelle Version auf https://go.dev/dl/ nachsehen, hier als Beispiel 1.26.5 +curl -LO https://go.dev/dl/go1.26.5.linux-amd64.tar.gz +sudo rm -rf /usr/local/go +sudo tar -C /usr/local -xzf go1.26.5.linux-amd64.tar.gz +echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.profile +export PATH=$PATH:/usr/local/go/bin +go version +``` + +Der erste Build lädt die vier Abhängigkeiten von `proxy.golang.org` — der +Host braucht dafür einmalig Internetzugang. Soll er dauerhaft ohne Netz +auskommen, entweder das Binary auf einer anderen Maschine bauen +(`make release`) oder einmalig `go mod vendor` ausführen und das +`vendor/`-Verzeichnis mitliefern. + ### Integrationstests gegen eine echte OPNsense Die Feldnamen der Export-API sind versionsabhängig. Vor einer Auslieferung