xfreerdp3(1) xfreerdp3 xfreerdp3(1)

xfreerdp3 - کلاینت X11 برای FreeRDP

xfreerdp3 [file] [options] [/v:server[:port]]

xfreerdp3 یک کلاینت پروتکل میزکار از راه دور (RDP) تحت سامانه پنجره‌بندی X11 است که بخشی از پروژه FreeRDP به شمار می‌رود. سرور RDP به صورت پیش‌ساخته در بسیاری از نسخه‌های Windows تعبیه شده است. سرورهای جایگزین شامل ogon، gnome-remote-desktop، xrdp و VRDP (در VirtualBox) هستند.

/a:addin[,options], /addin:addin[,options]

افزونه (Addin)

/azure:[tenantid:id],[use-tenantid[:[on|off]],[ad:url][avd-access:format string],[avd-token:format string],[avd-scope:format string]

گزینه‌های AzureAD

/action-script:file-name

اسکریپت اقدام (پیش‌فرض:~/.config/freerdp/action.sh)

/admin, /console

نشست مدیریتی (یا کنسول)

+aero

ترکیب پنجره‌های میزکار (desktop composition) (پیش‌فرض:off)

/app:program:[path|||alias],cmd:command,file:filename,guid:guid,icon:filename,name:name,workdir:directory,hidef:[on|off]

برنامه کاربردی راه دور (Remote application)

/assistance:password

گذرواژه کمک از راه دور (Remote assistance)

/auto-request-control:

درخواست خودکار کنترل ورودی برای کمک از راه دور

+async-channels

کانال‌های ناهمگام (آزمایشی) (پیش‌فرض:off)

+async-update

به‌روزرسانی ناهمگام (پیش‌فرض:off)

/audio-mode:[[none|2]|[server|1]|[redirect|0]]

حالت خروجی صوتی

+auth-only

فقط احراز هویت (پیش‌فرض:off)

/auth-pkg-list:[[none],]!ntlm,kerberos,!u2u

فیلتر بسته‌های احراز هویت (فهرست جداشده با کاما، استفاده از '!' برای غیرفعال‌سازی). به طور پیش‌فرض همه روش‌ها فعال هستند. استفاده از مقدار صریح 'none' به عنوان اولین آرگومان تمام روش‌ها را غیرفعال کرده و تنها مواردی که پس از آن می‌آیند فعال می‌شوند.

-authentication

احراز هویت (آزمایشی) (پیش‌فرض:on)

+auto-reconnect

اتصال مجدد خودکار (پیش‌فرض:off)

/auto-reconnect-max-retries:retries

حداکثر تلاش‌ها برای اتصال مجدد خودکار، مقدار 0 برای نامحدود [0,1000]

/bpp:depth

عمق رنگ نشست یا bpp (پیش‌فرض:16)

/buildconfig

چاپ پیکربندی ساخت نرم‌افزار

/cache:[bitmap[:on|off],codec[:rfx|nsc],glyph[:on|off],offscreen[:on|off],persist,persist-file:filename]

/cert:[deny,ignore,name:name,tofu,fingerprint:hash:hash as hex[,fingerprint:hash:another hash]]

گزینه‌های پذیرش گواهی‌نامه. با احتیاط استفاده شود!
* deny ... قطع خودکار اتصال در صورت عدم تطابق گواهی‌نامه، بدون دخالت کاربر.
* ignore ... نادیده گرفتن کلی بررسی‌های گواهی‌نامه (بر تمام گزینه‌های دیگر اولویت دارد).
* name ... استفاده از <name> جایگزین به جای موضوع گواهی‌نامه جهت تطبیق با گواهی‌نامه‌های محلی ذخیره‌شده.
* tofu ... پذیرش بدون قید و شرط گواهی‌نامه در نخستین اتصال و رد آن در اتصالات بعدی در صورت عدم تطابق.
* fingerprints ... فهرستی از هش‌های گواهی‌نامه که بدون قید و شرط برای اتصال پذیرفته می‌شوند.

/client-build-number:number

شماره ساخت کلاینت ارسالی به سرور (بر رفتار کارت هوشمند تأثیر می‌گذارد، [MS-RDPESC] را ببینید)

/client-hostname:name

نام میزبان کلاینت برای ارسال به سرور

/clipboard:[[use-selection:atom],[direction-to:[all|local|remote|off]],[files-to[:all|local|remote|off]]]

بازهدایت کلیپ‌بورد:
* use-selection:<atom> ... (در X11) مشخص کردن گزینش X برای دسترسی. پیش‌فرض CLIPBOARD است. مقدار PRIMARY گزینش به سبک کلیک میانی در X است.
* direction-to:[all|local|remote|off] کنترل جهت فعال انتقال کلیپ‌بورد
* files-to:[all|local|remote|off] کنترل جهت فعال انتقال فایل‌ها در کلیپ‌بورد (پیش‌فرض:on)

-compression, -z

فشرده‌سازی (پیش‌فرض:on)

/compression-level:level

سطح فشرده‌سازی (0,1,2)

+credentials-delegation

واگذاری اطلاعات کاربری (پیش‌فرض:off)

/d:domain

دامنه (Domain)

-decorations

تزیینات پنجره (پیش‌فرض:on)

/disp

کنترل نمایشگر

/drive:name,path

بازهدایت مسیر پوشه <path> به عنوان یک اشتراک نام‌گذاری‌شده با عنوان <name>. پشتیبانی از اتصال حین کار با /drive:hotplug,* فعال می‌شود. این آرگومان عملکردی مشابه گزینه “Drives that I plug in later” در ابزار MSTSC ارائه می‌دهد.

+drives

بازهدایت همه نقاط اتصال به عنوان اشتراک (پیش‌فرض:off)

/dump:record|replay,file:file[,nodelay]

ضبط یا بازپخش دامپ

/dvc:channel[,options]

کانال مجازی پویا (Dynamic virtual channel)

+dynamic-resolution

ارسال به‌روزرسانی‌های وضوح تصویر به هنگام تغییر اندازه پنجره (پیش‌فرض:off) /echo, /echo
کانال Echo

-encryption

رمزنگاری (آزمایشی) (پیش‌فرض: on)

/encryption-methods:[40,][56,][128,][FIPS]

روش‌های رمزنگاری امنیت استاندارد RDP

/endpointfedauth:token

توکن FedAuth نقطه پایانی برای سناریوهای اتصال به کنسول ماشین مجازی Hyper-V

/f

حالت تمام‌صفحه (<Ctrl>+<Alt>+<Enter> وضعیت تمام‌صفحه را تغییر می‌دهد)

+fipsmode

حالت FIPS (پیش‌فرض: off)

/floatbar[:sticky:[on|off],default:[visible|hidden],show:[always|fullscreen|window]]

نوار شناور (floatbar) به‌طور پیش‌فرض غیرفعال است (در صورت فعال‌سازی، به‌طور پیش‌فرض در حالت تمام‌صفحه چسبان/sticky است)

-fonts

فونت‌های هموار (ClearType) (پیش‌فرض: on)

+force-console-callbacks

استفاده از فراخوانی‌های بازگشتی پیش‌فرض (کنسول) برای گواهی/اعتبارنامه/... (پیش‌فرض: off)

/frame-ack:number

تعداد تأییدیه‌های فریم (frame acknowledgement)

/args-from:file:file|stdin|fd:number|env:name

خواندن خط فرمان از یک فایل، stdin یا توصیف‌گر فایل (file descriptor). این آرگومان نمی‌تواند با هیچ آرگومان دیگری ترکیب شود. در هر خط یک آرگومان وارد کنید.

/from-stdin[:force]

خواندن اطلاعات احراز هویت از stdin. با <force> درخواست قبل از اتصال انجام می‌شود، در غیر این صورت به درخواست سرور خواهد بود.

/gateway:g:gateway[:port],u:user,d:domain,p:password,usage-method:[direct|detect],access-token:token,type:[rpc|http[,no-websockets][,extauth-sspi-ntlm]|auto[,no-websockets][,extauth-sspi-ntlm]]|arm,url:wss://url,bearer:oauth2-bearer-token, /gw:g:gateway[:port],u:user,d:domain,p:password,usage-method:[direct|detect],access-token:token,type:[rpc|http[,no-websockets][,extauth-sspi-ntlm]|auto[,no-websockets][,extauth-sspi-ntlm]]|arm,url:wss://url,bearer:oauth2-bearer-token

نام میزبان Gateway

/gdi:sw|hw

رندرینگ GDI

/geometry

کانال ردیابی هندسه (Geometry)

+gestures

پردازش ورودی چندلمسی به‌صورت محلی (پیش‌فرض: off)

/gfx[:[[progressive[:on|off]|RFX[:on|off]|AVC420[:on|off]AVC444[:on|off]],mask:value,small-cache[:on|off],thin-client[:on|off],progressive[:on|off],frame-ack[:on|off]]

خط لوله گرافیکی RDP8

-grab-keyboard

تسخیر فوکوس صفحه‌کلید، هدایت تمام کلیدها به سیستم راه دور (پیش‌فرض: on)

-grab-mouse

تسخیر فوکوس موشواره، هدایت تمام رویدادها به سیستم راه دور (پیش‌فرض: on)

/h:height

ارتفاع (پیش‌فرض: 768)

-heartbeat

پشتیبانی از PDUهای ضربان قلب (heartbeat) (پیش‌فرض: on)

/help, /?

نمایش راهنما

+home-drive

هدایت دایرکتوری خانگی کاربر به‌عنوان اشتراک (پیش‌فرض: off)

/ipv4[:[:force]], /4[:[:force]]

اولویت دادن به رکورد A در IPv4 نسبت به رکورد AAAA در IPv6

/ipv6[:[:force]], /6[:[:force]]

اولویت دادن به رکورد AAAA در IPv6 نسبت به رکورد A در IPv4

/jpeg

پشتیبانی از کُدک JPEG

/jpeg-quality:percentage

کیفیت JPEG

/kbd:[layout:[0xid|name],lang:0xid,fn-key:value,type:value,subtype:value,unicode[:on|off],remap:key1=value1,remap:key2=value2,pipe:filename]

گزینه‌های مربوط به صفحه‌کلید:
* layout: تنظیم طرح‌بندی صفحه‌کلید اعلان‌شده به سرور
* lang: تنظیم شناسه زبان صفحه‌کلید ارسالی به سرور
* fn-key: مقدار کلید Function
* remap: بازنگاشت اسکن‌کد RDP به مقداری دیگر. برای دریافت نگاشت‌ها از /list:kbd-scancode استفاده کنید. مثال: برای جابه‌جایی 'a' و 's' روی یک صفحه‌کلید آمریکایی (US): /kbd:remap:0x1e=0x1f,remap:0x1f=0x1e
* pipe: نام یک لوله نام‌گذاری‌شده (named pipe) که می‌تواند برای نوشتن متن در نشست RDP به کار رود

/kerberos:[kdc-url:url,lifetime:time,start-time:time,renewable-lifetime:time,cache:path,armor:path,pkinit-anchors:path,pkcs11-module:name]

گزینه‌های Kerberos

/load-balance-info:info-string

اطلاعات توازن بار (Load balance info)

/list:[kbd|kbd-scancode|kbd-lang[:value]|smartcard[:[pkinit-anchors:path][,pkcs11-module:name]]|monitor|tune|timezones]

فهرست کردن گزینه‌های موجود برای زیرفرمان (پیش‌فرض: List available options for subcommand)

/log-filters:tag:level[,tag:level[,...]]

تنظیم فیلترهای ثبت وقایع، برای جزئیات wLog(7) را ببینید

/log-level:[OFF|FATAL|ERROR|WARN|INFO|DEBUG|TRACE]

تنظیم سطح پیش‌فرض گزارش‌گیری، برای جزئیات wLog(7) را ببینید

/max-fast-path-size:size

تعیین حداکثر اندازه به‌روزرسانی fast-path

/max-loop-time:time

تعیین حداکثر زمان برحسب میلی‌ثانیه برای پردازش بسته‌ها

+menu-anims

پویانمایی‌های منو (پیش‌فرض: off)

/microphone[:[sys:sys,][dev:dev,][format:format,][rate:rate,][channel:channel]], /mic[:[sys:sys,][dev:dev,][format:format,][rate:rate,][channel:channel]]

ورودی صدا (میکروفون)

/monitors:id[,id[,...]]

[آزمایشی] انتخاب نمایشگرها جهت استفاده (تنها در حالت تمام‌صفحه یا چندنمایشگره مؤثر است) -mouse-motion
ارسال رویدادهای حرکت ماوس (پیش‌فرض: on)

+mouse-relative

ارسال حرکت ماوس با آدرس‌دهی نسبی (پیش‌فرض: off)

/mouse:[relative:[on|off],grab:[on|off]]

گزینه‌های مربوط به ماوس:
* relative: ارسال حرکات نسبی ماوس در صورت پشتیبانی سرور
* grab: به دام انداختن ماوس در صورت قرار داشتن در پنجره

/multimon[:force]

استفاده از چند نمایشگر

+multitouch

بازهدایت ورودی چندلمسی (پیش‌فرض: off)

-multitransport

پشتیبانی از پروتکل multitransport (پیش‌فرض: on)

-nego

مذاکره امنیتی پروتکل (پیش‌فرض: on)

/network:[invalid|modem|broadband|broadband-low|broadband-high|wan|lan|auto]

نوع اتصال شبکه

/nsc, /nscodec

پشتیبانی از NSCodec

/orientation:[0|90|180|270]

جهت‌گیری نمایشگر بر حسب درجه

+old-license

استفاده از جریان کاری قدیمی مجوز (بدون CAL و با تنظیم hwId روی 0) (پیش‌فرض: off)

/p[:password]

گذرواژه. ارسال /p بدون آرگومان در صورتی که نیازی به اطلاعات کاربری برای اتصال نباشد، اعلان‌های تعاملی گذرواژه را غیرفعال می‌کند.

/parallel[:name[,path]]

بازهدایت دستگاه موازی

/parent-window:window-id

شناسه پنجره والد

/pcb:blob

داده باینری پیش‌اتصال (Preconnection Blob)

/pcid:id

شناسه پیش‌اتصال (Preconnection Id)

/pheight:height

ارتفاع فیزیکی نمایشگر (به میلی‌متر)

/play-rfx:pcap-file

پخش مجدد فایل pcap مربوط به rfx

/port:number

پورت سرور

-suppress-output

فرونشانی خروجی هنگام کمینه‌شدن (پیش‌فرض: on)

+print-reconnect-cookie

چاپ کوکی اتصال مجدد base64 پس از اتصال (پیش‌فرض: off)

/printer[:name[,driver[,default]]]

بازهدایت دستگاه چاپگر

/proxy:[proto://][user:password@]host[:port]

تنظیمات پروکسی: نادیده‌گرفتن متغیر محیطی (همچنین متغیر محیطی زیر را ببینید). در حالی که "http" پیش‌فرض است، پروتکل "socks5" باید صریحاً مشخص شود.

/pth:password-hash, /pass-the-hash:password-hash

روش Pass the hash (حالت مدیر محدودشده)

/pwidth:width

عرض فیزیکی نمایشگر (به میلی‌متر)

/rdp2tcp:executable path[:arg...]

بازهدایت TCP

/reconnect-cookie:base64-cookie

ارسال کوکی اتصال مجدد base64 به اتصال

/redirect-prefer:FQDN|IP|NETBIOS,[...]

بازنویسی ترتیب اولویت بازهدایت

/relax-order-checks, /relax-order-checks

بررسی نکردن اعلان شدن دستور RDP در حین تبادل قابلیت‌ها؛ تنها هنگام اتصال به سرورهای دارای باگ استفاده شود

/restricted-admin, /restrictedAdmin

حالت مدیر محدودشده (Restricted admin)

/rfx

RemoteFX

/rfx-mode:[image|video]

حالت RemoteFX

/scale:[100|140|180]

ضریب مقیاس‌بندی نمایشگر (پیش‌فرض: 100)

/scale-desktop:percentage

ضریب مقیاس‌بندی برای برنامه‌های میزکار (مقداری بین 100 و 500) (پیش‌فرض: 100)

/scale-device:100|140|180

ضریب مقیاس‌بندی برای برنامه‌های app store (پیش‌فرض: 100)

/sec:rdp[:[on|off]]|tls[:[on|off]]|nla[:[on|off]]|ext[:[on|off]]|aad[:[on|off]]

اجبار امنیت پروتکل مشخص. به عنوان مثال /sec:nla پروتکل NLA را فعال و سایر موارد را غیرفعال می‌کند، در حالی که /sec:nla:[on|off] صرفاً وضعیت NLA را تغییر می‌دهد

/serial[:name[,path[,driver[,permissive]]]], /tty[:name[,path[,driver[,permissive]]]]

بازهدایت دستگاه سریال

/server-name:name

نام سرور تعیین‌شده توسط کاربر جهت اعتبارسنجی (TLS, Kerberos)

/shell:shell

پوسته جایگزین

/shell-dir:dir

دایرکتوری کاری پوسته /size:widthxheight یا percent%[wh]
اندازه صفحه نمایش (پیش‌فرض: 1024x768)

/smart-sizing[:widthxheight]

مقیاس‌بندی میزکار دوردست به اندازه پنجره

/smartcard[:str[,str...]]

هدایت دستگاه‌های کارت هوشمند که نام آن‌ها حاوی هر یک از <str> باشد.

/smartcard-logon[:[[cert:path|cert:base64(PEM)],[key:path|key:base64(PEM)],pin:pin,csp:csp name,reader:reader,card:card]]

احراز هویت ورود به سیستم با کارت هوشمند (گواهی اختیاری) را فعال می‌کند.

/sound[:[sys:sys,][dev:dev,][format:format,][rate:rate,][channel:channel,][latency:latency,][quality:quality]], /audio[:[sys:sys,][dev:dev,][format:format,][rate:rate,][channel:channel,][latency:latency,][quality:quality]]

خروجی صدا (صوت)

/span

گسترش صفحه نمایش روی چند نمایشگر

/spn-class:service-class

کلاس سرویس احراز هویت SPN

/ssh-agent, /ssh-agent

کانال فورواردینگ SSH Agent

/sspi-module:SSPI module path

مسیر فایل ماژول کتابخانه اشتراکی SSPI

/winscard-module:WinSCard module path

مسیر فایل ماژول کتابخانه اشتراکی WinSCard

/disable-output

غیرفعال‌سازی کلیه رمزگشایی‌های گرافیکی در نشست کلاینت. برای آزمون‌های بار با اتصالات هم‌زمان متعدد کاربرد دارد

/t:title, /title:title

عنوان پنجره

-themes

تم‌ها (پیش‌فرض: on)

/timeout:time in ms, /timeout:time in ms

تنظیمات پیشرفته برای پیوندهای با تاخیر بالا: تنظیم مهلت زمانی اتصال؛ در صورت مواجهه با خطای مهلت زمانی در اتصال خود از آن استفاده کنید (پیش‌فرض: 9000)

/timezone:windows timezone

استفاده از منطقه زمانی ویندوزی ارائه‌شده برای اتصال (نیازمند پشتیبانی سرور است)؛ برای مقادیر مجاز /list:timezones را ببینید

/tls:[ciphers|seclevel|secrets-file|enforce]

گزینه‌های پیکربندی TLS: * ciphers:[netmon|ma|<cipher names>]
* seclevel:<level>، پیش‌فرض: 1، بازه: [0-5] بازنویسی سطح امنیت پیش‌فرض TLS، ممکن است برای سرورهای مقصد قدیمی‌تر مورد نیاز باشد. جزئیات در https://docs.openssl.org/3.0/man3/SSL_CTX_set_security_level
* secrets-file:<filename>
* enforce[:[ssl3|1.0|1.1|1.2|1.3]] اجبار به استفاده از نگارش خاصی از SSL/TLS برای یک اتصال. برخی از سرورها دارای مذاکره نگارش TLS باگ‌دار هستند و ممکن است بدون این گزینه اتصال ناموفق باشد. در صورت عدم ارائه آرگومان، پیش‌فرض روی TLS 1.2 قرار می‌گیرد. برای windows 7 از 1.0 استفاده کنید

-toggle-fullscreen

کلید Alt+Ctrl+Enter برای تغییر وضعیت تمام‌صفحه (پیش‌فرض: on)

/tune:setting:value,setting:value

[آزمایشی] دستکاری مستقیم تنظیمات freerdp؛ با احتیاط بسیار زیاد استفاده شود! (پیش‌فرض:)

/u:[[domain]user|user[@domain]]

نام کاربری

+unmap-buttons

اجازه به سرور برای مشاهده دکمه فیزیکی واقعی اشاره‌گر (پیش‌فرض: off)

/usb:[dbg,][id:vid:pid#...,][addr:bus:addr#...,][auto]

هدایت دستگاه USB

/v:server[:port]

hostname|URL|IPv4|IPv6 سرور یا vsock://<number> یا /some/path/to/pipe یا |:1234 جهت ارسال یک سوکت TCP برای استفاده

/vc:channel[,options]

کانال مجازی ایستا

/version

چاپ نسخه

/video

کانال ارتباط از راه دور بهینه‌شده برای ویدیو

/prevent-session-lock[:time in sec]

جلوگیری از قفل شدن نشست با تزریق رویدادهای ساختگی حرکت ماوس به سرور در زمان بیکار بودن اتصال (بازه زمانی پیش‌فرض: 180 ثانیه)

/vmconnect[:vmid]

کنسول Hyper-V (استفاده از درگاه 2179، غیرفعال‌سازی مذاکره)

/w:width

عرض (پیش‌فرض: 1024)

-wallpaper

تصویر پس‌زمینه (پیش‌فرض: on)

+window-drag

کشیدن کامل پنجره (پیش‌فرض: off)

/window-position:xposxypos

موقعیت پنجره

/wm-class:class-name

تنظیم راهنمای WM_CLASS برای نمونه پنجره

/workarea

استفاده از فضای کاری در دسترس

<Right CTRL>

تسخیر صفحه‌کلید و موشواره را رها می‌کند.
اگر صفحه‌کلید در حالت تسخیر باشد، میانبرهای سامانهٔ محلی دیگر کار نکرده و به سامانهٔ دوردست ارسال می‌شوند.
اگر موشواره تسخیر شده باشد (اختیاری)، تشخیص حرکات لمسی محلی کار نمی‌کند و ممکن است موشواره قادر به خروج از پنجرهٔ RDP نباشد. رویدادهای موشواره تغییر داده نمی‌شوند.

<CTRL>+<ALT>+<Return>

وضعیت تمام‌صفحهٔ برنامه را جابه‌جا می‌کند

<CTRL>+<ALT>+<m>

برنامه را کمینه می‌کند

<CTRL>+<ALT>+c

کنترل از راه دور را در یک نشست امداد از راه دور تغییر وضعیت می‌دهد

<CTRL>+<ALT>+<d>

ارتباط نشست را قطع کرده و برنامه را خاتمه می‌دهد

Action Script

با فشردن کلید، یک اسکریپت از پیش تعریف‌شده را اجرا می‌کند. در صورتی که اسکریپت وجود نداشته باشد، نادیده گرفته می‌شود. اسکریپت‌ها را می‌توان در مکان پیش‌فرض $XDG_CONFIG_HOME/freerdp/action.sh یا به عنوان آرگومان خط فرمان /action:script:<path> ارائه داد. اسکریپت ترکیب کلید فعلی را به عنوان آرگومان دریافت خواهد کرد. خروجی اسکریپت برای عبارت key-local پردازش می‌شود که نشان می‌دهد اسکریپت از ترکیب کلید استفاده کرده است، در غیر این صورت ترکیب کلید به سامانهٔ دوردست ارسال می‌شود.

متغیرهای محیطی wlog

برنامهٔ xfreerdp3 از wLog به عنوان ابزار ثبت وقایع خود استفاده می‌کند؛ برای اطلاعات بیشتر می‌توانید به صفحهٔ راهنمای مربوطه (wlog(7)) مراجعه کنید. آرگومان‌های ارسال‌شده از طریق /log-level یا /log-filters بر متغیرهای محیطی ارجحیت دارند.

FREERDP_ASKPASS

تنظیم برنامه‌ای برای درخواست گذرواژه، مشابه با SSH_ASKPASS

قالب و مکان:

فایل‌های پیکربندی در پیکربندی سراسری سامانه ذخیره می‌شوند.

مکان مشترک تنظیمات گواهی /etc/FreeRDP/certificates.json است.

قالب فایل JSON است

گزینه‌های پشتیبانی‌شده:

deny

JSON boolean

رد کردن گواهی در صورتی که بررسی در برابر مخزن SSL سامانه ناموفق باشد

ignore

JSON boolean

نادیده گرفتن خطاهای گواهی؛ صرفاً گواهی نادیده گرفته می‌شود

deny-userconfig

JSON boolean

اگر بررسی‌ها در پیکربندی سراسری گواهی را تأیید نکنند، از کاربر سؤالی پرسیده نشود

certificate-db

JSON array

آرایه‌ای از JSON objects شامل:

type

JSON string

رشته‌ای که الگوریتم درهم‌سازی استفاده‌شده را مشخص می‌کند، به عنوان مثال sha256

hash

JSON string

رشته‌ای از مقادیر عددی صحیح در مبنای شانزده (hex) که نشان‌دهندهٔ درهم‌سازی گواهی هستند، به عنوان مثال 0123456789abcdef

محل پیکربندی کلاینت X11 عبارت است از: /etc/FreeRDP/xfreerdp.json

قالب فایل JSON است

گزینه‌های پشتیبانی‌شده:

isActionScriptAllowed

JSON boolean

مجاز کردن یا مسدود کردن اسکریپت‌های کنش. حالت پیش‌فرض (در صورت تنظیم نشدن گزینه) مجاز دانستن اسکریپت‌های کنش است.

#!/bin/bash
# we got a key combination
if [ "$1" = "key" ];
then
	# we only got one argument 'key'
	# list all supported combinations with echo
	if [ $# -eq 1 ];
	then
		echo "ctrl+alt+f1"
		echo "ctrl+alt+f2"
	else
		# We want the action for a single combination
		# use 'key-local' to not forward to RDP session
		if [ "$2" = "ctrl+alt+f1" ];
		then
			echo "key-local"
		fi
		if [ "$2" = "ctrl+alt+f2" ];
		then
				echo "/usr/local/bin/somescript.sh"
		fi
	fi
fi
if [ "$1" = "xevent" ];
	then
		if [ $# -eq 1 ];
		then
			echo "FocusIn"
			echo "SelectionClear"
		else
			if [ "$2" = "SelectionNotify" ];
			then
				echo "/usr/local/bin/someprogram"
			fi
		fi
	fi
نمونه اسکریپت کنش برای رویدادهای کلید، که مشخص می‌کند ctrl+alt+f1 توسط مدیر پنجرهٔ محلی مدیریت شود و ctrl+alt+f2 یک اسکریپت را اجرا کند

مقدار بازگشتی برنامه مشخص می‌کند که آیا کلید به‌صورت محلی مدیریت شود یا از راه دور (0 برای محلی، > 0 برای دوردست، < 0 برای خطاها)

xfreerdp3 connection.rdp /p:Pwd123! /f

اتصال در حالت تمام‌صفحه با استفاده از پیکربندی ذخیره‌شدهٔ connection.rdp و گذرواژهٔ Pwd123!

xfreerdp3 /u:USER /size:50%h /v:rdp.contoso.com

اتصال به میزبان rdp.contoso.com با کاربر USER و اندازه‌ای برابر با ۵۰ درصد از ارتفاع. اگر به جای ارتفاع (h) پهنا (w) مانند /size:50%w تنظیم شود. ۵۰ درصد از پهنا استفاده می‌شود.

xfreerdp3 /u:CONTOSO\\JohnDoe /p:Pwd123! /v:rdp.contoso.com

اتصال به میزبان rdp.contoso.com با کاربر CONTOSO\\JohnDoe و گذرواژهٔ Pwd123!

xfreerdp3 /u:JohnDoe /p:Pwd123! /w:1366 /h:768 /v:192.168.1.100:4489

اتصال به میزبان 192.168.1.100 روی درگاه 4489 با کاربر JohnDoe، گذرواژهٔ Pwd123!. پهنای صفحه روی 1366 و ارتفاع آن روی 768 تنظیم شده است.

xfreerdp3 /u:JohnDoe /p:Pwd123! /vmconnect:C824F53E-95D2-46C6-9A18-23A5BB403532 /v:192.168.1.100

برقراری ارتباط با میزبان 192.168.1.100 با کاربر JohnDoe، گذرواژهٔ Pwd123! و اتصال به کنسول Hyper-V (استفاده از درگاه 2179، غیرفعال‌سازی مذاکره) با شناسهٔ ماشین مجازی C824F53E-95D2-46C6-9A18-23A5BB403532

+clipboard

فعال‌سازی بازهدایت کلیپ‌بورد

/drive:home,/home/user

فعال‌سازی بازهدایت درایو /home/user به عنوان درایو خانه (home)

/smartcard:<device>

فعال‌سازی بازهدایت کارت هوشمند برای دستگاه device

/printer:<device>,<driver>

فعال‌سازی بازهدایت چاپگر برای چاپگر device با استفاده از درایور driver

/serial:<device>

فعال‌سازی بازهدایت درگاه سریال برای درگاه device

/parallel:<device>

فعال‌سازی بازهدایت درگاه موازی برای درگاه device

/sound:sys:alsa

فعال‌سازی بازهدایت خروجی صوتی با استفاده از دستگاه sys:alsa

/microphone:sys:alsa

فعال‌سازی بازهدایت ورودی صوتی با استفاده از دستگاه sys:alsa

/multimedia:sys:alsa

فعال‌سازی بازهدایت چندرسانه‌ای با استفاده از دستگاه sys:alsa

/usb:id,dev:054c:0268

فعال‌سازی بازهدایت دستگاه USB برای دستگاه مشخص‌شده با 054c:0268

/kbd:remap:29=58,remap:58=29

جابه‌جایی کلید Control چپ (29) و Caps Lock (58).

http://www.freerdp.com

تیم FreeRDP

2026-09-03 freerdp