Příkazová řádka na počítači
Sestavení DR-Terminalu pro počítač přináší rozhraní příkazové řádky. Užitečné pro integrace s IDE, skriptování a automatizaci.
Použití
DR-Terminal connect <target> [flags]
- target — nejprve se vyhodnotí jako název uloženého připojení (bez ohledu na velikost písmen), poté se porovná s uloženými připojeními podle
host[:port](zúženo přepínačem-u, pokud je zadán) a nakonec se parsuje jakohost[:port]pro ad-hoc relaci. Shoda s uloženým připojením převezme jeho motiv, skupinu a uložené přihlašovací údaje.
Přepínače
| Přepínač | Popis |
|---|---|
-u, --user | Uživatelské jméno (pro cíle host:port). |
-p, --password | Heslo na příkazové řádce (nebezpečné — může se dostat do historie shellu). |
--password-stdin | Čte heslo ze stdin (bezpečné: pass show server | DR-Terminal ...). Pouze s --exec. |
-i, --identity | Soubor soukromého klíče (PEM). Pouze s --exec. |
-j, --jump | Řetězec jump hostů podle názvu, např. bastion1,bastion2. |
-c, --command | Úryvek shellu: vložený po přihlášení (výchozí) nebo spuštěný bezhlavě s --exec. |
--new-tab | Vynutí otevření nové karty v běžící instanci. |
--exec | Bezhlavě: spustí příkaz, streamuje stdout/stderr, ukončí se s návratovým kódem vzdáleného procesu. |
-h, --help | Zobrazí tuto nápovědu. |
-i a --password-stdin platí pouze pro bezhlavé spuštění s --exec. Při otevírání karty v grafickém rozhraní se pro ověření použijí přihlašovací údaje uloženého připojení nebo běžné výzvy v aplikaci.
Příklady
# Open a new tab in the running instance and log into saved "lager"
DR-Terminal connect lager --new-tab
# Ad-hoc host with user — the app prompts for credentials
DR-Terminal connect 10.0.0.1:22 -u pi --new-tab
# Jump chain: bastion1 → bastion2 → target
DR-Terminal connect production -j bastion1,bastion2 --new-tab
# Headless exec with a key file — prints uptime and exits
DR-Terminal connect 10.0.0.1:22 -u pi -i ~/.ssh/id_ed25519 --exec -c 'uptime'
# CLI start script: run commands after login
DR-Terminal connect dev --new-tab -c 'cd /srv/app && tmux attach -t main'
Místní terminál z příkazové řádky
DR-Terminal local [přepínače]
Otevře novou kartu Místního terminálu v grafickém rozhraní (a spustí aplikaci, pokud neběží) a volitelně napíše příkaz do připraveného shellu. Shell zůstává po dokončení příkazu interaktivní — karta je běžná lokální relace.
| Přepínač | Popis |
|---|---|
-t, --type | Shell k otevření: system, cmd, powershell, pwsh, wsl nebo wsl:<distribuce>. Vynechán: lokální shell nastavený v Nastavení — tentýž, který otevírá tlačítko Místní terminál. Volba platí jen pro tuto kartu. |
-c, --command | Napíše se do shellu nové karty, jakmile je připravený — nikdy do relace, která byla zrovna aktivní. |
--cwd | Pracovní adresář shellu. Vynechán: adresář, ze kterého bylo CLI vyvoláno, takže relativní cesty v --command ukazují na stejné soubory bez ohledu na to, zda aplikace už běžela. |
cmd, powershell, pwsh a wsl jsou shelly Windows; na jiných systémech použijte --type system, nebo shell nastavte v Nastavení.
# Default local shell, run a script from the current directory
DR-Terminal local --command "python3 aaaa.py"
# Windows: force CMD and a working directory with spaces
DR-Terminal.exe local --type cmd --cwd "C:\projekty\demo" --command "python3 aaaa.py"
# Just open a WSL tab in a picked distribution
DR-Terminal local --type wsl:Ubuntu-24.04
Symbolický odkaz do PATH
Po instalaci DR-Terminalu vytvořte symbolický odkaz, aby příkaz fungoval globálně:
sudo ln -s /path/to/DR-Terminal/bin/DR-Terminal /usr/local/bin/dr-terminal
dr-terminal connect lager --exec -c 'df -h'
Jediná instance
DR-Terminal udržuje jednu instanci na uživatele (doménový soket Unix nebo pojmenovaná roura na Windows). Druhé DR-Terminal connect ... nebo DR-Terminal local ... předá své argumenty běžící instanci a ukončí se — běžící instance pak otevře novou kartu.