An open-source Looking Glass with a master/slave architecture, written in Go. The master provides a web UI for selecting a slave, viewing its IPv4/IPv6 addresses, running network tools (ping, mtr, traceroute, iperf3), and downloading test files.
- 🖥️ Web UI in the style of shadcn (Tailwind CSS).
- 🐳 Master and Slave written in Go, packaged in separate Docker images.
- 📡 Streaming command output via Server-Sent Events.
- 📊 Real-time network interface traffic charts (RX/TX area charts).
- 📁 Test files: 1M, 10M, 100M, 1G, 10G, 100G (configurable).
- 🚀 Ready-to-use images built via GitHub Actions and published to GHCR.
A live Looking Glass demo is available as the ApexNodes hosting page: https://cuttlefish.apexnodes.xyz/
The installer is interactive. It installs Docker, generates tokens, optionally sets up Nginx with SSL, and configures the master or slave for you. It reads prompts from /dev/tty, so it works through curl | bash.
sudo bash -c "$(curl -sSL https://raw.githubusercontent.com/trusted-technologies/cuttlefish/main/scripts/install.sh)"Run the same installer again and choose Update existing installation or Uninstall from the menu.
For manual Docker commands, Docker Compose examples, environment variables and building from source, see INSTALL.md.
- Master — web server and slave registry.
- Slave — agent that registers with the master and executes network commands.
- Communication between master and slave uses HTTP/REST.
MIT — see LICENSE.