UPTERM(1) Upterm Manual UPTERM(1)

upterm-host - میزبانی یک نشست ترمینال

upterm host [flags]

میزبانی یک نشست ترمینال از طریق یک تونل معکوس SSH به کارساز Upterm.

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

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

--accept[=false] پذیرش خودکار اتصالات کلاینت بدون نیاز به اعلان و تایید.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

# میزبانی یک نشست ترمینال در حال اجرای $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

upterm(1)

۶ مه ۲۰۲۶ به‌صورت خودکار توسط spf13/cobra تولید شد

May 2026 Upterm 0.0.0+dev