justray

A modern VPN client that lives in your terminal

Features

• Modern protocols: VMess, VLESS, Trojan, Shadowsocks, Hysteria1/2, TUIC, AnyTLS, SOCKS5 and more
• Flexible: subscriptions from raw links or Clash/Mihomo YAML, auto-refreshing and a wide list of settings
• Lightweight: up to ~50 MB of RAM on unix-based systems, ~100 MB on Windows
• Crossplatform: runs in every terminal on macOS, Linux and Windows (PowerShell and WSL)

Install

[!TIP] You can re-run the script at any time to update client

irm https://raw.githubusercontent.com/luynrs/justray/main/install.ps1 | iex

curl -fsSL https://raw.githubusercontent.com/luynrs/justray/main/install.sh | sh

nix run github:luynrs/justray

# flake.nix
{ inputs.justray.url = "github:luynrs/justray"; }

# home-manager: justrayd as a systemd --user service
{
  imports = [ justray.homeManagerModules.default ];
  services.justray.enable = true;
}

curl -fsSL https://raw.githubusercontent.com/luynrs/justray/main/install.sh | sh

nix run github:luynrs/justray

Usage

If justray is installed via a script or package manager, the jray alias is available.

jray: open the TUI

Connection

• jray up <node> [--tun | --proxy]: start the daemon
• jray down: disconnect and shut down
• jray status: show connection status

Subscriptions

jray subscription or jray sub

• add: add a subscription or raw protocol link
• remove: remove a subscription or node by ID
• list: list subscriptions and nodes

Options

• -h, --help: show help
• -v, --version: show the current version

License

GPL-3.0