.nh
.TH "UPTERM" "1" "مه ۲۰۲۶" "Upterm 0.0.0+dev" "راهنمای Upterm"

.SH "نام (NAME)"
upterm \- اشتراک‌گذاری آنی نشست ترمینال


.SH "خلاصه دستور (SYNOPSIS)"
\fBupterm [flags]\fP


.SH "توضیحات (DESCRIPTION)"
ابزار Upterm یک راهکار متن‌باز برای اشتراک‌گذاری آنی نشست‌های ترمینال بر روی تونل‌های امن SSH در بستر اینترنت عمومی است.

.PP
اولویت پیکربندی (از بالاترین به پایین‌ترین):
  ۱. گزینه‌های خط فرمان
  ۲. متغیرهای محیطی (با پیشوند UPTERM_)
  ۳. فایل پیکربندی (به بخش زیر مراجعه کنید)
  ۴. مقادیر پیش‌فرض

.PP
فایل پیکربندی:
  ~/.config/upterm/config.yaml (لینوکس)
  ~/Library/Application Support/upterm/config.yaml (مک‌او‌اس)
  %LOCALAPPDATA%\\upterm\\config.yaml (ویندوز)

.PP
برای مشاهدهٔ محل فایل پیکربندی خود، دستور 'upterm config path' را اجرا کنید.
  برای ایجاد و ویرایش فایل پیکربندی، دستور 'upterm config edit' را اجرا کنید.

.PP
متغیرهای محیطی:
  تمامی گزینه‌ها را می‌توان از طریق متغیرهای محیطی با پیشوند UPTERM_ تعیین کرد.
  نام گزینه‌ها با جایگزینی خط تیره (-) با زیرخط (_) تبدیل می‌شوند.

.PP
مثال‌ها:
    --hide-client-ip  → UPTERM_HIDE_CLIENT_IP=true
    --read-only       → UPTERM_READ_ONLY=true
    --accept          → UPTERM_ACCEPT=true


.SH "گزینه‌ها (OPTIONS)"
\fB--debug\fP[=false]
	فعال‌سازی ثبت گزارش در سطح اشکال‌زدایی (فایل گزارش: /build/.upterm/upterm.log).

.PP
\fB-h\fP, \fB--help\fP[=false]
	نمایش راهنمای upterm


.SH "مثال‌ها (EXAMPLES)"
.EX
  # میزبانی یک نشست ترمینال در حال اجرای $SHELL و اتصال ورودی/خروجی کلاینت به میزبان:
  $ upterm host

  # نمایش رشتهٔ اتصال SSH جهت اشتراک‌گذاری با کلاینت(ها):
  $ upterm session current
  === SESSION_ID
  Command:                /bin/bash
  Force Command:          n/a
  Host:                   ssh://uptermd.upterm.dev:22
  SSH Session:            ssh TOKEN@uptermd.upterm.dev

  # اتصال یک کلاینت به نشست میزبان از طریق SSH:
  $ ssh TOKEN@uptermd.upterm.dev

  # تنظیم گزینه‌ها از طریق متغیرهای محیطی:
  $ UPTERM_HIDE_CLIENT_IP=true upterm host
.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBupterm-config(1)\fP, \fBupterm-host(1)\fP, \fBupterm-proxy(1)\fP, \fBupterm-session(1)\fP, \fBupterm-upgrade(1)\fP, \fBupterm-version(1)\fP


.SH "تاریخچه (HISTORY)"
۶ مه ۲۰۲۶ تولید خودکار توسط spf13/cobra