Skip to content

README.de.md

Latest commit

 

History

History
152 lines (109 loc) · 6.34 KB

README.de.md

File metadata and controls

152 lines (109 loc) · 6.34 KB
Raw

HiDeck

Selbst gehostete Konsole für Qualcomm-4G-/LTE-/5G-Modems

English · 简体中文 · 日本語 · 한국어 · Español · Français · Deutsch · Português · Русский

Release Docker Go Vue 3 License: PolyForm Noncommercial 1.0.0

USB-Modems, Mobilfunk-Proxy, SMS, WiFi calling / IMS-Sprache, eSIM und geplante Aufgaben im Browser verwalten.
Web-UI http://YOUR_IP:7575
Standard-Login admin / admin (beim ersten Anmelden ändern)
Datenbank SQLite (data/hideck.db)

Funktionen

  • Geräte — USB-Autodiscovery; QMI, MBIM, AT, PC/SC; Funk und SIM-Identität live
  • Proxy — SOCKS5 / HTTP, mit SO_BINDTODEVICE an das Modem gebunden
  • SMS — Posteingang, Senden, Kontakte; vcf/csv von iOS, Google, Samsung, Xiaomi, Huawei, OPPO, vivo
  • Telefon — WiFi calling, zellulares Software-IMS oder natives VoLTE; Halten, Anklopfen, Nur-Hören-Annahme
  • VoWiFi — SWu / IMS, Aufnahmen; Proxy-Pool pro Land, Knoten pinnen oder direkt
  • Natives VoLTE — Modem-IMS (phone_mode=volte), ohne ePDG; nur das eindeutige China-MBN-Mapping
  • eSIM — herunterladen, aktivieren, deaktivieren, umbenennen, löschen; Aktivierungscode oder QR / PDF
  • Automatisierung und Benachrichtigung — geplante Aufgaben; Telegram, E-Mail, Bark, Feishu, WeCom, WeChat, QQ

Protokollnotizen: VoWiFi · VoLTE · Betreiber · Hardware

Schnellstart

Docker (empfohlen). Braucht Linux, curl, Docker Compose, Host-Netzwerk und USB-Zugriff. Das Image enthält AMR/MP3-Bibliotheken für Gesprächsaufzeichnung.

curl -fsSL https://raw.githubusercontent.com/yibaiba/hideck/main/deploy.sh | sh
curl -fsSL https://raw.githubusercontent.com/yibaiba/hideck/main/deploy.sh | HIDECK_DIR=/opt/hideck sh

Danach http://YOUR_IP:7575 öffnen.

Mit öffentlichem Hostnamen (DNS A/AAAA auf den Host, 443/TCP und 443/UDP offen):

curl -fsSL https://raw.githubusercontent.com/yibaiba/hideck/main/deploy.sh | \
  HIDECK_DOMAIN=hideck.example.com \
  HIDECK_DIR=/opt/hideck sh

Image: yibaiba/hideck:latest. Compose nutzt network_mode: host, privileged: true, /dev und persistiert config/, data/, logs/. Siehe DOCKERHUB.md und HTTPS / WebRTC.

docker compose ps
docker compose logs -f hideck

Screenshots

Anmeldung

Dashboard

Geräte Telefon
Geräte Telefon
Befehle Proxy
Befehle Proxy

Binärinstallation

curl -fsSL https://raw.githubusercontent.com/yibaiba/hideck/main/deploy-binary.sh | sh
curl -fsSL https://raw.githubusercontent.com/yibaiba/hideck/main/deploy-binary.sh | \
  HIDECK_DIR=/opt/hideck \
  HIDECK_VERSION=v2.1.23 \
  HIDECK_ARCH=linux_amd64 sh
Datei Plattform
hideck_v2.1.23_linux_amd64 x86_64, glibc + UPX
hideck_v2.1.23_linux_arm64 ARM64 / Raspberry Pi OS 64-Bit, glibc + UPX
hideck_v2.1.23_linux_armv7 32-Bit-ARM, glibc + UPX
hideck_v2.1.23_openwrt_amd64 OpenWrt x86_64, musl statisch, ohne UPX
hideck_v2.1.23_openwrt_arm64 OpenWrt aarch64
hideck_v2.1.23_openwrt_armv7 OpenWrt 32-Bit-ARM

Unter OpenWrt nur openwrt_* verwenden. Siehe packaging/openwrt/README.md.

Konfiguration

config/config.example.yaml nach config/config.yaml kopieren.

Schlüssel Standard Hinweis
server.port 7575 HTTP
server.https_enabled false Eingebautes HTTPS; hinter Reverse-Proxy aus lassen
server.https_port 7576 Port für eingebautes HTTPS
server.webrtc_udp_address :7580 WebRTC-Audio-UDP
server.webrtc_public_host leer Öffentlicher ICE-Host hinter NAT
web.username / web.password admin Sofort ändern
vowifi.enabled false Globales VoWiFi
system.openwrt_dynamic_interfaces false OpenWrt-netifd-Mapping

Keine Geheimnisse committen. SIM-PIN-Felder speichern nur Umgebungsvariablen-Namen (HIDECK_SIM_PIN_READER1). PROXY_WEB_PASSWORD überschreibt die Datei.

Bauen

Go 1.26.4+, Node.js / npm. make build-* braucht UPX.

make build-amd64    # außerdem: build-arm64, build-armv7, build-all
npm ci --prefix web && npm run build --prefix web
cp -R web/dist internal/web/dist
GOWORK=off CGO_ENABLED=0 GOOS=linux GOARCH=amd64 \
  go build -trimpath -tags "with_utls nomsgpack" -o dist/hideck_linux_amd64 ./cmd/hideck
npm test --prefix web && npm run typecheck --prefix web
go test -timeout=60s ./cmd/... ./internal/... ./pkg/...

Dev-Proxy: VITE_API_PROXY_TARGET=http://127.0.0.1:7575 in web/.env.local. API-Doku: /api/docs.

Lizenz

Zum persönlichen Lernen, Forschen und Testen. Kein Produktions-Telefonie-Stack. Unabhängig von Quectel, Qualcomm und Netzbetreibern. Lokales Recht und die AGB des Betreibers einhalten.

PolyForm Noncommercial 1.0.0. third_party/vowifi-go ist AGPL-3.0. Vor der Verteilung von Binaries oder Images THIRD_PARTY_NOTICES.md lesen.

Thanks: LINUX DO · iniwex5/vohive-release · boa-z/vowifi-go