Linux Syncthing命令详解

# 1. 通过Web界面添加文件夹
# Web界面 -> 添加文件夹

# 2. 通过配置文件添加
# 编辑 ~/.config/syncthing/config.xml
# 在 <folder> 部分添加

# 3. 文件夹配置示例
<folder id="documents" label="Documents" path="~/Documents" type="sendreceive" rescanIntervalS="3600" fsWatcherEnabled="true" fsWatcherDelayS="10" ignorePerms="false" autoNormalize="true">
    <device id="device-id-here"></device>
    <minDiskFree unit="%">1</minDiskFree>
    <versioning type="simple">
        <param value="10"></param>
    </versioning>
    <copiers>0</copiers>
    <pullerMaxPendingKiB>0</pullerMaxPendingKiB>
    <hashers>0</hashers>
    <order>random</order>
    <ignoreDelete>false</ignoreDelete>
    <scanProgressIntervalS>0</scanProgressIntervalS>
    <pullerPauseS>0</pullerPauseS>
    <maxConflicts>10</maxConflicts>
    <disableSparseFiles>false</disableSparseFiles>
    <disableTempIndexes>false</disableTempIndexes>
    <paused>false</paused>
    <weakHashThresholdPct>25</weakHashThresholdPct>
    <markerName>.stfolder</markerName>
    <copyOwnershipFromParent>false</copyOwnershipFromParent>
    <modTimeWindowS>0</modTimeWindowS>
    <maxConcurrentWrites>2</maxConcurrentWrites>
    <disableFsync>false</disableFsync>
    <blockPullOrder>standard</blockPullOrder>
    <copyRangeMethod>standard</copyRangeMethod>
    <caseSensitiveFS>false</caseSensitiveFS>
    <junctionsAsDirs>false</junctionsAsDirs>
</folder>

# 4. 使用API添加文件夹
curl -X POST -H "X-API-Key: your-api-key" -H "Content-Type: application/json" \
  -d '{"id":"test","label":"Test Folder","path":"/home/user/test","type":"sendreceive","devices":[{"deviceID":"device-id"}]}' \
  http://localhost:8384/rest/config/folders

# 1. 在同步文件夹中创建 .stignore 文件
# 语法类似.gitignore，支持通配符和正则表达式

# 2. .stignore 示例
# 忽略临时文件
*.tmp
*.temp
*.swp
*.swo

# 忽略目录
.cache/
.temp/
node_modules/
vendor/

# 忽略特定文件
secret.txt
passwords.txt

# 注释以 # 开头
# 忽略日志文件
*.log

# 使用正则表达式
(?d).*\.bak$   # 忽略所有.bak文件

# 取消忽略（使用!）
!important.log

# 3. 刷新忽略规则
# 通过Web界面：文件夹 -> 编辑 -> 重新扫描
# 或通过API
curl -X POST -H "X-API-Key: your-api-key" \
  http://localhost:8384/rest/db/scan?folder=folder-id

# 4. 检查忽略状态
curl -H "X-API-Key: your-api-key" \
  http://localhost:8384/rest/db/ignores?folder=folder-id

# 1. 全局带宽限制
# 编辑配置文件，在options部分添加
<options>
    <listenAddress>default</listenAddress>
    <globalAnnounceServer>default</globalAnnounceServer>
    <globalAnnounceEnabled>true</globalAnnounceEnabled>
    <localAnnounceEnabled>true</localAnnounceEnabled>
    <maxSendKbps>1000</maxSendKbps>    # 最大发送速度 1Mbps
    <maxRecvKbps>2000</maxRecvKbps>    # 最大接收速度 2Mbps
    <reconnectionIntervalS>60</reconnectionIntervalS>
    <relaysEnabled>true</relaysEnabled>
    <relayReconnectIntervalM>10</relayReconnectIntervalM>
    <startBrowser>true</startBrowser>
    <natEnabled>true</natEnabled>
    <natLeaseMinutes>60</natLeaseMinutes>
    <natRenewalMinutes>30</natRenewalMinutes>
    <natTimeoutSeconds>10</natTimeoutSeconds>
    <urAccepted>-1</urAccepted>
    <urUniqueID></urUniqueID>
    <urURL>https://data.syncthing.net/newdata</urURL>
    <urPostInsecurely>false</urPostInsecurely>
    <urInitialDelayS>1800</urInitialDelayS>
    <restartOnWakeup>true</restartOnWakeup>
    <autoUpgradeIntervalH>12</autoUpgradeIntervalH>
    <upgradeToPreReleases>false</upgradeToPreReleases>
    <keepTemporariesH>24</keepTemporariesH>
    <cacheIgnoredFiles>false</cacheIgnoredFiles>
    <progressUpdateIntervalS>5</progressUpdateIntervalS>
    <limitBandwidthInLan>false</limitBandwidthInLan>
    <minHomeDiskFree unit="%">1</minHomeDiskFree>
    <releasesURL>https://upgrades.syncthing.net/meta.json</releasesURL>
    <overwriteRemoteDeviceNamesOnConnect>false</overwriteRemoteDeviceNamesOnConnect>
    <tempIndexMinBlocks>10</tempIndexMinBlocks>
    <unackedNotificationIDs></unackedNotificationIDs>
</options>

# 2. 设备级带宽限制
# 在device配置中
<device id="device-id">
    <maxSendKbps>500</maxSendKbps>
    <maxRecvKbps>1000</maxRecvKbps>
</device>

# 3. 文件夹级并发设置
# 在folder配置中
<folder id="folder-id">
    <copiers>2</copiers>          # 同时复制文件数
    <hashers>1</hashers>          # 同时哈希计算数
    <pullerMaxPendingKiB>1024</pullerMaxPendingKiB>
    <maxConcurrentWrites>2</maxConcurrentWrites>
</folder>

# 1. 自定义发现服务器
# 在options部分修改
<globalAnnounceServer>default</globalAnnounceServer>
# 或指定多个
<globalAnnounceServer>https://discovery.syncthing.net/v2/</globalAnnounceServer>
<globalAnnounceServer>https://discovery-v4.syncthing.net/v2/</globalAnnounceServer>
<globalAnnounceServer>https://discovery-v6.syncthing.net/v2/</globalAnnounceServer>

# 2. 自定义中继服务器
# 默认使用公共中继池，也可指定
<relaysEnabled>true</relaysEnabled>
<relayReconnectIntervalM>10</relayReconnectIntervalM>
# 如果需要，可以添加特定中继
<relay>relay://relay.syncthing.net:22067</relay>
<relay>relay://relay://192.168.1.100:22067</relay>

# 3. 局域网发现（mDNS/Bonjour）
<localAnnounceEnabled>true</localAnnounceEnabled>
<localAnnouncePort>21027</localAnnouncePort>
<localAnnounceMCAddr>[ff12::8384]:21027</localAnnounceMCAddr>