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 comprehensive directory of recommended free and open source software. Our carefully curated collection spans every major software category. This directory is part of our ongoing series of informative articles for Linux enthusiasts. It features hundreds of detailed reviews, along with open source alternatives to proprietary solutions from major corporations such as Google, Microsoft, Apple, Adobe, IBM, Cisco, Oracle, and Autodesk. You’ll also find interesting projects to try, hardware coverage, free programming books and tutorials, and much more. Discovered a useful open source Linux program that we haven’t covered yet? Let us know by completing this form.