Syncthing 在 Linux 上有五种安装方式：一、APT（Ubuntu/Debian）；二、Snap（Ubuntu 18.04+）；三、手动二进制（全发行版）；四、Docker（容器环境）；五、首次运行后需修改 config.xml 中 GUI 监听地址为 0.0.0.0:8384 以支持远程访问。
如果您希望在 Linux 系统上部署 Syncthing 实现本地文件同步，但尚未完成安装与基础配置，则可能是由于缺少依赖、源配置错误或二进制未正确注册至系统路径。以下是多种可行的安装方法：
一、使用 APT 包管理器安装（适用于 Ubuntu/Debian）
该方式通过官方仓库或可信镜像源安装，适合追求稳定性和快速部署的用户，无需手动处理二进制或依赖。
1、添加 Syncthing 官方 GPG 密钥及清华镜像源：
sudo apt-get install curl
curl -s https://syncthing.net/release-key.txt | sudo apt-key add -
echo "deb https://mirrors.tuna.tsinghua.edu.cn/syncthing/apt/ stable main" | sudo tee /etc/apt/sources.list.d/syncthing.list
2、更新软件包索引并安装：
sudo apt update
sudo apt install syncthing
3、验证安装结果：
syncthing --version
若输出类似 syncthing v2.0.10 "Hafnium Hornet" 的版本信息，表示安装成功。
二、使用 Snap 安装（适用于 Ubuntu 18.04+）
该方式由 Snapd 守护进程统一管理，自动处理依赖与沙箱权限，适合桌面环境且对系统侵入性较低。
1、确保 snapd 已启用：
sudo apt-get install snapd
2、安装 Syncthing：
sudo snap install syncthing
3、启动服务并确认状态：
sudo snap start syncthing
sudo snap services syncthing
此时 Web 界面应可通过 http://localhost:8384 访问。
三、手动下载二进制安装（适用于所有 Linux 发行版）
该方式绕过包管理器，直接获取 GitHub 官方构建版本，适用于 AlmaLinux、CentOS 或无 root 权限的用户。
1、下载最新 Linux AMD64 版本压缩包：
wget https://github.com/syncthing/syncthing/releases/download/v2.0.10/syncthing-linux-amd64-v2.0.10.tar.gz
2、解压并提取二进制文件：
tar -xzf syncthing-linux-amd64-v2.0.10.tar.gz
cd syncthing-linux-amd64-v2.0.10
sudo mv syncthing /usr/local/bin/
3、验证可执行性：
Linux 安全审计工具，检查 SSH 配置、开放/监听端口、防火墙规则（ufw/iptables/nftables）、失败登录尝试、sudoers 权限...
syncthing --version
如显示有效版本号，说明已成功注册至系统 PATH。
四、通过 Docker 部署（适用于已有容器运行时环境）
该方式将 Syncthing 运行为隔离容器，便于统一管理、版本切换与资源限制，适合服务器集群场景。
1、拉取并加载官方镜像（若使用国内镜像加速）：
docker pull syncthing/syncthing
2、运行容器并映射端口与数据卷：
docker run -d \
--name syncthing \
--restart=always \
-p 8384:8384 \
-p 22000:22000 \
-v $HOME/.config/syncthing:/root/.config/syncthing \
-v $HOME/Sync:/root/Sync \
syncthing/syncthing
3、确认容器运行状态：
docker ps | grep syncthing
输出中应包含 Up 状态及端口映射信息。
五、配置首次运行与远程访问
无论采用哪种安装方式，首次运行均需生成默认配置，并修改监听地址以支持局域网或外网访问。
1、首次启动 Syncthing（前台运行）：
syncthing
等待日志输出出现 GUI and API listening on 127.0.0.1:8384 后按 Ctrl+C 停止。
2、定位并编辑 config.xml 文件：
vi ~/.config/syncthing/config.xml
若路径不存在，尝试：vi ~/.local/state/syncthing/config.xml
3、修改 GUI 监听地址：
查找 127.0.0.1:8384 并替换为 0.0.0.0:8384
4、重启 Syncthing 使配置生效：
syncthing
