mirror of
https://github.com/octoleo/syncthing.git
synced 2025-01-22 22:58:25 +00:00
gui, man: Update docs & translations
This commit is contained in:
parent
95a65bf0d0
commit
bd12e38b56
@ -191,7 +191,7 @@
|
|||||||
"See external versioning help for supported templated command line parameters.": "Consulter l'aide à la gestion externe des versions pour voir les paramètres de ligne de commande supportés.",
|
"See external versioning help for supported templated command line parameters.": "Consulter l'aide à la gestion externe des versions pour voir les paramètres de ligne de commande supportés.",
|
||||||
"Select a version": "Choisissez une version",
|
"Select a version": "Choisissez une version",
|
||||||
"Select the devices to share this folder with.": "Synchroniser avec :",
|
"Select the devices to share this folder with.": "Synchroniser avec :",
|
||||||
"Select the folders to share with this device.": "Sélectionner les partages auxquels cet appareil doit participer :",
|
"Select the folders to share with this device.": "Choisir les partages auxquels cet appareil doit participer :",
|
||||||
"Send & Receive": "Envoi & réception",
|
"Send & Receive": "Envoi & réception",
|
||||||
"Send Only": "Envoi (lecture seule)",
|
"Send Only": "Envoi (lecture seule)",
|
||||||
"Settings": "Configuration",
|
"Settings": "Configuration",
|
||||||
|
@ -24,7 +24,7 @@
|
|||||||
"An external command handles the versioning. It has to remove the file from the shared folder.": "外部コマンドにバージョン管理を任せます。ここで指定するコマンドは、共有フォルダーからファイルを削除するものでなくてはなりません。",
|
"An external command handles the versioning. It has to remove the file from the shared folder.": "外部コマンドにバージョン管理を任せます。ここで指定するコマンドは、共有フォルダーからファイルを削除するものでなくてはなりません。",
|
||||||
"An external command handles the versioning. It has to remove the file from the synced folder.": "外部コマンドにバージョンを管理させます。ここで指定するコマンドは、同期フォルダーからファイルを削除するものでなくてはなりません。",
|
"An external command handles the versioning. It has to remove the file from the synced folder.": "外部コマンドにバージョンを管理させます。ここで指定するコマンドは、同期フォルダーからファイルを削除するものでなくてはなりません。",
|
||||||
"Anonymous Usage Reporting": "匿名での使用状況レポート",
|
"Anonymous Usage Reporting": "匿名での使用状況レポート",
|
||||||
"Anonymous usage report format has changed. Would you like to move to the new format?": "Anonymous usage report format has changed. Would you like to move to the new format?",
|
"Anonymous usage report format has changed. Would you like to move to the new format?": "匿名での使用状況レポートのフォーマットが変わりました。新形式でのレポートに移行しますか?",
|
||||||
"Any devices configured on an introducer device will be added to this device as well.": "紹介者デバイス上で設定されたデバイスは、このデバイス上にも追加されます。",
|
"Any devices configured on an introducer device will be added to this device as well.": "紹介者デバイス上で設定されたデバイスは、このデバイス上にも追加されます。",
|
||||||
"Automatic upgrade now offers the choice between stable releases and release candidates.": "自動アップグレードは、安定版とリリース候補版のいずれかを選べるようになりました。",
|
"Automatic upgrade now offers the choice between stable releases and release candidates.": "自動アップグレードは、安定版とリリース候補版のいずれかを選べるようになりました。",
|
||||||
"Automatic upgrades": "自動アップグレード",
|
"Automatic upgrades": "自動アップグレード",
|
||||||
@ -54,7 +54,7 @@
|
|||||||
"Device Identification": "デバイスID",
|
"Device Identification": "デバイスID",
|
||||||
"Device Name": "デバイス名",
|
"Device Name": "デバイス名",
|
||||||
"Devices": "デバイス",
|
"Devices": "デバイス",
|
||||||
"Disabled": "Disabled",
|
"Disabled": "無効",
|
||||||
"Disconnected": "切断中",
|
"Disconnected": "切断中",
|
||||||
"Discovered": "探索結果",
|
"Discovered": "探索結果",
|
||||||
"Discovery": "探索サーバー",
|
"Discovery": "探索サーバー",
|
||||||
@ -152,7 +152,7 @@
|
|||||||
"Outgoing Rate Limit (KiB/s)": "上り帯域制限 (KiB/s)",
|
"Outgoing Rate Limit (KiB/s)": "上り帯域制限 (KiB/s)",
|
||||||
"Override Changes": "他のデバイスの変更を上書きする",
|
"Override Changes": "他のデバイスの変更を上書きする",
|
||||||
"Path": "パス",
|
"Path": "パス",
|
||||||
"Path to the folder on the local computer. Will be created if it does not exist. The tilde character (~) can be used as a shortcut for": "ローカルコンピュータ上のフォルダーパス。フォルダーが存在しない場合は作成されます。チルダ (~) で次のフォルダーを短縮入力できます:",
|
"Path to the folder on the local computer. Will be created if it does not exist. The tilde character (~) can be used as a shortcut for": "ローカルコンピュータ上のフォルダーパス。フォルダーが存在しない場合は作成されます。チルダ (~) で以下のフォルダーを短縮入力できます:",
|
||||||
"Path where versions should be stored (leave empty for the default .stversions directory in the shared folder).": "古いバージョンを保存するパス (空欄の場合、デフォルトで共有フォルダー内の .stversions ディレクトリ)",
|
"Path where versions should be stored (leave empty for the default .stversions directory in the shared folder).": "古いバージョンを保存するパス (空欄の場合、デフォルトで共有フォルダー内の .stversions ディレクトリ)",
|
||||||
"Path where versions should be stored (leave empty for the default .stversions folder in the folder).": "古いバージョンを保存するパス (空欄の場合、デフォルトでフォルダー内の .stversions フォルダー)",
|
"Path where versions should be stored (leave empty for the default .stversions folder in the folder).": "古いバージョンを保存するパス (空欄の場合、デフォルトでフォルダー内の .stversions フォルダー)",
|
||||||
"Pause": "一時停止",
|
"Pause": "一時停止",
|
||||||
@ -188,8 +188,8 @@
|
|||||||
"Scan Time Remaining": "スキャン残り時間",
|
"Scan Time Remaining": "スキャン残り時間",
|
||||||
"Scanning": "スキャン中",
|
"Scanning": "スキャン中",
|
||||||
"See external versioner help for supported templated command line parameters.": "See external versioner help for supported templated command line parameters.",
|
"See external versioner help for supported templated command line parameters.": "See external versioner help for supported templated command line parameters.",
|
||||||
"See external versioning help for supported templated command line parameters.": "See external versioning help for supported templated command line parameters.",
|
"See external versioning help for supported templated command line parameters.": "使用可能なコマンドラインパラメータについてはお使いのバージョン管理ツールのヘルプを参照してください。",
|
||||||
"Select a version": "Select a version",
|
"Select a version": "バージョンを選択してください",
|
||||||
"Select the devices to share this folder with.": "このフォルダーを共有するデバイスを選択してください。",
|
"Select the devices to share this folder with.": "このフォルダーを共有するデバイスを選択してください。",
|
||||||
"Select the folders to share with this device.": "このデバイスと共有するフォルダーを選択してください。",
|
"Select the folders to share with this device.": "このデバイスと共有するフォルダーを選択してください。",
|
||||||
"Send & Receive": "送受信",
|
"Send & Receive": "送受信",
|
||||||
@ -203,7 +203,7 @@
|
|||||||
"Shared With": "共有中のデバイス",
|
"Shared With": "共有中のデバイス",
|
||||||
"Show ID": "IDを表示",
|
"Show ID": "IDを表示",
|
||||||
"Show QR": "QRコードを表示",
|
"Show QR": "QRコードを表示",
|
||||||
"Show diff with previous version": "Show diff with previous version",
|
"Show diff with previous version": "前バージョンとの差分を表示",
|
||||||
"Shown instead of Device ID in the cluster status. Will be advertised to other devices as an optional default name.": "ステータス画面でデバイスIDの代わりに表示されます。他のデバイスに対してもデフォルトの名前として通知されます。",
|
"Shown instead of Device ID in the cluster status. Will be advertised to other devices as an optional default name.": "ステータス画面でデバイスIDの代わりに表示されます。他のデバイスに対してもデフォルトの名前として通知されます。",
|
||||||
"Shown instead of Device ID in the cluster status. Will be updated to the name the device advertises if left empty.": "ステータス画面でデバイスIDの代わりに表示されます。空欄にすると相手側デバイスが通知してきた名前で更新されます。",
|
"Shown instead of Device ID in the cluster status. Will be updated to the name the device advertises if left empty.": "ステータス画面でデバイスIDの代わりに表示されます。空欄にすると相手側デバイスが通知してきた名前で更新されます。",
|
||||||
"Shutdown": "シャットダウン",
|
"Shutdown": "シャットダウン",
|
||||||
@ -229,7 +229,7 @@
|
|||||||
"Syncthing seems to be down, or there is a problem with your Internet connection. Retrying…": "Syncthingが落ちているか、インターネット接続に問題があります。リトライ中です…",
|
"Syncthing seems to be down, or there is a problem with your Internet connection. Retrying…": "Syncthingが落ちているか、インターネット接続に問題があります。リトライ中です…",
|
||||||
"Syncthing seems to be experiencing a problem processing your request. Please refresh the page or restart Syncthing if the problem persists.": "リクエストの処理に問題があるようです。問題が継続する場合、ページを更新するかSyncthingを再起動してください。",
|
"Syncthing seems to be experiencing a problem processing your request. Please refresh the page or restart Syncthing if the problem persists.": "リクエストの処理に問題があるようです。問題が継続する場合、ページを更新するかSyncthingを再起動してください。",
|
||||||
"The Syncthing admin interface is configured to allow remote access without a password.": "Syncthingの管理画面が、パスワードなしで外部からアクセスできるように設定されています。",
|
"The Syncthing admin interface is configured to allow remote access without a password.": "Syncthingの管理画面が、パスワードなしで外部からアクセスできるように設定されています。",
|
||||||
"The aggregated statistics are publicly available at the URL below.": "集計結果は次のURLで公開されています。",
|
"The aggregated statistics are publicly available at the URL below.": "集計結果は以下のURLで公開されています。",
|
||||||
"The configuration has been saved but not activated. Syncthing must restart to activate the new configuration.": "設定が保存されましたが、まだ有効になっていません。新しい設定を有効にするにはSyncthingを再起動してください。",
|
"The configuration has been saved but not activated. Syncthing must restart to activate the new configuration.": "設定が保存されましたが、まだ有効になっていません。新しい設定を有効にするにはSyncthingを再起動してください。",
|
||||||
"The device ID cannot be blank.": "デバイスIDを入力してください。",
|
"The device ID cannot be blank.": "デバイスIDを入力してください。",
|
||||||
"The device ID to enter here can be found in the \"Actions > Show ID\" dialog on the other device. Spaces and dashes are optional (ignored).": "ここに入力するデバイスIDは、接続したい相手側デバイスの [メニュー]→[IDを表示] で確認できます。スペースとハイフンは入力しなくてもかまいません。",
|
"The device ID to enter here can be found in the \"Actions > Show ID\" dialog on the other device. Spaces and dashes are optional (ignored).": "ここに入力するデバイスIDは、接続したい相手側デバイスの [メニュー]→[IDを表示] で確認できます。スペースとハイフンは入力しなくてもかまいません。",
|
||||||
@ -259,7 +259,7 @@
|
|||||||
"Time": "日時",
|
"Time": "日時",
|
||||||
"Trash Can File Versioning": "ゴミ箱によるバージョン管理",
|
"Trash Can File Versioning": "ゴミ箱によるバージョン管理",
|
||||||
"Type": "タイプ",
|
"Type": "タイプ",
|
||||||
"Undecided (will prompt)": "Undecided (will prompt)",
|
"Undecided (will prompt)": "未決定(再確認する)",
|
||||||
"Unknown": "不明",
|
"Unknown": "不明",
|
||||||
"Unshared": "非共有",
|
"Unshared": "非共有",
|
||||||
"Unused": "未使用",
|
"Unused": "未使用",
|
||||||
|
@ -54,7 +54,7 @@
|
|||||||
"Device Identification": "Идентификация устройства",
|
"Device Identification": "Идентификация устройства",
|
||||||
"Device Name": "Имя устройства",
|
"Device Name": "Имя устройства",
|
||||||
"Devices": "Устройства",
|
"Devices": "Устройства",
|
||||||
"Disabled": "Disabled",
|
"Disabled": "Отключено",
|
||||||
"Disconnected": "Нет соединения",
|
"Disconnected": "Нет соединения",
|
||||||
"Discovered": "Обнаружено",
|
"Discovered": "Обнаружено",
|
||||||
"Discovery": "Обнаружение",
|
"Discovery": "Обнаружение",
|
||||||
@ -86,7 +86,7 @@
|
|||||||
"Files are moved to date stamped versions in a .stversions directory when replaced or deleted by Syncthing.": "Когда Syncthing изменяет или удаляет файлы, их версии с таймштампами помещаются в папку .stversions",
|
"Files are moved to date stamped versions in a .stversions directory when replaced or deleted by Syncthing.": "Когда Syncthing изменяет или удаляет файлы, их версии с таймштампами помещаются в папку .stversions",
|
||||||
"Files are moved to date stamped versions in a .stversions folder when replaced or deleted by Syncthing.": "Файлы с временнОй меткой версии помещаются в папку .stversions при их замене или удалении Syncthing.",
|
"Files are moved to date stamped versions in a .stversions folder when replaced or deleted by Syncthing.": "Файлы с временнОй меткой версии помещаются в папку .stversions при их замене или удалении Syncthing.",
|
||||||
"Files are protected from changes made on other devices, but changes made on this device will be sent to the rest of the cluster.": "Файлы защищены от изменений сделанных на других устройствах, но изменения сделанные на этом устройстве будут отправлены всему кластеру.",
|
"Files are protected from changes made on other devices, but changes made on this device will be sent to the rest of the cluster.": "Файлы защищены от изменений сделанных на других устройствах, но изменения сделанные на этом устройстве будут отправлены всему кластеру.",
|
||||||
"Filesystem Notifications": "Filesystem Notifications",
|
"Filesystem Notifications": "Уведомления файловой системы",
|
||||||
"Folder": "Папка",
|
"Folder": "Папка",
|
||||||
"Folder ID": "ID папки",
|
"Folder ID": "ID папки",
|
||||||
"Folder Label": "Ярлык папки",
|
"Folder Label": "Ярлык папки",
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "STDISCOSRV" "1" "November 18, 2017" "v0.14" "Syncthing"
|
.TH "STDISCOSRV" "1" "Nov 23, 2017" "v0.14" "Syncthing"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
stdiscosrv \- Syncthing Discovery Server
|
stdiscosrv \- Syncthing Discovery Server
|
||||||
.
|
.
|
||||||
@ -51,17 +51,17 @@ can run a discovery server and point Syncthing installations to it.
|
|||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-cert=<file>
|
.B \-cert=<file>
|
||||||
Certificate file (default "cert.pem").
|
Certificate file (default “cert.pem”).
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-db\-backend=<string>
|
.B \-db\-backend=<string>
|
||||||
Database backend to use (default "ql").
|
Database backend to use (default “ql”).
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-db\-dsn=<string>
|
.B \-db\-dsn=<string>
|
||||||
Database DSN (default "memory://stdiscosrv").
|
Database DSN (default “memory://stdiscosrv”).
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
@ -76,7 +76,7 @@ Listen on HTTP (behind an HTTPS proxy).
|
|||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-key=<file>
|
.B \-key=<file>
|
||||||
Key file (default "key.pem").
|
Key file (default “key.pem”).
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
@ -96,7 +96,7 @@ Limiter cache entries (default 10240).
|
|||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-listen=<address>
|
.B \-listen=<address>
|
||||||
Listen address (default ":8443").
|
Listen address (default “:8443”).
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
@ -107,8 +107,8 @@ File to write periodic operation stats to.
|
|||||||
.sp
|
.sp
|
||||||
By default, Syncthing uses a number of global discovery servers, signified by
|
By default, Syncthing uses a number of global discovery servers, signified by
|
||||||
the entry \fBdefault\fP in the list of discovery servers. To make Syncthing use
|
the entry \fBdefault\fP in the list of discovery servers. To make Syncthing use
|
||||||
your own instance of stdiscosrv, open up Syncthing\(aqs web GUI. Go to settings,
|
your own instance of stdiscosrv, open up Syncthing’s web GUI. Go to settings,
|
||||||
Global Discovery Server and add stdiscosrv\(aqs host address to the comma\-separated
|
Global Discovery Server and add stdiscosrv’s host address to the comma\-separated
|
||||||
list, e.g. \fBhttps://disco.example.com:8443/v2/\fP\&. Note that stdiscosrv uses port
|
list, e.g. \fBhttps://disco.example.com:8443/v2/\fP\&. Note that stdiscosrv uses port
|
||||||
8443 by default. For stdiscosrv to be available over the internet with a dynamic
|
8443 by default. For stdiscosrv to be available over the internet with a dynamic
|
||||||
IP address, you will need a dynamic DNS service.
|
IP address, you will need a dynamic DNS service.
|
||||||
@ -119,7 +119,7 @@ entry from the list.
|
|||||||
.SS Description
|
.SS Description
|
||||||
.sp
|
.sp
|
||||||
This guide assumes that you have already set up Syncthing. If you
|
This guide assumes that you have already set up Syncthing. If you
|
||||||
haven\(aqt yet, head over to getting\-started first.
|
haven’t yet, head over to getting\-started first.
|
||||||
.SS Installing
|
.SS Installing
|
||||||
.sp
|
.sp
|
||||||
Go to \fI\%releases\fP <\fBhttps://build.syncthing.net/job/stdiscosrv\fP> and
|
Go to \fI\%releases\fP <\fBhttps://build.syncthing.net/job/stdiscosrv\fP> and
|
||||||
@ -129,7 +129,7 @@ this in whatever way you are most comfortable with; double clicking should
|
|||||||
work in any graphical environment. At first start, stdiscosrv will generate the
|
work in any graphical environment. At first start, stdiscosrv will generate the
|
||||||
directory \fB/var/stdiscosrv\fP (\fBX:\evar\estdiscosrv\fP on Windows, where X is the
|
directory \fB/var/stdiscosrv\fP (\fBX:\evar\estdiscosrv\fP on Windows, where X is the
|
||||||
partition \fBstdiscosrv.exe\fP is executed from) with configuration. If the user
|
partition \fBstdiscosrv.exe\fP is executed from) with configuration. If the user
|
||||||
running \fBstdiscosrv\fP doesn\(aqt have permission to do so, create the directory
|
running \fBstdiscosrv\fP doesn’t have permission to do so, create the directory
|
||||||
and set the owner appropriately or use the command line switches (see below)
|
and set the owner appropriately or use the command line switches (see below)
|
||||||
to select a different location.
|
to select a different location.
|
||||||
.SS Configuring
|
.SS Configuring
|
||||||
@ -151,10 +151,10 @@ from clients there are three options:
|
|||||||
.IP \(bu 2
|
.IP \(bu 2
|
||||||
Use a CA\-signed certificate pair for the domain name you will use for the
|
Use a CA\-signed certificate pair for the domain name you will use for the
|
||||||
discovery server. This is like any other HTTPS website; clients will
|
discovery server. This is like any other HTTPS website; clients will
|
||||||
authenticate the server based on it\(aqs certificate and domain name.
|
authenticate the server based on it’s certificate and domain name.
|
||||||
.IP \(bu 2
|
.IP \(bu 2
|
||||||
Use any certificate pair and let clients authenticate the server based on
|
Use any certificate pair and let clients authenticate the server based on
|
||||||
it\(aqs "device ID" (similar to Syncthing\-to\-Syncthing authentication). In
|
it’s “device ID” (similar to Syncthing\-to\-Syncthing authentication). In
|
||||||
this case, using \fBsyncthing \-generate\fP is a good option to create a
|
this case, using \fBsyncthing \-generate\fP is a good option to create a
|
||||||
certificate pair.
|
certificate pair.
|
||||||
.IP \(bu 2
|
.IP \(bu 2
|
||||||
@ -163,7 +163,7 @@ reverse proxy. See below for configuration.
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
For the first two options, the discovery server must be given the paths to
|
For the first two options, the discovery server must be given the paths to
|
||||||
the certificate and key at startup. This isn\(aqt necessary with the \fBhttp\fP flag:
|
the certificate and key at startup. This isn’t necessary with the \fBhttp\fP flag:
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
.sp
|
.sp
|
||||||
@ -176,7 +176,7 @@ Server device ID is 7DDRT7J\-UICR4PM\-PBIZYL3\-MZOJ7X7\-EX56JP6\-IK6HHMW\-S7EK32
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
The discovery server prints it\(aqs device ID at startup. In the case where you
|
The discovery server prints it’s device ID at startup. In the case where you
|
||||||
are using a non CA signed certificate, this device ID (fingerprint) must be
|
are using a non CA signed certificate, this device ID (fingerprint) must be
|
||||||
given to the clients in the discovery server URL:
|
given to the clients in the discovery server URL:
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
@ -218,10 +218,10 @@ Run the discovery server using the \-http flag \fBstdiscosrv \-http\fP\&.
|
|||||||
.IP \(bu 2
|
.IP \(bu 2
|
||||||
SSL certificate/key configured for the reverse proxy
|
SSL certificate/key configured for the reverse proxy
|
||||||
.IP \(bu 2
|
.IP \(bu 2
|
||||||
The "X\-Forwarded\-For" http header must be passed through with the client\(aqs
|
The “X\-Forwarded\-For” http header must be passed through with the client’s
|
||||||
real IP address
|
real IP address
|
||||||
.IP \(bu 2
|
.IP \(bu 2
|
||||||
The "X\-SSL\-Cert" must be passed through with the PEM\-encoded client SSL
|
The “X\-SSL\-Cert” must be passed through with the PEM\-encoded client SSL
|
||||||
certificate
|
certificate
|
||||||
.IP \(bu 2
|
.IP \(bu 2
|
||||||
The proxy must request the client SSL certificate but not require it to be
|
The proxy must request the client SSL certificate but not require it to be
|
||||||
@ -296,10 +296,10 @@ server {
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
An example of automating the SSL certificates and reverse\-proxying the Discovery
|
An example of automating the SSL certificates and reverse\-proxying the Discovery
|
||||||
Server and Syncthing using Nginx, \fI\%Let\(aqs Encrypt\fP <\fBhttps://letsencrypt.org/\fP> and Docker can be found \fI\%here\fP <\fBhttps://forum.syncthing.net/t/docker-syncthing-and-syncthing-discovery-behind-nginx-reverse-proxy-with-lets-encrypt/6880\fP>\&.
|
Server and Syncthing using Nginx, \fI\%Let’s Encrypt\fP <\fBhttps://letsencrypt.org/\fP> and Docker can be found \fI\%here\fP <\fBhttps://forum.syncthing.net/t/docker-syncthing-and-syncthing-discovery-behind-nginx-reverse-proxy-with-lets-encrypt/6880\fP>\&.
|
||||||
.SH SEE ALSO
|
.SH SEE ALSO
|
||||||
.sp
|
.sp
|
||||||
\fIsyncthing\-networking(7)\fP, \fIsyncthing\-faq(7)\fP
|
\fBsyncthing\-networking(7)\fP, \fBsyncthing\-faq(7)\fP
|
||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
The Syncthing Authors
|
The Syncthing Authors
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "STRELAYSRV" "1" "November 18, 2017" "v0.14" "Syncthing"
|
.TH "STRELAYSRV" "1" "Nov 23, 2017" "v0.14" "Syncthing"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
strelaysrv \- Syncthing Relay Server
|
strelaysrv \- Syncthing Relay Server
|
||||||
.
|
.
|
||||||
@ -72,12 +72,12 @@ Global rate limit, in bytes/s.
|
|||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-keys=<dir>
|
.B \-keys=<dir>
|
||||||
Directory where cert.pem and key.pem is stored (default ".").
|
Directory where cert.pem and key.pem is stored (default “.”).
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-listen=<listen addr>
|
.B \-listen=<listen addr>
|
||||||
Protocol listen address (default ":22067").
|
Protocol listen address (default “:22067”).
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
@ -127,13 +127,13 @@ How often pings are sent (default 1m0s).
|
|||||||
.TP
|
.TP
|
||||||
.B \-pools=<pool addresses>
|
.B \-pools=<pool addresses>
|
||||||
Comma separated list of relay pool addresses to join (default
|
Comma separated list of relay pool addresses to join (default
|
||||||
"\fI\%http://relays.syncthing.net/endpoint\fP"). Blank to disable announcement to
|
“\fI\%http://relays.syncthing.net/endpoint\fP”). Blank to disable announcement to
|
||||||
a pool, thereby remaining a private relay.
|
a pool, thereby remaining a private relay.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-protocol=<string>
|
.B \-protocol=<string>
|
||||||
Protocol used for listening. \(aqtcp\(aq for IPv4 and IPv6, \(aqtcp4\(aq for IPv4, \(aqtcp6\(aq for IPv6 (default "tcp").
|
Protocol used for listening. ‘tcp’ for IPv4 and IPv6, ‘tcp4’ for IPv4, ‘tcp6’ for IPv6 (default “tcp”).
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
@ -143,7 +143,7 @@ An optional description about who provides the relay.
|
|||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-status\-srv=<listen addr>
|
.B \-status\-srv=<listen addr>
|
||||||
Listen address for status service (blank to disable) (default ":22070").
|
Listen address for status service (blank to disable) (default “:22070”).
|
||||||
Status service is used by the relay pool server UI for displaying stats (data transfered, number of clients, etc.)
|
Status service is used by the relay pool server UI for displaying stats (data transfered, number of clients, etc.)
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.SH SETTING UP
|
.SH SETTING UP
|
||||||
@ -191,7 +191,7 @@ relay://private\-relay\-1.example.com:443/?id=ITZRNXE\-YNROGBZ\-HXTH5P7\-VK5NYE5
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
The relay\(aqs device ID is output on start\-up.
|
The relay’s device ID is output on start\-up.
|
||||||
.SS Running on port 443 as an unprivileged user
|
.SS Running on port 443 as an unprivileged user
|
||||||
.sp
|
.sp
|
||||||
It is recommended that you run the relay on port 443 (or another port which is
|
It is recommended that you run the relay on port 443 (or another port which is
|
||||||
@ -213,7 +213,7 @@ iptables \-t nat \-A PREROUTING \-i eth0 \-p tcp \-\-dport 443 \-j REDIRECT \-\-
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
Or, if you\(aqre using \fBufw\fP, add the following to \fB/etc/ufw/before.rules\fP:
|
Or, if you’re using \fBufw\fP, add the following to \fB/etc/ufw/before.rules\fP:
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
.sp
|
.sp
|
||||||
@ -266,8 +266,8 @@ iptables \-I INPUT \-p tcp \-\-dport 22070 \-j ACCEPT
|
|||||||
Please consult Linux distribution documentation to persist firewall rules.
|
Please consult Linux distribution documentation to persist firewall rules.
|
||||||
.SH SEE ALSO
|
.SH SEE ALSO
|
||||||
.sp
|
.sp
|
||||||
\fIsyncthing\-relay(7)\fP, \fIsyncthing\-faq(7)\fP,
|
\fBsyncthing\-relay(7)\fP, \fBsyncthing\-faq(7)\fP,
|
||||||
\fIsyncthing\-networking(7)\fP
|
\fBsyncthing\-networking(7)\fP
|
||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
The Syncthing Authors
|
The Syncthing Authors
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "SYNCTHING-BEP" "7" "November 18, 2017" "v0.14" "Syncthing"
|
.TH "SYNCTHING-BEP" "7" "Nov 23, 2017" "v0.14" "Syncthing"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
syncthing-bep \- Block Exchange Protocol v1
|
syncthing-bep \- Block Exchange Protocol v1
|
||||||
.
|
.
|
||||||
@ -44,8 +44,8 @@ other devices in the cluster.
|
|||||||
File data is described and transferred in units of \fIblocks\fP, each being
|
File data is described and transferred in units of \fIblocks\fP, each being
|
||||||
128 KiB (131072 bytes) in size.
|
128 KiB (131072 bytes) in size.
|
||||||
.sp
|
.sp
|
||||||
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
|
The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”,
|
||||||
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
|
“SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this
|
||||||
document are to be interpreted as described in RFC 2119.
|
document are to be interpreted as described in RFC 2119.
|
||||||
.SH TRANSPORT AND AUTHENTICATION
|
.SH TRANSPORT AND AUTHENTICATION
|
||||||
.sp
|
.sp
|
||||||
@ -70,8 +70,8 @@ v ... v
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
The encryption and authentication layer SHALL use TLS 1.2 or a higher
|
The encryption and authentication layer SHALL use TLS 1.2 or a higher
|
||||||
revision. A strong cipher suite SHALL be used, with "strong cipher
|
revision. A strong cipher suite SHALL be used, with “strong cipher
|
||||||
suite" being defined as being without known weaknesses and providing
|
suite” being defined as being without known weaknesses and providing
|
||||||
Perfect Forward Secrecy (PFS). Examples of strong cipher suites are
|
Perfect Forward Secrecy (PFS). Examples of strong cipher suites are
|
||||||
given at the end of this document. This is not to be taken as an
|
given at the end of this document. This is not to be taken as an
|
||||||
exhaustive list of allowed cipher suites but represents best practices
|
exhaustive list of allowed cipher suites but represents best practices
|
||||||
@ -83,7 +83,7 @@ connection. Possibilities include certificates signed by a common
|
|||||||
trusted CA, preshared certificates, preshared certificate fingerprints
|
trusted CA, preshared certificates, preshared certificate fingerprints
|
||||||
or certificate pinning combined with some out of band first
|
or certificate pinning combined with some out of band first
|
||||||
verification. The reference implementation uses preshared certificate
|
verification. The reference implementation uses preshared certificate
|
||||||
fingerprints (SHA\-256) referred to as "Device IDs".
|
fingerprints (SHA\-256) referred to as “Device IDs”.
|
||||||
.sp
|
.sp
|
||||||
There is no required order or synchronization among BEP messages except
|
There is no required order or synchronization among BEP messages except
|
||||||
as noted per message type \- any message type may be sent at any time and
|
as noted per message type \- any message type may be sent at any time and
|
||||||
@ -92,9 +92,9 @@ another.
|
|||||||
.sp
|
.sp
|
||||||
The underlying transport protocol MUST guarantee reliable packet delivery.
|
The underlying transport protocol MUST guarantee reliable packet delivery.
|
||||||
.sp
|
.sp
|
||||||
In this document, in diagrams and text, "bit 0" refers to the \fImost
|
In this document, in diagrams and text, “bit 0” refers to the \fImost
|
||||||
significant\fP bit of a word; "bit 15" is thus the least significant bit of a
|
significant\fP bit of a word; “bit 15” is thus the least significant bit of a
|
||||||
16 bit word (int16) and "bit 31" is the least significant bit of a 32 bit
|
16 bit word (int16) and “bit 31” is the least significant bit of a 32 bit
|
||||||
word (int32). Non protocol buffer integers are always represented in network
|
word (int32). Non protocol buffer integers are always represented in network
|
||||||
byte order (i.e., big endian) and are signed unless stated otherwise, but
|
byte order (i.e., big endian) and are signed unless stated otherwise, but
|
||||||
when describing message lengths negative values do not make sense and the
|
when describing message lengths negative values do not make sense and the
|
||||||
@ -107,7 +107,7 @@ message is \fIvalid\fP with all fields empty \- for example, an index entry for
|
|||||||
file that does not have a name is not useful and MAY be rejected by the
|
file that does not have a name is not useful and MAY be rejected by the
|
||||||
implementation. However the folder label is for human consumption only so an
|
implementation. However the folder label is for human consumption only so an
|
||||||
empty label should be accepted \- the implementation will have to choose some
|
empty label should be accepted \- the implementation will have to choose some
|
||||||
way to represent the folder, perhaps by using the ID in it\(aqs place or
|
way to represent the folder, perhaps by using the ID in it’s place or
|
||||||
automatically generating a label.
|
automatically generating a label.
|
||||||
.SH PRE-AUTHENTICATION MESSAGES
|
.SH PRE-AUTHENTICATION MESSAGES
|
||||||
.sp
|
.sp
|
||||||
@ -169,7 +169,7 @@ name or host name, for the remote device.
|
|||||||
The \fBclient_name\fP and \fBclient_version\fP identifies the implementation. The
|
The \fBclient_name\fP and \fBclient_version\fP identifies the implementation. The
|
||||||
values SHOULD be simple strings identifying the implementation name, as a
|
values SHOULD be simple strings identifying the implementation name, as a
|
||||||
user would expect to see it, and the version string in the same manner. An
|
user would expect to see it, and the version string in the same manner. An
|
||||||
example client name is "syncthing" and an example client version is "v0.7.2".
|
example client name is “syncthing” and an example client version is “v0.7.2”.
|
||||||
The client version field SHOULD follow the patterns laid out in the \fI\%Semantic
|
The client version field SHOULD follow the patterns laid out in the \fI\%Semantic
|
||||||
Versioning\fP <\fBhttp://semver.org/\fP> standard.
|
Versioning\fP <\fBhttp://semver.org/\fP> standard.
|
||||||
.sp
|
.sp
|
||||||
@ -460,7 +460,7 @@ The \fBfiles\fP field is a list of files making up the index information.
|
|||||||
The \fBname\fP is the file name path relative to the folder root. Like all
|
The \fBname\fP is the file name path relative to the folder root. Like all
|
||||||
strings in BEP, the Name is always in UTF\-8 NFC regardless of operating
|
strings in BEP, the Name is always in UTF\-8 NFC regardless of operating
|
||||||
system or file system specific conventions. The name field uses the slash
|
system or file system specific conventions. The name field uses the slash
|
||||||
character ("/") as path separator, regardless of the implementation\(aqs
|
character (“/”) as path separator, regardless of the implementation’s
|
||||||
operating system conventions. The combination of folder and name uniquely
|
operating system conventions. The combination of folder and name uniquely
|
||||||
identifies each file in a cluster.
|
identifies each file in a cluster.
|
||||||
.sp
|
.sp
|
||||||
@ -519,7 +519,7 @@ symlink type. It is empty for all other entry types.
|
|||||||
.SS Request
|
.SS Request
|
||||||
.sp
|
.sp
|
||||||
The Request message expresses the desire to receive a data block
|
The Request message expresses the desire to receive a data block
|
||||||
corresponding to a part of a certain file in the peer\(aqs folder.
|
corresponding to a part of a certain file in the peer’s folder.
|
||||||
.SS Protocol Buffer Schema
|
.SS Protocol Buffer Schema
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
@ -542,7 +542,7 @@ message Request {
|
|||||||
.SS Fields
|
.SS Fields
|
||||||
.sp
|
.sp
|
||||||
The \fBid\fP is the request identifier. It will be matched in the
|
The \fBid\fP is the request identifier. It will be matched in the
|
||||||
corresponding \fBRequest\fP message. Each outstanding request must have a
|
corresponding \fBResponse\fP message. Each outstanding request must have a
|
||||||
unique ID.
|
unique ID.
|
||||||
.sp
|
.sp
|
||||||
The \fBfolder\fP and \fBname\fP fields are as documented for the Index message.
|
The \fBfolder\fP and \fBname\fP fields are as documented for the Index message.
|
||||||
@ -556,7 +556,7 @@ requested hash. The other device MAY reuse a block from a different file and
|
|||||||
offset having the same size and hash, if one exists.
|
offset having the same size and hash, if one exists.
|
||||||
.sp
|
.sp
|
||||||
The \fBfrom temporary\fP field is set to indicate that the read should be
|
The \fBfrom temporary\fP field is set to indicate that the read should be
|
||||||
performed from the temporary file (converting name to it\(aqs temporary form)
|
performed from the temporary file (converting name to it’s temporary form)
|
||||||
and falling back to the non temporary file if any error occurs. Knowledge of
|
and falling back to the non temporary file if any error occurs. Knowledge of
|
||||||
contents of temporary files comes from DownloadProgress messages.
|
contents of temporary files comes from DownloadProgress messages.
|
||||||
.SS Response
|
.SS Response
|
||||||
@ -754,7 +754,7 @@ directions.
|
|||||||
.sp
|
.sp
|
||||||
In send\-only mode, a device does not apply any updates from the cluster, but
|
In send\-only mode, a device does not apply any updates from the cluster, but
|
||||||
publishes changes of its local folder to the cluster as usual. The local
|
publishes changes of its local folder to the cluster as usual. The local
|
||||||
folder can be seen as a "master copy" that is never affected by the actions
|
folder can be seen as a “master copy” that is never affected by the actions
|
||||||
of other cluster devices.
|
of other cluster devices.
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
@ -783,7 +783,7 @@ index data.
|
|||||||
For situations with large indexes or frequent reconnects this can be quite
|
For situations with large indexes or frequent reconnects this can be quite
|
||||||
inefficient. A mechanism can then be used to retain index data between
|
inefficient. A mechanism can then be used to retain index data between
|
||||||
connections and only transmit any changes since that data on connection
|
connections and only transmit any changes since that data on connection
|
||||||
start. This is called "delta indexes". To enable this mechanism the
|
start. This is called “delta indexes”. To enable this mechanism the
|
||||||
\fBsequence\fP and \fBindex ID\fP fields are used.
|
\fBsequence\fP and \fBindex ID\fP fields are used.
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
@ -832,7 +832,7 @@ Update messages rather than sending a very large Index message.
|
|||||||
The Syncthing implementation imposes a hard limit of 500,000,000 bytes on
|
The Syncthing implementation imposes a hard limit of 500,000,000 bytes on
|
||||||
all messages. Attempting to send or receive a larger message will result in
|
all messages. Attempting to send or receive a larger message will result in
|
||||||
a connection close. This size was chosen to accommodate Index messages
|
a connection close. This size was chosen to accommodate Index messages
|
||||||
containing a large block list. It\(aqs intended that the limit may be further
|
containing a large block list. It’s intended that the limit may be further
|
||||||
reduced in a future protocol update supporting variable block sizes (and
|
reduced in a future protocol update supporting variable block sizes (and
|
||||||
thus shorter block lists for large files).
|
thus shorter block lists for large files).
|
||||||
.SH EXAMPLE EXCHANGE
|
.SH EXAMPLE EXCHANGE
|
||||||
@ -943,7 +943,7 @@ T} T{
|
|||||||
T}
|
T}
|
||||||
_
|
_
|
||||||
T{
|
T{
|
||||||
\&...
|
…
|
||||||
T} T{
|
T} T{
|
||||||
T} T{
|
T} T{
|
||||||
T}
|
T}
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "SYNCTHING-CONFIG" "5" "November 18, 2017" "v0.14" "Syncthing"
|
.TH "SYNCTHING-CONFIG" "5" "Nov 23, 2017" "v0.14" "Syncthing"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
syncthing-config \- Syncthing Configuration
|
syncthing-config \- Syncthing Configuration
|
||||||
.
|
.
|
||||||
@ -58,7 +58,7 @@ directory the following files are located:
|
|||||||
The configuration file, in XML format.
|
The configuration file, in XML format.
|
||||||
.TP
|
.TP
|
||||||
.B \fBcert.pem\fP, \fBkey.pem\fP
|
.B \fBcert.pem\fP, \fBkey.pem\fP
|
||||||
The device\(aqs RSA public and private key. These form the basis for the
|
The device’s RSA public and private key. These form the basis for the
|
||||||
device ID. The key must be kept private.
|
device ID. The key must be kept private.
|
||||||
.TP
|
.TP
|
||||||
.B \fBhttps\-cert.pem\fP, \fBhttps\-key.pem\fP
|
.B \fBhttps\-cert.pem\fP, \fBhttps\-key.pem\fP
|
||||||
@ -81,9 +81,10 @@ The following shows an example of the default configuration file (IDs will diffe
|
|||||||
.sp
|
.sp
|
||||||
.nf
|
.nf
|
||||||
.ft C
|
.ft C
|
||||||
<configuration version="14">
|
<configuration version="26">
|
||||||
<folder id="zj2AA\-q55a7" label="Default Folder (zj2AA\-q55a7)" path="/Users/jb/Sync/" type="readwrite" rescanIntervalS="60" ignorePerms="false" autoNormalize="true">
|
<folder id="zj2AA\-q55a7" label="Default Folder" path="/Users/jb/Sync/" type="readwrite" rescanIntervalS="60" fsWatcherEnabled="false" fsWatcherDelayS="10" ignorePerms="false" autoNormalize="true">
|
||||||
<device id="3LT2GA5\-CQI4XJM\-WTZ264P\-MLOGMHL\-MCRLDNT\-MZV4RD3\-KA745CL\-OGAERQZ"></device>
|
<device id="3LT2GA5\-CQI4XJM\-WTZ264P\-MLOGMHL\-MCRLDNT\-MZV4RD3\-KA745CL\-OGAERQZ"></device>
|
||||||
|
<filesystemType>basic</filesystemType>
|
||||||
<minDiskFree unit="%">1</minDiskFree>
|
<minDiskFree unit="%">1</minDiskFree>
|
||||||
<versioning></versioning>
|
<versioning></versioning>
|
||||||
<copiers>0</copiers>
|
<copiers>0</copiers>
|
||||||
@ -92,17 +93,19 @@ The following shows an example of the default configuration file (IDs will diffe
|
|||||||
<order>random</order>
|
<order>random</order>
|
||||||
<ignoreDelete>false</ignoreDelete>
|
<ignoreDelete>false</ignoreDelete>
|
||||||
<scanProgressIntervalS>0</scanProgressIntervalS>
|
<scanProgressIntervalS>0</scanProgressIntervalS>
|
||||||
<pullerSleepS>0</pullerSleepS>
|
|
||||||
<pullerPauseS>0</pullerPauseS>
|
<pullerPauseS>0</pullerPauseS>
|
||||||
<maxConflicts>\-1</maxConflicts>
|
<maxConflicts>\-1</maxConflicts>
|
||||||
<disableSparseFiles>false</disableSparseFiles>
|
<disableSparseFiles>false</disableSparseFiles>
|
||||||
<disableTempIndexes>false</disableTempIndexes>
|
<disableTempIndexes>false</disableTempIndexes>
|
||||||
<fsync>false</fsync>
|
<paused>false</paused>
|
||||||
|
<weakHashThresholdPct>25</weakHashThresholdPct>
|
||||||
|
<markerName>.stfolder</markerName>
|
||||||
</folder>
|
</folder>
|
||||||
<device id="3LT2GA5\-CQI4XJM\-WTZ264P\-MLOGMHL\-MCRLDNT\-MZV4RD3\-KA745CL\-OGAERQZ" name="syno" compression="metadata" introducer="false">
|
<device id="3LT2GA5\-CQI4XJM\-WTZ264P\-MLOGMHL\-MCRLDNT\-MZV4RD3\-KA745CL\-OGAERQZ" name="syno" compression="metadata" introducer="false" skipIntroductionRemovals="false" introducedBy="">
|
||||||
<address>dynamic</address>
|
<address>dynamic</address>
|
||||||
|
<paused>false</paused>
|
||||||
</device>
|
</device>
|
||||||
<gui enabled="true" tls="false">
|
<gui enabled="true" tls="false" debugging="false">
|
||||||
<address>127.0.0.1:8384</address>
|
<address>127.0.0.1:8384</address>
|
||||||
<apikey>k1dnz1Dd0rzTBjjFFh7CXPnrF12C49B1</apikey>
|
<apikey>k1dnz1Dd0rzTBjjFFh7CXPnrF12C49B1</apikey>
|
||||||
<theme>default</theme>
|
<theme>default</theme>
|
||||||
@ -125,21 +128,34 @@ The following shows an example of the default configuration file (IDs will diffe
|
|||||||
<natRenewalMinutes>30</natRenewalMinutes>
|
<natRenewalMinutes>30</natRenewalMinutes>
|
||||||
<natTimeoutSeconds>10</natTimeoutSeconds>
|
<natTimeoutSeconds>10</natTimeoutSeconds>
|
||||||
<urAccepted>0</urAccepted>
|
<urAccepted>0</urAccepted>
|
||||||
<urUniqueID></urUniqueID>
|
<urSeen>0</urSeen>
|
||||||
|
<urUniqueID>LFWe2vn3</urUniqueID>
|
||||||
<urURL>https://data.syncthing.net/newdata</urURL>
|
<urURL>https://data.syncthing.net/newdata</urURL>
|
||||||
<urPostInsecurely>false</urPostInsecurely>
|
<urPostInsecurely>false</urPostInsecurely>
|
||||||
<urInitialDelayS>1800</urInitialDelayS>
|
<urInitialDelayS>1800</urInitialDelayS>
|
||||||
<restartOnWakeup>true</restartOnWakeup>
|
<restartOnWakeup>true</restartOnWakeup>
|
||||||
<autoUpgradeIntervalH>12</autoUpgradeIntervalH>
|
<autoUpgradeIntervalH>12</autoUpgradeIntervalH>
|
||||||
|
<upgradeToPreReleases>false</upgradeToPreReleases>
|
||||||
<keepTemporariesH>24</keepTemporariesH>
|
<keepTemporariesH>24</keepTemporariesH>
|
||||||
<cacheIgnoredFiles>false</cacheIgnoredFiles>
|
<cacheIgnoredFiles>false</cacheIgnoredFiles>
|
||||||
<progressUpdateIntervalS>5</progressUpdateIntervalS>
|
<progressUpdateIntervalS>5</progressUpdateIntervalS>
|
||||||
<limitBandwidthInLan>false</limitBandwidthInLan>
|
<limitBandwidthInLan>false</limitBandwidthInLan>
|
||||||
<minHomeDiskFree unit="%">1</minHomeDiskFree>
|
<minHomeDiskFree unit="%">1</minHomeDiskFree>
|
||||||
<releasesURL>https://api.github.com/repos/syncthing/syncthing/releases?per_page=30</releasesURL>
|
<releasesURL>https://upgrades.syncthing.net/meta.json</releasesURL>
|
||||||
<overwriteRemoteDeviceNamesOnConnect>false</overwriteRemoteDeviceNamesOnConnect>
|
<overwriteRemoteDeviceNamesOnConnect>false</overwriteRemoteDeviceNamesOnConnect>
|
||||||
<tempIndexMinBlocks>10</tempIndexMinBlocks>
|
<tempIndexMinBlocks>10</tempIndexMinBlocks>
|
||||||
|
<trafficClass>0</trafficClass>
|
||||||
|
<weakHashSelectionMethod>auto</weakHashSelectionMethod>
|
||||||
|
<stunServer>default</stunServer>
|
||||||
|
<stunKeepaliveSeconds>24</stunKeepaliveSeconds>
|
||||||
|
<kcpNoDelay>false</kcpNoDelay>
|
||||||
|
<kcpUpdateIntervalMs>25</kcpUpdateIntervalMs>
|
||||||
|
<kcpFastResend>false</kcpFastResend>
|
||||||
|
<kcpCongestionControl>true</kcpCongestionControl>
|
||||||
|
<kcpSendWindowSize>128</kcpSendWindowSize>
|
||||||
|
<kcpReceiveWindowSize>128</kcpReceiveWindowSize>
|
||||||
<defaultFolderPath>~</defaultFolderPath>
|
<defaultFolderPath>~</defaultFolderPath>
|
||||||
|
<minHomeDiskFreePct>0</minHomeDiskFreePct>
|
||||||
</options>
|
</options>
|
||||||
</configuration>
|
</configuration>
|
||||||
.ft P
|
.ft P
|
||||||
@ -147,22 +163,55 @@ The following shows an example of the default configuration file (IDs will diffe
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.SH CONFIGURATION ELEMENT
|
.SH CONFIGURATION ELEMENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.INDENT 3.5
|
||||||
.sp
|
.sp
|
||||||
This is the root element.
|
.nf
|
||||||
|
.ft C
|
||||||
|
<configuration version="26">
|
||||||
|
<folder></folder>
|
||||||
|
<device></device>
|
||||||
|
<gui></gui>
|
||||||
|
<options></options>
|
||||||
|
<ignoredDevice>5SYI2FS\-LW6YAXI\-JJDYETS\-NDBBPIO\-256MWBO\-XDPXWVG\-24QPUM4\-PDW4UQU</ignoredDevice>
|
||||||
|
<ignoredFolder>bd7q3\-zskm5</ignoredDevice>
|
||||||
|
</configuration>
|
||||||
|
.ft P
|
||||||
|
.fi
|
||||||
|
.UNINDENT
|
||||||
|
.UNINDENT
|
||||||
|
.sp
|
||||||
|
This is the root element. It has one attribute:
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B version
|
.B version
|
||||||
The config version. Increments whenever a change is made that requires
|
The config version. Increments whenever a change is made that requires
|
||||||
migration from previous formats.
|
migration from previous formats.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
|
.sp
|
||||||
|
It contains the elements described in the following sections and these two
|
||||||
|
additional child elements:
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B ignoredDevice
|
||||||
|
Contains the ID of the device that should be ignored. Connection attempts
|
||||||
|
from this device are logged to the console but never displayed in the web
|
||||||
|
GUI.
|
||||||
|
.TP
|
||||||
|
.B ignoredFolder
|
||||||
|
Contains the ID of the folder that should be ignored. This folder will
|
||||||
|
always be skipped when advertised from a remote device, i.e. this will be
|
||||||
|
logged, but there will be no dialog about it in the web GUI.
|
||||||
|
.UNINDENT
|
||||||
.SH FOLDER ELEMENT
|
.SH FOLDER ELEMENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
.sp
|
.sp
|
||||||
.nf
|
.nf
|
||||||
.ft C
|
.ft C
|
||||||
<folder id="zj2AA\-q55a7" label="Default Folder (zj2AA\-q55a7)" path="/Users/jb/Sync/" type="readwrite" rescanIntervalS="60" ignorePerms="false" autoNormalize="true" ro="false">
|
<folder id="zj2AA\-q55a7" label="Default Folder" path="/Users/jb/Sync/" type="readwrite" rescanIntervalS="60" fsWatcherEnabled="false" fsWatcherDelayS="10" ignorePerms="false" autoNormalize="true">
|
||||||
<device id="3LT2GA5\-CQI4XJM\-WTZ264P\-MLOGMHL\-MCRLDNT\-MZV4RD3\-KA745CL\-OGAERQZ" introducedBy="2CYF2WQ\-AKZO2QZ\-JAKWLYD\-AGHMQUM\-BGXUOIS\-GYILW34\-HJG3DUK\-LRRYQAR"></device>
|
<device id="3LT2GA5\-CQI4XJM\-WTZ264P\-MLOGMHL\-MCRLDNT\-MZV4RD3\-KA745CL\-OGAERQZ"></device>
|
||||||
|
<filesystemType>basic</filesystemType>
|
||||||
<minDiskFree unit="%">1</minDiskFree>
|
<minDiskFree unit="%">1</minDiskFree>
|
||||||
<versioning></versioning>
|
<versioning></versioning>
|
||||||
<copiers>0</copiers>
|
<copiers>0</copiers>
|
||||||
@ -171,12 +220,13 @@ migration from previous formats.
|
|||||||
<order>random</order>
|
<order>random</order>
|
||||||
<ignoreDelete>false</ignoreDelete>
|
<ignoreDelete>false</ignoreDelete>
|
||||||
<scanProgressIntervalS>0</scanProgressIntervalS>
|
<scanProgressIntervalS>0</scanProgressIntervalS>
|
||||||
<pullerSleepS>0</pullerSleepS>
|
|
||||||
<pullerPauseS>0</pullerPauseS>
|
<pullerPauseS>0</pullerPauseS>
|
||||||
<maxConflicts>\-1</maxConflicts>
|
<maxConflicts>\-1</maxConflicts>
|
||||||
<disableSparseFiles>false</disableSparseFiles>
|
<disableSparseFiles>false</disableSparseFiles>
|
||||||
<disableTempIndexes>false</disableTempIndexes>
|
<disableTempIndexes>false</disableTempIndexes>
|
||||||
<fsync>false</fsync>
|
<paused>false</paused>
|
||||||
|
<weakHashThresholdPct>25</weakHashThresholdPct>
|
||||||
|
<markerName>.stfolder</markerName>
|
||||||
</folder>
|
</folder>
|
||||||
.ft P
|
.ft P
|
||||||
.fi
|
.fi
|
||||||
@ -208,7 +258,7 @@ Controls how the folder is handled by Syncthing. Possible values are:
|
|||||||
The folder is in default mode. Sending local and accepting remote changes.
|
The folder is in default mode. Sending local and accepting remote changes.
|
||||||
.TP
|
.TP
|
||||||
.B readonly
|
.B readonly
|
||||||
The folder is in "send\-only" mode \-\- it will not be modified by
|
The folder is in “send\-only” mode – it will not be modified by
|
||||||
Syncthing on this device.
|
Syncthing on this device.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.TP
|
.TP
|
||||||
@ -216,6 +266,13 @@ Syncthing on this device.
|
|||||||
The rescan interval, in seconds. Can be set to zero to disable when external
|
The rescan interval, in seconds. Can be set to zero to disable when external
|
||||||
plugins are used to trigger rescans.
|
plugins are used to trigger rescans.
|
||||||
.TP
|
.TP
|
||||||
|
.B fsWatcherEnabled
|
||||||
|
If enabled this detects changes to files in the folder and scans them.
|
||||||
|
.TP
|
||||||
|
.B fsWatcherDelayS
|
||||||
|
The duration during which changes detected are accumulated, before a scan is
|
||||||
|
scheduled (only takes effect if fsWatcherEnabled is true).
|
||||||
|
.TP
|
||||||
.B ignorePerms
|
.B ignorePerms
|
||||||
True if the folder should ignore permissions.
|
True if the folder should ignore permissions.
|
||||||
.TP
|
.TP
|
||||||
@ -257,7 +314,7 @@ versioning
|
|||||||
.B copiers, pullers, hashers
|
.B copiers, pullers, hashers
|
||||||
The number of copier, puller and hasher routines to use, or zero for the
|
The number of copier, puller and hasher routines to use, or zero for the
|
||||||
system determined optimum. These are low level performance options for
|
system determined optimum. These are low level performance options for
|
||||||
advanced users only; do not change unless requested to or you\(aqve actually
|
advanced users only; do not change unless requested to or you’ve actually
|
||||||
read and understood the code yourself. :)
|
read and understood the code yourself. :)
|
||||||
.TP
|
.TP
|
||||||
.B order
|
.B order
|
||||||
@ -288,9 +345,9 @@ delete files from other devices.
|
|||||||
The interval with which scan progress information is sent to the GUI. Zero
|
The interval with which scan progress information is sent to the GUI. Zero
|
||||||
means the default value (two seconds).
|
means the default value (two seconds).
|
||||||
.TP
|
.TP
|
||||||
.B pullerSleepS, pullerPauseS
|
.B pullerPauseS
|
||||||
Tweaks for rate limiting the puller. Don\(aqt change these unless you know
|
Tweak for rate limiting the puller when it retries pulling files. Don’t
|
||||||
what you\(aqre doing.
|
change these unless you know what you’re doing.
|
||||||
.TP
|
.TP
|
||||||
.B maxConflicts
|
.B maxConflicts
|
||||||
The maximum number of conflict copies to keep around for any given file.
|
The maximum number of conflict copies to keep around for any given file.
|
||||||
@ -307,9 +364,30 @@ By default, devices exchange information about blocks available in
|
|||||||
transfers that are still in progress. When set to true, such information
|
transfers that are still in progress. When set to true, such information
|
||||||
is not exchanged for this folder.
|
is not exchanged for this folder.
|
||||||
.TP
|
.TP
|
||||||
|
.B paused
|
||||||
|
True if this folder is (temporarily) suspended.
|
||||||
|
.TP
|
||||||
|
.B weakHashThresholdPct
|
||||||
|
Use weak hash if more than the given percentage of the file has changed. Set
|
||||||
|
to \-1 to always use weak hash. Default value is 25.
|
||||||
|
.TP
|
||||||
|
.B markerName
|
||||||
|
Name of a directory or file in the folder root to be used as
|
||||||
|
marker\-faq\&. Default is “.stfolder”.
|
||||||
|
.TP
|
||||||
.B fsync
|
.B fsync
|
||||||
|
Deprecated since version v0.14.37.
|
||||||
|
|
||||||
|
.sp
|
||||||
Transfer updated (from other devices) files to permanent storage before
|
Transfer updated (from other devices) files to permanent storage before
|
||||||
committing the changes to the internal database.
|
committing the changes to the internal database.
|
||||||
|
.TP
|
||||||
|
.B pullerSleepS
|
||||||
|
Deprecated since version v0.14.41.
|
||||||
|
|
||||||
|
.sp
|
||||||
|
Tweak for rate limiting the puller. Don’t change these unless you know
|
||||||
|
what you’re doing.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.SH DEVICE ELEMENT
|
.SH DEVICE ELEMENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
@ -317,11 +395,13 @@ committing the changes to the internal database.
|
|||||||
.sp
|
.sp
|
||||||
.nf
|
.nf
|
||||||
.ft C
|
.ft C
|
||||||
<device id="5SYI2FS\-LW6YAXI\-JJDYETS\-NDBBPIO\-256MWBO\-XDPXWVG\-24QPUM4\-PDW4UQU" name="syno" compression="metadata" introducer="false" introducedBy="2CYF2WQ\-AKZO2QZ\-JAKWLYD\-AGHMQUM\-BGXUOIS\-GYILW34\-HJG3DUK\-LRRYQAR">
|
<device id="5SYI2FS\-LW6YAXI\-JJDYETS\-NDBBPIO\-256MWBO\-XDPXWVG\-24QPUM4\-PDW4UQU" name="syno" compression="metadata" introducer="false" skipIntroductionRemovals="false" introducedBy="2CYF2WQ\-AKZO2QZ\-JAKWLYD\-AGHMQUM\-BGXUOIS\-GYILW34\-HJG3DUK\-LRRYQAR">
|
||||||
<address>dynamic</address>
|
<address>dynamic</address>
|
||||||
</device>
|
</device>
|
||||||
<device id="2CYF2WQ\-AKZO2QZ\-JAKWLYD\-AGHMQUM\-BGXUOIS\-GYILW34\-HJG3DUK\-LRRYQAR" name="syno local" compression="metadata" introducer="false">
|
<device id="2CYF2WQ\-AKZO2QZ\-JAKWLYD\-AGHMQUM\-BGXUOIS\-GYILW34\-HJG3DUK\-LRRYQAR" name="syno local" compression="metadata" introducer="false">
|
||||||
<address>tcp://192.0.2.1:22001</address>
|
<address>tcp://192.0.2.1:22001</address>
|
||||||
|
<paused>true<paused>
|
||||||
|
<allowedNetwork>192.168.0.0/16<allowedNetwork>
|
||||||
</device>
|
</device>
|
||||||
.ft P
|
.ft P
|
||||||
.fi
|
.fi
|
||||||
@ -382,11 +462,16 @@ to even if the original introducer is no longer listing the remote device as kno
|
|||||||
Defines which device has introduced us to this device. Used only for following de\-introductions.
|
Defines which device has introduced us to this device. Used only for following de\-introductions.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
In addition, one or more \fBaddress\fP child elements must be present. Each
|
From following child elements at least one \fBaddress\fP child must exist.
|
||||||
contains an address or host name to use when attempting to connect to this device and will
|
|
||||||
be tried in order. Entries other than \fBdynamic\fP must be prefixed with \fBtcp://\fP (dual\-stack), \fBtcp4://\fP (IPv4 only) or \fBtcp6://\fP (IPv6 only). Note that IP addresses need not use tcp4/tcp6; these are optional. Accepted formats are:
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
|
.B address
|
||||||
|
Contains an address or host name to use when attempting to connect to this device.
|
||||||
|
Entries other than \fBdynamic\fP must be prefixed with \fBtcp://\fP (dual\-stack),
|
||||||
|
\fBtcp4://\fP (IPv4 only) or \fBtcp6://\fP (IPv6 only). Note that IP addresses need
|
||||||
|
not use tcp4/tcp6; these are optional. Accepted formats are:
|
||||||
|
.INDENT 7.0
|
||||||
|
.TP
|
||||||
.B IPv4 address (\fBtcp://192.0.2.42\fP)
|
.B IPv4 address (\fBtcp://192.0.2.42\fP)
|
||||||
The default port (22000) is used.
|
The default port (22000) is used.
|
||||||
.TP
|
.TP
|
||||||
@ -402,35 +487,32 @@ The address and port is used as given. The address must be enclosed in
|
|||||||
square brackets.
|
square brackets.
|
||||||
.TP
|
.TP
|
||||||
.B Host name (\fBtcp6://fileserver\fP)
|
.B Host name (\fBtcp6://fileserver\fP)
|
||||||
The host name will be used on the default port (22000) and connections will be attempted only via IPv6.
|
The host name will be used on the default port (22000) and connections
|
||||||
|
will be attempted only via IPv6.
|
||||||
.TP
|
.TP
|
||||||
.B Host name and port (\fBtcp://fileserver:12345\fP)
|
.B Host name and port (\fBtcp://fileserver:12345\fP)
|
||||||
The host name will be used on the given port and connections will be attempted via both IPv4 and IPv6, depending on name resolution.
|
The host name will be used on the given port and connections will be
|
||||||
|
attempted via both IPv4 and IPv6, depending on name resolution.
|
||||||
.TP
|
.TP
|
||||||
.B \fBdynamic\fP
|
.B \fBdynamic\fP
|
||||||
The word \fBdynamic\fP (without \fBtcp://\fP prefix) means to use local and global discovery to find the
|
The word \fBdynamic\fP (without \fBtcp://\fP prefix) means to use local and
|
||||||
device.
|
global discovery to find the device.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.SH IGNOREDDEVICE ELEMENT
|
.TP
|
||||||
.INDENT 0.0
|
.B paused
|
||||||
.INDENT 3.5
|
True if synchronization with this devices is (temporarily) suspended.
|
||||||
.sp
|
.TP
|
||||||
.nf
|
.B allowedNetwork
|
||||||
.ft C
|
If given, this restricts connections to this device to only this network
|
||||||
<ignoredDevice>5SYI2FS\-LW6YAXI\-JJDYETS\-NDBBPIO\-256MWBO\-XDPXWVG\-24QPUM4\-PDW4UQU</ignoredDevice>
|
(see allowed\-networks).
|
||||||
.ft P
|
|
||||||
.fi
|
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
This optional element lists device IDs that have been specifically ignored. One element must be present for each device ID. Connection attempts from these devices are logged to the console but never displayed in the web GUI.
|
|
||||||
.SH GUI ELEMENT
|
.SH GUI ELEMENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
.sp
|
.sp
|
||||||
.nf
|
.nf
|
||||||
.ft C
|
.ft C
|
||||||
<gui enabled="true" tls="false">
|
<gui enabled="true" tls="false" debugging="false">
|
||||||
<address>127.0.0.1:8384</address>
|
<address>127.0.0.1:8384</address>
|
||||||
<apikey>l7jSbCqPD95JYZ0g8vi4ZLAMg3ulnN1b</apikey>
|
<apikey>l7jSbCqPD95JYZ0g8vi4ZLAMg3ulnN1b</apikey>
|
||||||
<theme>default</theme>
|
<theme>default</theme>
|
||||||
@ -453,8 +535,8 @@ If set to \fBtrue\fP, TLS (HTTPS) will be enforced. Non\-HTTPS requests will
|
|||||||
be redirected to HTTPS. When this is set to \fBfalse\fP, TLS connections are
|
be redirected to HTTPS. When this is set to \fBfalse\fP, TLS connections are
|
||||||
still possible but it is not mandatory.
|
still possible but it is not mandatory.
|
||||||
.TP
|
.TP
|
||||||
.B theme
|
.B debugging
|
||||||
The name of the theme to use.
|
This enables profiling and additional debugging endpoints in the rest\-api\&.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
The following child elements may be present:
|
The following child elements may be present:
|
||||||
@ -484,6 +566,13 @@ Contains the bcrypt hash of the real password.
|
|||||||
.TP
|
.TP
|
||||||
.B apikey
|
.B apikey
|
||||||
If set, this is the API key that enables usage of the REST interface.
|
If set, this is the API key that enables usage of the REST interface.
|
||||||
|
.TP
|
||||||
|
.B insecureAdminAccess
|
||||||
|
If true, this allows access to the web GUI from outside (i.e. not localhost)
|
||||||
|
without authorization. A warning will displayed about this setting on startup.
|
||||||
|
.TP
|
||||||
|
.B theme
|
||||||
|
The name of the theme to use.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.SH OPTIONS ELEMENT
|
.SH OPTIONS ELEMENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
@ -560,12 +649,6 @@ The port on which to listen and send IPv4 broadcast announcements to.
|
|||||||
.B localAnnounceMCAddr
|
.B localAnnounceMCAddr
|
||||||
The group address and port to join and send IPv6 multicast announcements on.
|
The group address and port to join and send IPv6 multicast announcements on.
|
||||||
.TP
|
.TP
|
||||||
.B relayServer
|
|
||||||
Lists one or more relay servers, on the format \fBrelay://hostname:port\fP\&.
|
|
||||||
Alternatively, a relay list can be loaded over https by using an URL like
|
|
||||||
\fBdynamic+https://somehost/path\fP\&. The default loads the list of relays
|
|
||||||
from the relay pool server, \fBrelays.syncthing.net\fP\&.
|
|
||||||
.TP
|
|
||||||
.B maxSendKbps
|
.B maxSendKbps
|
||||||
Outgoing data rate limit, in kibibytes per second.
|
Outgoing data rate limit, in kibibytes per second.
|
||||||
.TP
|
.TP
|
||||||
@ -604,6 +687,9 @@ Whether the user has accepted to submit anonymous usage data. The default,
|
|||||||
point in the future. \fB\-1\fP means no, a number above zero means that that
|
point in the future. \fB\-1\fP means no, a number above zero means that that
|
||||||
version of usage reporting has been accepted.
|
version of usage reporting has been accepted.
|
||||||
.TP
|
.TP
|
||||||
|
.B urSeen
|
||||||
|
The highest usage reporting version that has already been shown in the web GUI.
|
||||||
|
.TP
|
||||||
.B urUniqueID
|
.B urUniqueID
|
||||||
The unique ID sent together with the usage report. Generated when usage
|
The unique ID sent together with the usage report. Generated when usage
|
||||||
reporting is enabled.
|
reporting is enabled.
|
||||||
@ -627,6 +713,10 @@ waking from sleep mode (i.e. a folded up laptop).
|
|||||||
Check for a newer version after this many hours. Set to zero to disable
|
Check for a newer version after this many hours. Set to zero to disable
|
||||||
automatic upgrades.
|
automatic upgrades.
|
||||||
.TP
|
.TP
|
||||||
|
.B upgradeToPreReleases
|
||||||
|
If true, automatical upgrades include release candidates (see
|
||||||
|
release\-channels).
|
||||||
|
.TP
|
||||||
.B keepTemporariesH
|
.B keepTemporariesH
|
||||||
Keep temporary failed transfers for this many hours. While the temporaries
|
Keep temporary failed transfers for this many hours. While the temporaries
|
||||||
are kept, the data they contain need not be transferred again.
|
are kept, the data they contain need not be transferred again.
|
||||||
@ -644,18 +734,6 @@ the GUI.
|
|||||||
Whether to apply bandwidth limits to devices in the same broadcast domain
|
Whether to apply bandwidth limits to devices in the same broadcast domain
|
||||||
as the local device.
|
as the local device.
|
||||||
.TP
|
.TP
|
||||||
.B databaseBlockCacheMiB
|
|
||||||
Override the automatically calculated database block cache size. Don\(aqt,
|
|
||||||
unless you\(aqre very short on memory, in which case you want to set this to
|
|
||||||
\fB8\fP\&.
|
|
||||||
.TP
|
|
||||||
.B pingTimeoutS
|
|
||||||
Ping\-timeout in seconds. Don\(aqt change it unless you are having issues due to
|
|
||||||
slow response time (slow connection/cpu) and large index exchanges.
|
|
||||||
.TP
|
|
||||||
.B pingIdleTimeS
|
|
||||||
Ping interval in seconds. Don\(aqt change it unless you feel it\(aqs necessary.
|
|
||||||
.TP
|
|
||||||
.B minHomeDiskFree
|
.B minHomeDiskFree
|
||||||
The minimum required free space that should be available on the
|
The minimum required free space that should be available on the
|
||||||
partition holding the configuration and index. Accepted units are \fB%\fP, \fBkB\fP,
|
partition holding the configuration and index. Accepted units are \fB%\fP, \fBkB\fP,
|
||||||
@ -664,6 +742,9 @@ partition holding the configuration and index. Accepted units are \fB%\fP, \fBkB
|
|||||||
.B releasesURL
|
.B releasesURL
|
||||||
The URL from which release information is loaded, for automatic upgrades.
|
The URL from which release information is loaded, for automatic upgrades.
|
||||||
.TP
|
.TP
|
||||||
|
.B alwaysLocalNet
|
||||||
|
Network that should be considered as local given in CIDR notation.
|
||||||
|
.TP
|
||||||
.B overwriteRemoteDeviceNamesOnConnect
|
.B overwriteRemoteDeviceNamesOnConnect
|
||||||
If set, device names will always be overwritten with the name given by
|
If set, device names will always be overwritten with the name given by
|
||||||
remote on each connection. By default, the name that the remote device
|
remote on each connection. By default, the name that the remote device
|
||||||
@ -673,9 +754,53 @@ announces will only be adopted when a name has not already been set.
|
|||||||
When exchanging index information for incomplete transfers, only take
|
When exchanging index information for incomplete transfers, only take
|
||||||
into account files that have at least this many blocks.
|
into account files that have at least this many blocks.
|
||||||
.TP
|
.TP
|
||||||
|
.B unackedNotificationID
|
||||||
|
ID of a notification to be displayed in the web GUI. Will be removed once
|
||||||
|
the user acknowledged it (e.g. an transition notice on an upgrade).
|
||||||
|
.TP
|
||||||
|
.B trafficClass
|
||||||
|
Specify a type of service (TOS)/traffic class of outgoing packets.
|
||||||
|
.TP
|
||||||
|
.B weakHashSelectionMethod
|
||||||
|
Specify whether weak hashing is used, possible options are
|
||||||
|
\fBWeakHashAlways\fP, \fBWeakHashNever\fP and \fBWeakHashAuto\fP\&. Deciding
|
||||||
|
automatically means running benchmarks at startup to decide whether the
|
||||||
|
performance impact is acceptable (this is the default).
|
||||||
|
.TP
|
||||||
|
.B stunServer
|
||||||
|
Specify whether weak hashing is used, possible options are
|
||||||
|
.TP
|
||||||
|
.B stunKeepaliveSeconds
|
||||||
|
Specify whether weak hashing is used, possible options are
|
||||||
|
.TP
|
||||||
|
.B kcpNoDelay, kcpUpdateIntervalMs, kcpFastResend, kcpCongestionControl, kcpSendWindowSize, kcpReceiveWindowSize
|
||||||
|
Various KCP tweaking parameters.
|
||||||
|
.TP
|
||||||
.B defaultFolderPath
|
.B defaultFolderPath
|
||||||
The UI will propose to create new folders at this path. This can be disabled by
|
The UI will propose to create new folders at this path. This can be disabled by
|
||||||
setting this to an empty string.
|
setting this to an empty string.
|
||||||
|
.TP
|
||||||
|
.B relayServer
|
||||||
|
Deprecated since version v0.13.0: You can now specify custom relay servers with \fBlistenAddress\fP\&.
|
||||||
|
|
||||||
|
.sp
|
||||||
|
Lists one or more relay servers, on the format \fBrelay://hostname:port\fP\&.
|
||||||
|
Alternatively, a relay list can be loaded over https by using an URL like
|
||||||
|
\fBdynamic+https://somehost/path\fP\&. The default loads the list of relays
|
||||||
|
from the relay pool server, \fBrelays.syncthing.net\fP\&.
|
||||||
|
.TP
|
||||||
|
.B pingTimeoutS
|
||||||
|
Deprecated since version v0.12.0.
|
||||||
|
|
||||||
|
.sp
|
||||||
|
Ping\-timeout in seconds. Don’t change it unless you are having issues due to
|
||||||
|
slow response time (slow connection/cpu) and large index exchanges.
|
||||||
|
.TP
|
||||||
|
.B pingIdleTimeS
|
||||||
|
Deprecated since version v0.12.0.
|
||||||
|
|
||||||
|
.sp
|
||||||
|
Ping interval in seconds. Don’t change it unless you feel it’s necessary.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.SS Listen Addresses
|
.SS Listen Addresses
|
||||||
.sp
|
.sp
|
||||||
@ -741,9 +866,9 @@ that the files you are backing up are in a folder\-sendonly to prevent other
|
|||||||
devices from overwriting the per device configuration. The folder on the remote
|
devices from overwriting the per device configuration. The folder on the remote
|
||||||
device(s) should not be used as configuration for the remote devices.
|
device(s) should not be used as configuration for the remote devices.
|
||||||
.sp
|
.sp
|
||||||
If you\(aqd like to sync your home folder in non\-send\-only mode, you may add the
|
If you’d like to sync your home folder in non\-send\-only mode, you may add the
|
||||||
folder that stores the configuration files to the ignore list\&.
|
folder that stores the configuration files to the ignore list\&.
|
||||||
If you\(aqd also like to backup your configuration files, add another folder in
|
If you’d also like to backup your configuration files, add another folder in
|
||||||
send\-only mode for just the configuration folder.
|
send\-only mode for just the configuration folder.
|
||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
The Syncthing Authors
|
The Syncthing Authors
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "SYNCTHING-DEVICE-IDS" "7" "November 18, 2017" "v0.14" "Syncthing"
|
.TH "SYNCTHING-DEVICE-IDS" "7" "Nov 23, 2017" "v0.14" "Syncthing"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
syncthing-device-ids \- Understanding Device IDs
|
syncthing-device-ids \- Understanding Device IDs
|
||||||
.
|
.
|
||||||
@ -33,8 +33,8 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.sp
|
.sp
|
||||||
Every device is identified by a device ID. The device ID is used for address
|
Every device is identified by a device ID. The device ID is used for address
|
||||||
resolution, authentication and authorization. The term "device ID" could
|
resolution, authentication and authorization. The term “device ID” could
|
||||||
interchangeably have been "key ID" since the device ID is a direct property of
|
interchangeably have been “key ID” since the device ID is a direct property of
|
||||||
the public key in use.
|
the public key in use.
|
||||||
.SH KEYS
|
.SH KEYS
|
||||||
.sp
|
.sp
|
||||||
@ -43,7 +43,7 @@ startup, Syncthing will create a public/private keypair.
|
|||||||
.sp
|
.sp
|
||||||
Currently this is a 3072 bit RSA key. The keys are saved in the form of the
|
Currently this is a 3072 bit RSA key. The keys are saved in the form of the
|
||||||
private key (\fBkey.pem\fP) and a self signed certificate (\fBcert.pem\fP). The self
|
private key (\fBkey.pem\fP) and a self signed certificate (\fBcert.pem\fP). The self
|
||||||
signing part doesn\(aqt actually add any security or functionality as far as
|
signing part doesn’t actually add any security or functionality as far as
|
||||||
Syncthing is concerned but it enables the use of the keys in a standard TLS
|
Syncthing is concerned but it enables the use of the keys in a standard TLS
|
||||||
exchange.
|
exchange.
|
||||||
.sp
|
.sp
|
||||||
@ -94,7 +94,7 @@ Certificate:
|
|||||||
.sp
|
.sp
|
||||||
We can see here that the certificate is little more than a container for the
|
We can see here that the certificate is little more than a container for the
|
||||||
public key; the serial number is zero and the Issuer and Subject are both
|
public key; the serial number is zero and the Issuer and Subject are both
|
||||||
"syncthing" where a qualified name might otherwise be expected.
|
“syncthing” where a qualified name might otherwise be expected.
|
||||||
.sp
|
.sp
|
||||||
An advanced user could replace the \fBkey.pem\fP and \fBcert.pem\fP files with a
|
An advanced user could replace the \fBkey.pem\fP and \fBcert.pem\fP files with a
|
||||||
keypair generated directly by the \fBopenssl\fP utility or other mechanism.
|
keypair generated directly by the \fBopenssl\fP utility or other mechanism.
|
||||||
@ -138,7 +138,7 @@ MFZWI3D\-BONSGYC\-YLTMRWG\-C43ENR5\-QXGZDMM\-FZWI3DP\-BONSGYY\-LTMRWAD
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.SS Connection Establishment
|
.SS Connection Establishment
|
||||||
.sp
|
.sp
|
||||||
Now we know what device IDs are, here\(aqs how they are used in Syncthing. When
|
Now we know what device IDs are, here’s how they are used in Syncthing. When
|
||||||
you add a device ID to the configuration, Syncthing will attempt to
|
you add a device ID to the configuration, Syncthing will attempt to
|
||||||
connect to that device. The first thing we need to do is figure out the IP and
|
connect to that device. The first thing we need to do is figure out the IP and
|
||||||
port to connect to. There are three possibilities here:
|
port to connect to. There are three possibilities here:
|
||||||
@ -150,13 +150,13 @@ dynamic DNS setup this might be a good option.
|
|||||||
.IP \(bu 2
|
.IP \(bu 2
|
||||||
Using local discovery, if enabled. Every Syncthing instance on a LAN
|
Using local discovery, if enabled. Every Syncthing instance on a LAN
|
||||||
periodically broadcasts information about itself (device ID, address,
|
periodically broadcasts information about itself (device ID, address,
|
||||||
port number). If we\(aqve seen one of these broadcasts for a given
|
port number). If we’ve seen one of these broadcasts for a given
|
||||||
device ID that\(aqs where we try to connect.
|
device ID that’s where we try to connect.
|
||||||
.IP \(bu 2
|
.IP \(bu 2
|
||||||
Using global discovery, if enabled. Every Syncthing instance
|
Using global discovery, if enabled. Every Syncthing instance
|
||||||
announces itself to the global discovery service (device ID and
|
announces itself to the global discovery service (device ID and
|
||||||
external port number \- the internal address is not announced to the
|
external port number \- the internal address is not announced to the
|
||||||
global server). If we don\(aqt have a static address and haven\(aqt seen
|
global server). If we don’t have a static address and haven’t seen
|
||||||
any local announcements the global discovery server will be queried
|
any local announcements the global discovery server will be queried
|
||||||
for an address.
|
for an address.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
@ -188,11 +188,11 @@ The SHA\-256 hash is cryptographically collision resistant. This means
|
|||||||
that there is no way that we know of to create two different messages
|
that there is no way that we know of to create two different messages
|
||||||
with the same hash.
|
with the same hash.
|
||||||
.sp
|
.sp
|
||||||
You can argue that of course there are collisions \- there\(aqs an infinite
|
You can argue that of course there are collisions \- there’s an infinite
|
||||||
amount of inputs and a finite amount of outputs \- so by definition there
|
amount of inputs and a finite amount of outputs \- so by definition there
|
||||||
are infinitely many messages that result in the same hash.
|
are infinitely many messages that result in the same hash.
|
||||||
.sp
|
.sp
|
||||||
I\(aqm going to quote \fI\%stack
|
I’m going to quote \fI\%stack
|
||||||
overflow\fP <\fBhttps://stackoverflow.com/questions/4014090/is-it-safe-to-ignore-the-possibility-of-sha-collisions-in-practice\fP>
|
overflow\fP <\fBhttps://stackoverflow.com/questions/4014090/is-it-safe-to-ignore-the-possibility-of-sha-collisions-in-practice\fP>
|
||||||
here:
|
here:
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
@ -203,28 +203,28 @@ civilization\-as\-we\- know\-it, and killing off a few billion people ?
|
|||||||
It can be argued that any unlucky event with a probability lower
|
It can be argued that any unlucky event with a probability lower
|
||||||
than that is not actually very important.
|
than that is not actually very important.
|
||||||
.sp
|
.sp
|
||||||
If we have a "perfect" hash function with output size n, and we have
|
If we have a “perfect” hash function with output size n, and we have
|
||||||
p messages to hash (individual message length is not important),
|
p messages to hash (individual message length is not important),
|
||||||
then probability of collision is about p2/2n+1 (this is an
|
then probability of collision is about p2/2n+1 (this is an
|
||||||
approximation which is valid for "small" p, i.e. substantially
|
approximation which is valid for “small” p, i.e. substantially
|
||||||
smaller than 2n/2). For instance, with SHA\-256 (n=256) and one
|
smaller than 2n/2). For instance, with SHA\-256 (n=256) and one
|
||||||
billion messages (p=10^9) then the probability is about 4.3*10^\-60.
|
billion messages (p=10^9) then the probability is about 4.3*10^\-60.
|
||||||
.sp
|
.sp
|
||||||
A mass\-murderer space rock happens about once every 30 million years
|
A mass\-murderer space rock happens about once every 30 million years
|
||||||
on average. This leads to a probability of such an event occurring
|
on average. This leads to a probability of such an event occurring
|
||||||
in the next second to about 10^\-15. That\(aqs 45 orders of magnitude
|
in the next second to about 10^\-15. That’s 45 orders of magnitude
|
||||||
more probable than the SHA\-256 collision. Briefly stated, if you
|
more probable than the SHA\-256 collision. Briefly stated, if you
|
||||||
find SHA\-256 collisions scary then your priorities are wrong.
|
find SHA\-256 collisions scary then your priorities are wrong.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
It\(aqs also worth noting that the property of SHA\-256 that we are using is not
|
It’s also worth noting that the property of SHA\-256 that we are using is not
|
||||||
simply collision resistance but resistance to a preimage attack, i.e. even if
|
simply collision resistance but resistance to a preimage attack, i.e. even if
|
||||||
you can find two messages that result in a hash collision that doesn\(aqt help you
|
you can find two messages that result in a hash collision that doesn’t help you
|
||||||
attack Syncthing (or TLS in general). You need to create a message that hashes
|
attack Syncthing (or TLS in general). You need to create a message that hashes
|
||||||
to exactly the hash that my certificate already has or you won\(aqt get in.
|
to exactly the hash that my certificate already has or you won’t get in.
|
||||||
.sp
|
.sp
|
||||||
Note also that it\(aqs not good enough to find a random blob of bits that happen to
|
Note also that it’s not good enough to find a random blob of bits that happen to
|
||||||
have the same hash as my certificate. You need to create a valid DER\-encoded,
|
have the same hash as my certificate. You need to create a valid DER\-encoded,
|
||||||
signed certificate that has the same hash as mine. The difficulty of this is
|
signed certificate that has the same hash as mine. The difficulty of this is
|
||||||
staggeringly far beyond the already staggering difficulty of finding a SHA\-256
|
staggeringly far beyond the already staggering difficulty of finding a SHA\-256
|
||||||
@ -239,8 +239,8 @@ Currently, neither the local nor global discovery mechanism is protected
|
|||||||
by crypto. This means that any device can in theory announce itself for
|
by crypto. This means that any device can in theory announce itself for
|
||||||
any device ID and potentially receive connections for that device.
|
any device ID and potentially receive connections for that device.
|
||||||
.sp
|
.sp
|
||||||
This could be a denial of service attack (we can\(aqt find the real device
|
This could be a denial of service attack (we can’t find the real device
|
||||||
for a given device ID, so can\(aqt connect to it and sync). It could also
|
for a given device ID, so can’t connect to it and sync). It could also
|
||||||
be an intelligence gathering attack; if I spoof a given ID, I can see
|
be an intelligence gathering attack; if I spoof a given ID, I can see
|
||||||
which devices try to connect to it.
|
which devices try to connect to it.
|
||||||
.sp
|
.sp
|
||||||
@ -259,21 +259,21 @@ The user could statically configure IP or host name for the devices.
|
|||||||
The user could run a trusted global server.
|
The user could run a trusted global server.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
It\(aqs something we might want to look at at some point, but not a huge
|
It’s something we might want to look at at some point, but not a huge
|
||||||
problem as I see it.
|
problem as I see it.
|
||||||
.SS Long Device IDs are Painful
|
.SS Long Device IDs are Painful
|
||||||
.sp
|
.sp
|
||||||
It\(aqs a mouthful to read over the phone, annoying to type into an SMS or even
|
It’s a mouthful to read over the phone, annoying to type into an SMS or even
|
||||||
into a computer. And it needs to be done twice, once for each side.
|
into a computer. And it needs to be done twice, once for each side.
|
||||||
.sp
|
.sp
|
||||||
This isn\(aqt a vulnerability as such, but a user experience problem. There are
|
This isn’t a vulnerability as such, but a user experience problem. There are
|
||||||
various possible solutions:
|
various possible solutions:
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.IP \(bu 2
|
.IP \(bu 2
|
||||||
Use shorter device IDs with verification based on the full ID ("You
|
Use shorter device IDs with verification based on the full ID (“You
|
||||||
entered MFZWI3; I found and connected to a device with the ID
|
entered MFZWI3; I found and connected to a device with the ID
|
||||||
MFZWI3\-DBONSG\-YYLTMR\-WGC43E\-NRQXGZ\-DMMFZW\-I3DBON\-SGYYLT\-MRWA, please
|
MFZWI3\-DBONSG\-YYLTMR\-WGC43E\-NRQXGZ\-DMMFZW\-I3DBON\-SGYYLT\-MRWA, please
|
||||||
confirm that this is correct").
|
confirm that this is correct”).
|
||||||
.IP \(bu 2
|
.IP \(bu 2
|
||||||
Use shorter device IDs with an out of band authentication, a la
|
Use shorter device IDs with an out of band authentication, a la
|
||||||
Bluetooth pairing. You enter a one time PIN into Syncthing and give
|
Bluetooth pairing. You enter a one time PIN into Syncthing and give
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "SYNCTHING-EVENT-API" "7" "November 18, 2017" "v0.14" "Syncthing"
|
.TH "SYNCTHING-EVENT-API" "7" "Nov 23, 2017" "v0.14" "Syncthing"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
syncthing-event-api \- Event API
|
syncthing-event-api \- Event API
|
||||||
.
|
.
|
||||||
@ -45,7 +45,7 @@ only the desired event types, add a parameter
|
|||||||
list below.
|
list below.
|
||||||
.sp
|
.sp
|
||||||
The optional parameter \fBsince=<lastSeenID>\fP sets the ID of the last event
|
The optional parameter \fBsince=<lastSeenID>\fP sets the ID of the last event
|
||||||
you\(aqve already seen. Syncthing returns a JSON encoded array of event objects,
|
you’ve already seen. Syncthing returns a JSON encoded array of event objects,
|
||||||
starting at the event just after the one with this last seen ID. The default
|
starting at the event just after the one with this last seen ID. The default
|
||||||
value is 0, which returns all events. There is a limit to the number of events
|
value is 0, which returns all events. There is a limit to the number of events
|
||||||
buffered, so if the rate of events is high or the time between polling calls is
|
buffered, so if the rate of events is high or the time between polling calls is
|
||||||
@ -186,8 +186,8 @@ Generated each time a connection to a device has been terminated.
|
|||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
The error key contains the cause for disconnection, which might not
|
The error key contains the cause for disconnection, which might not
|
||||||
necessarily be an error as such. Specifically, "EOF" and "unexpected
|
necessarily be an error as such. Specifically, “EOF” and “unexpected
|
||||||
EOF" both signify TCP connection termination, either due to the other
|
EOF” both signify TCP connection termination, either due to the other
|
||||||
device restarting or going offline or due to a network change.
|
device restarting or going offline or due to a network change.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "SYNCTHING-FAQ" "7" "November 18, 2017" "v0.14" "Syncthing"
|
.TH "SYNCTHING-FAQ" "7" "Nov 23, 2017" "v0.14" "Syncthing"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
syncthing-faq \- Frequently Asked Questions
|
syncthing-faq \- Frequently Asked Questions
|
||||||
.
|
.
|
||||||
@ -39,10 +39,10 @@ machine will automatically be replicated to your other devices. We believe your
|
|||||||
data is your data alone and you deserve to choose where it is stored. Therefore
|
data is your data alone and you deserve to choose where it is stored. Therefore
|
||||||
Syncthing does not upload your data to the cloud but exchanges your data across
|
Syncthing does not upload your data to the cloud but exchanges your data across
|
||||||
your machines as soon as they are online at the same time.
|
your machines as soon as they are online at the same time.
|
||||||
.SS Is it "syncthing", "Syncthing" or "SyncThing"?
|
.SS Is it “syncthing”, “Syncthing” or “SyncThing”?
|
||||||
.sp
|
.sp
|
||||||
It\(aqs \fBSyncthing\fP, although the command and source repository is spelled
|
It’s \fBSyncthing\fP, although the command and source repository is spelled
|
||||||
\fBsyncthing\fP so it may be referred to in that way as well. It\(aqs definitely not
|
\fBsyncthing\fP so it may be referred to in that way as well. It’s definitely not
|
||||||
SyncThing, even though the abbreviation \fBst\fP is used in some
|
SyncThing, even though the abbreviation \fBst\fP is used in some
|
||||||
circumstances and file names.
|
circumstances and file names.
|
||||||
.SS How does Syncthing differ from BitTorrent/Resilio Sync?
|
.SS How does Syncthing differ from BitTorrent/Resilio Sync?
|
||||||
@ -118,9 +118,9 @@ in the configuration file (24 hours by default).
|
|||||||
.sp
|
.sp
|
||||||
When troubleshooting a slow sync, there are a number of things to check.
|
When troubleshooting a slow sync, there are a number of things to check.
|
||||||
.sp
|
.sp
|
||||||
First of all, verify that you are not connected via a relay. In the "Remote
|
First of all, verify that you are not connected via a relay. In the “Remote
|
||||||
Devices" list on the right side of the GUI, double check that you see
|
Devices” list on the right side of the GUI, double check that you see
|
||||||
"Address: <some address>" and \fInot\fP "Relay: <some address>".
|
“Address: <some address>” and \fInot\fP “Relay: <some address>”.
|
||||||
[image]
|
[image]
|
||||||
.sp
|
.sp
|
||||||
If you are connected via a relay, this is because a direct connection could
|
If you are connected via a relay, this is because a direct connection could
|
||||||
@ -152,7 +152,7 @@ There is a certain amount of housekeeping that must be done to track the
|
|||||||
current and available versions of each file in the index database.
|
current and available versions of each file in the index database.
|
||||||
.IP 4. 3
|
.IP 4. 3
|
||||||
By default Syncthing uses periodic scanning every 60 seconds to detect
|
By default Syncthing uses periodic scanning every 60 seconds to detect
|
||||||
file changes. This means checking every file\(aqs modification time and
|
file changes. This means checking every file’s modification time and
|
||||||
comparing it to the database. This can cause spikes of CPU usage for large
|
comparing it to the database. This can cause spikes of CPU usage for large
|
||||||
folders.
|
folders.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
@ -166,20 +166,20 @@ To limit the amount of CPU used when syncing and scanning, set the
|
|||||||
environment variable \fBGOMAXPROCS\fP to the maximum number of CPU cores
|
environment variable \fBGOMAXPROCS\fP to the maximum number of CPU cores
|
||||||
Syncthing should use at any given moment. For example, \fBGOMAXPROCS=2\fP on a
|
Syncthing should use at any given moment. For example, \fBGOMAXPROCS=2\fP on a
|
||||||
machine with four cores will limit Syncthing to no more than half the
|
machine with four cores will limit Syncthing to no more than half the
|
||||||
system\(aqs CPU power.
|
system’s CPU power.
|
||||||
.sp
|
.sp
|
||||||
To reduce CPU spikes from scanning activity, use a filesystem notifications
|
To reduce CPU spikes from scanning activity, use a filesystem notifications
|
||||||
plugin. This is delivered by default via Synctrayzor, Syncthing\-GTK and on
|
plugin. This is delivered by default via Synctrayzor, Syncthing\-GTK and on
|
||||||
Android. For other setups, consider using \fI\%syncthing\-inotify\fP <\fBhttps://github.com/syncthing/syncthing-inotify\fP>\&.
|
Android. For other setups, consider using \fI\%syncthing\-inotify\fP <\fBhttps://github.com/syncthing/syncthing-inotify\fP>\&.
|
||||||
.SS Should I keep my device IDs secret?
|
.SS Should I keep my device IDs secret?
|
||||||
.sp
|
.sp
|
||||||
No. The IDs are not sensitive. Given a device ID it\(aqs possible to find the IP
|
No. The IDs are not sensitive. Given a device ID it’s possible to find the IP
|
||||||
address for that device, if global discovery is enabled on it. Knowing the device
|
address for that device, if global discovery is enabled on it. Knowing the device
|
||||||
ID doesn\(aqt help you actually establish a connection to that device or get a list
|
ID doesn’t help you actually establish a connection to that device or get a list
|
||||||
of files, etc.
|
of files, etc.
|
||||||
.sp
|
.sp
|
||||||
For a connection to be established, both devices need to know about the other\(aqs
|
For a connection to be established, both devices need to know about the other’s
|
||||||
device ID. It\(aqs not possible (in practice) to forge a device ID. (To forge a
|
device ID. It’s not possible (in practice) to forge a device ID. (To forge a
|
||||||
device ID you need to create a TLS certificate with that specific SHA\-256 hash.
|
device ID you need to create a TLS certificate with that specific SHA\-256 hash.
|
||||||
If you can do that, you can spoof any TLS certificate. The world is your
|
If you can do that, you can spoof any TLS certificate. The world is your
|
||||||
oyster!)
|
oyster!)
|
||||||
@ -206,16 +206,16 @@ device where it was deleted.
|
|||||||
Beware that the \fB<filename>.sync\-conflict\-<date>\-<time>.<ext>\fP files are
|
Beware that the \fB<filename>.sync\-conflict\-<date>\-<time>.<ext>\fP files are
|
||||||
treated as normal files after they are created, so they are propagated between
|
treated as normal files after they are created, so they are propagated between
|
||||||
devices. We do this because the conflict is detected and resolved on one device,
|
devices. We do this because the conflict is detected and resolved on one device,
|
||||||
creating the \fBsync\-conflict\fP file, but it\(aqs just as much of a conflict
|
creating the \fBsync\-conflict\fP file, but it’s just as much of a conflict
|
||||||
everywhere else and we don\(aqt know which of the conflicting files is the "best"
|
everywhere else and we don’t know which of the conflicting files is the “best”
|
||||||
from the user point of view. Moreover, if there\(aqs something that automatically
|
from the user point of view. Moreover, if there’s something that automatically
|
||||||
causes a conflict on change you\(aqll end up with \fBsync\-conflict\-...sync\-conflict
|
causes a conflict on change you’ll end up with \fBsync\-conflict\-...sync\-conflict
|
||||||
\-...\-sync\-conflict\fP files.
|
\-...\-sync\-conflict\fP files.
|
||||||
.SS How do I serve a folder from a read only filesystem?
|
.SS How do I serve a folder from a read only filesystem?
|
||||||
.sp
|
.sp
|
||||||
Syncthing requires a "folder marker" to indicate that the folder is present
|
Syncthing requires a “folder marker” to indicate that the folder is present
|
||||||
and healthy. By default this is a directory called \fB\&.stfolder\fP that is
|
and healthy. By default this is a directory called \fB\&.stfolder\fP that is
|
||||||
created by Syncthing when the folder is added. If this folder can\(aqt be
|
created by Syncthing when the folder is added. If this folder can’t be
|
||||||
created (you are serving files from a CD or something) you can instead set
|
created (you are serving files from a CD or something) you can instead set
|
||||||
the advanced config \fBMarker Name\fP to the name of some file or folder that
|
the advanced config \fBMarker Name\fP to the name of some file or folder that
|
||||||
you know will always exist in the folder.
|
you know will always exist in the folder.
|
||||||
@ -228,8 +228,8 @@ Do not nest shared folders. This behaviour is in no way supported,
|
|||||||
recommended or coded for in any way, and comes with many pitfalls.
|
recommended or coded for in any way, and comes with many pitfalls.
|
||||||
.SS How do I rename/move a synced folder?
|
.SS How do I rename/move a synced folder?
|
||||||
.sp
|
.sp
|
||||||
Syncthing doesn\(aqt have a direct way to do this, as it\(aqs potentially
|
Syncthing doesn’t have a direct way to do this, as it’s potentially
|
||||||
dangerous to do so if you\(aqre not careful \- it may result in data loss if
|
dangerous to do so if you’re not careful \- it may result in data loss if
|
||||||
something goes wrong during the move and is synchronized to your other
|
something goes wrong during the move and is synchronized to your other
|
||||||
devices.
|
devices.
|
||||||
.sp
|
.sp
|
||||||
@ -237,8 +237,8 @@ The easy way to rename or move a synced folder on the local system is to
|
|||||||
remove the folder in the Syncthing UI, move it on disk, then re\-add it using
|
remove the folder in the Syncthing UI, move it on disk, then re\-add it using
|
||||||
the new path.
|
the new path.
|
||||||
.sp
|
.sp
|
||||||
It\(aqs best to do this when the folder is already in sync between your
|
It’s best to do this when the folder is already in sync between your
|
||||||
devices, as it is otherwise unpredictable which changes will "win" after the
|
devices, as it is otherwise unpredictable which changes will “win” after the
|
||||||
move. Changes made on other devices may be overwritten, or changes made
|
move. Changes made on other devices may be overwritten, or changes made
|
||||||
locally may be overwritten by those on other devices.
|
locally may be overwritten by those on other devices.
|
||||||
.sp
|
.sp
|
||||||
@ -251,7 +251,7 @@ to configure listening ports such that they do not overlap (see config).
|
|||||||
.SS Does Syncthing support syncing between folders on the same system?
|
.SS Does Syncthing support syncing between folders on the same system?
|
||||||
.sp
|
.sp
|
||||||
No. Syncthing is not designed to sync locally and the overhead involved in
|
No. Syncthing is not designed to sync locally and the overhead involved in
|
||||||
doing so using Syncthing\(aqs method would be wasteful. There are better
|
doing so using Syncthing’s method would be wasteful. There are better
|
||||||
programs to achieve this such as rsync or Unison.
|
programs to achieve this such as rsync or Unison.
|
||||||
.SS When I do have two distinct Syncthing\-managed folders on two hosts, how does Syncthing handle moving files between them?
|
.SS When I do have two distinct Syncthing\-managed folders on two hosts, how does Syncthing handle moving files between them?
|
||||||
.sp
|
.sp
|
||||||
@ -288,7 +288,7 @@ The patterns in .stignore are glob patterns, where brackets are used to
|
|||||||
denote character ranges. That is, the pattern \fBq[abc]x\fP will match the
|
denote character ranges. That is, the pattern \fBq[abc]x\fP will match the
|
||||||
files \fBqax\fP, \fBqbx\fP and \fBqcx\fP\&.
|
files \fBqax\fP, \fBqbx\fP and \fBqcx\fP\&.
|
||||||
.sp
|
.sp
|
||||||
To match an actual file \fIcalled\fP \fBq[abc]x\fP the pattern needs to "escape"
|
To match an actual file \fIcalled\fP \fBq[abc]x\fP the pattern needs to “escape”
|
||||||
the brackets, like so: \fBq\e[abc\e]x\fP\&.
|
the brackets, like so: \fBq\e[abc\e]x\fP\&.
|
||||||
.sp
|
.sp
|
||||||
On Windows, escaping special characters is not supported as the \fB\e\fP
|
On Windows, escaping special characters is not supported as the \fB\e\fP
|
||||||
@ -297,7 +297,7 @@ such as \fB[\fP and \fB?\fP are not allowed in file names on Windows.
|
|||||||
.SS Why is the setup more complicated than BitTorrent/Resilio Sync?
|
.SS Why is the setup more complicated than BitTorrent/Resilio Sync?
|
||||||
.sp
|
.sp
|
||||||
Security over convenience. In Syncthing you have to setup both sides to
|
Security over convenience. In Syncthing you have to setup both sides to
|
||||||
connect two devices. An attacker can\(aqt do much with a stolen device ID, because
|
connect two devices. An attacker can’t do much with a stolen device ID, because
|
||||||
you have to add the device on the other side too. You have better control
|
you have to add the device on the other side too. You have better control
|
||||||
where your files are transferred.
|
where your files are transferred.
|
||||||
.sp
|
.sp
|
||||||
@ -353,7 +353,7 @@ $ ssh \-L 9090:127.0.0.1:8384 user@othercomputer.example.com
|
|||||||
will log you into othercomputer.example.com, and present the \fIremote\fP
|
will log you into othercomputer.example.com, and present the \fIremote\fP
|
||||||
Syncthing GUI on \fI\%http://localhost:9090\fP on your \fIlocal\fP computer.
|
Syncthing GUI on \fI\%http://localhost:9090\fP on your \fIlocal\fP computer.
|
||||||
.sp
|
.sp
|
||||||
If you only want to access the remote gui and don\(aqt want the terminal
|
If you only want to access the remote gui and don’t want the terminal
|
||||||
session, use this example,
|
session, use this example,
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
@ -378,7 +378,7 @@ Another Windows way to run ssh is to install gow.
|
|||||||
.sp
|
.sp
|
||||||
The easiest way to install gow is with chocolatey.
|
The easiest way to install gow is with chocolatey.
|
||||||
\fI\%https://chocolatey.org/\fP
|
\fI\%https://chocolatey.org/\fP
|
||||||
.SS Why do I get "Host check error" in the GUI/API?
|
.SS Why do I get “Host check error” in the GUI/API?
|
||||||
.sp
|
.sp
|
||||||
Since version 0.14.6 Syncthing does an extra security check when the GUI/API
|
Since version 0.14.6 Syncthing does an extra security check when the GUI/API
|
||||||
is bound to localhost \- namely that the browser is talking to localhost.
|
is bound to localhost \- namely that the browser is talking to localhost.
|
||||||
@ -403,8 +403,8 @@ Bind the GUI/API to a non\-localhost listen port.
|
|||||||
In all cases, username/password authentication and HTTPS should be used.
|
In all cases, username/password authentication and HTTPS should be used.
|
||||||
.SS My Syncthing database is corrupt
|
.SS My Syncthing database is corrupt
|
||||||
.sp
|
.sp
|
||||||
This is almost always a result of bad RAM, storage device or other hardware. When the index database is found to be corrupt Syncthing cannot operate and will note this in the logs and exit. To overcome this delete the \fI\%database folder\fP <\fBhttps://docs.syncthing.net/users/config.html#description\fP> inside Syncthing\(aqs home directory and re\-start Syncthing. It will then need to perform a full re\-hashing of all shared folders. You should check your system in case the underlying cause is indeed faulty hardware which may put the system at risk of further data loss.
|
This is almost always a result of bad RAM, storage device or other hardware. When the index database is found to be corrupt Syncthing cannot operate and will note this in the logs and exit. To overcome this delete the \fI\%database folder\fP <\fBhttps://docs.syncthing.net/users/config.html#description\fP> inside Syncthing’s home directory and re\-start Syncthing. It will then need to perform a full re\-hashing of all shared folders. You should check your system in case the underlying cause is indeed faulty hardware which may put the system at risk of further data loss.
|
||||||
.SS I don\(aqt like the GUI or the theme. Can it be changed?
|
.SS I don’t like the GUI or the theme. Can it be changed?
|
||||||
.sp
|
.sp
|
||||||
You can change the theme in the settings. Syncthing ships with other themes
|
You can change the theme in the settings. Syncthing ships with other themes
|
||||||
than the default.
|
than the default.
|
||||||
@ -415,7 +415,7 @@ By default, Syncthing will look for a directory \fBgui\fP inside the Syncthing
|
|||||||
home folder. To change the directory to look for themes, you need to set the
|
home folder. To change the directory to look for themes, you need to set the
|
||||||
STGUIASSETS environment variable. To get the concrete directory, run
|
STGUIASSETS environment variable. To get the concrete directory, run
|
||||||
syncthing with the \fB\-paths\fP parameter. It will print all the relevant paths,
|
syncthing with the \fB\-paths\fP parameter. It will print all the relevant paths,
|
||||||
including the "GUI override directory".
|
including the “GUI override directory”.
|
||||||
.sp
|
.sp
|
||||||
To add e.g. a red theme, you can create the file \fBred/assets/css/theme.css\fP
|
To add e.g. a red theme, you can create the file \fBred/assets/css/theme.css\fP
|
||||||
inside the GUI override directory to override the default CSS styles.
|
inside the GUI override directory to override the default CSS styles.
|
||||||
@ -432,7 +432,7 @@ crashes and other bugs.
|
|||||||
.SS Where do Syncthing logs go to?
|
.SS Where do Syncthing logs go to?
|
||||||
.sp
|
.sp
|
||||||
Syncthing logs to stdout by default. On Windows Syncthing by default also
|
Syncthing logs to stdout by default. On Windows Syncthing by default also
|
||||||
creates \fBsyncthing.log\fP in Syncthing\(aqs home directory (run \fBsyncthing
|
creates \fBsyncthing.log\fP in Syncthing’s home directory (run \fBsyncthing
|
||||||
\-paths\fP to see where that is). Command line option \fB\-logfile\fP can be used
|
\-paths\fP to see where that is). Command line option \fB\-logfile\fP can be used
|
||||||
to specify a user\-defined logfile.
|
to specify a user\-defined logfile.
|
||||||
.SS How can I view the history of changes?
|
.SS How can I view the history of changes?
|
||||||
@ -459,7 +459,7 @@ it initiates the conflict resolution procedure, which in the end results in a co
|
|||||||
up\-to\-date state with all the neighbours.
|
up\-to\-date state with all the neighbours.
|
||||||
.SS How do I upgrade Syncthing?
|
.SS How do I upgrade Syncthing?
|
||||||
.sp
|
.sp
|
||||||
If you use a package manager such as Debian\(aqs apt\-get, you should upgrade
|
If you use a package manager such as Debian’s apt\-get, you should upgrade
|
||||||
using the package manager. If you use the binary packages linked from
|
using the package manager. If you use the binary packages linked from
|
||||||
Syncthing.net, you can use Syncthing built in automatic upgrades.
|
Syncthing.net, you can use Syncthing built in automatic upgrades.
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
@ -487,14 +487,14 @@ version. We suggest to use the GitHub API at
|
|||||||
the JSON response.
|
the JSON response.
|
||||||
.SS How do I run Syncthing as a daemon process on Linux?
|
.SS How do I run Syncthing as a daemon process on Linux?
|
||||||
.sp
|
.sp
|
||||||
If you\(aqre using systemd, runit, or upstart, we already ship examples, check
|
If you’re using systemd, runit, or upstart, we already ship examples, check
|
||||||
\fI\%https://github.com/syncthing/syncthing/tree/master/etc\fP for example
|
\fI\%https://github.com/syncthing/syncthing/tree/master/etc\fP for example
|
||||||
configurations.
|
configurations.
|
||||||
.sp
|
.sp
|
||||||
If however you\(aqre not using one of these tools, you have a couple of options.
|
If however you’re not using one of these tools, you have a couple of options.
|
||||||
If your system has a tool called \fBstart\-stop\-daemon\fP installed (that\(aqs the name
|
If your system has a tool called \fBstart\-stop\-daemon\fP installed (that’s the name
|
||||||
of the command, not the package), look into the local documentation for that, it
|
of the command, not the package), look into the local documentation for that, it
|
||||||
will almost certainly cover 100% of what you want to do. If you don\(aqt have
|
will almost certainly cover 100% of what you want to do. If you don’t have
|
||||||
\fBstart\-stop\-daemon\fP, there are a bunch of other software packages you could use
|
\fBstart\-stop\-daemon\fP, there are a bunch of other software packages you could use
|
||||||
to do this. The most well known is called daemontools, and can be found in the
|
to do this. The most well known is called daemontools, and can be found in the
|
||||||
standard package repositories for almost every modern Linux distribution.
|
standard package repositories for almost every modern Linux distribution.
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "SYNCTHING-GLOBALDISCO" "7" "November 18, 2017" "v0.14" "Syncthing"
|
.TH "SYNCTHING-GLOBALDISCO" "7" "Nov 23, 2017" "v0.14" "Syncthing"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
syncthing-globaldisco \- Global Discovery Protocol v3
|
syncthing-globaldisco \- Global Discovery Protocol v3
|
||||||
.
|
.
|
||||||
@ -34,7 +34,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|||||||
.sp
|
.sp
|
||||||
A device should announce itself at startup. It does this by an HTTPS POST to
|
A device should announce itself at startup. It does this by an HTTPS POST to
|
||||||
the announce server URL. Standard discovery currently requires the path to be
|
the announce server URL. Standard discovery currently requires the path to be
|
||||||
"/v2/", yet this can be up to the discovery server. The POST has a JSON payload
|
“/v2/”, yet this can be up to the discovery server. The POST has a JSON payload
|
||||||
listing connection addresses (if any):
|
listing connection addresses (if any):
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
@ -49,9 +49,9 @@ listing connection addresses (if any):
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
It\(aqs OK for the "addresses" field to be either the empty list (\fB[]\fP),
|
It’s OK for the “addresses” field to be either the empty list (\fB[]\fP),
|
||||||
\fBnull\fP, or missing entirely. An announcement with the field missing
|
\fBnull\fP, or missing entirely. An announcement with the field missing
|
||||||
or empty is however not useful...
|
or empty is however not useful…
|
||||||
.sp
|
.sp
|
||||||
Any empty or unspecified IP addresses (i.e. addresses like \fBtcp://:22000\fP,
|
Any empty or unspecified IP addresses (i.e. addresses like \fBtcp://:22000\fP,
|
||||||
\fBtcp://0.0.0.0:22000\fP, \fBtcp://[::]:22000\fP) are interpreted as referring to
|
\fBtcp://0.0.0.0:22000\fP, \fBtcp://[::]:22000\fP) are interpreted as referring to
|
||||||
@ -63,7 +63,7 @@ authentication. The device ID is deduced from the presented certificate.
|
|||||||
.sp
|
.sp
|
||||||
The server response is empty, with code \fB204\fP (No Content) on success. If no
|
The server response is empty, with code \fB204\fP (No Content) on success. If no
|
||||||
certificate was presented, status \fB403\fP (Forbidden) is returned. If the
|
certificate was presented, status \fB403\fP (Forbidden) is returned. If the
|
||||||
posted data doesn\(aqt conform to the expected format, \fB400\fP (Bad Request) is
|
posted data doesn’t conform to the expected format, \fB400\fP (Bad Request) is
|
||||||
returned.
|
returned.
|
||||||
.sp
|
.sp
|
||||||
In successful responses, the server may return a \fBReannounce\-After\fP header
|
In successful responses, the server may return a \fBReannounce\-After\fP header
|
||||||
@ -80,14 +80,14 @@ Many Requests).
|
|||||||
.SH QUERIES
|
.SH QUERIES
|
||||||
.sp
|
.sp
|
||||||
Queries are performed as HTTPS GET requests to the announce server URL. The
|
Queries are performed as HTTPS GET requests to the announce server URL. The
|
||||||
requested device ID is passed as the query parameter "device", in canonical
|
requested device ID is passed as the query parameter “device”, in canonical
|
||||||
string form, i.e. \fBhttps://announce.syncthing.net/v2/?device=ABC12345\-....\fP
|
string form, i.e. \fBhttps://announce.syncthing.net/v2/?device=ABC12345\-....\fP
|
||||||
.sp
|
.sp
|
||||||
Successful responses will have status code \fB200\fP (OK) and carry a JSON payload
|
Successful responses will have status code \fB200\fP (OK) and carry a JSON payload
|
||||||
of the same format as the announcement above. The response will not contain
|
of the same format as the announcement above. The response will not contain
|
||||||
empty or unspecified addresses.
|
empty or unspecified addresses.
|
||||||
.sp
|
.sp
|
||||||
If the "device" query parameter is missing or malformed, the status code 400
|
If the “device” query parameter is missing or malformed, the status code 400
|
||||||
(Bad Request) is returned.
|
(Bad Request) is returned.
|
||||||
.sp
|
.sp
|
||||||
If the device ID is of a valid format but not found in the registry, 404 (Not
|
If the device ID is of a valid format but not found in the registry, 404 (Not
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "SYNCTHING-LOCALDISCO" "7" "November 18, 2017" "v0.14" "Syncthing"
|
.TH "SYNCTHING-LOCALDISCO" "7" "Nov 23, 2017" "v0.14" "Syncthing"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
syncthing-localdisco \- Local Discovery Protocol v4
|
syncthing-localdisco \- Local Discovery Protocol v4
|
||||||
.
|
.
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "SYNCTHING-NETWORKING" "7" "November 18, 2017" "v0.14" "Syncthing"
|
.TH "SYNCTHING-NETWORKING" "7" "Nov 23, 2017" "v0.14" "Syncthing"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
syncthing-networking \- Firewall Setup
|
syncthing-networking \- Firewall Setup
|
||||||
.
|
.
|
||||||
@ -72,7 +72,7 @@ Port \fB21027/UDP\fP (for discovery broadcasts on IPv4 and multicasts on IPv6)
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.SS Uncomplicated Firewall (ufw)
|
.SS Uncomplicated Firewall (ufw)
|
||||||
.sp
|
.sp
|
||||||
If you\(aqre using \fBufw\fP on Linux and have installed the \fI\%Syncthing package\fP <\fBhttps://apt.syncthing.net/\fP>, you can allow the necessary ports by running:
|
If you’re using \fBufw\fP on Linux and have installed the \fI\%Syncthing package\fP <\fBhttps://apt.syncthing.net/\fP>, you can allow the necessary ports by running:
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
.sp
|
.sp
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "SYNCTHING-RELAY" "7" "November 18, 2017" "v0.14" "Syncthing"
|
.TH "SYNCTHING-RELAY" "7" "Nov 23, 2017" "v0.14" "Syncthing"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
syncthing-relay \- Relay Protocol v1
|
syncthing-relay \- Relay Protocol v1
|
||||||
.
|
.
|
||||||
@ -37,7 +37,7 @@ connect to each other directly otherwise. This is usually due to both devices
|
|||||||
being behind a NAT and neither side being able to open a port which would
|
being behind a NAT and neither side being able to open a port which would
|
||||||
be directly accessible from the internet.
|
be directly accessible from the internet.
|
||||||
.sp
|
.sp
|
||||||
A relay was designed to relay BEP protocol, hence the reliance on device ID\(aqs
|
A relay was designed to relay BEP protocol, hence the reliance on device ID’s
|
||||||
in the protocol spec, but at the same time it is general enough that could be
|
in the protocol spec, but at the same time it is general enough that could be
|
||||||
reused by other protocols or applications, as the data transferred between two
|
reused by other protocols or applications, as the data transferred between two
|
||||||
devices which use a relay is completely obscure and does not affect the
|
devices which use a relay is completely obscure and does not affect the
|
||||||
@ -92,14 +92,14 @@ exists.
|
|||||||
After the client has joined, no more messages are exchanged apart from
|
After the client has joined, no more messages are exchanged apart from
|
||||||
Ping/Pong messages for general connection keep alive checking.
|
Ping/Pong messages for general connection keep alive checking.
|
||||||
.sp
|
.sp
|
||||||
From this point onwards, the client stand\-by\(aqs and waits for SessionInvitation
|
From this point onwards, the client stand\-by’s and waits for SessionInvitation
|
||||||
messages from the relay, which implies that some other device is trying to
|
messages from the relay, which implies that some other device is trying to
|
||||||
connect with you. SessionInvitation message contains the unique session key
|
connect with you. SessionInvitation message contains the unique session key
|
||||||
which then can be used to establish a connection in session mode.
|
which then can be used to establish a connection in session mode.
|
||||||
.sp
|
.sp
|
||||||
If the client fails to send a JoinRelayRequest message within the first ping
|
If the client fails to send a JoinRelayRequest message within the first ping
|
||||||
interval, the connection is terminated.
|
interval, the connection is terminated.
|
||||||
If the client fails to send a message (even if it\(aqs a ping message) every minute
|
If the client fails to send a message (even if it’s a ping message) every minute
|
||||||
(by default), the connection is terminated.
|
(by default), the connection is terminated.
|
||||||
.SS Temporary protocol submode
|
.SS Temporary protocol submode
|
||||||
.sp
|
.sp
|
||||||
@ -574,7 +574,7 @@ identify which session you are trying to connect to.
|
|||||||
.B : Address
|
.B : Address
|
||||||
An optional IP address on which the relay server is expecting you to
|
An optional IP address on which the relay server is expecting you to
|
||||||
connect, in order to start a connection in session mode.
|
connect, in order to start a connection in session mode.
|
||||||
Empty/all zero IP should be replaced with the relay\(aqs public IP address that
|
Empty/all zero IP should be replaced with the relay’s public IP address that
|
||||||
was used when establishing the protocol mode connection.
|
was used when establishing the protocol mode connection.
|
||||||
.TP
|
.TP
|
||||||
.B : Port
|
.B : Port
|
||||||
@ -585,14 +585,14 @@ in order to start a connection in session mode.
|
|||||||
Because both sides connecting to the relay use the client side of the socket,
|
Because both sides connecting to the relay use the client side of the socket,
|
||||||
and some protocols behave differently depending if the connection starts on
|
and some protocols behave differently depending if the connection starts on
|
||||||
the server side or the client side, this boolean indicates which side of the
|
the server side or the client side, this boolean indicates which side of the
|
||||||
connection this client should assume it\(aqs getting. The value is inverted in
|
connection this client should assume it’s getting. The value is inverted in
|
||||||
the invitation which is sent to the other device, so that there is always
|
the invitation which is sent to the other device, so that there is always
|
||||||
one client socket, and one server socket.
|
one client socket, and one server socket.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.SH HOW SYNCTHING USES RELAYS, AND GENERAL SECURITY
|
.SH HOW SYNCTHING USES RELAYS, AND GENERAL SECURITY
|
||||||
.sp
|
.sp
|
||||||
In the case of Syncthing and BEP, when two devices connect via relay, they
|
In the case of Syncthing and BEP, when two devices connect via relay, they
|
||||||
start their standard TLS connection encapsulated within the relay\(aqs plain\-text
|
start their standard TLS connection encapsulated within the relay’s plain\-text
|
||||||
session connection, effectively upgrading the plain\-text connection to a TLS
|
session connection, effectively upgrading the plain\-text connection to a TLS
|
||||||
connection.
|
connection.
|
||||||
.sp
|
.sp
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "SYNCTHING-REST-API" "7" "November 18, 2017" "v0.14" "Syncthing"
|
.TH "SYNCTHING-REST-API" "7" "Nov 23, 2017" "v0.14" "Syncthing"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
syncthing-rest-api \- REST API
|
syncthing-rest-api \- REST API
|
||||||
.
|
.
|
||||||
@ -48,7 +48,7 @@ with \fBcurl\fP\&.
|
|||||||
.SS GET /rest/system/browse
|
.SS GET /rest/system/browse
|
||||||
.sp
|
.sp
|
||||||
Returns a list of directories matching the path given by the optional parameter
|
Returns a list of directories matching the path given by the optional parameter
|
||||||
\fBcurrent\fP\&. The path can use \fI\%patterns as described in Go\(aqs filepath package\fP <\fBhttps://golang.org/pkg/path/filepath/#Match\fP>\&. A \(aq*\(aq will always be appended
|
\fBcurrent\fP\&. The path can use \fI\%patterns as described in Go’s filepath package\fP <\fBhttps://golang.org/pkg/path/filepath/#Match\fP>\&. A ‘*’ will always be appended
|
||||||
to the given path (e.g. \fB/tmp/\fP matches all its subdirectories). If the option
|
to the given path (e.g. \fB/tmp/\fP matches all its subdirectories). If the option
|
||||||
\fBcurrent\fP is not given, filesystem root paths are returned.
|
\fBcurrent\fP is not given, filesystem root paths are returned.
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
@ -859,8 +859,8 @@ Response contains the same output as \fBGET /rest/db/need\fP
|
|||||||
Request immediate scan. Takes the optional parameters \fBfolder\fP (folder ID),
|
Request immediate scan. Takes the optional parameters \fBfolder\fP (folder ID),
|
||||||
\fBsub\fP (path relative to the folder root) and \fBnext\fP (time in seconds). If
|
\fBsub\fP (path relative to the folder root) and \fBnext\fP (time in seconds). If
|
||||||
\fBfolder\fP is omitted or empty all folders are scanned. If \fBsub\fP is given,
|
\fBfolder\fP is omitted or empty all folders are scanned. If \fBsub\fP is given,
|
||||||
only this path (and children, in case it\(aqs a directory) is scanned. The \fBnext\fP
|
only this path (and children, in case it’s a directory) is scanned. The \fBnext\fP
|
||||||
argument delays Syncthing\(aqs automated rescan interval for a given amount of
|
argument delays Syncthing’s automated rescan interval for a given amount of
|
||||||
seconds.
|
seconds.
|
||||||
.sp
|
.sp
|
||||||
Requesting scan of a path that no longer exists, but previously did, is
|
Requesting scan of a path that no longer exists, but previously did, is
|
||||||
@ -939,7 +939,7 @@ only the desired event types, add a parameter
|
|||||||
list below.
|
list below.
|
||||||
.sp
|
.sp
|
||||||
The optional parameter \fBsince=<lastSeenID>\fP sets the ID of the last event
|
The optional parameter \fBsince=<lastSeenID>\fP sets the ID of the last event
|
||||||
you\(aqve already seen. Syncthing returns a JSON encoded array of event objects,
|
you’ve already seen. Syncthing returns a JSON encoded array of event objects,
|
||||||
starting at the event just after the one with this last seen ID. The default
|
starting at the event just after the one with this last seen ID. The default
|
||||||
value is 0, which returns all events. There is a limit to the number of events
|
value is 0, which returns all events. There is a limit to the number of events
|
||||||
buffered, so if the rate of events is high or the time between polling calls is
|
buffered, so if the rate of events is high or the time between polling calls is
|
||||||
@ -1080,8 +1080,8 @@ Generated each time a connection to a device has been terminated.
|
|||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
The error key contains the cause for disconnection, which might not
|
The error key contains the cause for disconnection, which might not
|
||||||
necessarily be an error as such. Specifically, "EOF" and "unexpected
|
necessarily be an error as such. Specifically, “EOF” and “unexpected
|
||||||
EOF" both signify TCP connection termination, either due to the other
|
EOF” both signify TCP connection termination, either due to the other
|
||||||
device restarting or going offline or due to a network change.
|
device restarting or going offline or due to a network change.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "SYNCTHING-SECURITY" "7" "November 18, 2017" "v0.14" "Syncthing"
|
.TH "SYNCTHING-SECURITY" "7" "Nov 23, 2017" "v0.14" "Syncthing"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
syncthing-security \- Security Principles
|
syncthing-security \- Security Principles
|
||||||
.
|
.
|
||||||
@ -92,7 +92,7 @@ Automatic upgrades default to \fBon\fP (unless Syncthing was compiled with
|
|||||||
upgrades disabled).
|
upgrades disabled).
|
||||||
.sp
|
.sp
|
||||||
Even when automatic upgrades are disabled in the configuration, an upgrade check
|
Even when automatic upgrades are disabled in the configuration, an upgrade check
|
||||||
as above is done when the GUI is loaded, in order to show the "Upgrade to ..."
|
as above is done when the GUI is loaded, in order to show the “Upgrade to …”
|
||||||
button when necessary. This can be disabled only by compiling Syncthing with
|
button when necessary. This can be disabled only by compiling Syncthing with
|
||||||
upgrades disabled.
|
upgrades disabled.
|
||||||
.sp
|
.sp
|
||||||
@ -106,7 +106,7 @@ information about the user or device.
|
|||||||
When usage reporting is enabled, Syncthing reports usage data at startup and
|
When usage reporting is enabled, Syncthing reports usage data at startup and
|
||||||
then every 24 hours. The report is sent as an HTTPS POST to the usage reporting
|
then every 24 hours. The report is sent as an HTTPS POST to the usage reporting
|
||||||
server, currently hosted by \fI\%@calmh\fP <\fBhttps://github.com/calmh\fP>\&. The contents of the usage report can
|
server, currently hosted by \fI\%@calmh\fP <\fBhttps://github.com/calmh\fP>\&. The contents of the usage report can
|
||||||
be seen behind the "Preview" link in settings. Usage reporting defaults to
|
be seen behind the “Preview” link in settings. Usage reporting defaults to
|
||||||
\fBoff\fP but the GUI will ask once about enabling it, shortly after the first
|
\fBoff\fP but the GUI will ask once about enabling it, shortly after the first
|
||||||
install.
|
install.
|
||||||
.sp
|
.sp
|
||||||
@ -130,13 +130,13 @@ case.
|
|||||||
.sp
|
.sp
|
||||||
When relaying is enabled, Syncthing will look up the pool of public relays
|
When relaying is enabled, Syncthing will look up the pool of public relays
|
||||||
and establish a connection to one of them (the best, based on an internal
|
and establish a connection to one of them (the best, based on an internal
|
||||||
heuristic). The selected relay server will learn the connecting device\(aqs
|
heuristic). The selected relay server will learn the connecting device’s
|
||||||
device ID. Relay servers can be run by \fBanyone in the general public\fP\&.
|
device ID. Relay servers can be run by \fBanyone in the general public\fP\&.
|
||||||
Relaying defaults to \fBon\fP\&. Syncthing can be configured to disable
|
Relaying defaults to \fBon\fP\&. Syncthing can be configured to disable
|
||||||
relaying, or only use specific relays.
|
relaying, or only use specific relays.
|
||||||
.sp
|
.sp
|
||||||
If a relay connections is required between two devices, the relay will learn
|
If a relay connections is required between two devices, the relay will learn
|
||||||
the other device\(aqs device ID as well.
|
the other device’s device ID as well.
|
||||||
.sp
|
.sp
|
||||||
Any data exchanged between the two devices is encrypted as usual and not
|
Any data exchanged between the two devices is encrypted as usual and not
|
||||||
subject to inspection by the relay.
|
subject to inspection by the relay.
|
||||||
@ -161,7 +161,7 @@ synced files. Here are some general principles to protect your files:
|
|||||||
If a device of yours is lost, make sure to revoke its access from your other
|
If a device of yours is lost, make sure to revoke its access from your other
|
||||||
devices.
|
devices.
|
||||||
.IP 2. 3
|
.IP 2. 3
|
||||||
If you\(aqre syncing confidential data on an encrypted disk to guard against
|
If you’re syncing confidential data on an encrypted disk to guard against
|
||||||
device theft, put the Syncthing config folder on the same encrypted disk to
|
device theft, put the Syncthing config folder on the same encrypted disk to
|
||||||
avoid leaking keys and metadata. Or, use whole disk encryption.
|
avoid leaking keys and metadata. Or, use whole disk encryption.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "SYNCTHING-STIGNORE" "5" "November 18, 2017" "v0.14" "Syncthing"
|
.TH "SYNCTHING-STIGNORE" "5" "Nov 23, 2017" "v0.14" "Syncthing"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
syncthing-stignore \- Prevent files from being synchronized to other nodes
|
syncthing-stignore \- Prevent files from being synchronized to other nodes
|
||||||
.
|
.
|
||||||
@ -96,7 +96,7 @@ are \fIincluded\fP (that is, \fInot\fP ignored). This can be used to override
|
|||||||
more general patterns that follow. Note that files in ignored
|
more general patterns that follow. Note that files in ignored
|
||||||
directories can not be re\-included this way. This is due to the fact
|
directories can not be re\-included this way. This is due to the fact
|
||||||
that Syncthing stops scanning when it reaches an ignored directory,
|
that Syncthing stops scanning when it reaches an ignored directory,
|
||||||
so doesn\(aqt know what files it might contain.
|
so doesn’t know what files it might contain.
|
||||||
.IP \(bu 2
|
.IP \(bu 2
|
||||||
A pattern beginning with a \fB(?i)\fP prefix enables case\-insensitive pattern
|
A pattern beginning with a \fB(?i)\fP prefix enables case\-insensitive pattern
|
||||||
matching. \fB(?i)test\fP matches \fBtest\fP, \fBTEST\fP and \fBtEsT\fP\&. The
|
matching. \fB(?i)test\fP matches \fBtest\fP, \fBTEST\fP and \fBtEsT\fP\&. The
|
||||||
@ -116,8 +116,8 @@ Windows does not support escaping \fB\e[foo \- bar\e]\fP\&.
|
|||||||
\fBNOTE:\fP
|
\fBNOTE:\fP
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
Prefixes can be specified in any order (e.g. "(?d)(?i)"), but cannot be in a
|
Prefixes can be specified in any order (e.g. “(?d)(?i)”), but cannot be in a
|
||||||
single pair of parentheses (not "(?di)").
|
single pair of parentheses (not “(?di)”).
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.SH EXAMPLE
|
.SH EXAMPLE
|
||||||
@ -163,8 +163,8 @@ qu*
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
all files and directories called "foo", ending in a "2" or starting with
|
all files and directories called “foo”, ending in a “2” or starting with
|
||||||
"qu" will be ignored. The end result becomes:
|
“qu” will be ignored. The end result becomes:
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
.sp
|
.sp
|
||||||
@ -196,24 +196,24 @@ directory itself. If you want the pattern to match the directory and its
|
|||||||
content, make sure it does not have a \fB/\fP at the end of the pattern.
|
content, make sure it does not have a \fB/\fP at the end of the pattern.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.SH EFFECTS ON "IN SYNC" STATUS
|
.SH EFFECTS ON “IN SYNC” STATUS
|
||||||
.sp
|
.sp
|
||||||
Currently the effects on who is in sync with what can be a bit confusing
|
Currently the effects on who is in sync with what can be a bit confusing
|
||||||
when using ignore patterns. This should be cleared up in a future
|
when using ignore patterns. This should be cleared up in a future
|
||||||
version...
|
version…
|
||||||
.sp
|
.sp
|
||||||
Assume two devices, Alice and Bob, where Alice has 100 files to share, but
|
Assume two devices, Alice and Bob, where Alice has 100 files to share, but
|
||||||
Bob ignores 25 of these. From Alice\(aqs point of view Bob will become
|
Bob ignores 25 of these. From Alice’s point of view Bob will become
|
||||||
about 75% in sync (the actual number depends on the sizes of the
|
about 75% in sync (the actual number depends on the sizes of the
|
||||||
individual files) and remain in "Syncing" state even though it is in
|
individual files) and remain in “Syncing” state even though it is in
|
||||||
fact not syncing anything (\fI\%issue #623\fP <\fBhttps://github.com/syncthing/syncthing/issues/623\fP>). From Bob\(aqs point of view, it\(aqs
|
fact not syncing anything (\fI\%issue #623\fP <\fBhttps://github.com/syncthing/syncthing/issues/623\fP>). From Bob’s point of view, it’s
|
||||||
100% up to date but will show fewer files in both the local and global
|
100% up to date but will show fewer files in both the local and global
|
||||||
view.
|
view.
|
||||||
.sp
|
.sp
|
||||||
If Bob adds files that have already been synced to the ignore list, they
|
If Bob adds files that have already been synced to the ignore list, they
|
||||||
will remain in the "global" view but disappear from the "local" view.
|
will remain in the “global” view but disappear from the “local” view.
|
||||||
The end result is more files in the global folder than in the local,
|
The end result is more files in the global folder than in the local,
|
||||||
but still 100% in sync (\fI\%issue #624\fP <\fBhttps://github.com/syncthing/syncthing/issues/624\fP>). From Alice\(aqs point of view, Bob
|
but still 100% in sync (\fI\%issue #624\fP <\fBhttps://github.com/syncthing/syncthing/issues/624\fP>). From Alice’s point of view, Bob
|
||||||
will remain 100% in sync until the next reconnect, because Bob has
|
will remain 100% in sync until the next reconnect, because Bob has
|
||||||
already announced that he has the files that are now suddenly ignored.
|
already announced that he has the files that are now suddenly ignored.
|
||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "SYNCTHING-VERSIONING" "7" "November 18, 2017" "v0.14" "Syncthing"
|
.TH "SYNCTHING-VERSIONING" "7" "Nov 23, 2017" "v0.14" "Syncthing"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
syncthing-versioning \- Keep automatic backups of deleted files by other nodes
|
syncthing-versioning \- Keep automatic backups of deleted files by other nodes
|
||||||
.
|
.
|
||||||
@ -33,13 +33,13 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.sp
|
.sp
|
||||||
Syncthing supports archiving the old version of a file when it is deleted or
|
Syncthing supports archiving the old version of a file when it is deleted or
|
||||||
replaced with a newer version from the cluster. This is called "file
|
replaced with a newer version from the cluster. This is called “file
|
||||||
versioning" and uses one of the available \fIversioning strategies\fP described
|
versioning” and uses one of the available \fIversioning strategies\fP described
|
||||||
below. File versioning is configured per folder, on a per\-device basis, and
|
below. File versioning is configured per folder, on a per\-device basis, and
|
||||||
defaults to "no file versioning", i.e. no old copies of files are kept.
|
defaults to “no file versioning”, i.e. no old copies of files are kept.
|
||||||
.SH TRASH CAN FILE VERSIONING
|
.SH TRASH CAN FILE VERSIONING
|
||||||
.sp
|
.sp
|
||||||
This versioning strategy emulates the common "trash can" approach. When a file
|
This versioning strategy emulates the common “trash can” approach. When a file
|
||||||
is deleted or replaced due to a change on a remote device, it is a moved to
|
is deleted or replaced due to a change on a remote device, it is a moved to
|
||||||
the trash can in the \fB\&.stversions\fP folder. If a file with the same name was
|
the trash can in the \fB\&.stversions\fP folder. If a file with the same name was
|
||||||
already in the trash can it is replaced.
|
already in the trash can it is replaced.
|
||||||
@ -51,26 +51,26 @@ this to zero prevents any files from being removed from the trash can
|
|||||||
automatically.
|
automatically.
|
||||||
.SH SIMPLE FILE VERSIONING
|
.SH SIMPLE FILE VERSIONING
|
||||||
.sp
|
.sp
|
||||||
With "Simple File Versioning" files are moved to the \fB\&.stversions\fP folder
|
With “Simple File Versioning” files are moved to the \fB\&.stversions\fP folder
|
||||||
(inside your shared folder) when replaced or deleted on a remote device. This
|
(inside your shared folder) when replaced or deleted on a remote device. This
|
||||||
option also takes a value in an input titled "Keep Versions" which tells
|
option also takes a value in an input titled “Keep Versions” which tells
|
||||||
Syncthing how many old versions of the file it should keep. For example, if
|
Syncthing how many old versions of the file it should keep. For example, if
|
||||||
you set this value to 5, if a file is replaced 5 times on a remote device, you
|
you set this value to 5, if a file is replaced 5 times on a remote device, you
|
||||||
will see 5 time\-stamped versions on that file in the ".stversions" folder on
|
will see 5 time\-stamped versions on that file in the “.stversions” folder on
|
||||||
the other devices sharing the same folder.
|
the other devices sharing the same folder.
|
||||||
.SH STAGGERED FILE VERSIONING
|
.SH STAGGERED FILE VERSIONING
|
||||||
.sp
|
.sp
|
||||||
With "Staggered File Versioning" files are also moved to a different folder
|
With “Staggered File Versioning” files are also moved to a different folder
|
||||||
when replaced or deleted on a remote device (just like "Simple File
|
when replaced or deleted on a remote device (just like “Simple File
|
||||||
Versioning"), however, versions are automatically deleted if they are older
|
Versioning”), however, versions are automatically deleted if they are older
|
||||||
than the maximum age or exceed the number of files allowed in an interval.
|
than the maximum age or exceed the number of files allowed in an interval.
|
||||||
.sp
|
.sp
|
||||||
With this versioning method it\(aqs possible to specify where the versions are
|
With this versioning method it’s possible to specify where the versions are
|
||||||
stored, with the default being the \fB\&.stversions\fP folder inside the normal
|
stored, with the default being the \fB\&.stversions\fP folder inside the normal
|
||||||
folder path. If you set a custom version path, please ensure that it\(aqs on the
|
folder path. If you set a custom version path, please ensure that it’s on the
|
||||||
same partition or filesystem as the regular folder path, as moving files there
|
same partition or filesystem as the regular folder path, as moving files there
|
||||||
may otherwise fail. You can use an absolute path (this is recommended) or a
|
may otherwise fail. You can use an absolute path (this is recommended) or a
|
||||||
relative path. Relative paths are interpreted relative to Syncthing\(aqs current
|
relative path. Relative paths are interpreted relative to Syncthing’s current
|
||||||
or startup directory.
|
or startup directory.
|
||||||
.sp
|
.sp
|
||||||
The following intervals are used and they each have a maximum number of files
|
The following intervals are used and they each have a maximum number of files
|
||||||
@ -91,7 +91,7 @@ Until maximum age, the most recent version is kept every week.
|
|||||||
.TP
|
.TP
|
||||||
.B Maximum Age
|
.B Maximum Age
|
||||||
The maximum time to keep a version in days. For example, to keep replaced or
|
The maximum time to keep a version in days. For example, to keep replaced or
|
||||||
deleted files in the ".stversions" folder for an entire year, use 365. If
|
deleted files in the “.stversions” folder for an entire year, use 365. If
|
||||||
only for 10 days, use 10. \fBNote: Set to 0 to keep versions forever.\fP
|
only for 10 days, use 10. \fBNote: Set to 0 to keep versions forever.\fP
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.SH EXTERNAL FILE VERSIONING
|
.SH EXTERNAL FILE VERSIONING
|
||||||
@ -111,7 +111,7 @@ Path to the file within the folder
|
|||||||
.SS Example for Unixes
|
.SS Example for Unixes
|
||||||
.sp
|
.sp
|
||||||
Lets say I want to keep the latest version of each file as they are replaced
|
Lets say I want to keep the latest version of each file as they are replaced
|
||||||
or removed; essentially I want a "trash can"\-like behavior. For this, I create
|
or removed; essentially I want a “trash can”\-like behavior. For this, I create
|
||||||
the following script and store it as \fB/Users/jb/bin/onlylatest.sh\fP (i.e. the
|
the following script and store it as \fB/Users/jb/bin/onlylatest.sh\fP (i.e. the
|
||||||
\fBbin\fP directory in my home directory):
|
\fBbin\fP directory in my home directory):
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
@ -142,7 +142,7 @@ mv \-f "$folderpath/$filepath" "$versionspath/$filepath"
|
|||||||
I must ensure that the script has execute permissions (\fBchmod 755
|
I must ensure that the script has execute permissions (\fBchmod 755
|
||||||
onlylatest.sh\fP), then configure Syncthing with command \fB/Users/jb/bin/onlylatest.sh %FOLDER_PATH% %FILE_PATH%\fP
|
onlylatest.sh\fP), then configure Syncthing with command \fB/Users/jb/bin/onlylatest.sh %FOLDER_PATH% %FILE_PATH%\fP
|
||||||
.sp
|
.sp
|
||||||
Lets assume I have a folder "default" in ~/Sync, and that within that folder
|
Lets assume I have a folder “default” in ~/Sync, and that within that folder
|
||||||
there is a file \fBdocs/letter.txt\fP that is being replaced or deleted. The
|
there is a file \fBdocs/letter.txt\fP that is being replaced or deleted. The
|
||||||
script will be called as if I ran this from the command line:
|
script will be called as if I ran this from the command line:
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
@ -161,7 +161,7 @@ The script will then move the file in question to
|
|||||||
that may already have been there.
|
that may already have been there.
|
||||||
.SS Example for Windows
|
.SS Example for Windows
|
||||||
.sp
|
.sp
|
||||||
On Windows we can use a batch script to perform the same "trash can"\-like
|
On Windows we can use a batch script to perform the same “trash can”\-like
|
||||||
behavior as mentioned above. I created the following script and saved it as
|
behavior as mentioned above. I created the following script and saved it as
|
||||||
\fBC:\eUsers\emfrnd\eScripts\eonlylatest.bat\fP\&.
|
\fBC:\eUsers\emfrnd\eScripts\eonlylatest.bat\fP\&.
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "SYNCTHING" "1" "November 18, 2017" "v0.14" "Syncthing"
|
.TH "SYNCTHING" "1" "Nov 23, 2017" "v0.14" "Syncthing"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
syncthing \- Syncthing
|
syncthing \- Syncthing
|
||||||
.
|
.
|
||||||
@ -217,14 +217,14 @@ over 128+N on Unix usually represent the signal which caused the process to
|
|||||||
exit. For example, \fB128 + 9 (SIGKILL) = 137\fP\&.
|
exit. For example, \fB128 + 9 (SIGKILL) = 137\fP\&.
|
||||||
.SH DEVELOPMENT SETTINGS
|
.SH DEVELOPMENT SETTINGS
|
||||||
.sp
|
.sp
|
||||||
The following environment variables modify Syncthing\(aqs behavior in ways that
|
The following environment variables modify Syncthing’s behavior in ways that
|
||||||
are mostly useful for developers. Use with care.
|
are mostly useful for developers. Use with care.
|
||||||
If you start Syncthing from within service managers like systemd or supervisor,
|
If you start Syncthing from within service managers like systemd or supervisor,
|
||||||
path expansion may not be supported.
|
path expansion may not be supported.
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B STNODEFAULTFOLDER
|
.B STNODEFAULTFOLDER
|
||||||
Don\(aqt create a default folder when starting for the first time. This
|
Don’t create a default folder when starting for the first time. This
|
||||||
variable will be ignored anytime after the first run.
|
variable will be ignored anytime after the first run.
|
||||||
.TP
|
.TP
|
||||||
.B STGUIASSETS
|
.B STGUIASSETS
|
||||||
@ -315,7 +315,7 @@ All of the above.
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.TP
|
.TP
|
||||||
.B STPROFILER
|
.B STPROFILER
|
||||||
Set to a listen address such as "127.0.0.1:9090" to start the profiler with
|
Set to a listen address such as “127.0.0.1:9090” to start the profiler with
|
||||||
HTTP access.
|
HTTP access.
|
||||||
.TP
|
.TP
|
||||||
.B STCPUPROFILE
|
.B STCPUPROFILE
|
||||||
@ -352,7 +352,7 @@ Disable automatic upgrades.
|
|||||||
.TP
|
.TP
|
||||||
.B STHASHING
|
.B STHASHING
|
||||||
Specify which hashing package to use. Defaults to automatic based on
|
Specify which hashing package to use. Defaults to automatic based on
|
||||||
performance. Specify "minio" (compatibility) or "standard" for the default Go implementation.
|
performance. Specify “minio” (compatibility) or “standard” for the default Go implementation.
|
||||||
.TP
|
.TP
|
||||||
.B GOMAXPROCS
|
.B GOMAXPROCS
|
||||||
Set the maximum number of CPU cores to use. Defaults to all available CPU
|
Set the maximum number of CPU cores to use. Defaults to all available CPU
|
||||||
@ -365,10 +365,10 @@ numbers keep peak memory usage down, at the price of CPU usage
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.SH SEE ALSO
|
.SH SEE ALSO
|
||||||
.sp
|
.sp
|
||||||
\fIsyncthing\-config(5)\fP, \fIsyncthing\-stignore(5)\fP,
|
\fBsyncthing\-config(5)\fP, \fBsyncthing\-stignore(5)\fP,
|
||||||
\fIsyncthing\-device\-ids(7)\fP, \fIsyncthing\-security(7)\fP,
|
\fBsyncthing\-device\-ids(7)\fP, \fBsyncthing\-security(7)\fP,
|
||||||
\fIsyncthing\-networking(7)\fP, \fIsyncthing\-versioning(7)\fP,
|
\fBsyncthing\-networking(7)\fP, \fBsyncthing\-versioning(7)\fP,
|
||||||
\fIsyncthing\-faq(7)\fP
|
\fBsyncthing\-faq(7)\fP
|
||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
The Syncthing Authors
|
The Syncthing Authors
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
|
Loading…
x
Reference in New Issue
Block a user