.nh
.TH "UPTERM" "1" "May 2026" "Upterm 0.0.0+dev" "Upterm Manual"

.SH "نام (NAME)"
upterm-host \- میزبانی یک نشست ترمینال


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


.SH "توضیحات (DESCRIPTION)"
میزبانی یک نشست ترمینال از طریق یک تونل معکوس SSH به کارساز Upterm.

.PP
این نشست ورودی/خروجی (IO) میزبان و کلاینت را به ورودی/خروجی یک دستور پیوند می‌دهد. احراز هویت با کارساز Upterm از کلیدهای خصوصی به این ترتیب استفاده می‌کند:
  1. فایل‌های کلید خصوصی: ~/.ssh/id_dsa، ~/.ssh/id_ecdsa، ~/.ssh/id_ed25519، ~/.ssh/id_rsa
  2. کلیدهای SSH Agent
  3. کلید موقت خودکار تولیدشده (در صورت نیافتن هیچ کلیدی)

.PP
برای مجاز کردن اتصالات کلاینت، از \-\-authorized\-keys برای مشخص کردن فایل authorized_keys حاوی کلیدهای عمومی کلاینت استفاده کنید.


.SH "گزینه‌ها (OPTIONS)"
\fB--accept\fP[=false]
	پذیرش خودکار اتصالات کلاینت بدون نیاز به اعلان و تایید.

.PP
\fB--allow-local-tcp-forwarding\fP[=false]
	اجازه دادن به کلاینت‌ها برای استفاده از فوروارد محلی TCP در SSH (دستور ssh -L) از طریق نشست میزبانی‌شده، جهت دسترسی به مقصدهای TCP قابل مشاهده برای میزبان.

.PP
\fB--authorized-keys\fP=""
	مشخص کردن یک فایل authorize_keys حاوی فهرست کلیدهای عمومی مجاز برای اتصال.

.PP
\fB--codeberg-user\fP=[]
	مجاز کردن کاربران مشخص‌شدهٔ Codeberg با اجازه دادن به اتصال کلیدهای عمومی آن‌ها.

.PP
\fB-f\fP, \fB--force-command\fP=""
	اجبار یک دستور مشخص برای پیوستن کلاینت‌ها، و پیوند دادن ورودی/خروجی دستور به ترمینال کلاینت.

.PP
\fB--github-user\fP=[]
	مجاز کردن کاربران مشخص‌شدهٔ GitHub با اجازه دادن به اتصال کلیدهای عمومی آن‌ها. متغیرهای محیطی GitHub CLI را در صورت نیاز پیکربندی کنید؛ برای جزئیات به https://cli.github.com/manual/gh_help_environment مراجعه نمایید.

.PP
\fB--gitlab-user\fP=[]
	مجاز کردن کاربران مشخص‌شدهٔ GitLab با اجازه دادن به اتصال کلیدهای عمومی آن‌ها.

.PP
\fB-h\fP, \fB--help\fP[=false]
	راهنمای دستور host.

.PP
\fB--hide-client-ip\fP[=false]
	مخفی کردن نشانی‌های IP کلاینت از خروجی (به‌طور خودکار در محیط‌های CI فعال است).

.PP
\fB--known-hosts\fP="/build/.ssh/known_hosts"
	مشخص کردن فایلی شامل کلیدهای شناخته‌شده برای میزبان‌های دوردست (الزامی).

.PP
\fB--no-sftp\fP[=false]
	غیرفعال کردن انتقال فایل از طریق SFTP/SCP. به‌طور پیش‌فرض، کلاینت‌ها می‌توانند با همان سطح دسترسی نشست ترمینال فایل‌ها را انتقال دهند.

.PP
\fB-i\fP, \fB--private-key\fP=[]
	مشخص کردن فایل‌های کلید خصوصی برای احراز هویت با کلید عمومی در کارساز upterm (الزامی).

.PP
\fB-r\fP, \fB--read-only\fP[=false]
	میزبانی یک نشست فقط‌خواندنی، و جلوگیری از تعامل کلاینت. همچنین SFTP را به حالت فقط‌دانلود محدود می‌کند.

.PP
\fB--server\fP="ssh://uptermd.upterm.dev:22"
	مشخص کردن نشانی کارساز upterm (الزامی). پروتکل‌های پشتیبانی‌شده: ssh، ws، wss.

.PP
\fB--skip-host-key-check\fP[=false]
	پذیرش خودکار کلیدهای میزبان ناشناختهٔ کارساز و افزودن آن‌ها به known_hosts (مشابه گزینهٔ StrictHostKeyChecking=accept-new در SSH). این گزینه راستی‌آزمایی کلید میزبان را برای اتصالات جدید نادیده می‌گیرد.

.PP
\fB--srht-user\fP=[]
	مجاز کردن کاربران مشخص‌شدهٔ SourceHut با اجازه دادن به اتصال کلیدهای عمومی آن‌ها.


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


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

  # پذیرش خودکار اتصالات کلاینت بدون نیاز به اعلان:
  upterm host --accept

  # میزبانی یک نشست ترمینال با اجازهٔ اتصال تنها به کلید(های) عمومی مشخص‌شده:
  upterm host --authorized-keys PATH_TO_AUTHORIZED_KEY_FILE

  # میزبانی نشستی که یک دستور سفارشی را اجرا می‌کند:
  upterm host -- docker run --rm -ti ubuntu bash

  # میزبانی یک نشست 'tmux new -t pair-programming'، و اجبار کلاینت‌ها به پیوستن با 'tmux attach -t pair-programming':
  upterm host --force-command 'tmux attach -t pair-programming' -- tmux new -t pair-programming

  # اجازه به کلاینت‌ها برای استفاده از فوروارد محلی TCP در SSH (دستور ssh -L) از طریق نشست میزبانی‌شده:
  upterm host --allow-local-tcp-forwarding

  # استفاده از یک کارساز Uptermd متفاوت و میزبانی یک نشست از طریق WebSocket:
  upterm host --server wss://YOUR_UPTERMD_SERVER -- YOUR_COMMAND
.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBupterm(1)\fP


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