浏览代码

gui, man, authors: Update docs, translations, and contributors

Syncthing Release Automation 1 年之前
父节点
当前提交
878016db39

+ 31 - 100
man/stdiscosrv.1

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 ..
-.TH "STDISCOSRV" "1" "Sep 04, 2024" "v1.27.11" "Syncthing"
+.TH "STDISCOSRV" "1" "Sep 13, 2024" "v1.27.11" "Syncthing"
 .SH NAME
 .SH NAME
 stdiscosrv \- Syncthing Discovery Server
 stdiscosrv \- Syncthing Discovery Server
 .SH SYNOPSIS
 .SH SYNOPSIS
@@ -35,9 +35,10 @@ stdiscosrv \- Syncthing Discovery Server
 .INDENT 3.5
 .INDENT 3.5
 .sp
 .sp
 .EX
 .EX
-stdiscosrv [\-cert=<file>] [\-db\-dir=<string>] [\-debug] [\-http] [\-key=<string>]
-           [\-listen=<address>] [\-metrics\-listen=<address>]
-           [\-replicate=<peers>] [\-replication\-listen=<address>]
+stdiscosrv [\-\-debug] [\-\-http] [\-\-compression] [\-\-version]
+           [\-\-cert=<file>] [\-\-key=<string>]
+           [\-\-listen=<address>] [\-\-metrics\-listen=<address>]
+           [\-\-db\-dir=<string>] [\-\-db\-flush\-interval=<string>]
 .EE
 .EE
 .UNINDENT
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -49,48 +50,55 @@ Syncthing project also maintains a global cluster for public use.
 .SH OPTIONS
 .SH OPTIONS
 .INDENT 0.0
 .INDENT 0.0
 .TP
 .TP
-.B \-cert=<file>
-Certificate file (default “./cert.pem”).
+.B \-\-debug
+Enable debug output.
 .UNINDENT
 .UNINDENT
 .INDENT 0.0
 .INDENT 0.0
 .TP
 .TP
-.B \-db\-dir=<string>
-Database directory, where data is stored (default “./discovery.db”).
+.B \-\-http
+Listen on HTTP (behind an HTTPS proxy).
 .UNINDENT
 .UNINDENT
 .INDENT 0.0
 .INDENT 0.0
 .TP
 .TP
-.B \-debug
-Enable debug output.
+.B \-\-version
+Print the current version number and exit.
 .UNINDENT
 .UNINDENT
 .INDENT 0.0
 .INDENT 0.0
 .TP
 .TP
-.B \-http
-Listen on HTTP (behind an HTTPS proxy).
+.B \-\-compression
+Enable GZIP compression of HTTP responses.
 .UNINDENT
 .UNINDENT
 .INDENT 0.0
 .INDENT 0.0
 .TP
 .TP
-.B \-key=<file>
-Key file (default “./key.pem”).
+.B \-\-cert=<file>
+Certificate file (default “./cert.pem”). Unused in –http mode.
 .UNINDENT
 .UNINDENT
 .INDENT 0.0
 .INDENT 0.0
 .TP
 .TP
-.B \-listen=<address>
+.B \-\-key=<file>
+Key file (default “./key.pem”). Unused in –http mode.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-listen=<address>
 Listen address (default “:8443”).
 Listen address (default “:8443”).
 .UNINDENT
 .UNINDENT
 .INDENT 0.0
 .INDENT 0.0
 .TP
 .TP
-.B \-metrics\-listen=<address>
-Prometheus compatible metrics endpoint listen address (default disabled).
+.B \-\-metrics\-listen=<address>
+Prometheus compatible metrics endpoint listen address (default
+disabled).
 .UNINDENT
 .UNINDENT
 .INDENT 0.0
 .INDENT 0.0
 .TP
 .TP
-.B \-replicate=<peers>
-Replication peers, \X'tty: link mailto:id@address'\fI\%id@address\fP <\fBid@address\fP>\X'tty: link', comma separated
+.B \-\-db\-dir=<string>
+Database directory, where data is stored (default “.”).
 .UNINDENT
 .UNINDENT
 .INDENT 0.0
 .INDENT 0.0
 .TP
 .TP
-.B \-replication\-listen=<address>
-Listen address for incoming replication connections (default “:19200”).
+.B \-\-db\-flush\-interval=<string>
+Interval at which the in\-memory database is flushed to disk (default
+“5m”).
 .UNINDENT
 .UNINDENT
 .SH POINTING SYNCTHING AT YOUR DISCOVERY SERVER
 .SH POINTING SYNCTHING AT YOUR DISCOVERY SERVER
 .sp
 .sp
@@ -153,7 +161,7 @@ its “device ID” (similar to Syncthing\-to\-Syncthing authentication). This
 option can be used with the certificate automatically generated by the
 option can be used with the certificate automatically generated by the
 discovery server.
 discovery server.
 .IP \(bu 2
 .IP \(bu 2
-Pass the \fB\-http\fP flag if the discovery server is behind an SSL\-secured
+Pass the \fB\-\-http\fP flag if the discovery server is behind an SSL\-secured
 reverse proxy. See below for configuration.
 reverse proxy. See below for configuration.
 .UNINDENT
 .UNINDENT
 .sp
 .sp
@@ -163,7 +171,7 @@ the certificate and key at startup. This isn’t necessary with the \fBhttp\fP f
 .INDENT 3.5
 .INDENT 3.5
 .sp
 .sp
 .EX
 .EX
-$ stdiscosrv \-cert=/path/to/cert.pem \-key=/path/to/key.pem
+$ stdiscosrv \-\-cert=/path/to/cert.pem \-\-key=/path/to/key.pem
 Server device ID is 7DDRT7J\-UICR4PM\-PBIZYL3\-MZOJ7X7\-EX56JP6\-IK6HHMW\-S7EK32W\-G3EUPQA
 Server device ID is 7DDRT7J\-UICR4PM\-PBIZYL3\-MZOJ7X7\-EX56JP6\-IK6HHMW\-S7EK32W\-G3EUPQA
 .EE
 .EE
 .UNINDENT
 .UNINDENT
@@ -190,83 +198,6 @@ https://disco.example.com:8443/
 .EE
 .EE
 .UNINDENT
 .UNINDENT
 .UNINDENT
 .UNINDENT
-.SS Replication
-.sp
-The discovery server can be deployed in a redundant, load sharing fashion.
-In this mode announcements are replicated from the server that receives them
-to other peer servers and queries can be answered equally by all servers.
-.sp
-Replication connections are encrypted and authenticated using TLS. The
-certificate is selected by the \fB\-cert\fP and \fB\-key\fP options and is thus
-shared with the main discovery API. If the \fB\-http\fP mode is used the
-certificate is not used for client requests but only for replication
-connections.
-.sp
-Authentication of replication connections is done using \X'tty: link https://docs.syncthing.net/dev/device-ids.html#id1'\fI\%Syncthing\-style
-device IDs\fP <\fBhttps://docs.syncthing.net/dev/device-ids.html#id1\fP>\X'tty: link' only \- CA
-verification is not available. The device IDs in question are those printed
-by the discovery server on startup.
-.sp
-Replication connections are unidirectional \- announcements are replication
-from the \fBsender\fP to a \fBlistener\fP\&. In order to have a bidirectional
-replication relationship between two servers both need to be configured as
-sender and listener.
-.sp
-As an example, lets assume two discovery servers:
-.INDENT 0.0
-.IP \(bu 2
-Server one is on 192.0.2.20 and has certificate ID I6K…H76
-.IP \(bu 2
-Server two is on 192.0.2.55 and has certificate ID MRI…7OK
-.UNINDENT
-.sp
-In order for both to replicate to the other and thus form a redundant pair,
-use the following commands.
-.sp
-On server one:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.EX
-$ stdiscosrv \[email protected]:19200 <other options>
-.EE
-.UNINDENT
-.UNINDENT
-.sp
-On server two:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.EX
-$ stdiscosrv \[email protected]:19200 <other options>
-.EE
-.UNINDENT
-.UNINDENT
-.sp
-The \fB\-replicate\fP directive sets which remote device IDs are expected and
-allowed for both outgoing (sending) and incoming (listening) connections,
-and which addresses to use when connecting out to those peers. Both IP and
-port must be specified in peer addresses.
-.sp
-It is possible to only allow incoming connections from a peer without
-establishing an outgoing replication connection. To do so, give only the
-device ID without “@ip:port” address:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.EX
-$ stdiscosrv \-replicate=I6K...H76 <other options>
-.EE
-.UNINDENT
-.UNINDENT
-.sp
-Discosrv will listen on the replication port only when \fB\-replicate\fP is
-given. The default replication listen address is “:19200”.
-.sp
-To achieve load balancing over two mutually replicating discovery server
-instances, add multiple A / AAAA DNS records for a given name and point
-Syncthing towards this name. The same certificate must be used on both
-discovery servers.
 .SS Reverse Proxy Setup
 .SS Reverse Proxy Setup
 .sp
 .sp
 Added in version 1.8.0: A new “X\-Client\-Port” HTTP header was added.
 Added in version 1.8.0: A new “X\-Client\-Port” HTTP header was added.

+ 1 - 1
man/strelaysrv.1

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 ..
-.TH "STRELAYSRV" "1" "Sep 04, 2024" "v1.27.11" "Syncthing"
+.TH "STRELAYSRV" "1" "Sep 13, 2024" "v1.27.11" "Syncthing"
 .SH NAME
 .SH NAME
 strelaysrv \- Syncthing Relay Server
 strelaysrv \- Syncthing Relay Server
 .SH SYNOPSIS
 .SH SYNOPSIS

+ 1 - 1
man/syncthing-bep.7

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 ..
-.TH "SYNCTHING-BEP" "7" "Sep 04, 2024" "v1.27.11" "Syncthing"
+.TH "SYNCTHING-BEP" "7" "Sep 13, 2024" "v1.27.11" "Syncthing"
 .SH NAME
 .SH NAME
 syncthing-bep \- Block Exchange Protocol v1
 syncthing-bep \- Block Exchange Protocol v1
 .SH INTRODUCTION AND DEFINITIONS
 .SH INTRODUCTION AND DEFINITIONS

+ 1 - 1
man/syncthing-config.5

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 ..
-.TH "SYNCTHING-CONFIG" "5" "Sep 04, 2024" "v1.27.11" "Syncthing"
+.TH "SYNCTHING-CONFIG" "5" "Sep 13, 2024" "v1.27.11" "Syncthing"
 .SH NAME
 .SH NAME
 syncthing-config \- Syncthing Configuration
 syncthing-config \- Syncthing Configuration
 .SH SYNOPSIS
 .SH SYNOPSIS

+ 1 - 1
man/syncthing-device-ids.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 ..
-.TH "SYNCTHING-DEVICE-IDS" "7" "Sep 04, 2024" "v1.27.11" "Syncthing"
+.TH "SYNCTHING-DEVICE-IDS" "7" "Sep 13, 2024" "v1.27.11" "Syncthing"
 .SH NAME
 .SH NAME
 syncthing-device-ids \- Understanding Device IDs
 syncthing-device-ids \- Understanding Device IDs
 .sp
 .sp

+ 1 - 1
man/syncthing-event-api.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 ..
-.TH "SYNCTHING-EVENT-API" "7" "Sep 04, 2024" "v1.27.11" "Syncthing"
+.TH "SYNCTHING-EVENT-API" "7" "Sep 13, 2024" "v1.27.11" "Syncthing"
 .SH NAME
 .SH NAME
 syncthing-event-api \- Event API
 syncthing-event-api \- Event API
 .SH DESCRIPTION
 .SH DESCRIPTION

+ 1 - 1
man/syncthing-faq.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 ..
-.TH "SYNCTHING-FAQ" "7" "Sep 04, 2024" "v1.27.11" "Syncthing"
+.TH "SYNCTHING-FAQ" "7" "Sep 13, 2024" "v1.27.11" "Syncthing"
 .SH NAME
 .SH NAME
 syncthing-faq \- Frequently Asked Questions
 syncthing-faq \- Frequently Asked Questions
 .INDENT 0.0
 .INDENT 0.0

+ 1 - 1
man/syncthing-globaldisco.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 ..
-.TH "SYNCTHING-GLOBALDISCO" "7" "Sep 04, 2024" "v1.27.11" "Syncthing"
+.TH "SYNCTHING-GLOBALDISCO" "7" "Sep 13, 2024" "v1.27.11" "Syncthing"
 .SH NAME
 .SH NAME
 syncthing-globaldisco \- Global Discovery Protocol v3
 syncthing-globaldisco \- Global Discovery Protocol v3
 .SH ANNOUNCEMENTS
 .SH ANNOUNCEMENTS

+ 1 - 1
man/syncthing-localdisco.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 ..
-.TH "SYNCTHING-LOCALDISCO" "7" "Sep 04, 2024" "v1.27.11" "Syncthing"
+.TH "SYNCTHING-LOCALDISCO" "7" "Sep 13, 2024" "v1.27.11" "Syncthing"
 .SH NAME
 .SH NAME
 syncthing-localdisco \- Local Discovery Protocol v4
 syncthing-localdisco \- Local Discovery Protocol v4
 .SH MODE OF OPERATION
 .SH MODE OF OPERATION

+ 1 - 1
man/syncthing-networking.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 ..
-.TH "SYNCTHING-NETWORKING" "7" "Sep 04, 2024" "v1.27.11" "Syncthing"
+.TH "SYNCTHING-NETWORKING" "7" "Sep 13, 2024" "v1.27.11" "Syncthing"
 .SH NAME
 .SH NAME
 syncthing-networking \- Firewall Setup
 syncthing-networking \- Firewall Setup
 .SH ROUTER SETUP
 .SH ROUTER SETUP

+ 1 - 1
man/syncthing-relay.7

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 ..
-.TH "SYNCTHING-RELAY" "7" "Sep 04, 2024" "v1.27.11" "Syncthing"
+.TH "SYNCTHING-RELAY" "7" "Sep 13, 2024" "v1.27.11" "Syncthing"
 .SH NAME
 .SH NAME
 syncthing-relay \- Relay Protocol v1
 syncthing-relay \- Relay Protocol v1
 .SH WHAT IS A RELAY?
 .SH WHAT IS A RELAY?

+ 1 - 1
man/syncthing-rest-api.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 ..
-.TH "SYNCTHING-REST-API" "7" "Sep 04, 2024" "v1.27.11" "Syncthing"
+.TH "SYNCTHING-REST-API" "7" "Sep 13, 2024" "v1.27.11" "Syncthing"
 .SH NAME
 .SH NAME
 syncthing-rest-api \- REST API
 syncthing-rest-api \- REST API
 .sp
 .sp

+ 1 - 1
man/syncthing-security.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 ..
-.TH "SYNCTHING-SECURITY" "7" "Sep 04, 2024" "v1.27.11" "Syncthing"
+.TH "SYNCTHING-SECURITY" "7" "Sep 13, 2024" "v1.27.11" "Syncthing"
 .SH NAME
 .SH NAME
 syncthing-security \- Security Principles
 syncthing-security \- Security Principles
 .sp
 .sp

+ 1 - 1
man/syncthing-stignore.5

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 ..
-.TH "SYNCTHING-STIGNORE" "5" "Sep 04, 2024" "v1.27.11" "Syncthing"
+.TH "SYNCTHING-STIGNORE" "5" "Sep 13, 2024" "v1.27.11" "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
 .SH SYNOPSIS
 .SH SYNOPSIS

+ 1 - 1
man/syncthing-versioning.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 ..
-.TH "SYNCTHING-VERSIONING" "7" "Sep 04, 2024" "v1.27.11" "Syncthing"
+.TH "SYNCTHING-VERSIONING" "7" "Sep 13, 2024" "v1.27.11" "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
 .sp
 .sp

+ 1 - 1
man/syncthing.1

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 ..
-.TH "SYNCTHING" "1" "Sep 04, 2024" "v1.27.11" "Syncthing"
+.TH "SYNCTHING" "1" "Sep 13, 2024" "v1.27.11" "Syncthing"
 .SH NAME
 .SH NAME
 syncthing \- Syncthing
 syncthing \- Syncthing
 .SH SYNOPSIS
 .SH SYNOPSIS