Syncthing 安装与使用教程

1. 项目目录结构及介绍

Syncthing 的源代码仓库主要由以下几个核心目录组成：

• cmd: 包含了 Syncthing 可执行文件的主程序。
• docs: 存放项目文档，包括 Markdown 格式的用户指南和开发者参考。
• gui: 用于图形用户界面（GUI）的部分代码。
• lib: 各种库文件，提供了 Syncthing 的核心功能。
• test: 测试用例和自动化测试脚本。
• vendor: 第三方依赖包。

这些目录协同工作，以实现 Syncthing 文件同步的功能。

2. 项目的启动文件介绍

Syncthing 的启动文件通常是 cmd/syncthing/main.go 中的 main() 函数。这个函数是整个应用程序的入口点，它负责初始化配置、网络连接以及启动守护进程来监控文件系统变更并进行同步。

在编译完成后，你会得到一个名为 syncthing 的可执行文件。在命令行中运行此文件即可启动 Syncthing：

./syncthing

或者在操作系统服务管理工具中设置为开机启动，例如在 systemd 系统中创建一个服务单元文件。

3. 项目的配置文件介绍

Syncthing 使用 JSON 格式配置文件，默认存储位置因操作系统而异，通常位于用户的主目录下：

• Linux/macOS: $HOME/.config/syncthing/config.xml
• Windows: %APPDATA%\syncthing\config.xml

配置文件包含了设备 ID、要同步的文件夹列表、网络设置、以及其他高级选项。以下是一些关键配置项的示例：

<configuration>
    <gui enabled="true" password="your-password">
        <address>0.0.0.0:8384</address>
    </gui>

    <folder id="personal-docs" path="/home/user/Documents" type="delta">
        <device id="ABCDEF-123456"/>
    </folder>

    <device id="ABCDEF-123456">
        <name>My Other Computer</name>
        <address>192.168.1.100:22000</address>
        <address>example.com:22000</address>
    </device>
</configuration>

在这个例子中：

• <gui> 部分设置了 GUI 是否启用及其访问地址和密码。
• <folder> 描述了一个要同步的文件夹，指定路径、类型（全量或增量）和参与同步的设备。
• <device> 包含了远程设备的信息，如名称、IP 地址和端口号。

可以通过 GUI 或者直接编辑 config.xml 来修改这些配置。但是，强烈建议通过 GUI 进行修改，以防止引入无效的配置导致 Syncthing 无法正常工作。

请确保在配置更改后重新启动 Syncthing 以应用新的设置。

以上就是 Syncthing 的基本安装与配置介绍，希望对你的使用有所帮助。进一步的学习和详细操作请参考官方文档：Syncthing 文档。