justray – modern VPN client for the terminal

justray is a modern VPN client designed around terminal workflows. It combines an interactive text interface with command-line controls, while a background daemon maintains the active connection.

The software is built around sing-box and supports both individual proxy links and subscription feeds. This gives users a single interface for managing multiple connection types and remote nodes without relying on separate clients for each protocol. It is particularly suited to users who prefer keyboard-driven administration and want both interactive and scriptable control over their VPN configuration.

This is free and open source software.

Key Features

• Supports VMess, VLESS, Trojan, Shadowsocks, Hysteria, TUIC, AnyTLS, SOCKS5, WireGuard, and other protocols.
• Imports subscriptions from raw links and Clash/Mihomo YAML configurations.
• Offers TUN and proxy operating modes.
• Provides a keyboard-driven TUI for browsing and selecting nodes.
• Includes CLI commands for connecting, disconnecting, checking status, and managing subscriptions.
• Can test individual nodes or probe all available nodes.
• Lets users reorder subscriptions from the interface.
• Supports refreshing individual subscriptions or all subscriptions together.
• Provides filtering for quickly locating nodes.
• Lets users add and remove subscriptions and routing rules.
• Includes configurable DNS and routing behaviour.
• Supports HTTP endpoints and DNS over HTTPS.
• Maintains connection state through a separate daemon.
• Cross-platform support – runs on Linux, macOS, and Windows.

Website: github.com/luynrs/justray
Support:
Developer: luynar
License: GNU General Public License v3.0

justray is written in Go. Learn Go with our recommended free books and free tutorials.

Explore our carefully curated directory of recommended free and open source software, covering every major software category. The directory forms part of our extensive collection of articles for Linux enthusiasts. It includes hundreds of detailed reviews, together with free and open source alternatives to proprietary software from companies such as Google, Microsoft, Apple, Adobe, IBM, Cisco, Oracle, and Autodesk. LinuxLinks also covers interesting projects worth exploring, Linux-compatible hardware, free programming books and tutorials, and much more. Know a useful free and open source Linux application that we haven’t covered? Tell us about it using our submission form.