sdl-freerdp3(1) sdl-freerdp3 sdl-freerdp3(1)

sdl-freerdp3 - کلاینت SDL برای FreeRDP

sdl-freerdp3 [file] [options] [/v:server[:port]]

برنامهٔ sdl-freerdp3 یک کلاینت پروتکل میزکار از راه دور (RDP) مبتنی بر SDL است که بخشی از پروژهٔ 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]

برنامهٔ کاربردی از راه دور

/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> جایگزین به جای موضوع (subject) گواهی برای تطبیق با گواهی‌های ذخیره‌شده محلی
* 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]

کانال مجازی پویا (DVC)

+dynamic-resolution

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

-encryption

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

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

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

/endpointfedauth:token

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

/f

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

+fipsmode

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

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

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

-fonts

هموارسازی فونت‌ها (ClearType) (پیش‌فرض: فعال)

+force-console-callbacks

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

/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

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

/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

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

-grab-mouse

در دست گرفتن فوکوس ماوس، ارسال تمام رویدادها به سیستم راه دور (پیش‌فرض: فعال)

/h:height

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

-heartbeat

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

/help, /?

نمایش راهنما

+home-drive

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

/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 key)
* remap: نگاشت یک scancode در RDP به دیگری. برای دریافت فهرست نگاشت‌ها از /list:kbd-scancode استفاده کنید. مثال: برای جابه‌جایی 'a' و 's' در یک صفحه‌کلید US: /kbd:remap:0x1e=0x1f,remap:0x1f=0x1e
* pipe: نام یک 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]

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

/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

پویانمایی‌های منو (پیش‌فرض: غیرفعال)

/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]]

بازهدایت دستگاه موازی (parallel)

/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]

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

/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

ضریب مقیاس‌بندی برای برنامه‌های فروشگاه برنامه (پیش‌فرض: 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]

نام میزبان سرور|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

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

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

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

FREERDP_ASKPASS

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

FREERDP_WLROOTS_HACK

در صورت تعریف به صورت 0، ترفند تشخیص چندنمایشگره را کاملاً غیرفعال می‌کند. برای فعال‌سازی آن در نشست‌های تمام‌صفحه روی 1 تنظیم کنید. برای فعال‌سازی در تمام نشست‌ها روی force تنظیم کنید.
هشدار: تنظیم مقدار force تنها برای نشست‌های تمام‌صفحه یا چندنمایشگره کار می‌کند؛ نشست‌های پنجره‌ای رفتار نادرستی از خود نشان خواهند داد!
به طور پیش‌فرض، با ارزیابی XDG_SESSION_DESKTOP و XDG_CURRENT_DESKTOP به تشخیص sway یا سایر کامپوزیتورهای مبتنی بر wlroots رجوع می‌شود.
دلیل منطقی: کامپوزیتورهای مبتنی بر wlroots اطلاعات نمایشگر را به پنجره‌های نامرئی ارائه نمی‌دهند، بنابراین روش مناسبی برای استعلام چیدمان فعلی مانیتورها وجود ندارد.
با فعال بودن این ترفند، روش جایگزین در پیش گرفته شده و تلاش می‌شود تفکیک‌پذیری‌ها از طریق استعلام جزئیات مقیاس‌بندی و تفکیک‌پذیری نمایشگر که قابلیت اطمینان کمتری دارند، تعیین شوند.

قالب و مکان:

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

متغیر محیطی XDG_CONFIG_HOME می‌تواند برای تغییر دایرکتوری پایه استفاده شود.

مقدار پیش‌فرض آن ~/.config است. مکان فایل نسبت به XDG_CONFIG_HOME برابر است با $XDG_CONFIG_HOME/freerdp/sdl-freerdp.json

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

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

SDL_KeyModMask

ترکیب کلیدهای مورد نیاز برای کلیدهای میانبر کلاینت SDL را تعریف می‌کند.

پیش‌فرض KMOD_RSHIFT

آرایه‌ای از رشته‌های SDL_Keymod همان‌طور که در https://wiki.libsdl.org/SDL3/SDL_Keymod تعریف شده است.
برای غیرفعال کردن کلیدهای میانبر از KEYMOD_NONE استفاده کنید

SDL_Fullscreen

حالت تمام‌صفحه کلاینت را تغییر می‌دهد.

پیش‌فرض SDL_SCANCODE_RETURN.

رشته‌ای همان‌طور که در https://wiki.libsdl.org/SDL3/SDL_Scancode تعریف شده است.

SDL_Minimize

پنجره کلاینت را کمینه می‌کند

پیش‌فرض SDL_SCANCODE_M.

رشته‌ای همان‌طور که در https://wiki.libsdl.org/SDL3/SDL_Scancode تعریف شده است.

SDL_Resizeable

وضعیت تغییرپذیری اندازه پنجره محلی را تغییر می‌دهد.

پیش‌فرض SDL_SCANCODE_R.

رشته‌ای همان‌طور که در https://wiki.libsdl.org/SDL3/SDL_Scancode تعریف شده است.

SDL_Grab

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

پیش‌فرض SDL_SCANCODE_G.

رشته‌ای همان‌طور که در https://wiki.libsdl.org/SDL3/SDL_Scancode تعریف شده است.

SDL_Disconnect

اتصال از نشست RDP را قطع می‌کند.

پیش‌فرض SDL_SCANCODE_D.

رشته‌ای همان‌طور که در https://wiki.libsdl.org/SDL3/SDL_Scancode تعریف شده است.

قالب و مکان:

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

مکان تنظیمات مشترک گواهی عبارت است از: /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

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

مکان پیکربندی کلاینت SDL3 عبارت است از: /etc/FreeRDP/sdl-freerdp.json

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

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

isUserConfigEnabled

JSON boolean

مجاز یا مسدود کردن پشتیبانی از فایل پیکربندی به ازای هر کاربر.

تمام گزینه‌های سطح کاربر از CONFIGURATION FILE نیز می‌توانند در اینجا تنظیم شوند

sdl-freerdp3 connection.rdp /p:Pwd123! /f

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

sdl-freerdp3 /u:USER /size:50%h /v:rdp.contoso.com

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

sdl-freerdp3 /u:CONTOSO\\JohnDoe /p:Pwd123! /v:rdp.contoso.com

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

sdl-freerdp3 /u:JohnDoe /p:Pwd123! /w:1366 /h:768 /v:192.168.1.100:4489

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

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

برقراری اتصال به میزبان 192.168.1.100 با کاربر JohnDoe، گذرواژهٔ Pwd123! و اتصال به کنسول Hyper-V (استفاده از درگاه 2179، غیرفعال‌سازی مذاکره) با شناسه ماشین مجازی (VMID) 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

http://www.freerdp.com

تیم FreeRDP

2026-09-03 freerdp