| xfreerdp3(1) | xfreerdp3 | xfreerdp3(1) |
نام (NAME)
xfreerdp3 - کلاینت X11 برای FreeRDP
خلاصه دستور (SYNOPSIS)
xfreerdp3 [file] [options] [/v:server[:port]]
توضیحات (DESCRIPTION)
xfreerdp3 یک کلاینت پروتکل میزکار از راه دور (RDP) تحت سامانه پنجرهبندی X11 است که بخشی از پروژه FreeRDP به شمار میرود. سرور RDP به صورت پیشساخته در بسیاری از نسخههای Windows تعبیه شده است. سرورهای جایگزین شامل ogon، gnome-remote-desktop، xrdp و VRDP (در VirtualBox) هستند.
گزینهها (OPTIONS)
/a:addin[,options], /addin:addin[,options]
/azure:[tenantid:id],[use-tenantid[:[on|off]],[ad:url][avd-access:format string],[avd-token:format string],[avd-scope:format string]
/action-script:file-name
/admin, /console
+aero
/app:program:[path|||alias],cmd:command,file:filename,guid:guid,icon:filename,name:name,workdir:directory,hidef:[on|off]
/assistance:password
/auto-request-control:
+async-channels
+async-update
/audio-mode:[[none|2]|[server|1]|[redirect|0]]
+auth-only
/auth-pkg-list:[[none],]!ntlm,kerberos,!u2u
-authentication
+auto-reconnect
/auto-reconnect-max-retries:retries
/bpp:depth
/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
/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
/compression-level:level
+credentials-delegation
/d:domain
-decorations
/disp
/drive:name,path
+drives
/dump:record|replay,file:file[,nodelay]
/dvc:channel[,options]
+dynamic-resolution
-encryption
/encryption-methods:[40,][56,][128,][FIPS]
/endpointfedauth:token
/f
+fipsmode
/floatbar[:sticky:[on|off],default:[visible|hidden],show:[always|fullscreen|window]]
-fonts
+force-console-callbacks
/frame-ack:number
/args-from:file:file|stdin|fd:number|env:name
/from-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
/gdi:sw|hw
/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]]
-grab-keyboard
-grab-mouse
/h:height
-heartbeat
/help, /?
+home-drive
/ipv4[:[:force]], /4[:[:force]]
/ipv6[:[:force]], /6[:[:force]]
/jpeg
/jpeg-quality:percentage
/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]
/load-balance-info:info-string
/list:[kbd|kbd-scancode|kbd-lang[:value]|smartcard[:[pkinit-anchors:path][,pkcs11-module:name]]|monitor|tune|timezones]
/log-filters:tag:level[,tag:level[,...]]
/log-level:[OFF|FATAL|ERROR|WARN|INFO|DEBUG|TRACE]
/max-fast-path-size:size
/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-relative
/mouse:[relative:[on|off],grab:[on|off]]
* relative: ارسال حرکات نسبی ماوس در صورت پشتیبانی سرور
* grab: به دام انداختن ماوس در صورت قرار داشتن در پنجره
/multimon[:force]
+multitouch
-multitransport
-nego
/network:[invalid|modem|broadband|broadband-low|broadband-high|wan|lan|auto]
/nsc, /nscodec
/orientation:[0|90|180|270]
+old-license
/p[:password]
/parallel[:name[,path]]
/parent-window:window-id
/pcb:blob
/pcid:id
/pheight:height
/play-rfx:pcap-file
/port:number
-suppress-output
+print-reconnect-cookie
/printer[:name[,driver[,default]]]
/proxy:[proto://][user:password@]host[:port]
/pth:password-hash, /pass-the-hash:password-hash
/pwidth:width
/rdp2tcp:executable path[:arg...]
/reconnect-cookie:base64-cookie
/redirect-prefer:FQDN|IP|NETBIOS,[...]
/relax-order-checks, /relax-order-checks
/restricted-admin, /restrictedAdmin
/rfx
/rfx-mode:[image|video]
/scale:[100|140|180]
/scale-desktop:percentage
/scale-device:100|140|180
/sec:rdp[:[on|off]]|tls[:[on|off]]|nla[:[on|off]]|ext[:[on|off]]|aad[:[on|off]]
/serial[:name[,path[,driver[,permissive]]]], /tty[:name[,path[,driver[,permissive]]]]
/server-name:name
/shell:shell
/shell-dir:dir
/smart-sizing[:widthxheight]
/smartcard[: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
/ssh-agent, /ssh-agent
/sspi-module:SSPI module path
/winscard-module:WinSCard module path
/disable-output
/t:title, /title:title
-themes
/timeout:time in ms, /timeout:time in ms
/timezone:windows timezone
/tls:[ciphers|seclevel|secrets-file|enforce]
* 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
/tune:setting:value,setting:value
/u:[[domain]user|user[@domain]]
+unmap-buttons
/usb:[dbg,][id:vid:pid#...,][addr:bus:addr#...,][auto]
/v:server[:port]
/vc:channel[,options]
/version
/video
/prevent-session-lock[:time in sec]
/vmconnect[:vmid]
/w:width
-wallpaper
+window-drag
/window-position:xposxypos
/wm-class:class-name
/workarea
<Right CTRL>
اگر صفحهکلید در حالت تسخیر باشد، میانبرهای سامانهٔ محلی دیگر کار نکرده و به سامانهٔ دوردست ارسال میشوند.
اگر موشواره تسخیر شده باشد (اختیاری)، تشخیص حرکات لمسی محلی کار نمیکند و ممکن است موشواره قادر به خروج از پنجرهٔ RDP نباشد. رویدادهای موشواره تغییر داده نمیشوند.
<CTRL>+<ALT>+<Return>
<CTRL>+<ALT>+<m>
<CTRL>+<ALT>+c
<CTRL>+<ALT>+<d>
Action Script
متغیرهای محیطی (ENVIRONMENT VARIABLES)
متغیرهای محیطی wlog
FREERDP_ASKPASS
پیکربندی سراسری (GLOBAL CONFIGURATION (client common))
قالب و مکان:
مکان مشترک تنظیمات گواهی /etc/FreeRDP/certificates.json است.
قالب فایل JSON است
گزینههای پشتیبانیشده:
deny
رد کردن گواهی در صورتی که بررسی در برابر مخزن SSL سامانه ناموفق باشد
ignore
نادیده گرفتن خطاهای گواهی؛ صرفاً گواهی نادیده گرفته میشود
deny-userconfig
اگر بررسیها در پیکربندی سراسری گواهی را تأیید نکنند، از کاربر سؤالی پرسیده نشود
certificate-db
JSON array
type
رشتهای که الگوریتم درهمسازی استفادهشده را مشخص میکند، به عنوان مثال sha256
hash
رشتهای از مقادیر عددی صحیح در مبنای شانزده (hex) که نشاندهندهٔ درهمسازی گواهی هستند، به عنوان مثال 0123456789abcdef
محل پیکربندی کلاینت X11 عبارت است از: /etc/FreeRDP/xfreerdp.json
قالب فایل JSON است
گزینههای پشتیبانیشده:
isActionScriptAllowed
مجاز کردن یا مسدود کردن اسکریپتهای کنش. حالت پیشفرض (در صورت تنظیم نشدن گزینه) مجاز دانستن اسکریپتهای کنش است.
مثالها (EXAMPLES)
#!/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
مقدار بازگشتی برنامه مشخص میکند که آیا کلید بهصورت محلی مدیریت شود یا از راه دور (0 برای محلی، > 0 برای دوردست، < 0 برای خطاها)
xfreerdp3 connection.rdp /p:Pwd123! /f
xfreerdp3 /u:USER /size:50%h /v:rdp.contoso.com
xfreerdp3 /u:CONTOSO\\JohnDoe /p:Pwd123! /v:rdp.contoso.com
xfreerdp3 /u:JohnDoe /p:Pwd123! /w:1366 /h:768 /v:192.168.1.100:4489
xfreerdp3 /u:JohnDoe /p:Pwd123! /vmconnect:C824F53E-95D2-46C6-9A18-23A5BB403532 /v:192.168.1.100
+clipboard
/drive:home,/home/user
/smartcard:<device>
/printer:<device>,<driver>
/serial:<device>
/parallel:<device>
/sound:sys:alsa
/microphone:sys:alsa
/multimedia:sys:alsa
/usb:id,dev:054c:0268
/kbd:remap:29=58,remap:58=29
نویسندگان (AUTHORS)
تیم FreeRDP
| 2026-09-03 | freerdp |