Syncthing 安装与使用教程
syncthingOpen Source Continuous File Synchronization项目地址:https://gitcode.com/gh_mirrors/sy/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 文档。
syncthingOpen Source Continuous File Synchronization项目地址:https://gitcode.com/gh_mirrors/sy/syncthing