Skip to content

README.ja.md

Latest commit

 

History

History
152 lines (109 loc) · 7 KB

README.ja.md

File metadata and controls

152 lines (109 loc) · 7 KB
Raw

HiDeck

Qualcomm 4G / LTE / 5G モデム向けセルフホストコンソール

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

Release Docker Go Vue 3 License: PolyForm Noncommercial 1.0.0

USB モデム、セルラープロキシ、SMS、WiFi calling / IMS 音声、eSIM、スケジュールタスクをブラウザから管理します。
Web UI http://YOUR_IP:7575
初期ログイン admin / admin（初回サインイン時に変更）
データベース SQLite（data/hideck.db）

機能

  • デバイス — USB 自動検出。QMI、MBIM、AT、PC/SC。電波と SIM 識別をリアルタイム表示
  • プロキシ — モデムに SO_BINDTODEVICE でバインドした SOCKS5 / HTTP
  • SMS — 受信、送信、連絡先。iOS / Google / Samsung / Xiaomi / Huawei / OPPO / vivo の vcf / csv
  • 電話 — WiFi calling、セルラーソフトウェア IMS、ネイティブ VoLTE。保留、キャッチホン、聞き取り専用応答
  • VoWiFi — SWu / IMS、録音。国別プロキシプール、ノード固定、または直結
  • ネイティブ VoLTE — モデム IMS（phone_mode=volte）、ePDG なし。中国向けの一意な MBN マッピングのみ
  • eSIM — ダウンロード、有効化、無効化、名前変更、削除。アクティベーションコードまたは QR / PDF
  • 自動化と通知 — スケジュールタスク。Telegram、メール、Bark、Feishu、WeCom、WeChat、QQ

プロトコル：VoWiFi · VoLTE · 事業者 · ハードウェア

クイックスタート

Docker を推奨します。Linux、curl、Docker Compose、ホストネットワーク、USB アクセスが必要です。イメージには通話録音用の AMR/MP3 ライブラリが含まれます。

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

http://YOUR_IP:7575 を開きます。

公開ホスト名（DNS の A/AAAA をホストへ、443/TCP と 443/UDP を開放）：

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

イメージ：yibaiba/hideck:latest。Compose は network_mode: host、privileged: true、/dev を使い、config/、data/、logs/ を永続化します。DOCKERHUB.md と HTTPS / WebRTC を参照してください。

docker compose ps
docker compose logs -f hideck

スクリーンショット

ログイン

ダッシュボード

デバイス 電話
デバイス 電話
コマンド プロキシ
コマンド プロキシ

バイナリインストール

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
ファイル 対象
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 静的、UPX なし
hideck_v2.1.23_openwrt_arm64 OpenWrt aarch64
hideck_v2.1.23_openwrt_armv7 OpenWrt 32-bit ARM

OpenWrt では openwrt_* のみを使ってください。packaging/openwrt/README.md を参照。

設定

config/config.example.yaml を config/config.yaml にコピーします。

キー デフォルト 説明
server.port 7575 HTTP
server.https_enabled false 内蔵 HTTPS。リバースプロキシ配下ではオフ
server.https_port 7576 内蔵 HTTPS ポート
server.webrtc_udp_address :7580 WebRTC 音声 UDP
server.webrtc_public_host 空 NAT 配下の公開 ICE ホスト
web.username / web.password admin すぐに変更する
vowifi.enabled false グローバル VoWiFi
system.openwrt_dynamic_interfaces false OpenWrt netifd マッピング

秘密情報をコミットしないでください。SIM PIN 欄は環境変数名だけを保存します（HIDECK_SIM_PIN_READER1）。PROXY_WEB_PASSWORD はファイルより優先されます。

ビルド

Go 1.26.4+、Node.js / npm。make build-* には UPX が必要です。

make build-amd64    # ほか: 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/...

開発用プロキシ：web/.env.local に VITE_API_PROXY_TARGET=http://127.0.0.1:7575。API ドキュメント：/api/docs。

ライセンス

個人の学習、研究、テスト向けです。本番の電話基盤ではありません。Quectel、Qualcomm、通信事業者とは無関係です。現地の法令と契約に従ってください。

PolyForm Noncommercial 1.0.0。third_party/vowifi-go は AGPL-3.0 です。バイナリやイメージを配布する前に THIRD_PARTY_NOTICES.md を読んでください。

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