.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "SYNCTHING-CONFIG" "5" "Jul 23, 2026" "v2.1.0" "Syncthing"
.SH "نام (NAME)"
syncthing-config \- پیکربندی سینک‌تینگ
.SH "نمای کلی (OVERVIEW)"
.sp
این صفحه نحوه پیکربندی سینک‌تینگ (Syncthing) را برای همگام‌سازی فایل‌ها، شامل راه‌اندازی دستگاه، پیکربندی پوشه، تنظیمات اتصال و روش‌های مختلف پیکربندی از طریق رابط کاربری تحت وب (web GUI)، خط فرمان یا ویرایش مستقیم فایل پوشش می‌دهد.
.SH "مکان‌های فایل پیکربندی (CONFIGURATION FILE LOCATIONS)"
.sp
مکان‌های پیش‌فرض دایرکتوری پیکربندی و پایگاه‌داده عبارتند از:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$XDG_STATE_HOME/syncthing
$HOME/.local/state/syncthing
$HOME/Library/Application Support/Syncthing
%LOCALAPPDATA%\eSyncthing
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
تغییر یافته در نسخه 1.27.0: مکان پیش‌فرض دایرکتوری پیکربندی و پایگاه‌داده در سیستم‌های شبه‌یونیکس به
\fB$XDG_STATE_HOME/syncthing\fP
یا
\fB$HOME/.local/state/syncthing\fP
تغییر یافت. پیش از این، مکان پیش‌فرض پیکربندی
\fB$XDG_CONFIG_HOME/syncthing\fP
یا
\fB$HOME/.config/syncthing\fP
بود. دایرکتوری پایگاه‌داده نیز پیش‌تر
\fB$HOME/.config/syncthing\fP
یا در صورت تنظیم متغیر محیطی،
\fB$XDG_DATA_HOME/syncthing\fP
بود. نصب‌های موجود ممکن است همچنان به جای پیش‌فرض‌های جدیدتر از این دایرکتوری‌ها استفاده کنند.

.sp
افزوده شده در نسخه 1.5.0: پایگاه‌داده و پیکربندی اکنون می‌توانند به طور جداگانه تنظیم شوند. پیش از این، پایگاه‌داده همیشه در همان دایرکتوری پیکربندی قرار داشت.

.sp
سینک‌تینگ از یک دایرکتوری واحد برای ذخیره پیکربندی و کلیدهای رمزنگاری استفاده می‌کند. سینک‌تینگ همچنین یک پایگاه‌داده شاخص (index) به همراه فراداده‌های فایل نگهداری می‌کند که به صورت پیش‌فرض در همان دایرکتوری ذخیره می‌شود، اگرچه این مورد قابل تغییر است.
.sp
این مکان به صورت پیش‌فرض
\fB$XDG_STATE_HOME/syncthing\fP
یا
\fB$HOME/.local/state/syncthing\fP
(شبه‌یونیکس)،
\fB$HOME/Library/Application Support/Syncthing\fP
(مک)، یا
\fB%LOCALAPPDATA%\eSyncthing\fP
(ویندوز) است. این مقدار می‌تواند در زمان اجرا با استفاده از فلگ‌های
\fB\-\-config\fP
یا
\fB\-\-home\fP
یا متغیرهای محیطی متناظر (\fB$STCONFDIR\fP یا \fBSTHOMEDIR\fP) تغییر یابد. فایل‌های زیر در این دایرکتوری قرار دارند:
.INDENT 0.0
.TP
.B \fBconfig.xml\fP
فایل پیکربندی، با فرمت XML.
.TP
.B \fBcert.pem\fP, \fBkey.pem\fP
کلید عمومی و خصوصی ECDSA دستگاه. این کلیدها مبنای شناسه دستگاه (device ID) را تشکیل می‌دهند. کلید باید خصوصی و محرمانه نگه داشته شود.
.TP
.B \fBhttps\-cert.pem\fP, \fBhttps\-key.pem\fP
گواهی و کلید برای اتصالات HTTPS رابط گرافیکی تحت وب (GUI). در صورت تمایل می‌توان این موارد را با یک گواهی سفارشی برای HTTPS جایگزین کرد.
.UNINDENT
.sp
پایگاه‌داده به طور پیش‌فرض در همان دایرکتوری پیکربندی ذخیره می‌شود، اما مکان آن را می‌توان با فلگ‌های
\fB\-\-data\fP
یا
\fB\-\-home\fP
یا متغیرهای محیطی متناظر (\fB$STDATADIR\fP یا \fBSTHOMEDIR\fP) لغو و بازنویسی کرد.
.sp
دایرکتوری پایگاه‌داده شامل فایل‌های زیر (از جمله موارد دیگر) است:
.INDENT 0.0
.TP
.B \fBindex\-\fP\fI*\fP
پایگاه‌داده حاوی فراداده‌ها و هش‌های فایل‌هایی که در حال حاضر روی دیسک هستند و از همتایان (peers) در دسترس می‌باشند.
.TP
.B \fBsyncthing.log\fP
خروجی لاگ (گزارش رویدادها)، در برخی سیستم‌ها.
.TP
.B \fBaudit\-\fP\fI*\fP\fB\&.log\fP
داده‌های لاگ حسابرسی (audit log)، در صورت فعال بودن.
.TP
.B \fBpanic\-\fP\fI*\fP\fB\&.log\fP
داده‌های لاگ خرابی و کرش (crash log)، در صورت نیاز.
.UNINDENT
.SH "فرمت فایل پیکربندی (CONFIG FILE FORMAT)"
.sp
در ادامه نمونه‌ای از یک فایل پیکربندی پیش‌فرض نشان داده شده است (شناسه‌ها متفاوت خواهند بود):
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
مثال‌های پیکربندی صرفاً جهت توضیح و نمایش آورده شده‌اند. آن‌ها را به طور کامل جهت استفاده به عنوان پیکربندی خود کپی
\fBنکنید\fP\&.
آن‌ها احتمالاً قدیمی هستند و مقادیر ممکن است دیگر با پیش‌فرض‌ها مطابقت نداشته باشند.
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<configuration version=\(dq37\(dq>
    <folder id=\(dqdefault\(dq label=\(dqDefault Folder\(dq group=\(dqHome\(dq path=\(dq/Users/jb/Sync/\(dq type=\(dqsendreceive\(dq rescanIntervalS=\(dq3600\(dq fsWatcherEnabled=\(dqtrue\(dq fsWatcherDelayS=\(dq10\(dq fsWatcherTimeoutS=\(dq0\(dq ignorePerms=\(dqfalse\(dq autoNormalize=\(dqtrue\(dq>
        <filesystemType>basic</filesystemType>
        <device id=\(dqS7UKX27\-GI7ZTXS\-GC6RKUA\-7AJGZ44\-C6NAYEB\-HSKTJQK\-KJHU2NO\-CWV7EQW\(dq introducedBy=\(dq\(dq>
            <encryptionPassword></encryptionPassword>
        </device>
        <minDiskFree unit=\(dq%\(dq>1</minDiskFree>
        <versioning>
            <cleanupIntervalS>3600</cleanupIntervalS>
            <fsPath></fsPath>
            <fsType>basic</fsType>
        </versioning>
        <copiers>0</copiers>
        <pullerMaxPendingKiB>0</pullerMaxPendingKiB>
        <hashers>0</hashers>
        <order>random</order>
        <ignoreDelete>false</ignoreDelete>
        <scanProgressIntervalS>0</scanProgressIntervalS>
        <pullerPauseS>0</pullerPauseS>
        <maxConflicts>\-1</maxConflicts>
        <disableSparseFiles>false</disableSparseFiles>
        <paused>false</paused>
        <markerName>.stfolder</markerName>
        <copyOwnershipFromParent>false</copyOwnershipFromParent>
        <modTimeWindowS>0</modTimeWindowS>
        <maxConcurrentWrites>16</maxConcurrentWrites>
        <disableFsync>false</disableFsync>
        <blockPullOrder>standard</blockPullOrder>
        <copyRangeMethod>standard</copyRangeMethod>
        <caseSensitiveFS>false</caseSensitiveFS>
        <junctionsAsDirs>false</junctionsAsDirs>
        <syncOwnership>false</syncOwnership>
        <sendOwnership>false</sendOwnership>
        <syncXattrs>false</syncXattrs>
        <sendXattrs>false</sendXattrs>
    </folder>
    <device id=\(dqS7UKX27\-GI7ZTXS\-GC6RKUA\-7AJGZ44\-C6NAYEB\-HSKTJQK\-KJHU2NO\-CWV7EQW\(dq name=\(dqsyno\(dq group=\(dqPersonal\(dq compression=\(dqmetadata\(dq introducer=\(dqfalse\(dq skipIntroductionRemovals=\(dqfalse\(dq introducedBy=\(dq\(dq>
        <address>dynamic</address>
        <paused>false</paused>
        <autoAcceptFolders>false</autoAcceptFolders>
        <maxSendKbps>0</maxSendKbps>
        <maxRecvKbps>0</maxRecvKbps>
        <ignoredFolder time=\(dq2022\-01\-09T19:09:52Z\(dq id=\(dqbr63e\-wyhb7\(dq label=\(dqFoo\(dq></ignoredFolder>
        <maxRequestKiB>0</maxRequestKiB>
        <untrusted>false</untrusted>
        <remoteGUIPort>0</remoteGUIPort>
    </device>
    <gui enabled=\(dqtrue\(dq tls=\(dqfalse\(dq>
        <address>127.0.0.1:8384</address>
        <apikey>k1dnz1Dd0rzTBjjFFh7CXPnrF12C49B1</apikey>
        <theme>default</theme>
    </gui>
    <ldap></ldap>
    <options>
        <listenAddress>default</listenAddress>
        <globalAnnounceServer>default</globalAnnounceServer>
        <globalAnnounceEnabled>true</globalAnnounceEnabled>
        <localAnnounceEnabled>true</localAnnounceEnabled>
        <localAnnouncePort>21027</localAnnouncePort>
        <localAnnounceMCAddr>[ff12::8384]:21027</localAnnounceMCAddr>
        <maxSendKbps>0</maxSendKbps>
        <maxRecvKbps>0</maxRecvKbps>
        <reconnectionIntervalS>60</reconnectionIntervalS>
        <relaysEnabled>true</relaysEnabled>
        <relayReconnectIntervalM>10</relayReconnectIntervalM>
        <startBrowser>true</startBrowser>
        <natEnabled>true</natEnabled>
        <natLeaseMinutes>60</natLeaseMinutes>
        <natRenewalMinutes>30</natRenewalMinutes>
        <natTimeoutSeconds>10</natTimeoutSeconds>
        <urAccepted>0</urAccepted>
        <urSeen>0</urSeen>
        <urUniqueID></urUniqueID>
        <urURL>https://data.syncthing.net/newdata</urURL>
        <urPostInsecurely>false</urPostInsecurely>
        <urInitialDelayS>1800</urInitialDelayS>
        <autoUpgradeIntervalH>12</autoUpgradeIntervalH>
        <upgradeToPreReleases>false</upgradeToPreReleases>
        <keepTemporariesH>24</keepTemporariesH>
        <cacheIgnoredFiles>false</cacheIgnoredFiles>
        <progressUpdateIntervalS>5</progressUpdateIntervalS>
        <limitBandwidthInLan>false</limitBandwidthInLan>
        <minHomeDiskFree unit=\(dq%\(dq>1</minHomeDiskFree>
        <releasesURL>https://upgrades.syncthing.net/meta.json</releasesURL>
        <overwriteRemoteDeviceNamesOnConnect>false</overwriteRemoteDeviceNamesOnConnect>
        <tempIndexMinBlocks>10</tempIndexMinBlocks>
        <unackedNotificationID>authenticationUserAndPassword</unackedNotificationID>
        <trafficClass>0</trafficClass>
        <setLowPriority>true</setLowPriority>
        <maxFolderConcurrency>0</maxFolderConcurrency>
        <crashReportingURL>https://crash.syncthing.net/newcrash</crashReportingURL>
        <crashReportingEnabled>true</crashReportingEnabled>
        <stunKeepaliveStartS>180</stunKeepaliveStartS>
        <stunKeepaliveMinS>20</stunKeepaliveMinS>
        <stunServer>default</stunServer>
        <maxConcurrentIncomingRequestKiB>0</maxConcurrentIncomingRequestKiB>
        <announceLANAddresses>true</announceLANAddresses>
        <sendFullIndexOnUpgrade>false</sendFullIndexOnUpgrade>
        <connectionLimitEnough>0</connectionLimitEnough>
        <connectionLimitMax>0</connectionLimitMax>
    </options>
    <remoteIgnoredDevice time=\(dq2022\-01\-09T20:02:01Z\(dq id=\(dq5SYI2FS\-LW6YAXI\-JJDYETS\-NDBBPIO\-256MWBO\-XDPXWVG\-24QPUM4\-PDW4UQU\(dq name=\(dqbugger\(dq address=\(dq192.168.0.20:22000\(dq></remoteIgnoredDevice>
    <defaults>
        <folder id=\(dq\(dq label=\(dq\(dq path=\(dq~\(dq type=\(dqsendreceive\(dq rescanIntervalS=\(dq3600\(dq fsWatcherEnabled=\(dqtrue\(dq fsWatcherDelayS=\(dq10\(dq fsWatcherTimeoutS=\(dq0\(dq ignorePerms=\(dqfalse\(dq autoNormalize=\(dqtrue\(dq>
            <filesystemType>basic</filesystemType>
            <device id=\(dqS7UKX27\-GI7ZTXS\-GC6RKUA\-7AJGZ44\-C6NAYEB\-HSKTJQK\-KJHU2NO\-CWV7EQW\(dq introducedBy=\(dq\(dq>
                <encryptionPassword></encryptionPassword>
            </device>
            <minDiskFree unit=\(dq%\(dq>1</minDiskFree>
            <versioning>
                <cleanupIntervalS>3600</cleanupIntervalS>
                <fsPath></fsPath>
                <fsType>basic</fsType>
            </versioning>
            <copiers>0</copiers>
            <pullerMaxPendingKiB>0</pullerMaxPendingKiB>
            <hashers>0</hashers>
            <order>random</order>
            <ignoreDelete>false</ignoreDelete>
            <scanProgressIntervalS>0</scanProgressIntervalS>
            <pullerPauseS>0</pullerPauseS>
            <maxConflicts>10</maxConflicts>
            <disableSparseFiles>false</disableSparseFiles>
            <paused>false</paused>
            <markerName>.stfolder</markerName>
            <copyOwnershipFromParent>false</copyOwnershipFromParent>
            <modTimeWindowS>0</modTimeWindowS>
            <maxConcurrentWrites>16</maxConcurrentWrites>
            <disableFsync>false</disableFsync>
            <blockPullOrder>standard</blockPullOrder>
            <copyRangeMethod>standard</copyRangeMethod>
            <caseSensitiveFS>false</caseSensitiveFS>
            <junctionsAsDirs>false</junctionsAsDirs>
            <syncOwnership>false</syncOwnership>
            <sendOwnership>false</sendOwnership>
            <syncXattrs>false</syncXattrs>
            <sendXattrs>false</sendXattrs>
        </folder>
        <device id=\(dq\(dq compression=\(dqmetadata\(dq introducer=\(dqfalse\(dq skipIntroductionRemovals=\(dqfalse\(dq introducedBy=\(dq\(dq>
            <address>dynamic</address>
            <paused>false</paused>
            <autoAcceptFolders>false</autoAcceptFolders>
            <maxSendKbps>0</maxSendKbps>
            <maxRecvKbps>0</maxRecvKbps>
            <maxRequestKiB>0</maxRequestKiB>
            <untrusted>false</untrusted>
            <remoteGUIPort>0</remoteGUIPort>
        </device>
    </defaults>
</configuration>
.EE
.UNINDENT
.UNINDENT
.SH "عنصر CONFIGURATION (CONFIGURATION ELEMENT)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<configuration version=\(dq37\(dq>
    <folder></folder>
    <device></device>
    <gui></gui>
    <ldap></ldap>
    <options></options>
    <remoteIgnoredDevice></remoteIgnoredDevice>
    <defaults></defaults>
</configuration>
.EE
.UNINDENT
.UNINDENT
.sp
این عنصر ریشه (root element) است. دارای یک ویژگی (attribute) است:
.INDENT 0.0
.TP
.B version
نسخه پیکربندی. هر زمان که تغییری ایجاد شود که نیازمند مهاجرت (migration) از فرمت‌های قبلی باشد، این مقدار افزایش می‌یابد.
.UNINDENT
.sp
این عنصر شامل عناصر شرح داده شده در بخش‌های بعدی و هر تعداد از این عنصر فرزند اضافی است:
.INDENT 0.0
.TP
.B remoteIgnoredDevice
شامل شناسه دستگاهی است که باید نادیده گرفته شود. تلاش‌های اتصال از این دستگاه در کنسول ثبت (لاگ) می‌شوند اما هرگز در رابط تحت وب (web GUI) نمایش داده نمی‌شوند.
.UNINDENT
.SH "عنصر FOLDER (FOLDER ELEMENT)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<folder id=\(dqdefault\(dq label=\(dqDefault Folder\(dq group=\(dqHome\(dq path=\(dq/Users/jb/Sync/\(dq type=\(dqsendreceive\(dq rescanIntervalS=\(dq3600\(dq fsWatcherEnabled=\(dqtrue\(dq fsWatcherDelayS=\(dq10\(dq fsWatcherTimeoutS=\(dq0\(dq ignorePerms=\(dqfalse\(dq autoNormalize=\(dqtrue\(dq>
    <filesystemType>basic</filesystemType>
    <device id=\(dqS7UKX27\-GI7ZTXS\-GC6RKUA\-7AJGZ44\-C6NAYEB\-HSKTJQK\-KJHU2NO\-CWV7EQW\(dq introducedBy=\(dq\(dq>
        <encryptionPassword></encryptionPassword>
    </device>
    <minDiskFree unit=\(dq%\(dq>1</minDiskFree>
    <versioning>
        <cleanupIntervalS>3600</cleanupIntervalS>
        <fsPath></fsPath>
        <fsType>basic</fsType>
    </versioning>
    <copiers>0</copiers>
    <pullerMaxPendingKiB>0</pullerMaxPendingKiB>
    <hashers>0</hashers>
    <order>random</order>
    <ignoreDelete>false</ignoreDelete>
    <scanProgressIntervalS>0</scanProgressIntervalS>
    <pullerPauseS>0</pullerPauseS>
    <maxConflicts>\-1</maxConflicts>
    <disableSparseFiles>false</disableSparseFiles>
    <paused>false</paused>
    <markerName>.stfolder</markerName>
    <copyOwnershipFromParent>false</copyOwnershipFromParent>
    <modTimeWindowS>0</modTimeWindowS>
    <maxConcurrentWrites>16</maxConcurrentWrites>
    <disableFsync>false</disableFsync>
    <blockPullOrder>standard</blockPullOrder>
    <copyRangeMethod>standard</copyRangeMethod>
    <caseSensitiveFS>false</caseSensitiveFS>
    <junctionsAsDirs>false</junctionsAsDirs>
    <syncOwnership>false</syncOwnership>
    <sendOwnership>false</sendOwnership>
    <syncXattrs>false</syncXattrs>
    <sendXattrs>false</sendXattrs>
</folder>
.EE
.UNINDENT
.UNINDENT
.sp
یک یا چند عنصر \fBfolder\fP باید در فایل وجود داشته باشند. هر عنصر یک پوشه را توصیف می‌کند. ویژگی‌های زیر را می‌توان روی عنصر \fBfolder\fP تنظیم کرد:
.INDENT 0.0
.TP
.B id (اجباری)
شناسه پوشه که باید یکتا باشد.
.UNINDENT
.INDENT 0.0
.TP
.B label
برچسب پوشه، یک نام محلی خوانا برای انسان و توصیفی است. می‌تواند روی هر دستگاه متفاوت، خالی و/یا مشابه با برچسب پوشه‌های دیگر باشد. (اختیاری)
.UNINDENT
.INDENT 0.0
.TP
.B group
در نسخه 2.1.0 اضافه شده است.

.sp
گروه برای یک پوشه، یک نام محلی خوانا برای انسان و توصیفی است. اجازه می‌دهد پوشه‌ها به‌صورت محلی گروه‌بندی شوند. می‌تواند روی هر دستگاه متفاوت، خالی و/یا مشابه با سایر گروه‌های پوشه باشد. (اختیاری)
.UNINDENT
.INDENT 0.0
.TP
.B filesystemType
پیاده‌سازی داخلی سیستم فایل مورد استفاده برای دسترسی به این پوشه، که در یک \fI\%فصل جداگانه\fP به تفصیل شرح داده شده است.
.UNINDENT
.INDENT 0.0
.TP
.B path (اجباری)
مسیر دایرکتوری که پوشه در آن روی این دستگاه ذخیره می‌شود؛ به سایر دستگاه‌ها ارسال نمی‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B type
نحوه مدیریت پوشه توسط Syncthing را کنترل می‌کند. مقادیر ممکن عبارتند از:
.INDENT 7.0
.TP
.B \fBsendreceive\fP
پوشه در حالت پیش‌فرض است. تغییرات محلی را ارسال و تغییرات راه دور را دریافت می‌کند. توجه داشته باشید که این نوع قبلاً «readwrite» نامیده می‌شد که منسوخ شده است اما همچنان در پیکربندی‌های ورودی پذیرفته می‌شود.
.TP
.B \fBsendonly\fP
پوشه در حالت «فقط ارسال» (send only) است – توسط Syncthing روی این دستگاه تغییر داده نخواهد شد. توجه داشته باشید که این نوع قبلاً «readonly» نامیده می‌شد که منسوخ شده است اما همچنان در پیکربندی‌های ورودی پذیرفته می‌شود.
.TP
.B \fBreceiveonly\fP
پوشه در حالت «فقط دریافت» (receive only) است – تغییرات را به سایر دستگاه‌ها انتشار نخواهد داد.
.TP
.B \fBreceiveencrypted\fP
باید در دستگاه‌های غیرقابل اعتماد (untrusted) استفاده شود، جایی که به دلیل وارد نشدن رمز عبور پوشه، داده‌ها قابل رمزگشایی نیستند. به \fI\%دستگاه‌های غیرقابل اعتماد (رمزگذاری‌شده)\fP مراجعه کنید.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B rescanIntervalS
فاصله زمانی پویش مجدد (rescan) بر حسب ثانیه. در صورتی که از افزونه‌های خارجی برای راه‌اندازی پویش مجدد استفاده شود، می‌توان آن را روی \fB0\fP تنظیم کرد تا غیرفعال شود.
.UNINDENT
.INDENT 0.0
.TP
.B fsWatcherEnabled
اگر روی \fBtrue\fP تنظیم شود، تغییرات فایل‌ها در پوشه را شناسایی کرده و آن‌ها را پویش می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B fsWatcherDelayS
مدت زمانی که تغییرات شناسایی‌شده پیش از زمان‌بندی یک پویش انباشته می‌شوند (تنها در صورتی اعمال می‌شود که \fI\%fsWatcherEnabled\fP روی \fBtrue\fP تنظیم شده باشد).
.UNINDENT
.INDENT 0.0
.TP
.B fsWatcherTimeoutS
حداکثر تاخیر پیش از راه‌اندازی یک پویش هنگامی که فایلی به‌طور مداوم در حال تغییر است. اگر تنظیم نشده یا صفر باشد، یک مقدار پیش‌فرض بر اساس \fI\%fsWatcherDelayS\fP محاسبه می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B ignorePerms
اگر \fBtrue\fP باشد، فایل‌های مبدأ از این پوشه با فلگ «بدون بیت‌های مجوز» (no permission bits) به دستگاه‌های راه دور اعلام می‌شوند. دستگاه‌های راه دور هنگام ایجاد فایل‌ها از هر آنچه تنظیمات پیش‌فرض مجوزهایشان است استفاده خواهند کرد. کاربرد اصلی برای سیستم‌های فایلی است که از مجوزها پشتیبانی نمی‌کنند، مانند FAT، یا محیط‌هایی که در آن‌ها تغییر مجوزها غیرممکن است.
.UNINDENT
.INDENT 0.0
.TP
.B autoNormalize
تصحیح خودکار خطاهای نرمال‌سازی UTF\-8 که در نام فایل‌ها یافت می‌شوند. این سازوکار و نحوه راه‌اندازی آن در یک \fI\%فصل جداگانه\fP توضیح داده شده است.
.UNINDENT
.sp
عناصر فرزند زیر می‌توانند وجود داشته باشند:
.INDENT 0.0
.TP
.B device
این عناصر باید دارای ویژگی \fBid\fP باشند و می‌توانند ویژگی \fBintroducedBy\fP را نیز داشته باشند، که دستگاهی را مشخص می‌کند که ما را برای اشتراک‌گذاری این پوشه با دستگاه مشخص‌شده معرفی کرده است. اگر معرفی‌کننده اصلی اشتراک این پوشه را با این دستگاه قطع کند، دستگاه ما نیز پیروی کرده و اشتراک پوشه را قطع خواهد کرد (مشروط بر اینکه \fI\%skipIntroductionRemovals\fP در دستگاه معرفی‌کننده روی \fBfalse\fP باشد).
.sp
تمام دستگاه‌های ذکرشده دستگاه‌هایی هستند که پوشه مربوطه را به اشتراک خواهند گذاشت. هر دستگاه ذکرشده باید یک عنصر \fBdevice\fP مجزا در ادامه فایل داشته باشد. مرسوم است که شناسه دستگاه محلی در همه پوشه‌ها گنجانده شود. در حال حاضر اگر در فایل پیکربندی موجود نباشد، Syncthing آن را به‌طور خودکار اضافه خواهد کرد.
.sp
زیرعنصر \fBencryptionPassword\fP حاوی رمز مخفی لازم برای رمزگشایی داده‌های این پوشه در دستگاه راه دور است. در صورت خالی ماندن، داده‌ها به‌صورت ساده و مستقیم قابل دسترسی خواهند بود (اما همچنان با رمزگذاری لایه انتقال محافظت می‌شوند). این سازوکار و نحوه راه‌اندازی آن در یک \fI\%فصل جداگانه\fP توضیح داده شده است.
.UNINDENT
.INDENT 0.0
.TP
.B minDiskFree
حداقل فضای خالی مورد نیازی که باید روی دیسک محل استقرار این پوشه در دسترس باشد. با کاهش مقدار به زیر این آستانه، پوشه متوقف خواهد شد. محتوای این عنصر بر اساس ویژگی \fBunit\fP مشخص‌شده تفسیر می‌شود. مقادیر پذیرفته‌شده برای \fBunit\fP عبارتند از \fB%\fP (درصد از اندازه دیسک / حجم)، \fBkB\fP، \fBMB\fP، \fBGB\fP و \fBTB\fP\&. برای غیرفعال کردن روی صفر تنظیم کنید.
.UNINDENT
.INDENT 0.0
.TP
.B versioning
پیکربندی نسخه‌بندی (versioning) را مشخص می‌کند.
.sp
\fBهمچنین ببینید:\fP
.INDENT 7.0
.INDENT 3.5
\fI\%File Versioning\fP
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B copiers
.TP
.B hashers
تعداد روتین‌های کپی‌کننده (copier) و هش‌کننده (hasher) برای استفاده، یا \fB0\fP برای مقادیر بهینه تعیین‌شده توسط سیستم. این‌ها گزینه‌های عملکردی سطح پایین فقط برای کاربران پیشرفته هستند؛ آن‌ها را تغییر ندهید مگر اینکه درخواست شده باشد یا خودتان کد را خوانده و کاملاً درک کرده باشید. :)
.UNINDENT
.INDENT 0.0
.TP
.B pullerMaxPendingKiB
کنترل می‌کند که پس از رسیدن به این میزان از درخواست‌های پاسخ‌داده‌نشده، ارسال درخواست به سایر دستگاه‌ها چه زمانی متوقف شود. تعداد کشنده‌ها (pullers) بر اساس این مقدار مورد نظر از داده‌های درخواست‌های معوق به‌طور خودکار تنظیم می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B order
ترتیبی که فایل‌های مورد نیاز باید از کلاستر دریافت (pull) شوند. در صورتی که نوع پوشه «send only» باشد هیچ تاثیری ندارد. مقادیر ممکن عبارتند از:
.INDENT 7.0
.TP
.B \fBrandom\fP (پیش‌فرض)
دریافت فایل‌ها با ترتیب تصادفی. این گزینه برای ایجاد تعادل در منابع میان دستگاه‌های موجود در کلاستر بهینه‌سازی شده است.
.TP
.B \fBalphabetic\fP
دریافت فایل‌ها بر اساس ترتیب حروف الفبای نام فایل.
.TP
.B \fBsmallestFirst\fP, \fBlargestFirst\fP
دریافت فایل‌ها به ترتیب اندازه فایل؛ به ترتیب ابتدا کوچک‌ترین و ابتدا بزرگ‌ترین.
.TP
.B \fBoldestFirst\fP, \fBnewestFirst\fP
دریافت فایل‌ها به ترتیب زمان آخرین تغییر؛ به ترتیب ابتدا قدیمی‌ترین و ابتدا جدیدترین.
.UNINDENT
.sp
توجه داشته باشید که فایل‌های پویش‌شده به‌صورت دسته‌ای ارسال می‌شوند و مرتب‌سازی تنها روی فایل‌های کشف‌شده اعمال می‌گردد. این بدان معناست که همگام‌سازی ممکن است با یک فایل ۱ گیگابایتی شروع شود حتی اگر یک فایل ۱ کیلوبایتی در دستگاه مبدا موجود باشد، تا زمانی که آن فایل ۱ کیلوبایتی برای دستگاه دریافت‌کننده شناخته شود.
.UNINDENT
.INDENT 0.0
.TP
.B ignoreDelete
.
\fBهشدار:\fP
.INDENT 7.0
.INDENT 3.5
فعال‌سازی این گزینه به‌شدت منع می‌شود \- استفاده با مسئولیت خودتان است. به شما هشدار داده شد.
.UNINDENT
.UNINDENT
.sp
اگر روی \fBtrue\fP تنظیم شود، این دستگاه وانمود می‌کند که دستورالعمل‌های حذف فایل‌ها از سایر دستگاه‌ها را ندیده است. این سازوکار در یک \fI\%فصل جداگانه\fP توضیح داده شده است.
.UNINDENT
.INDENT 0.0
.TP
.B scanProgressIntervalS
فاصله زمانی بر حسب ثانیه که اطلاعات پیشرفت پویش با آن به رابط گرافیکی (GUI) ارسال می‌شود. تنظیم روی \fB0\fP باعث می‌شود Syncthing از مقدار پیش‌فرض ۲ استفاده کند. اگر نیازی به مشاهده پیشرفت پویش ندارید، برای غیرفعال کردن آن را روی \fB\-1\fP تنظیم کنید.
.UNINDENT
.INDENT 0.0
.TP
.B pullerPauseS
تنظیمی برای محدود کردن نرخ تلاش مجدد کشنده (puller) هنگام دریافت فایل‌ها. این مقدار را تغییر ندهید مگر اینکه دقیقاً بدانید چه کاری انجام می‌دهید.
.UNINDENT
.INDENT 0.0
.TP
.B maxConflicts
حداکثر تعداد نسخه‌های تداخل (conflict copies) که برای هر فایل نگهداری می‌شود. پیش‌فرض \fB10\fP است. مقدار \fB\-1\fP به معنای تعداد نامحدود است. تنظیم این مقدار روی \fB0\fP نسخه‌های تداخل را به‌طور کلی غیرفعال می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B disableSparseFiles
به‌طور پیش‌فرض، بلوک‌های حاوی تماماً صفر نوشته نمی‌شوند و باعث می‌شوند فایل‌ها در سیستم‌های فایلی که از این قابلیت پشتیبانی می‌کنند به‌صورت تنک (sparse) ذخیره شوند. هنگامی که روی \fBtrue\fP تنظیم شود، فایل‌های تنک (Sparse Files) ایجاد نخواهند شد.
.UNINDENT
.INDENT 0.0
.TP
.B paused
اگر این پوشه (به‌طور موقت) تعلیق شده باشد، برابر با true است.
.UNINDENT
.INDENT 0.0
.TP
.B markerName
نام یک دایرکتوری یا فایل در ریشه پوشه که به‌عنوان نشانگر (marker) استفاده می‌شود \- برای هدف آن به \fI\%marker FAQ\fP مراجعه کنید. دایرکتوری نشانگر توسط Syncthing تنها برای حالت پیش‌فرض \fB\&.stfolder\fP ایجاد می‌شود و در غیر این صورت ایجاد نخواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B copyOwnershipFromParent
در سیستم‌های یونیکس، سعی می‌کند مالکیت فایل/پوشه را از دایرکتوری والد (دایرکتوری که در آن قرار دارد) کپی کند. نیازمند اجرای Syncthing با دسترسی کاربر ارشد (privileged user) یا اعطای قابلیت‌های بیشتر به آن (مانند CAP_CHOWN در لینوکس) است.
.UNINDENT
.INDENT 0.0
.TP
.B modTimeWindowS
اختلاف برچسب زمان تغییر مجاز هنگام مقایسه فایل‌ها برای برابری. برای استفاده در سیستم‌های فایلی که دارای برچسب‌های زمان تغییر ناپایداری هستند که ممکن است پس از ثبت در طول آخرین عملیات نوشتن تغییر کنند. مقدار پیش‌فرض در اندروید هنگامی که پوشه در یک پارتیشن FAT قرار دارد برابر با \fB2\fP و در غیر این صورت \fB0\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B maxConcurrentWrites
حداکثر تعداد عملیات نوشتن همزمان در حین همگام‌سازی. افزایش این مقدار ممکن است بسته به فضای ذخیره‌سازی زیربنایی، عملکرد دیسک را افزایش یا کاهش دهد. پیش‌فرض \fB16\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B disableFsync
.
\fBهشدار:\fP
.INDENT 7.0
.INDENT 3.5
این یک گزینه ناامن و شناخته‌شده است \- استفاده با مسئولیت خودتان است.
.UNINDENT
.UNINDENT
.sp
اعمال عملیات فایل روی دیسک پیش از ثبت آن‌ها در پایگاه داده را غیرفعال می‌کند. غیرفعال کردن fsync می‌تواند منجر به آسیب‌دیدگی داده‌ها (data corruption) شود. این سازوکار در یک \fI\%فصل جداگانه\fP توضیح داده شده است.
.UNINDENT
.INDENT 0.0
.TP
.B blockPullOrder
ترتیبی که بلوک‌های یک فایل بارگیری (دانلود) می‌شوند. این گزینه سرعت انتشار بخش‌های مختلف فایل را میان دستگاه‌های متصل کنترل می‌کند، به بهای تحمیل فشار بیشتر بر حافظه ذخیره‌سازی.
.sp
گزینه‌های موجود:
.INDENT 7.0
.TP
.B \fBstandard\fP (پیش‌فرض)
بلوک‌های یک فایل به N توالی پیوسته و مساوی تقسیم می‌شوند که در آن N تعداد دستگاه‌های متصل است. هر دستگاه شروع به دانلود توالی اختصاصی خود می‌کند و پس از آن توالی‌های سایر دستگاه‌ها را به‌صورت تصادفی انتخاب می‌نماید. توزیع داده قابل قبولی را فراهم کرده و حداقل فشار را به دیسک‌های گردان (spinning disk) وارد می‌کند.
.TP
.B \fBrandom\fP
بلوک‌های یک فایل با ترتیب تصادفی دانلود می‌شوند. توزیع داده‌های عالی فراهم می‌کند، اما فشار بسیار زیادی به درایوهای دیسک گردان وارد می‌سازد.
.TP
.B \fBinOrder\fP
بلوک‌های یک فایل به‌صورت متوالی، از ابتدا تا انتها دانلود می‌شوند. برای درایوهای دیسک گردان مناسب است، اما بهبودی در توزیع داده‌ها ایجاد نمی‌کند.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B copyRangeMethod
انتخاب روشی را برای کپی داده‌ها میان فایل‌ها فراهم می‌کند. می‌توان از این گزینه برای بهینه‌سازی کپی‌ها در سیستم‌های فایل شبکه‌ای، بهبود سرعت کپی‌های بزرگ یا کلون کردن داده‌ها با استفاده از قابلیت copy\-on\-write در صورت پشتیبانی سیستم فایل زیربنایی، استفاده کرد. این سازوکار در یک \fI\%فصل جداگانه\fP توضیح داده شده است.
.UNINDENT
.INDENT 0.0
.TP
.B caseSensitiveFS
با غیرفعال کردن بررسی‌های امنیتی اضافی برای سیستم‌های فایل غیرحساس به حروف بزرگ و کوچک (case insensitive)، بر عملکرد تأثیر می‌گذارد. این سازوکار و نحوه راه‌اندازی آن در یک \fI\%فصل جداگانه\fP توضیح داده شده است.
.UNINDENT
.INDENT 0.0
.TP
.B junctionsAsDirs
در صورت تنظیم روی \fBtrue\fP، با اتصالات دایرکتوری (junctions) در سامانه NTFS مانند دایرکتوری‌های معمولی رفتار می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B syncOwnership
اگر روی \fBtrue\fP تنظیم شود، مالکیت فایل و دایرکتوری همگام‌سازی می‌شود. برای اطلاعات بیشتر به \fI\%syncOwnership\fP مراجعه کنید.
.UNINDENT
.INDENT 0.0
.TP
.B sendOwnership
اگر روی \fBtrue\fP تنظیم شود، اطلاعات مالکیت فایل و دایرکتوری پویش می‌شود. برای اطلاعات بیشتر به \fI\%sendOwnership\fP مراجعه کنید.
.UNINDENT
.INDENT 0.0
.TP
.B syncXattrs
اگر روی \fBtrue\fP تنظیم شود، ویژگی‌های گسترش‌یافته (extended attributes) فایل و دایرکتوری همگام‌سازی می‌شوند. برای اطلاعات بیشتر به \fI\%syncXattrs\fP مراجعه کنید.
.UNINDENT
.INDENT 0.0
.TP
.B sendXattrs
اگر روی \fBtrue\fP تنظیم شود، ویژگی‌های گسترش‌یافته فایل و دایرکتوری پویش شده و به سایر دستگاه‌ها ارسال می‌شوند. برای اطلاعات بیشتر به \fI\%sendXattrs\fP مراجعه کنید.
.UNINDENT
.INDENT 0.0
.TP
.B blockIndexing
در نسخه 2.1.0 اضافه شده است.

.sp
مشخص می‌کند که آیا برای پوشه از نمایه‌سازی بلوکی (block indexing) استفاده شود یا خیر؛ مقدار پیش‌فرض برای پوشه‌های ارسال\-دریافت و فقط\-دریافت برابر با \fBtrue\fP است. نمایه‌سازی بلوکی این امکان را برای Syncthing فراهم می‌کند که بلوک‌های داده را بین فایل‌ها (حتی در پوشه‌های مختلف) دوباره استفاده کند، اما نیازمند نگهداری نمایه‌ای از هش تک‌تک بلوک‌ها است. این نمایه برای پوشه‌های بزرگ می‌تواند پرهزینه باشد، بنابراین می‌توان نمایه‌سازی را در ازای مصرف پهنای باند بیشتر برای انتقال غیرفعال کرد.
.UNINDENT
.SH "عنصر DEVICE (DEVICE ELEMENT)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<device id=\(dqS7UKX27\-GI7ZTXS\-GC6RKUA\-7AJGZ44\-C6NAYEB\-HSKTJQK\-KJHU2NO\-CWV7EQW\(dq name=\(dqsyno\(dq group=\(dqPersonal\(dq compression=\(dqmetadata\(dq introducer=\(dqfalse\(dq skipIntroductionRemovals=\(dqfalse\(dq introducedBy=\(dq2CYF2WQ\-AKZO2QZ\-JAKWLYD\-AGHMQUM\-BGXUOIS\-GYILW34\-HJG3DUK\-LRRYQAR\(dq>
    <address>dynamic</address>
    <paused>false</paused>
    <autoAcceptFolders>false</autoAcceptFolders>
    <maxSendKbps>0</maxSendKbps>
    <maxRecvKbps>0</maxRecvKbps>
    <ignoredFolder time=\(dq2022\-01\-09T19:09:52Z\(dq id=\(dqbr63e\-wyhb7\(dq label=\(dqFoo\(dq></ignoredFolder>
    <maxRequestKiB>0</maxRequestKiB>
    <untrusted>false</untrusted>
    <remoteGUIPort>0</remoteGUIPort>
    <numConnections>0</numConnections>
</device>
<device id=\(dq2CYF2WQ\-AKZO2QZ\-JAKWLYD\-AGHMQUM\-BGXUOIS\-GYILW34\-HJG3DUK\-LRRYQAR\(dq name=\(dqsyno local\(dq compression=\(dqmetadata\(dq introducer=\(dqtrue\(dq skipIntroductionRemovals=\(dqfalse\(dq introducedBy=\(dq\(dq>
    <address>tcp://192.0.2.1:22001</address>
    <paused>true</paused>
    <allowedNetwork>192.168.0.0/16</allowedNetwork>
    <autoAcceptFolders>false</autoAcceptFolders>
    <maxSendKbps>100</maxSendKbps>
    <maxRecvKbps>100</maxRecvKbps>
    <maxRequestKiB>65536</maxRequestKiB>
    <untrusted>false</untrusted>
    <remoteGUIPort>8384</remoteGUIPort>
    <numConnections>0</numConnections>
</device>
.EE
.UNINDENT
.UNINDENT
.sp
یک یا چند عنصر \fBdevice\fP باید در فایل وجود داشته باشند. هر عنصر یک دستگاه حاضر در کلاستر را توصیف می‌کند. مرسوم است که یک عنصر \fBdevice\fP برای دستگاه محلی گنجانده شود؛ Syncthing در حال حاضر در صورت عدم وجود، آن را اضافه خواهد کرد. ویژگی‌های زیر را می‌توان روی عنصر \fBdevice\fP تنظیم کرد:
.INDENT 0.0
.TP
.B id (اجباری)
شناسه دستگاه (\fI\%device ID\fP)\&.
.UNINDENT
.INDENT 0.0
.TP
.B name
یک نام ملموس برای دستگاه. (اختیاری)
.UNINDENT
.INDENT 0.0
.TP
.B group
در نسخه 2.1.0 اضافه شده است.

.sp
گروه برای یک دستگاه، یک نام محلی خوانا برای انسان و توصیفی است. اجازه می‌دهد دستگاه‌ها به‌صورت محلی در کنار هم گروه‌بندی شوند. می‌تواند روی هر دستگاه متفاوت، خالی و/یا مشابه سایر گروه‌های دستگاه باشد. (اختیاری)
.UNINDENT
.INDENT 0.0
.TP
.B compression
اینکه آیا هنگام ارسال پیام‌ها به این دستگاه از فشرده‌سازی پروتکل استفاده شود یا خیر. مقادیر ممکن عبارتند از:
.INDENT 7.0
.TP
.B \fBmetadata\fP
فشرده‌سازی بسته‌های فراداده (متادیتا)، مانند اطلاعات ایندکس. فراداده معمولاً بسیار فشرده‌سازی‌پذیر است، بنابراین این یک پیش‌فرض مناسب محسوب می‌شود.
.TP
.B \fBalways\fP
فشرده‌سازی تمامی بسته‌ها، از جمله داده‌های فایل. در صورتی توصیه می‌شود که محتوای پوشه‌ها عمدتاً داده‌های فشرده‌پذیر مانند اسناد یا فایل‌های متنی باشند.
.TP
.B \fBnever\fP
غیرفعال کردن تمام فشرده‌سازی‌ها.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B introducer
اگر این دستگاه باید به عنوان معرفی‌کننده (introducer) مورد اعتماد باشد، روی true تنظیم می‌شود؛ یعنی ما باید هنگام اتصال، لیست دستگاه‌های آن را برای هر پوشه کپی کنیم.
.sp
\fBهمچنین ببینید (SEE ALSO):\fP
.INDENT 7.0
.INDENT 3.5
\fI\%Introducer Configuration\fP
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B skipIntroductionRemovals
اگر می‌خواهید فقط معرفی‌ها را دنبال کنید و لغو معرفی‌ها (de\-introductions) را اعمال نکنید، روی true تنظیم کنید. برای مثال، در صورت فعال بودن این گزینه، دستگاهی را که به ما معرفی شده است حذف نخواهیم کرد، حتی اگر معرفی‌کننده اصلی دیگر آن دستگاه راه دور را به عنوان دستگاه شناخته‌شده فهرست نکند.
.UNINDENT
.INDENT 0.0
.TP
.B introducedBy
مشخص می‌کند کدام دستگاه ما را به این دستگاه معرفی کرده است. فقط برای دنبال کردن لغو معرفی‌ها (de\-introductions) استفاده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B certName
نام عمومی (Common Name) گواهی دستگاه، در صورتی که مقدار پیش‌فرض «syncthing» نباشد.
.UNINDENT
.sp
از میان عناصر فرزند زیر، حداقل یک فرزند \fBaddress\fP باید وجود داشته باشد.
.INDENT 0.0
.TP
.B address (اجباری: حداقل یک مورد باید وجود داشته باشد.)
حاوی یک آدرس یا نام هاست (میزبان) برای استفاده هنگام تلاش برای اتصال به این دستگاه است. ورودی‌هایی غیر از \fBdynamic\fP به یک پیشوند مخصوص پروتکل نیاز دارند. برای پروتکل TCP می‌توان از پیشوندهای \fBtcp://\fP (دوگانه‌پشته / dual\-stack)، \fBtcp4://\fP (فقط IPv4) یا \fBtcp6://\fP (فقط IPv6) استفاده کرد. پیشوندها برای پروتکل QUIC نیز مشابه هستند: \fBquic://\fP، \fBquic4://\fP و \fBquic6://\fP
توجه داشته باشید که آدرس‌های IP نیازی به استفاده از پیشوندهای IPv4 یا IPv6 ندارند؛ این پیشوندها اختیاری هستند. فرمت‌های پذیرفته‌شده عبارتند از:
.INDENT 7.0
.TP
.B آدرس IPv4 (\fBtcp://192.0.2.42\fP)
از پورت پیش‌فرض (22000) استفاده می‌شود.
.TP
.B آدرس IPv4 و پورت (\fBtcp://192.0.2.42:12345\fP)
آدرس و پورت دقیقاً همان‌طور که مشخص شده استفاده می‌شوند.
.TP
.B آدرس IPv6 (\fBtcp://[2001:db8::23:42]\fP)
از پورت پیش‌فرض (22000) استفاده می‌شود. آدرس باید درون براکت‌های کروشه قرار گیرد.
.TP
.B آدرس IPv6 و پورت (\fBtcp://[2001:db8::23:42]:12345\fP)
آدرس و پورت دقیقاً همان‌طور که مشخص شده استفاده می‌شوند. آدرس باید درون براکت‌های کروشه قرار گیرد.
.TP
.B نام هاست (\fBtcp6://fileserver\fP)
نام هاست روی پورت پیش‌فرض (22000) استفاده خواهد شد و تلاش برای برقراری اتصالات فقط از طریق IPv6 انجام می‌شود.
.TP
.B نام هاست و پورت (\fBtcp://fileserver:12345\fP)
نام هاست روی پورت مشخص‌شده استفاده خواهد شد و بسته به وضوح نام (name resolution)، تلاش برای برقراری اتصال از طریق هر دو پروتکل IPv4 و IPv6 صورت می‌گیرد.
.TP
.B \fBdynamic\fP
کلمه \fBdynamic\fP (بدون هیچ پیشوندی) به این معنی است که از کشف محلی و سراسری برای یافتن دستگاه استفاده شود.
.UNINDENT
.sp
می‌توانید چندین آدرس تعیین کنید \fIو\fP آن را با کلمه کلیدی \fBdynamic\fP ترکیب نمایید؛ برای مثال:
.INDENT 7.0
.INDENT 3.5
.sp
.EX
<device id=\(dq...\(dq>
    <address>tcp://192.0.2.1:22001</address>
    <address>quic://192.0.1.254:22000</address>
    <address>dynamic</address>
</device>
.EE
.UNINDENT
.UNINDENT
.sp
در رابط گرافیکی (GUI)، چندین مقدار با کاما از یکدیگر جدا می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B paused
مقدار True در صورتی که همگام‌سازی با این دستگاه (به‌طور موقت) متوقف یا معلق شده باشد.
.UNINDENT
.INDENT 0.0
.TP
.B allowedNetwork
در صورت تعیین شدن، اتصالات به این دستگاه را فقط به این شبکه محدود می‌کند. این سازوکار با جزئیات در یک \fI\%فصل جداگانه\fP توصیف شده است. برای پیکربندی چندین شبکه، می‌توانید: تگ‌های \fB<allowedNetwork>\fP را در فایل پیکربندی تکرار کنید یا چندین شبکه را با کاما در رابط کاربری گرافیکی وارد نمایید.
.UNINDENT
.INDENT 0.0
.TP
.B autoAcceptFolders
اگر \fBtrue\fP باشد، پوشه‌های به‌اشتراک‌گذاشته‌شده از این دستگاه راه دور به‌طور خودکار اضافه شده و به‌صورت محلی تحت \fI\%مسیر پیش‌فرض\fP همگام‌سازی می‌شوند. برای نام پوشه، Syncthing تلاش می‌کند از برچسب دستگاه راه دور استفاده کند، و اگر همان برچسب از قبل وجود داشته باشد، سپس تلاش می‌کند از شناسه پوشه استفاده نماید. اگر آن شناسه نیز وجود داشته باشد، پوشه صرفاً برای پذیرش دستی پیشنهاد می‌شود. یک پوشه محلی که از قبل با همان شناسه اضافه شده باشد، به جای ایجاد جداگانه، صرفاً به اشتراک گذاشته خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B maxSendKbps
حداکثر نرخ ارسال برای استفاده در این دستگاه. با وجود اینکه نام پیکربندی شبیه به کیلوبیت بر ثانیه به نظر می‌رسد، اما واحد آن کیبی‌بایت بر ثانیه است.
.UNINDENT
.INDENT 0.0
.TP
.B maxRecvKbps
حداکثر نرخ دریافت برای استفاده در این دستگاه. با وجود اینکه نام پیکربندی شبیه به کیلوبیت بر ثانیه به نظر می‌رسد، اما واحد آن کیبی‌بایت بر ثانیه است.
.UNINDENT
.INDENT 0.0
.TP
.B ignoredFolder
شامل شناسه پوشه‌ای است که باید نادیده گرفته شود. این پوشه همیشه هنگام اعلان شدن از سوی دستگاه راه دور مربوطه نادیده گرفته خواهد شد؛ یعنی این مورد ثبت (لاگ) می‌شود، اما هیچ پنجره‌ای در رابط وب نشان داده نخواهد شد. چندین پوشه نادیده‌گرفته‌شده با تکرار تگ‌های \fB<ignoredFolder>\fP در فایل پیکربندی مشخص می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B maxRequestKiB
حداکثر میزان داده‌ای که می‌تواند در درخواست‌ها به سمت این دستگاه معلق باشد. واحد آن کیبی‌بایت است.
.UNINDENT
.INDENT 0.0
.TP
.B remoteGUIPort
در صورت تنظیم روی یک عدد صحیح مثبت، رابط گرافیکی یک پیوند HTTP به آدرس IP که در حال حاضر برای همگام‌سازی استفاده می‌شود، نمایش می‌دهد. فقط پورت TCP با مقدار مشخص‌شده در اینجا جایگزین می‌شود. توجه داشته باشید که هرگونه فوروارد پورت یا تنظیمات فایروال باید به‌صورت دستی انجام شود و این پیوند به دلیل محدودیت‌های مرورگرهای مدرن احتمالاً برای آدرس‌های IPv6 محلی پیوند (link\-local) کار نخواهد کرد.
.UNINDENT
.INDENT 0.0
.TP
.B untrusted
این مقدار بولی یک دستگاه خاص را به عنوان غیرقابل‌اعتماد (untrusted) مشخص می‌کند، که مانع از هرگونه اشتراک‌گذاری داده‌های رمزگذاری‌نشده با آن می‌شود. سپس هر پوشه به‌اشتراک‌گذاشته‌شده با آن دستگاه نیاز به تنظیم گذرواژه رمزگذاری دارد، یا باید از قبل به‌صورت محلی از نوع «دریافت رمزگذاری‌شده» باشد. به توضیحات مفصل تحت \fI\%Untrusted (Encrypted) Devices\fP مراجعه کنید.
.UNINDENT
.INDENT 0.0
.TP
.B numConnections
تعداد اتصالات به این دستگاه. برای اطلاعات بیشتر \fI\%numConnections\fP را ببینید.
.UNINDENT
.SH "عنصر GUI (GUI ELEMENT)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<gui enabled=\(dqtrue\(dq tls=\(dqfalse\(dq>
    <address>127.0.0.1:8384</address>
    <apikey>k1dnz1Dd0rzTBjjFFh7CXPnrF12C49B1</apikey>
    <theme>default</theme>
</gui>
.EE
.UNINDENT
.UNINDENT
.sp
باید دقیقاً یک عنصر \fBgui\fP وجود داشته باشد. پیکربندی رابط گرافیکی کاربر همچنین توسط
\fI\%REST API\fP و \fI\%Event API\fP\& استفاده می‌شود. صفت‌های زیر می‌توانند روی عنصر
\fBgui\fP
تنظیم شوند:
.INDENT 0.0
.TP
.B enabled
اگر برابر با \fBtrue\fP نباشد، رابط گرافیکی کاربر و API راه‌اندازی نخواهند شد.
.UNINDENT
.INDENT 0.0
.TP
.B tls
اگر روی \fBtrue\fP تنظیم شود، TLS (HTTPS) اجباری خواهد شد. درخواست‌های غیر HTTPS به
HTTPS تغییر مسیر داده می‌شوند. وقتی روی \fBfalse\fP تنظیم شود، اتصالات TLS همچنان
امکان‌پذیر هستند اما الزامی نیستند.
.UNINDENT
.sp
عناصر فرزند زیر می‌توانند وجود داشته باشند:
.INDENT 0.0
.TP
.B address (الزامی: دقیقاً یک عنصر باید وجود داشته باشد.)
آدرس گوش دادن (listen address) را تنظیم می‌کند. فرمت‌های آدرس مجاز عبارتند از:
.INDENT 7.0
.TP
.B آدرس و پورت IPv4 (\fB127.0.0.1:8384\fP)
آدرس و پورت همان‌طور که داده شده‌اند استفاده می‌شوند.
.TP
.B آدرس و پورت IPv6 (\fB[::1]:8384\fP)
آدرس و پورت همان‌طور که داده شده‌اند استفاده می‌شوند. آدرس باید درون براکت
قرار گیرد.
.TP
.B نویسه عام (Wildcard) و پورت (\fB0.0.0.0:12345\fP, \fB[::]:12345\fP, \fB:12345\fP)
این موارد معادل یکدیگرند و باعث می‌شوند Syncthing روی تمام رابط‌ها از طریق هر دو IPv4 و IPv6 گوش فرا دهد.
.TP
.B مکان سوکت یونیکس (\fB/var/run/st.sock\fP)
اگر آدرس یک مسیر مطلق باشد، به عنوان مسیر یک سوکت یونیکس تفسیر می‌شود.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B unixSocketPermissions
هنگامی که \fBaddress\fP روی مکان یک سوکت یونیکس تنظیم شده است، این مقدار را به یک مقدار هشت‌هشتی (اکتال) تنظیم کنید
تا مجوزهای پیش‌فرض سوکت را بازنویسی کند.
.UNINDENT
.INDENT 0.0
.TP
.B user
برای الزام به احراز هویت تنظیم می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B password
شامل هش bcrypt از گذرواژه واقعی است.
.UNINDENT
.INDENT 0.0
.TP
.B apikey
در صورت تنظیم، کلید API است که امکان استفاده از رابط REST را فعال می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B insecureAdminAccess
اگر true باشد، اجازه دسترسی به رابط گرافیکی وب را از خارج (یعنی خارج از localhost)
بدون احراز هویت می‌دهد. در هنگام راه‌اندازی، هشداری درباره این تنظیم نمایش داده خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B insecureSkipHostcheck
هنگامی که رابط گرافیکی / API به localhost متصل است، الزام می‌شود که هدر
\fBHost\fP
مشابه localhost باشد. این گزینه آن بررسی را دور می‌زند.
.UNINDENT
.INDENT 0.0
.TP
.B insecureAllowFrameLoading
با تنظیم نکردن هدر HTTP بنام \fBX\-Frame\-Options: SAMEORIGIN\fP، امکان رندر کردن رابط گرافیکی را درون یک \fB<iframe>\fP، \fB<frame>\fP یا \fB<object>\fP
فراهم می‌کند. این ممکن است برای ارائه رابط گرافیکی Syncthing به عنوان بخشی از یک وب‌سایت از طریق پراکسی مورد نیاز باشد.
.UNINDENT
.INDENT 0.0
.TP
.B theme
نام پوسته‌ای که باید استفاده شود.
.UNINDENT
.INDENT 0.0
.TP
.B authMode
حالت احراز هویت مورد استفاده. در صورت عدم وجود، حالت احراز هویت (static)
به منظور سازگاری با نسخه‌های پیشین توسط وجود فیلدهای user/password کنترل می‌شود.
.INDENT 7.0
.TP
.B \fBstatic\fP
احراز هویت با استفاده از کاربر و گذرواژه.
.TP
.B \fBldap\fP
احراز هویت LDAP. مستلزم وجود بخش پیکربندی سطح بالای ldap است.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B sendBasicAuthPrompt
در نسخه 1.26.0 اضافه شد.

.sp
پیش از نسخه 1.26.0، رابط گرافیکی از HTTP Basic Authorization برای ورود استفاده می‌کرد، اما
از نسخه 1.26.0 به بعد به‌طور پیش‌فرض از یک فرم HTML استفاده می‌کند. احراز هویت پایه (Basic
Authorization) همچنان در صورتی که هدر درخواست \fBAuthorization\fP در یک درخواست
وجود داشته باشد پشتیبانی می‌شود، اما برخی مرورگرها این هدر را ارسال نمی‌کنند مگر اینکه
با یک پاسخ 401 درخواست شود.
.sp
هنگامی که این تنظیم فعال باشد، رابط گرافیکی به درخواست‌های احراز هویت‌نشده با یک پاسخ 401 پاسخ می‌دهد
و احراز هویت پایه را درخواست می‌کند، تا نشانی‌های وب به سبک \fBhttps://user:pass@localhost\fP همچنان
در مرورگرهای استاندارد کار کنند. سایر کلاینت‌هایی که همیشه هدر درخواست \fBAuthorization\fP را
ارسال می‌کنند به این تنظیم نیازی ندارند.
.sp
هنگامی که این تنظیم غیرفعال باشد، رابط گرافیکی پاسخ‌های 401 ارسال نخواهد کرد تا کاربران
پنجره‌های بازشوی مرورگر برای درخواست نام کاربری و گذرواژه را مشاهده نکنند.
.UNINDENT
.INDENT 0.0
.TP
.B metricsWithoutAuth
اگر true باشد، اجازه دسترسی به \(aq/metrics\(aq را بدون احراز هویت می‌دهد.
.UNINDENT
.INDENT 0.0
.TP
.B sessionCookieDurationS
در نسخه 2.1.0 اضافه شد.

.sp
مدت زمانی که پس از انتخاب «stay logged in» در فرم ورود رابط گرافیکی،
کاربر در حالت واردشده باقی می‌ماند. به ثانیه، پیش‌فرض 604800 (یک هفته).
.UNINDENT
.INDENT 0.0
.TP
.B sessionCookiePath
در نسخه 2.1.0 اضافه شد.

.sp
مسیر کوکی نشست؛ پیش‌فرض «/»، تنها در صورتی تغییر دهید که رابط گرافیکی
از طریق یک پراکسی در یک زیرمسیر ارائه شود.
.UNINDENT
.SH "عنصر LDAP (LDAP ELEMENT)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<ldap>
    <address>localhost:389</address>
    <bindDN>cn=%s,ou=users,dc=syncthing,dc=net</bindDN>
    <transport>nontls</transport>
    <insecureSkipVerify>false</insecureSkipVerify>
</ldap>
.EE
.UNINDENT
.UNINDENT
.sp
عنصر \fBldap\fP شامل گزینه‌های پیکربندی LDAP است. این سازوکار
به‌طور مفصل در بخش \fI\%LDAP Authentication\fP\& شرح داده شده است.
.INDENT 0.0
.TP
.B address (الزامی)
.INDENT 7.0
.INDENT 3.5
آدرس سرور LDAP (سرور:پورت).
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B bindDN (الزامی)
.INDENT 7.0
.INDENT 3.5
مقدار BindDN برای احراز هویت کاربر.
متغیر ویژه \fB%s\fP باید برای انتقال نام کاربری به LDAP استفاده شود.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B transport
.INDENT 7.0
.TP
.B \fBnontls\fP
اتصال غیرامن.
.TP
.B \fBtls\fP
اتصال امن‌شده با TLS.
.TP
.B \fBstarttls\fP
حالت اتصال StartTLS.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B insecureSkipVerify
رد کردن اعتبارسنجی (\fBtrue\fP یا \fBfalse\fP).
.UNINDENT
.INDENT 0.0
.TP
.B searchBaseDN
مقدار Base DN برای جستجوهای کاربر.
.UNINDENT
.INDENT 0.0
.TP
.B searchFilter
فیلتر جستجو برای جستجوهای کاربر.
.UNINDENT
.SH "عنصر OPTIONS (OPTIONS ELEMENT)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<options>
    <listenAddress>default</listenAddress>
    <globalAnnounceServer>default</globalAnnounceServer>
    <globalAnnounceEnabled>true</globalAnnounceEnabled>
    <localAnnounceEnabled>true</localAnnounceEnabled>
    <localAnnouncePort>21027</localAnnouncePort>
    <localAnnounceMCAddr>[ff12::8384]:21027</localAnnounceMCAddr>
    <maxSendKbps>0</maxSendKbps>
    <maxRecvKbps>0</maxRecvKbps>
    <reconnectionIntervalS>60</reconnectionIntervalS>
    <relaysEnabled>true</relaysEnabled>
    <relayReconnectIntervalM>10</relayReconnectIntervalM>
    <startBrowser>true</startBrowser>
    <natEnabled>true</natEnabled>
    <natLeaseMinutes>60</natLeaseMinutes>
    <natRenewalMinutes>30</natRenewalMinutes>
    <natTimeoutSeconds>10</natTimeoutSeconds>
    <urAccepted>0</urAccepted>
    <urSeen>0</urSeen>
    <urUniqueID></urUniqueID>
    <urURL>https://data.syncthing.net/newdata</urURL>
    <urPostInsecurely>false</urPostInsecurely>
    <urInitialDelayS>1800</urInitialDelayS>
    <autoUpgradeIntervalH>12</autoUpgradeIntervalH>
    <upgradeToPreReleases>false</upgradeToPreReleases>
    <keepTemporariesH>24</keepTemporariesH>
    <cacheIgnoredFiles>false</cacheIgnoredFiles>
    <progressUpdateIntervalS>5</progressUpdateIntervalS>
    <limitBandwidthInLan>false</limitBandwidthInLan>
    <minHomeDiskFree unit=\(dq%\(dq>1</minHomeDiskFree>
    <releasesURL>https://upgrades.syncthing.net/meta.json</releasesURL>
    <overwriteRemoteDeviceNamesOnConnect>false</overwriteRemoteDeviceNamesOnConnect>
    <tempIndexMinBlocks>10</tempIndexMinBlocks>
    <unackedNotificationID>authenticationUserAndPassword</unackedNotificationID>
    <trafficClass>0</trafficClass>
    <setLowPriority>true</setLowPriority>
    <maxFolderConcurrency>0</maxFolderConcurrency>
    <crashReportingURL>https://crash.syncthing.net/newcrash</crashReportingURL>
    <crashReportingEnabled>true</crashReportingEnabled>
    <stunKeepaliveStartS>180</stunKeepaliveStartS>
    <stunKeepaliveMinS>20</stunKeepaliveMinS>
    <stunServer>default</stunServer>
    <maxConcurrentIncomingRequestKiB>0</maxConcurrentIncomingRequestKiB>
    <announceLANAddresses>true</announceLANAddresses>
    <sendFullIndexOnUpgrade>false</sendFullIndexOnUpgrade>
    <connectionLimitEnough>0</connectionLimitEnough>
    <connectionLimitMax>0</connectionLimitMax>
</options>
.EE
.UNINDENT
.UNINDENT
.sp
عنصر \fBoptions\fP شامل تمام گزینه‌های پیکربندی سراسری دیگر است.
.INDENT 0.0
.TP
.B listenAddress
آدرس شنود برای اتصال‌های همگام‌سازی ورودی. برای نحو مجاز، به
\fI\%Listen Addresses\fP مراجعه کنید. برای پیکربندی چندین آدرس، می‌توانید تگ‌های \fB<listenAddress>\fP را در فایل پیکربندی تکرار کنید یا چندین آدرس جداشده با کاما را در GUI وارد نمایید.
.UNINDENT
.INDENT 0.0
.TP
.B globalAnnounceServer
یک URI به سرور اعلان (کشف) سراسری، یا کلمه \fBdefault\fP برای گنجاندن سرورهای پیش‌فرض. هر تعداد از عناصر globalAnnounceServer می‌توانند وجود داشته باشند. نحو برای ورودی‌های غیرپیش‌فرض، ساختار یک URL با پروتکل HTTP یا HTTPS است. تعدادی گزینه می‌توانند به عنوان گزینه‌های پرسمان به URL اضافه شوند:
\fBinsecure\fP برای جلوگیری از اعتبارسنجی گواهی (مورد نیاز برای نشانی‌های HTTP) و \fBid=<device ID>\fP برای انجام پین‌کردن گواهی (certificate pinning). شناسه دستگاه مورد استفاده هنگام راه‌اندازی توسط سرور کشف چاپ می‌شود. برای پیکربندی چندین سرور، می‌توانید تگ‌های \fB<globalAnnounceServer>\fP را در فایل پیکربندی تکرار کنید یا چندین سرور جداشده با کاما را در GUI وارد نمایید.
.UNINDENT
.INDENT 0.0
.TP
.B globalAnnounceEnabled
مشخص می‌کند که آیا این دستگاه به سرور اعلان (کشف) سراسری اعلام شود و همچنین از آن برای جستجوی دستگاه‌های دیگر استفاده گردد یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B localAnnounceEnabled
مشخص می‌کند که آیا اعلان‌ها به شبکه محلی (LAN) ارسال شوند و همچنین از چنین اعلان‌هایی برای یافتن دستگاه‌های دیگر استفاده شود یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B localAnnouncePort
درگاهی (Port) که برای شنود و ارسال اعلان‌های همگانی (Broadcast) پروتکل IPv4 استفاده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B localAnnounceMCAddr
آدرس گروهی و درگاهی که برای عضویت و ارسال اعلان‌های چندپخشی (Multicast) پروتکل IPv6 استفاده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B maxSendKbps
محدودیت نرخ داده‌های خروجی، به کیبی‌بایت بر ثانیه.
.UNINDENT
.INDENT 0.0
.TP
.B maxRecvKbps
محدودیت نرخ داده‌های ورودی، به کیبی‌بایت بر ثانیه.
.UNINDENT
.INDENT 0.0
.TP
.B reconnectionIntervalS
تعداد ثانیه‌های انتظار بین هر تلاش برای اتصال به دستگاه‌هایی که در حال حاضر متصل نیستند.
.UNINDENT
.INDENT 0.0
.TP
.B relaysEnabled
هنگامی که \fBtrue\fP باشد، به رله‌ها متصل شده و به صورت بالقوه برای اتصال‌های دستگاه‌به‌دستگاه استفاده می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B relayReconnectIntervalM
فاصله زمانی (به دقیقه) بین تلاش‌های اتصال مجدد به رله را تنظیم می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B startBrowser
مشخص می‌کند که آیا هنگام شروع سینک‌تینگ، برای نمایش GUI تلاشی برای باز کردن مرورگر انجام شود یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B natEnabled
مشخص می‌کند که آیا برای اتصال‌های همگام‌سازی ورودی، تلاشی برای انجام نگاشت درگاه UPnP و NAT\-PMP صورت گیرد یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B natLeaseMinutes
درخواست اجاره (lease) برای این تعداد دقیقه؛ صفر برای درخواست اجاره دائمی.
.UNINDENT
.INDENT 0.0
.TP
.B natRenewalMinutes
تلاش برای تمدید اجاره پس از این تعداد دقیقه.
.UNINDENT
.INDENT 0.0
.TP
.B natTimeoutSeconds
هنگام پویش برای دستگاه‌های UPnP، این مدت زمان برای دریافت پاسخ‌ها منتظر بماند.
.UNINDENT
.INDENT 0.0
.TP
.B urAccepted
مشخص می‌کند که آیا کاربر ارسال داده‌های استفاده ناشناس را پذیرفته است یا خیر. مقدار پیش‌فرض،
\fB0\fP، به این معنی است که کاربر انتخابی نکرده است و سینک‌تینگ در زمانی دیگر در آینده سوال خواهد کرد. \fB\-1\fP به معنای خیر است، و یک عدد بالاتر از صفر به این معنی است که آن نسخه از گزارش استفاده پذیرفته شده است.
.UNINDENT
.INDENT 0.0
.TP
.B urSeen
بالاترین نسخه گزارش استفاده که تاکنون در GUI وب نمایش داده شده است.
.UNINDENT
.INDENT 0.0
.TP
.B urUniqueID
شناسه یکتایی که همراه با گزارش استفاده ارسال می‌شود. هنگام فعال شدن گزارش استفاده ایجاد می‌گردد.
.UNINDENT
.INDENT 0.0
.TP
.B urURL
آدرس اینترنتی (URL) برای ارسال داده‌های گزارش استفاده در صورت فعال بودن.
.UNINDENT
.INDENT 0.0
.TP
.B urPostInsecurely
هنگامی که true باشد، نشانی UR URL می‌تواند به جای https از http استفاده کند یا دارای یک گواهی خودامضا (self\-signed) باشد. مقدار پیش‌فرض \fBfalse\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B urInitialDelayS
مدت زمان انتظار از زمان راه‌اندازی تا ارسال اولین گزارش استفاده. این امکان را می‌دهد که سیستم قبل از گزارش آمار پایدار شود.
.UNINDENT
.INDENT 0.0
.TP
.B autoUpgradeIntervalH
بررسی نسخه جدیدتر پس از این تعداد ساعت. برای غیرفعال کردن ارتقای خودکار، روی \fB0\fP تنظیم کنید.
.UNINDENT
.INDENT 0.0
.TP
.B upgradeToPreReleases
اگر \fBtrue\fP باشد، ارتقای خودکار شامل کاندیداهای انتشار (پیش‌انتشارها) نیز می‌شود (به
\fI\%Versions & Releases\fP مراجعه کنید).
.UNINDENT
.INDENT 0.0
.TP
.B keepTemporariesH
نگهداری انتقال‌های ناموفق موقت به مدت این تعداد ساعت. تا زمانی که فایل‌های موقت نگهداری می‌شوند، نیازی به انتقال مجدد داده‌های موجود در آن‌ها نیست.
.UNINDENT
.INDENT 0.0
.TP
.B cacheIgnoredFiles
مشخص می‌کند که آیا نتایج ارزیابی الگوهای نادیده‌گیری کَش (ذخیره موقت) شوند یا خیر. افزایش عملکرد به بهای مصرف حافظه. مقدار پیش‌فرض \fBfalse\fP است زیرا هزینه ارزیابی الگوهای نادیده‌گیری معمولاً چندان قابل توجه نیست.
.UNINDENT
.INDENT 0.0
.TP
.B progressUpdateIntervalS
فاصله زمانی بر حسب ثانیه که پیشرفت دانلودهای در حال انجام به GUI ارائه می‌شود. برای غیرفعال کردن روی \fB\-1\fP تنظیم کنید. توجه داشته باشید که در صورت غیرفعال بودن، پیشرفت تفصیلی همگام‌سازی برای «موارد خارج از همگام‌سازی» (Out of Sync Items) که نشان می‌دهد چه مقدار از هر فایل دوباره استفاده، کپی و دانلود شده است، کار نخواهد کرد.
.UNINDENT
.INDENT 0.0
.TP
.B limitBandwidthInLan
مشخص می‌کند که آیا محدودیت‌های پهنای باند برای دستگاه‌های موجود در همان دامنه پخشی (Broadcast Domain) دستگاه محلی اعمال شود یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B minHomeDiskFree
حداقل فضای خالی مورد نیازی که باید در پارتیشن حاوی پیکربندی و نمایه (Index) در دسترس باشد. محتوای این عنصر بر اساس ویژگی \fBunit\fP داده‌شده تفسیر می‌شود. مقادیر پذیرفته‌شده برای \fBunit\fP عبارتند از:
\fB%\fP (درصد اندازه دیسک / حجم)، \fBkB\fP، \fBMB\fP، \fBGB\fP و
\fBTB\fP\&. برای غیرفعال کردن روی صفر تنظیم کنید.
.UNINDENT
.INDENT 0.0
.TP
.B releasesURL
نشانی اینترنتی (URL) که اطلاعات نسخه‌های منتشرشده برای ارتقای خودکار از آن بارگیری می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B alwaysLocalNet
شبکه‌ای که باید بر اساس نشانه‌گذاری CIDR به عنوان شبکه محلی در نظر گرفته شود. برای پیکربندی چندین شبکه، می‌توانید تگ‌های \fB<alwaysLocalNet>\fP را در فایل پیکربندی تکرار کنید یا چندین شبکه جداشده با کاما را در GUI وارد نمایید.
.UNINDENT
.INDENT 0.0
.TP
.B overwriteRemoteDeviceNamesOnConnect
اگر تنظیم شود، نام دستگاه‌ها در هر اتصال همیشه با نام ارائه‌شده توسط دستگاه دوردست بازنویسی خواهد شد. به طور پیش‌فرض، نامی که دستگاه دوردست اعلام می‌کند تنها زمانی پذیرفته می‌شود که قبلاً نامی تنظیم نشده باشد.
.UNINDENT
.INDENT 0.0
.TP
.B tempIndexMinBlocks
هنگام تبادل اطلاعات نمایه (Index) برای انتقال‌های ناقص، فقط فایل‌هایی را در نظر می‌گیرد که حداقل این تعداد بلوک داشته باشند.
.UNINDENT
.INDENT 0.0
.TP
.B unackedNotificationID
شناسه یک اعلان که باید در GUI وب نمایش داده شود. به محض اینکه کاربر آن را تایید کند (مانند اعلان انتقال هنگام ارتقا) حذف خواهد شد. شناسه‌های چندگانه با تکرار تگ‌های \fB<unackedNotificationID>\fP در فایل پیکربندی مشخص می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B trafficClass
یک نوع سرویس (TOS) در IPv4 یا کلاس ترافیک (Traffic Class) در IPv6 را برای بسته‌های خروجی مشخص می‌کند. برای مشخص کردن یک نقطه کد خدمات متمایز (DSCP)، مقدار باید دو بیت به چپ شیفت داده شود تا دو بیت کم‌ارزش ECN در نظر گرفته شوند.
.UNINDENT
.INDENT 0.0
.TP
.B stunServer
سروری که برای STUN استفاده می‌شود و به صورت ip:port مشخص می‌گردد. کلیدواژه \fBdefault\fP به مجموعه‌ای از سرورهای عمومی STUN گسترش می‌یابد، با اولویت دادن به سرورهایی که توسط پروژه سینک‌تینگ میزبانی می‌شوند.
.sp
برای پیکربندی چندین سرور، می‌توانید تگ‌های \fB<stunServer>\fP را در فایل پیکربندی تکرار کنید یا چندین سرور جداشده با کاما را در GUI وارد نمایید.
.UNINDENT
.INDENT 0.0
.TP
.B stunKeepaliveStartS
فاصله زمانی به ثانیه بین تماس با یک سرور STUN برای حفظ نگاشت NAT. مقدار پیش‌فرض \fB180\fP است و می‌توانید آن را روی \fB0\fP تنظیم کنید تا تماس با سرورهای STUN غیرفعال شود. در صورت نیاز، این فاصله زمانی به طور خودکار تا حداقل \fI\%stunKeepaliveMinS\fP کاهش می‌یابد.
.UNINDENT
.INDENT 0.0
.TP
.B stunKeepaliveMinS
حداقل فاصله زمانی برای \fI\%stunKeepaliveStartS\fP، به ثانیه.
.UNINDENT
.INDENT 0.0
.TP
.B setLowPriority
سینک‌تینگ در هنگام راه‌اندازی تلاش خواهد کرد تا اولویت پردازش خود را کاهش دهد. به طور مشخص: در لینوکس، خود را در یک گروه پردازشی جداگانه قرار می‌دهد، سطح niceness آن گروه پردازشی را روی ۹ و اولویت I/O را روی سطح تلاش حداکثری (best effort) پنج تنظیم می‌کند؛ در سایر یونیکس‌ها، سطح niceness پردازش را روی ۹ تنظیم می‌کند؛ در ویندوز، کلاس اولویت پردازش را روی below normal قرار می‌دهد. برای غیرفعال کردن این رفتار، به عنوان مثال برای کنترل اولویت پردازش توسط خودتان هنگام اجرای سینک‌تینگ، این گزینه را روی \fBfalse\fP تنظیم کنید.
.UNINDENT
.INDENT 0.0
.TP
.B maxFolderConcurrency
این گزینه کنترل می‌کند که چه تعداد پوشه می‌توانند به طور همزمان در عملیات‌های سنگین I/O مانند همگام‌سازی یا پویش باشند. این سازوکار به طور دقیق در یک \fI\%فصل جداگانه\fP توضیح داده شده است.
.UNINDENT
.INDENT 0.0
.TP
.B crashReportingURL
نشانی اینترنتی سروری که در صورت فعال بودن، \fI\%گزارش‌های خرابی خودکار\fP به آن ارسال خواهند شد.
.UNINDENT
.INDENT 0.0
.TP
.B crashReportingEnabled
سوییچی برای انصراف از ویژگی \fI\%گزارش خرابی خودکار\fP. مقدار \fBfalse\fP را تنظیم کنید تا سینک‌تینگ از ارسال لاگ‌های پنیک در مشکلات جدی خودداری کند. پیش‌فرض \fBtrue\fP است تا به توسعه‌دهندگان در رفع اشکال کمک کند.
.UNINDENT
.INDENT 0.0
.TP
.B maxConcurrentIncomingRequestKiB
این گزینه مقدار بایت‌هایی را که به صورت داده‌های پاسخ در حال خوانده شدن و پردازش «در جریان» هستند، محدود می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B announceLANAddresses
فعال‌سازی (پیش‌فرض) یا غیرفعال‌سازی اعلام آدرس‌های IP خصوصی شبکه محلی (RFC1918) به سیستم کشف سراسری.
.UNINDENT
.INDENT 0.0
.TP
.B sendFullIndexOnUpgrade
کنترل می‌کند که آیا هنگام رخ دادن ارتقا، تمام داده‌های نمایه دوباره ارسال شوند یا خیر. این رفتار در نسخه‌های قدیمی‌تر پیش‌فرض بود، اما عمدتاً به عنوان یک مرحله عیب‌یابی مفید است و باعث دگرگونی و بار زیاد پایگاه‌داده می‌شود. مقدار پیش‌فرض اکنون \fBfalse\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B featureFlag
فلگ‌های ویژگی (Feature flags) رشته‌های متنی ساده‌ای هستند که وقتی به پیکربندی اضافه می‌شوند، می‌توانند ویژگی‌های ناتمام یا در حال توسعه را برای امکان آزمایش زودهنگام توسط کاربر فعال کنند. هر مقدار پشتیبانی‌شده به طور جداگانه همراه با آن ویژگی اعلام خواهد شد تا کاربران عادی آن را تصادفی فعال نکنند. برای پیکربندی چندین فلگ، می‌توانید تگ‌های \fB<featureFlag>\fP را در فایل پیکربندی تکرار کنید یا چندین فلگ جداشده با کاما را در GUI وارد نمایید.
.UNINDENT
.INDENT 0.0
.TP
.B connectionLimitEnough
تعداد اتصال‌هایی که در آن از تلاش برای اتصال به دستگاه‌های بیشتر دست می‌کشیم، صفر به معنی عدم وجود محدودیت است. روی اتصال‌های ورودی تاثیری ندارد. این سازوکار به طور دقیق در یک \fI\%فصل جداگانه\fP توضیح داده شده است.
.UNINDENT
.INDENT 0.0
.TP
.B connectionLimitMax
حداکثر تعداد اتصال‌هایی که در کل اجازه خواهیم داد، صفر به معنی عدم وجود محدودیت است. روی اتصال‌های ورودی تاثیر می‌گذارد و از تلاش برای اتصال‌های خروجی جلوگیری می‌کند. این سازوکار به طور دقیق در یک \fI\%فصل جداگانه\fP توضیح داده شده است.
.UNINDENT
.INDENT 0.0
.TP
.B auditEnabled
هنگامی که \fBtrue\fP باشد، مشابه تنظیم بودن \fI\%\-\-audit\fP است.
پیش‌فرض \fBfalse\fP است.
.sp
هنگامی که این گزینه، یا \fI\%\-\-audit\fP (یا هر دو) فعال باشند، حسابرسی (auditing) فعال می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B auditFile
مشابه \fI\%\-\-auditfile\fP است. پیش‌فرض روی تنظیم‌نشده (unset) است.
.sp
به دلایل سازگاری، اگر هم این گزینه و هم \fI\%\-\-auditfile\fP تنظیم شده باشند، \fI\%\-\-auditfile\fP اولویت دارد.
.UNINDENT
.SH "عنصر DEFAULTS (DEFAULTS ELEMENT)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<defaults>
    <folder id=\(dq\(dq label=\(dq\(dq path=\(dq~\(dq type=\(dqsendreceive\(dq rescanIntervalS=\(dq3600\(dq fsWatcherEnabled=\(dqtrue\(dq fsWatcherDelayS=\(dq10\(dq fsWatcherTimeoutS=\(dq0\(dq ignorePerms=\(dqfalse\(dq autoNormalize=\(dqtrue\(dq>
        <filesystemType>basic</filesystemType>
        <device id=\(dqS7UKX27\-GI7ZTXS\-GC6RKUA\-7AJGZ44\-C6NAYEB\-HSKTJQK\-KJHU2NO\-CWV7EQW\(dq introducedBy=\(dq\(dq>
            <encryptionPassword></encryptionPassword>
        </device>
        <minDiskFree unit=\(dq%\(dq>1</minDiskFree>
        <versioning>
            <cleanupIntervalS>3600</cleanupIntervalS>
            <fsPath></fsPath>
            <fsType>basic</fsType>
        </versioning>
        <copiers>0</copiers>
        <pullerMaxPendingKiB>0</pullerMaxPendingKiB>
        <hashers>0</hashers>
        <order>random</order>
        <ignoreDelete>false</ignoreDelete>
        <scanProgressIntervalS>0</scanProgressIntervalS>
        <pullerPauseS>0</pullerPauseS>
        <maxConflicts>10</maxConflicts>
        <disableSparseFiles>false</disableSparseFiles>
        <paused>false</paused>
        <markerName>.stfolder</markerName>
        <copyOwnershipFromParent>false</copyOwnershipFromParent>
        <modTimeWindowS>0</modTimeWindowS>
        <maxConcurrentWrites>16</maxConcurrentWrites>
        <disableFsync>false</disableFsync>
        <blockPullOrder>standard</blockPullOrder>
        <copyRangeMethod>standard</copyRangeMethod>
        <caseSensitiveFS>false</caseSensitiveFS>
        <junctionsAsDirs>false</junctionsAsDirs>
    </folder>
    <device id=\(dq\(dq compression=\(dqmetadata\(dq introducer=\(dqfalse\(dq skipIntroductionRemovals=\(dqfalse\(dq introducedBy=\(dq\(dq>
        <address>dynamic</address>
        <paused>false</paused>
        <autoAcceptFolders>false</autoAcceptFolders>
        <maxSendKbps>0</maxSendKbps>
        <maxRecvKbps>0</maxRecvKbps>
        <maxRequestKiB>0</maxRequestKiB>
        <untrusted>false</untrusted>
        <remoteGUIPort>0</remoteGUIPort>
        <numConnections>0</numConnections>
    </device>
    <ignores>
        <line>!foo2</line>
        <line>// comment</line>
        <line>(?d).DS_Store</line>
        <line>*2</line>
        <line>qu*</line>
    </ignores>
</defaults>
.EE
.UNINDENT
.UNINDENT
.sp
عنصر \fBdefaults\fP یک الگو را برای گزینه‌های دستگاه و پوشه تازه اضافه‌شده توصیف می‌کند. هنگام افزودن یک دستگاه دوردست یا پوشه جدید، چه از طریق واسط کاربری گرافیکی (GUI) و چه از طریق واسط خط فرمان، از این گزینه‌ها استفاده خواهد شد. عناصر فرزند زیر می‌توانند در عنصر \fBdefaults\fP حضور داشته باشند:
.INDENT 0.0
.TP
.B device
الگویی برای یک عنصر \fBdevice\fP، با همان ساختار داخلی. هر فیلدی در اینجا برای یک دستگاه دوردست تازه اضافه‌شده استفاده خواهد شد. ویژگی \fBid\fP در این زمینه بی‌معنی است.
.UNINDENT
.INDENT 0.0
.TP
.B folder
الگویی برای یک عنصر \fBfolder\fP، با همان ساختار داخلی. هر فیلدی در اینجا برای یک پوشه به اشتراک گذاشته شده تازه اضافه‌شده استفاده خواهد شد. ویژگی \fBid\fP در این زمینه بی‌معنی است.
.sp
واسط کاربری پیشنهاد می‌کند که پوشه‌های جدید در مسیر ارائه‌شده در ویژگی \fBpath\fP ایجاد شوند (پیش‌تر \fBdefaultFolderPath\fP تحت \fBoptions\fP بود). این امر همچنین برای پوشه‌هایی که به طور خودکار از یک دستگاه دوردست پذیرفته می‌شوند اعمال می‌شود.
.sp
حتی اشتراک‌گذاری با سایر دستگاه‌های دوردست را می‌توان در الگو با گنجاندن عنصر مناسب \fI\%folder.device\fP در زیر آن انجام داد.
.UNINDENT
.INDENT 0.0
.TP
.B ignores
اضافه‌شده در نسخه 1.19.0.

.sp
الگویی برای \fI\%الگوهای نادیده‌گیری (ignore patterns)\fP اعمال‌شده روی پوشه‌های جدید. این الگوها هنگامی که یک پوشه به طور خودکار از یک دستگاه دوردست پذیرفته می‌شود، در فایل \fB\&.stignore\fP کپی می‌شوند. واسط گرافیکی (GUI) نیز هنگام افزودن یک پوشه جدید، از آن‌ها برای پر کردن اولیه فیلد مربوطه استفاده می‌کند. در XML، هر خط الگو با یک عنصر \fB<line>\fP مشخص می‌شود.
.UNINDENT
.SS "نشانی‌های شنود (Listen Addresses)"
.sp
انواع نشانی‌های زیر در نشانی‌های شنود پروتکل همگام‌سازی پذیرفته می‌شوند. اگر می‌خواهید سینک‌تینگ روی چندین نشانی شنود داشته باشد، می‌توانید یکی از این دو کار را انجام دهید: تکرار برچسب‌های \fB<listenAddress>\fP در فایل پیکربندی یا وارد کردن چندین نشانی جدا شده با کاما در واسط گرافیکی (GUI).
.INDENT 0.0
.TP
.B نشانی‌های شنود پیش‌فرض (\fBdefault\fP)
این معادل \fBtcp://0.0.0.0:22000\fP، \fBquic://0.0.0.0:22000\fP و \fBdynamic+https://relays.syncthing.net/endpoint\fP است\&.
.TP
.B وایلدکارت و پورت TCP (\fBtcp://0.0.0.0:22000\fP, \fBtcp://:22000\fP)
این‌ها معادل یکدیگرند و باعث می‌شوند سینک‌تینگ روی تمامی رابط‌ها، IPv4 و IPv6، روی پورت مشخص‌شده شنود کند.
.TP
.B وایلدکارت و پورت TCP IPv4 (\fBtcp4://0.0.0.0:22000\fP, \fBtcp4://:22000\fP)
این‌ها معادل یکدیگرند و باعث می‌شوند سینک‌تینگ روی تمامی رابط‌ها فقط از طریق IPv4 شنود کند.
.TP
.B نشانی و پورت TCP IPv4 (\fBtcp4://192.0.2.1:22000\fP)
این گزینه باعث می‌شود سینک‌تینگ فقط روی نشانی و پورت مشخص‌شده در IPv4 شنود کند.
.TP
.B وایلدکارت و پورت TCP IPv6 (\fBtcp6://[::]:22000\fP, \fBtcp6://:22000\fP)
این‌ها معادل یکدیگرند و باعث می‌شوند سینک‌تینگ روی تمامی رابط‌ها فقط از طریق IPv6 شنود کند.
.TP
.B نشانی و پورت TCP IPv6 (\fBtcp6://[2001:db8::42]:22000\fP)
این گزینه باعث می‌شود سینک‌تینگ فقط روی نشانی و پورت مشخص‌شده در IPv6 شنود کند.
.TP
.B نشانی و پورت QUIC (مانند \fBquic://0.0.0.0:22000\fP)
سینتکس آن همانند TCP است، همچنین \fBquic4\fP و \fBquic6\fP نیز می‌توانند استفاده شوند.
.TP
.B نشانی رله ایستا (\fBrelay://192.0.2.42:22067?id=abcd123...\fP)
سینک‌تینگ به نشانی رله مشخص‌شده متصل شده و برای اتصالات ورودی شنود خواهد کرد.
.INDENT 7.0
.INDENT 3.5
.SS "کارهای باقی‌مانده (Todo)"
.sp
مستندسازی پارامترهای URL در دسترس.
.UNINDENT
.UNINDENT
.TP
.B استخر رله پویا (\fBdynamic+https://192.0.2.42/relays\fP)
سینک‌تینگ نشانی HTTPS مشخص‌شده را واکشی کرده، آن را برای داده‌های JSON توصیف‌کننده رله‌ها تجزیه می‌کند، یک رله را از میان رله‌های موجود انتخاب کرده و از طریق آن شنود می‌کند، درست مانند اینکه در بالا به عنوان یک رله ایستا مشخص شده باشد.
.INDENT 7.0
.INDENT 3.5
.SS "کارهای باقی‌مانده (Todo)"
.sp
مستندسازی پارامترهای URL در دسترس.
.UNINDENT
.UNINDENT
.UNINDENT
.SH "همگام‌سازی فایل‌های پیکربندی (SYNCING CONFIGURATION FILES)"
.sp
همگام‌سازی فایل‌های پیکربندی بین دستگاه‌ها (به‌طوری که چندین دستگاه از فایل‌های پیکربندی یکسانی استفاده کنند) می‌تواند باعث بروز مشکلاتی شود. در صورتی که پوشه خانگی (Home) خود را بین دستگاه‌ها همگام کنید، این امر به سادگی و به طور تصادفی ممکن است رخ دهد. یک نشانه رایج از همگام‌سازی فایل‌های پیکربندی این است که دو دستگاه با شناسه دستگاه (Device ID) یکسان مواجه شوند.
.sp
اگر می‌خواهید از سینک‌تینگ برای پشتیبان‌گیری از فایل‌های پیکربندی خود استفاده کنید، توصیه می‌شود فایل‌هایی که از آن‌ها پشتیبان می‌گیرید در یک \fI\%پوشه فقط ارسال (Send Only Folder)\fP قرار داشته باشند تا از بازنویسی پیکربندی اختصاصی هر دستگاه توسط سایر دستگاه‌ها جلوگیری شود. پوشه موجود روی دستگاه(های) دوردست نباید به عنوان پیکربندی برای دستگاه‌های دوردست استفاده شود.
.sp
اگر مایلید پوشه خانگی خود را در حالتی غیر از فقط-ارسال همگام‌سازی کنید، می‌توانید پوشه‌ای را که فایل‌های پیکربندی را ذخیره می‌کند به \fI\%لیست نادیده‌گیری (ignore list)\fP اضافه کنید\&.
اگر همچنین مایلید از فایل‌های پیکربندی خود نسخه پشتیبان تهیه کنید، یک پوشه دیگر در حالت فقط ارسال تنها برای پوشه پیکربندی اضافه کنید.
.SH "نویسنده (AUTHOR)"
نویسندگان سینک‌تینگ (The Syncthing Authors)
.SH "حق نشر (COPYRIGHT)"
2014-2026, The Syncthing Authors
.\" Generated by docutils manpage writer.
.