# Syncthing 维护

# Syncthing 维护指南

本章节主要介绍 Syncthing 的日常运维操作，包括服务管理、日志排查、权限问题以及常见故障处理。

---

## 服务管理（systemd）

Syncthing 通常以 systemd 服务运行：

```bash
systemctl status syncthing@syncthing
```

### 启动 / 停止 / 重启

```bash
# 启动
systemctl start syncthing@syncthing

# 停止
systemctl stop syncthing@syncthing

# 重启
systemctl restart syncthing@syncthing
```

### 检查是否开机自启动（重点）

```bash
systemctl is-enabled syncthing@syncthing
```

返回：

- enabled → 已开机启动
- disabled → 未启用

### 设置开机自启动

```bash
systemctl enable syncthing@syncthing
```

### 取消开机自启动

```bash
systemctl disable syncthing@syncthing
```

### 日志查看（排错核心）

实时日志：

```bash
journalctl -u syncthing@syncthing -f
```

查看最近日志：

```bash
journalctl -u syncthing@syncthing --since "1 hour ago"
```

常见日志问题:

permission denied

说明权限不足：

> 需要检查目录归属

```bash
chown -R syncthing:syncthing /your/folder
```

### 权限问题（高频问题）

Syncthing 不会自动修复权限。

正确设置:
例: 给 `/site` 目录设置权限

```bash
chown -R syncthing:syncthing /site
chmod -R 755 /site
```

#### 查看目录属于哪个用户

```bash
ls -ld /site
```

关键是这一段：

```
drwxr-xr-x
```

拆解：

|位置|含义|
|:---:|:---:|
|d|目录|
|rwx|所有者权限|
|r-x|组权限|
|r-x|其他用户权限|

权限含义

|字符|含义|
|:---:|:---:|
|r|可读（read）|
|w|可写（write）|
|x|可执行（目录表示可进入）|

#### 用数字方式查看权限（更清晰）

```bash
stat /site
```

输出示例：

```
  File: /site
  Size: 4096            Blocks: 8          IO Block: 4096   directory
Device: 254,1   Inode: 524289      Links: 11
Access: (0755/drwxr-xr-x)  Uid: ( 1000/syncthing)   Gid: ( 1000/syncthing)
Access: 2026-04-09 07:53:58.865939821 +0530
Modify: 2026-04-07 09:30:12.473021927 +0530
Change: 2026-04-09 07:17:06.981783777 +0530
 Birth: 2026-04-07 09:29:09.726524648 +0530
```

这里可以直接看到：

权限：0755

用户：syncthing

组：syncthing

#### 测试权限

**测试读取权限**

```bash
runuser -u syncthing -- ls /site
```

这条命令的真实意思是：

> 用 `syncthing` 用户的权限，执行 `ls /site`

---

**测试写权限**

使用 `syncthing` 用户的权限,在`/site`目录中创建 `test` 目录

```bash
runuser -u syncthing -- touch /site/test
```

---

**测试删除权限**

使用 `syncthing` 用户的权限,在`/site`目录中删除 `test` 目录

```bash
runuser -u syncthing -- rm /site/test
```

#### 递归查看（排查用）

查看目录及子文件：

```bash
ls -l /site
```

如果很多文件：

```bash
ls -l /site | head
```

### 网络与端口检查

默认使用：

|端口|协议|用途|
|:---:|:---:|:---:|
|8384|TCP|WEB|
|22000|TCP|同步|
|22000|UDP|QUIC|

检查端口监听:

```bash
ss -tulnp | grep 22000
```