docs: Go-Version korrigiert und Installation auf dem Zielhost beschrieben

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NBHF4R9EAejDJUMdwr6C68
This commit is contained in:
Carsten Abele 2026-08-14 10:09:17 +02:00
parent 4130a4eb4d
commit 6694aa5d2e

View file

@ -362,7 +362,7 @@ Log. Es lädt nichts herunter und installiert nichts.
## Bauen aus dem Quelltext ## 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` kein Build-Step für das Frontend — Templates und Assets liegen per `go:embed`
im Binary. im Binary.
@ -374,6 +374,30 @@ make build # Binary nach dist/
make release # Archive für linux-amd64 und linux-arm64 inkl. SHA256SUMS 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 ### Integrationstests gegen eine echte OPNsense
Die Feldnamen der Export-API sind versionsabhängig. Vor einer Auslieferung Die Feldnamen der Export-API sind versionsabhängig. Vor einer Auslieferung