satmux README

README проекта с github.com/Th0rgal/satmux. Одним файлом markdown: README.md.

satmux

TCP multiplexer and 1-RTT HTTP/TLS relay for geostationary (GEO) inflight Wi-Fi (Inmarsat GX, Viasat, Panasonic, SITA). Pure Python 3 stdlib, zero external dependencies.

Measured inflight over Inmarsat GX Ka-band (~620 ms RTT, SITA AS206433 Amsterdam ground station):

  ORIGIN (6× PARALLEL)  RAW CABIN WI-FI (:443)    1-RTT BBR + ZLIB MUX    SPEEDUP
  ────────────────────  ────────────────────────  ──────────────────────  ─────────
  GitHub Repo           ████████████    TIMEOUT  ███░░░░░░░░░    4.66s  FIXED ✓
  GitHub API            ████████████  TCP RESET  ██░░░░░░░░░░    2.66s  FIXED ✓
  Hacker News           ████████████    TIMEOUT  ██░░░░░░░░░░    2.28s  FIXED ✓
  MDN Docs              ████████░░░░     12.01s  ██░░░░░░░░░░    2.30s     5.2×
  Cloudflare            ██░░░░░░░░░░      2.97s  █░░░░░░░░░░░    1.40s     2.1×
  PyPI JSON API         █████░░░░░░░      7.09s  ██░░░░░░░░░░    2.64s     2.7×
  ──────────────────────────────────────────────────────────────────────────────────
  6-Origin Burst:    19.13s (3/6 failed)  →  5.35s (0/6 failed)   [3.6× faster · -76% TTFB]

Problem

Non-Starlink inflight Wi-Fi usually breaks on three things unrelated to raw bandwidth:

  1. Onboard :443 middleboxes and DNS interception. Cabin gateways intercept :53 DNS and run a transparent :443 split-TCP proxy (PEP) whose state table drops connections under load (Connection reset by peer / TLS timeouts on github.com, api.github.com, package registries). Non-443 TCP ports pass through untouched.
  2. Handshake round-trips (~620 ms per GEO hop). Every new origin normally pays multiple satellite round-trips (DNS + TCP + TLS) before transferring payload bytes.
  3. Cubic congestion collapse. Cabin Wi-Fi packet loss causes standard TCP to halve cwnd repeatedly, leaving most of your per-seat token-bucket cap unused.

How it works

Direct (:443):
  laptop ──▶ cabin DNS + :443 PEP ══(3–4 GEO RTTs)══▶ ground ──▶ origin  (frequent TCP resets)

satmux (:8444):
  laptop ══(12 persistent TCP :8444 BBR + zlib pipes)══▶ ground VM ──(2 ms)──▶ origin

Limits

Setup

1. Ground VM

Rent a small Linux VM ($0.01–$0.03/h, Python 3.9+, open TCP port 8444) close to where the satellite downlinks to fiber. Check curl ipinfo.io on raw cabin Wi-Fi first to see the egress country/ASN:

Pause UDP VPNs (Tailscale/WireGuard) inflight—blocked UDP retry traffic competes for cabin airtime.

2. Run

With a coding agent:

Spin up a temporary Ubuntu VM near my current satellite egress IP, start https://github.com/Th0rgal/satmux on port 8444, connect the local 12-carrier client, enable bin/satmux-macos on, and run bin/satmux-bench.

Or manually:

# 1. Laptop: generate PSK
git clone https://github.com/Th0rgal/satmux.git && cd satmux
openssl rand -hex 32 > mux.psk && chmod 600 mux.psk

# 2. Ground VM: start server
scp satmux.py mux.psk root@<SERVER_IP>:/root/
ssh root@<SERVER_IP> 'nohup env SATMUX_PSK=$(cat /root/mux.psk) python3 /root/satmux.py server --port 8444 >/var/log/satmux.log 2>&1 &'

# 3. Laptop: start client + enable macOS / git / gh routing
SATMUX_PSK=$(cat mux.psk) python3 satmux.py client --host <SERVER_IP> --port 8444 --carriers 12 &
./bin/satmux-macos on <SERVER_IP>

Benchmark or run parallel range downloads:

./bin/satmux-bench
./bin/satmux-get https://example.com/archive.tar.gz

3. Teardown after landing

./bin/satmux-macos off

Restores macOS Wi-Fi proxy settings, ~/.gitconfig, gh http_unix_socket, and launchctl env vars, then destroy the temporary VM.

License

MIT

satmux (Th0rgal/satmux)

Ищем в базе…

1.1K ·GitHub
Что это такое?satmux — это мультиплексор TCP и ретранслятор HTTP/TLS с задержкой 1-RTT, который ускоряет медленный и теряющий пакеты геостационарный бортовой Wi-Fi в самолёте, поддерживая открытыми «прогретые» соединения с сервером рядом с наземной станцией.
Это приложение, которое я устанавливаю, или сервер, который я запускаю?И то, и другое: локальный клиент на вашем Mac слушает 127.0.0.1:1080 (SOCKS5) и 127.0.0.1:8080 (HTTP CONNECT) и подключается к ретранслятору, который вы запускаете на временной виртуальной машине Ubuntu.
Как это запустить?Запустите временную виртуальную машину Ubuntu рядом с текущим IP-адресом выхода спутниковой связи, запустите сервер на порту 8444, подключите локальный клиент с 12 «несущими» соединениями, затем включите bin/satmux-macos on и запустите bin/satmux-bench для измерений.
Нужно ли устанавливать что-то ещё?Достаточно Python 3, так как проект написан только на стандартной библиотеке без внешних зависимостей. Также нужна собственная виртуальная машина Ubuntu рядом с наземной станцией, потому что ретранслятор работает там.
Что нужно откатить потом?Завершающий шаг возвращает настройки прокси Wi-Fi в macOS, ~/.gitconfig, httpunixsocket у gh и переменные окружения launchctl, а затем уничтожает временную виртуальную машину. Если его пропустить, Mac может остаться направленным на прокси, которого уже нет.
Подходит ли это и для Starlink?Нет: README ориентирован на GEO-каналы, не относящиеся к Starlink, такие как Inmarsat GX, Viasat, Panasonic и SITA, а замеры проводились на Inmarsat GX в диапазоне Ka-band.
Работает ли это на ноутбуках с Windows?В README описаны только клиент для macOS (bin/satmux-macos) и сервер на Ubuntu, о Windows там ничего не сказано.
Мой трафик проходит через сервер, которым я управляю?Да: потоки идут через Linux-виртуальную машину, которую вы запускаете рядом с наземной станцией спутниковой связи, и на шаге отката эта машина уничтожается после посадки.
Почему полёты на GEO так медленно загружают github.com?Бортовые шлюзы перехватывают DNS и запускают прокси split-TCP на :443, который разрывает соединения под нагрузкой. Каждая задержка туда-обратно через спутник (около 620 мс) суммируется при рукопожатиях DNS, TCP и TLS.
Как он обходит прокси :443 в салоне?Его пул носителей работает на порту 8444, который проходит без изменений. Он держит 12 прогретых TCP-соединений с Linux-виртуальной машиной и направляет каждый поток на наименее загруженное из них.
Как он справляется с потерями пакетов в Wi-Fi салона?Стандартный Cubic при каждой потере снова и снова вдвое сокращает окно и впустую расходует ваш лимит на место. satmux использует прогретые соединения BBR, которые стремятся задействовать больше этого лимита token-bucket.
Какие есть похожие проекты?mtproto.zig, MasterHttpRelayVPN-RUST, gost, goproxy, smartdns, shadowsocks-rust, cfnew, kcp
Автор
Th0rgal
Размер
<0.1 MB
Звёзды
1.1K
Обновлён
КоммитNov 07
Возраст
11 д
Коммиты · 90 дней