.\" 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 . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .. .de UNINDENT . RE .nr rst2man-indent-level -1 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "SYNCTHING" "1" "Jul 23, 2026" "v2.1.0" "Syncthing" .SH "نام (NAME)" syncthing \- همگام‌ساز فایل پیوسته و غیرمتمرکز Syncthing .SH "شرح مختصر (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX syncthing [serve] [\-\-home= | \-\-config= \-\-data=] [\-\-allow\-newer\-config] [\-\-audit] [\-\-auditfile=] [\-\-db\-maintenance\-interval=] [\-\-db\-delete\-retention\-interval=] [\-\-gui\-address=
] [\-\-gui\-apikey=] [\-\-log\-level=] [\-\-log\-file=] [\-\-log\-max\-old\-files=] [\-\-log\-max\-size=] [\-\-log\-format\-timestamp=] [\-\-no\-log\-format\-level\-string] [\-\-log\-format\-level\-syslog] [\-\-no\-browser] [\-\-no\-console] [\-\-no\-port\-probing] [\-\-no\-restart] [\-\-no\-upgrade] [\-\-paused] [\-\-unpaused] [\-\-version] [\-\-help] [\-\-debug\-*] syncthing cli [\-\-home= | \-\-config= \-\-data=] [\-\-gui\-address=
] [\-\-gui\-apikey=] [\-\-help] [command options...] [arguments...] syncthing browser [\-\-home= | \-\-config= \-\-data=] [\-\-help] syncthing decrypt (\-\-to= | \-\-verify\-only) [\-\-home= | \-\-config= \-\-data=] [\-\-password=] [\-\-folder\-id=] [\-\-token\-path=] [\-\-continue] [\-\-verbose] [\-\-help] syncthing device\-id [\-\-home= | \-\-config= \-\-data=] [\-\-help] syncthing generate [\-\-home= | \-\-config= \-\-data=] [\-\-gui\-user=] [\-\-gui\-password=] [\-\-no\-port\-probing] [\-\-help] syncthing paths [\-\-home= | \-\-config= \-\-data=] [\-\-help] syncthing upgrade [\-\-home= | \-\-config= \-\-data=] [\-\-check\-only] [\-\-from=] [\-\-help] syncthing version [\-\-home= | \-\-config= \-\-data=] [\-\-help] syncthing debug [\-\-home= | \-\-config= \-\-data=] [\-\-help] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp برنامه Syncthing به شما امکان می‌دهد فایل‌های خود را به صورت دوطرفه در چندین دستگاه همگام‌سازی کنید. این بدان معناست که ایجاد، تغییر یا حذف فایل‌ها در یک دستگاه به طور خودکار در دستگاه‌های دیگر شما تکرار خواهد شد. ما معتقدیم داده‌های شما متعلق به خود شماست و شما سزاوار آن هستید که محل ذخیره‌سازی آن‌ها را انتخاب کنید. بنابراین Syncthing داده‌های شما را در فضای ابری بارگذاری نمی‌کند، بلکه به محض اینکه دستگاه‌های شما هم‌زمان آنلاین شوند، داده‌ها را مستقیماً بین دستگاه‌هایتان مبادله می‌کند. .sp برنامه هسته \fBsyncthing\fP یک برنامه خط فرمان است که معمولاً در پس‌زمینه اجرا می‌شود و همگام‌سازی را مدیریت می‌کند. این برنامه یک رابط کاربری داخلی مبتنی بر HTML و JavaScript برای کنترل از طریق مرورگر وب فراهم می‌کند. این رابط کاربری فرانت‌اند از طریق چند API مبتنی بر HTTP با برنامه اصلی ارتباط برقرار می‌کند، که سایر برنامه‌ها مانند ابزارهای کمکی یکپارچه‌سازی گرافیکی سیستم نیز می‌توانند برای بیشترین انعطاف‌پذیری از آن استفاده کنند. پیوندی برای دسترسی به رابط کاربری گرافیکی و API در میان اولین پیام‌های ثبت وقایع (لاگ) چاپ می‌شود. .SH "گزینه‌های عمومی (COMMON OPTIONS)" .INDENT 0.0 .TP .B \-\-home=, \-H ($STHOMEDIR) تنظیم دایرکتوری مشترک پیکربندی و داده‌ها. دایرکتوری پیش‌فرض پیکربندی عبارت است از \fB$XDG_STATE_HOME/syncthing\fP یا \fB$HOME/.local/state/syncthing\fP (در شبه یونیکس)، \fB$HOME/Library/Application Support/Syncthing\fP (در مک) و \fB%LOCALAPPDATA%\eSyncthing\fP (در ویندوز). .UNINDENT .INDENT 0.0 .TP .B \-\-config=, \-C ($STCONFDIR) تنظیم دایرکتوری پیکربندی. جایگزینی برای \fB\-\-home\fP که باید همراه با \fB\-\-data\fP استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-\-data=, \-D ($STDATADIR) تنظیم دایرکتوری داده‌ها (مانند پایگاه داده). جایگزینی برای \fB\-\-home\fP که باید همراه با \fB\-\-config\fP استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-\-help, \-h نمایش متن راهنما درباره استفاده از خط فرمان. بسته به زیردستور مشخص‌شده، حساس به متن است. .UNINDENT .SH "گزینه‌های خدمت‌رسانی (SERVE OPTIONS)" .INDENT 0.0 .TP .B \-\-allow\-newer\-config ($STALLOWNEWERCONFIG) تلاش برای بارگیری فایل پیکربندی نوشته‌شده توسط نسخه جدیدتر برنامه، به جای شکست فوری. .UNINDENT .INDENT 0.0 .TP .B \-\-audit ($STAUDIT) نوشتن رویدادها در فایل با برچسب زمانی \fBaudit\-YYYYMMDD\-HHMMSS.log\fP. .UNINDENT .INDENT 0.0 .TP .B \-\-auditfile= ($STAUDITFILE) استفاده از فایل یا جریان مشخص‌شده (\fB\(dq\-\(dq\fP برای stdout، \fB\(dq\-\-\(dq\fP برای stderr) برای رویدادهای بازرسی، به جای نام فایل پیش‌فرض با برچسب زمانی. .UNINDENT .INDENT 0.0 .TP .B \-\-db\-maintenance\-interval= ($STDBMAINTENANCEINTERVAL) فاصله نگهداری پایگاه داده – رویه‌های نگهداری داخلی پایگاه داده در این فواصل اجرا می‌شوند. قالب آن به صورت رشته مدت زمان در زبان Go است (https://pkg.go.dev/time#ParseDuration را ببینید). .UNINDENT .INDENT 0.0 .TP .B \-\-db\-delete\-retention\-interval= ($STDBDELETERETENTIONINTERVAL) فاصله نگهداری موارد حذف‌شده پایگاه داده – موارد حذف‌شده پس از این بازه زمانی از پایگاه داده فراموش می‌شوند. قالب آن به صورت رشته مدت زمان در زبان Go است. .UNINDENT .INDENT 0.0 .TP .B \-\-gui\-address=
($STGUIADDRESS) بازنویسی آدرس شنود رابط گرافیکی. این مقدار را روی یک آدرس (\fB0.0.0.0:8384\fP) یا یک URL (\fBhttp://0.0.0.0:8384\fP) تنظیم کنید. طرح‌های پشتیبانی‌شده عبارتند از \fBhttp\fP برای HTTP ساده، \fBhttps\fP برای HTTP روی TLS، \fBunix\fP برای سوکت‌های ساده یونیکس یا \fBunixs\fP برای TLS روی سوکت‌های یونیکس. .UNINDENT .INDENT 0.0 .TP .B \-\-gui\-apikey= ($STGUIAPIKEY) بازنویسی کلید API مورد نیاز برای دسترسی به رابط گرافیکی / REST API. .UNINDENT .INDENT 0.0 .TP .B \-\-log\-file= ($STLOGFILE) تنظیم نام فایل مقصد برای ثبت وقایع (از \fB\(dq\-\(dq\fP برای stdout استفاده کنید که گزینه پیش‌فرض است). .UNINDENT .INDENT 0.0 .TP .B \-\-log\-level= ($STLOGLEVEL) تنظیم سطح ثبت لاگ برای تمام بسته‌ها. سطوح معتبر عبارتند از DEBUG، INFO، WARN و ERROR. .UNINDENT .INDENT 0.0 .TP .B \-\-log\-max\-old\-files= ($STLOGMAXOLDFILES) تعداد فایل‌های قدیمی برای نگهداری (صفر برای نگهداری فقط فایل فعلی). فقط زمانی اعمال می‌شود که چرخش لاگ از طریق \fB\-\-log\-max\-size\fP فعال باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-log\-max\-size= ($STLOGMAXSIZE) حداکثر اندازه بر حسب بایت برای هر فایل لاگ (صفر برای غیرفعال کردن چرخش لاگ). .UNINDENT .INDENT 0.0 .TP .B \-\-log\-format\-timestamp= ($STLOGFORMATTIMESTAMP) قالب برچسب زمانی، برای غیرفعال کردن برچسب زمانی خالی بگذارید. قالب مبتنی بر قالب‌بندی زمان در Go است. .UNINDENT .INDENT 0.0 .TP .B \-\-[no\-]log\-format\-level\-string ($STLOGFORMATLEVELSTRING) آیا رشته سطح (مانند “INF”) در خط لاگ گنجانده شود یا خیر. .UNINDENT .INDENT 0.0 .TP .B \-\-[no\-]log\-format\-level\-syslog ($STLOGFORMATLEVELSYSLOG) آیا سطح لاگ به عنوان پیشوند syslog (مانند “<6>”) در خط لاگ گنجانده شود یا خیر. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-browser ($STNOBROWSER) عدم راه‌اندازی خودکار مرورگر. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-console ($STNOCONSOLE) مخفی کردن پنجره کنسول (فقط در ویندوز). .UNINDENT .INDENT 0.0 .TP .B \-\-no\-port\-probing ($STNOPORTPROBING) هنگام تولید پیکربندی اولیه یا شروع برای بار اول، درگاه‌های تصادفی استفاده‌نشده برای GUI و آدرس شنود را بررسی نکن. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-restart ($STNORESTART) عدم راه‌اندازی مجدد Syncthing هنگام خروج. فرایند مانیتور همچنان برای مدیریت خرابی‌ها و نوشتن لاگ‌ها اجرا خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-upgrade ($STNOUPGRADE) غیرفعال کردن ارتقای خودکار. .UNINDENT .INDENT 0.0 .TP .B \-\-paused ($STPAUSED) شروع برنامه با تمام دستگاه‌ها و پوشه‌ها در وضعیت متوقف‌شده (paused). .UNINDENT .INDENT 0.0 .TP .B \-\-unpaused ($STUNPAUSED) شروع برنامه با تمام دستگاه‌ها و پوشه‌ها در وضعیت فعال (unpaused). .UNINDENT .INDENT 0.0 .TP .B \-\-version نمایش اطلاعات نسخه فعلی و سپس خروج. .UNINDENT .INDENT 0.0 .TP .B \-\-debug\-* چندین گزینه اشکال‌زدایی وجود دارد. برای پرچم‌های مربوط به نسخه خود، \fBsyncthing serve \-\-help\fP را ببینید. .UNINDENT .SH "گزینه‌های رمزگشایی (DECRYPT OPTIONS)" .INDENT 0.0 .TP .B \-\-to= دایرکتوری مقصد که در آن فایل‌ها پس از رمزگشایی ذخیره می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-\-verify\-only عدم نوشتن فایل‌های رمزگشایی‌شده روی دیسک (اما درستی‌سنجی هش متن ساده). .UNINDENT .INDENT 0.0 .TP .B \-\-password= ($FOLDER_PASSWORD) گذرواژه پوشه برای رمزگشایی / درستی‌سنجی. می‌تواند از طریق متغیر محیطی \fBFOLDER_PASSWORD\fP ارسال شود تا در بافر تاریخچه شل ذخیره نشود یا از فهرست فرایندهای در حال اجرا شنود نشود. .UNINDENT .INDENT 0.0 .TP .B \-\-folder\-id= شناسه پوشه رمزگذاری‌شده، در صورتی که نتواند به طور خودکار تعیین شود. .UNINDENT .INDENT 0.0 .TP .B \-\-token\-path= مسیر فایل توکن در پوشه (برای تعیین شناسه پوشه استفاده می‌شود). .UNINDENT .INDENT 0.0 .TP .B \-\-continue ادامه پردازش فایل بعدی در صورت بروز خطا، به جای توقف کامل. .UNINDENT .SH "گزینه‌های تولید (GENERATE OPTIONS)" .INDENT 0.0 .TP .B \-\-gui\-password= مشخص کردن گذرواژه جدید احراز هویت رابط گرافیکی برای به‌روزرسانی فایل پیکربندی. اگر فقط یک خط فاصله (\fB\-\fP) داده شود، از جریان ورودی استاندارد خوانده می‌شود. یک گذرواژه متن ساده قبل از نوشتن در فایل پیکربندی هش می‌شود، اما ورودی که قبلاً با bcrypt هش شده باشد همان‌طور ذخیره می‌شود. به عنوان یک حالت خاص، دادن هش گذرواژه موجود آن را دست‌نخورده باقی می‌گذارد. .UNINDENT .INDENT 0.0 .TP .B \-\-gui\-user= مشخص کردن نام کاربری جدید احراز هویت رابط گرافیکی برای به‌روزرسانی فایل پیکربندی. .UNINDENT .SH "گزینه‌های ارتقا (UPGRADE OPTIONS)" .INDENT 0.0 .TP .B \-\-check\-only ارتقا نده، فقط نشان بده آیا ارتقایی در دسترس است یا خیر. .UNINDENT .INDENT 0.0 .TP .B \-\-from= ارتقا به نسخه Syncthing موجود از بارگیری بسته در URL داده‌شده. .UNINDENT .SH "کدهای خروج (EXIT CODES)" .INDENT 0.0 .TP .B 0 موفقیت / خاموش شدن (Success / Shutdown) .TP .B 1 خطا (Error) .TP .B 2 ارتقا در دسترس نیست (Upgrade not available) .TP .B 3 در حال راه‌اندازی مجدد (Restarting) .TP .B 4 در حال ارتقا (Upgrading) .UNINDENT .sp کدهای خروج بالای 125 معمولاً توسط بارگذار شل/باینری یا مدیر سیگنال پیش‌فرض بازگردانده می‌شوند. کدهای خروج بالای 128+N در یونیکس معمولاً نشان‌دهنده سیگنالی هستند که باعث خروج فرایند شده است. برای مثال: \fB128 + 9 (SIGKILL) = 137\fP. .SH "زیردستورها (SUBCOMMANDS)" .sp ساختار نحوی خط فرمان از طریق چندین زیردستور که به عنوان اولین آرگومان مشخص می‌شوند، از حالت‌های مختلف عملیات پشتیبانی می‌کند. اگر حذف شود، زیردستور پیش‌فرض \fBserve\fP فرض می‌شود. .sp راه‌اندازی اولیه شناسه دستگاه و پیکربندی پیش‌فرض را می‌توان به صراحت با زیردستور \fBgenerate\fP فراخوانی کرد. همچنین می‌تواند اطلاعات احراز هویت پیکربندی‌شده GUI را بدون مراجعه به REST API به‌روزرسانی کند. گواهی دستگاه موجود دست‌نخورده باقی می‌ماند. اگر فایل پیکربندی از قبل وجود داشته باشد، اعتبارسنجی شده و به آخرین طرح پیکربندی به‌روزرسانی می‌شود. .sp زیردستور \fBdecrypt\fP همراه با دستگاه‌های نامطمئن (رمزگذاری‌شده) استفاده می‌شود. این زیردستور به در حال اجرا بودن Syncthing وابسته نیست، بلکه روی داده‌های آفلاین کار می‌کند. .sp برای کار با REST API جهت اشکال‌زدایی یا خودکارسازی، زیردستور \fBcli\fP دسترسی آسان به ویژگی‌های جداگانه را فراهم می‌کند و زحمت مدیریت اتصالات HTTP و احراز هویت API را برطرف می‌سازد. .sp زیردستورهای موجود در چندین سلسله‌مراتب تودرتو گروه‌بندی شده‌اند: .INDENT 0.0 .TP .B config دسترسی به پیکربندی زنده در یک نمونه در حال اجرا از طریق REST API برای بازیابی (get) یا به‌روزرسانی (set) مقادیر. .TP .B show نمایش ویژگی‌های سیستم و وضعیت یک نمونه در حال اجرا. خروجی مستقیماً از پاسخ REST API ارسال می‌شود و بنابراین نیاز به تجزیه قالب JSON دارد. .TP .B operations کنترل عملیات کلی برنامه مانند راه‌اندازی مجدد یا مدیریت ارتقا، و همچنین اجرای برخی اقدامات برای هر پوشه. .TP .B errors بررسی شرایط خطای معلقی که نیاز به توجه کاربر دارند، یا تأیید و پاکسازی (clear) آن‌ها. .TP .B debug ابزارهای مختلف برای کمک به تشخیص مشکلات یا جمع‌آوری اطلاعات برای گزارش‌های اشکال. .TP .B \fB\-\fP (یک خط تیره منفرد) خواندن دستورات بعدی از جریان ورودی استاندارد بدون نیاز به فراخوانی مکرر دستور \fBsyncthing cli\fP. .UNINDENT .sp برای رفع مشکلات، زیردستور \fBdebug\fP برخی اقدامات رایج مورد نیاز برای تحلیل و تعمیر داده‌ها را ارائه می‌دهد. برخی از این دستورات مستقیماً به پایگاه داده دسترسی دارند و بنابراین تنها زمانی کار می‌کنند که Syncthing در حال اجرا نباشد: .INDENT 0.0 .TP .B debug reset\-database بازنشانی پایگاه داده و اجبار به اسکن مجدد و همگام‌سازی مجدد کامل. \fBتنها زمانی باید استفاده شود که Syncthing در حال اجرا نباشد.\fP .TP .B debug database\-statistics نمایش آمار اندازه پایگاه داده. .TP .B debug database\-counts نمایش تعداد پوشه‌های پایگاه داده. .TP .B debug database\-file نمایش فراداده‌های فایل پایگاه داده. .UNINDENT .SH "پروکسی‌ها (PROXIES)" .sp برنامه Syncthing می‌تواند از پروکسی SOCKS، HTTP یا HTTPS برای ارتباط با دنیای خارج استفاده کند. پروکسی فقط برای اتصالات خروجی استفاده می‌شود و پذیرش اتصالات ورودی از طریق پروکسی امکان‌پذیر نیست. پروکسی از طریق متغیر محیطی \fBALL_PROXY\fP یا نسخه با حروف کوچک آن \fBall_proxy\fP پیکربندی می‌شود: .INDENT 0.0 .INDENT 3.5 .sp .EX $ export ALL_PROXY=socks://192.0.2.42:8081 .EE .UNINDENT .UNINDENT .SH "تنظیمات توسعه (DEVELOPMENT SETTINGS)" .sp متغیرهای محیطی زیر رفتار Syncthing را به روش‌هایی تغییر می‌دهند که عمدتاً برای توسعه‌دهندگان مفید است: .INDENT 0.0 .TP .B STTRACE برای افزایش پرگویی اشکال‌زدایی در بخش‌های خاص استفاده می‌شود که عموماً به یک بسته Go نگاشت می‌شوند. رشته‌ای از بخش‌ها را که با ویرگول جدا شده‌اند وارد کنید: \fBapi,beacon\fP. .TP .B STLOCKTHRESHOLD برای اشکال‌زدایی بن‌بست‌های داخلی استفاده می‌شود؛ حساسیت اشکال‌زدایی را تنظیم می‌کند. .TP .B STVERSIONEXTRA افزودن اطلاعات اضافی به رشته نسخه در لاگ‌ها و خط نسخه در GUI. .TP .B GOMAXPROCS تنظیم حداکثر تعداد هسته‌های پردازنده برای استفاده. پیش‌فرض تمام هسته‌های پردازنده موجود است. .TP .B GOGC درصد رشد هیپ که در آن زباله‌روبی (GC) فعال می‌شود. مقدار پیش‌فرض 100 است. .TP .B LOGGER_DISCARD ترفندی برای غیرفعال کردن کامل ثبت لاگ، مثلاً هنگام اجرای معیارهای ارزیابی (benchmarks). .UNINDENT .SH "همچنین ببینید (SEE ALSO)" .sp \fBsyncthing\-config(5)\fP, \fBsyncthing\-stignore(5)\fP, \fBsyncthing\-device\-ids(7)\fP, \fBsyncthing\-security(7)\fP, \fBsyncthing\-networking(7)\fP, \fBsyncthing\-versioning(7)\fP, \fBsyncthing\-faq(7)\fP .SH "نویسندگان (AUTHOR)" نویسندگان و توسعه‌دهندگان Syncthing .SH "حق نشر (COPYRIGHT)" 2014-2026, The Syncthing Authors