# syncthing-relaysrv-ctl

**Repository Path**: modstart-lib/syncthing-relaysrv-ctl

## Basic Information

- **Project Name**: syncthing-relaysrv-ctl
- **Description**: syncthing relaysrv installer
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-29
- **Last Updated**: 2026-01-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Syncthing Relay Server 自动部署脚本

[English](README.md) | 简体中文

自动部署 [Syncthing Relay Server v2.0.13](https://github.com/syncthing/relaysrv/releases/tag/v2.0.13) 的 Bash 脚本，支持多种 Linux 发行版。

## 功能特性

- ✅ 自动检测系统架构（amd64, arm64, arm, 386）
- ✅ 支持多种 Linux 发行版（Ubuntu, Debian, CentOS, Fedora, Rocky Linux, AlmaLinux, Arch, Manjaro, openSUSE, Alpine）
- ✅ 支持 systemd 和 OpenRC 服务管理
- ✅ 一键安装和卸载
- ✅ 可选的 relay token 配置（留空自动生成32位token）
- ✅ 自动创建 systemd/OpenRC 服务
- ✅ 开机自启动
- ✅ 日志管理

## 系统要求

- Linux 操作系统
- root 权限（使用 sudo）
- systemd 或 OpenRC 服务管理器
- 网络连接（用于下载文件）

## 使用方法

### 安装

1. 下载脚本：
```bash
wget https://raw.githubusercontent.com/your-repo/syncthing-relaysrv-ctl/main/relaysrv-ctl.sh
chmod +x relaysrv-ctl.sh
```

2. 运行安装命令：
```bash
sudo ./relaysrv-ctl.sh install
```

3. 按提示输入 relay token（可选，留空自动生成32位随机token）

### 卸载

```bash
sudo ./relaysrv-ctl.sh uninstall
```

卸载时会询问是否删除配置文件和日志，脚本本身不会被删除。

### 查看帮助

```bash
./relaysrv-ctl.sh help
```

## 安装后的文件位置

| 文件/目录        | 路径                                              |
| ---------------- | ------------------------------------------------- |
| 二进制文件       | `/usr/local/bin/strelaysrv`                       |
| 符号链接         | `/usr/local/bin/relaysrv`                         |
| systemd 服务文件 | `/etc/systemd/system/syncthing-relaysrv.service` |
| 配置目录         | `/etc/syncthing-relaysrv/`                       |
| 配置文件         | `/etc/syncthing-relaysrv/config`                 |
| 日志目录         | `/var/log/syncthing-relaysrv/`                   |

## 常用命令

### systemd 系统（大多数现代 Linux 发行版）

```bash
# 查看服务状态
sudo systemctl status syncthing-relaysrv

# 查看实时日志
sudo journalctl -u syncthing-relaysrv -f

# 重启服务
sudo systemctl restart syncthing-relaysrv

# 停止服务
sudo systemctl stop syncthing-relaysrv

# 启动服务
sudo systemctl start syncthing-relaysrv

# 禁用开机自启
sudo systemctl disable syncthing-relaysrv

# 启用开机自启
sudo systemctl enable syncthing-relaysrv
```

### OpenRC 系统（Alpine Linux）

```bash
# 查看服务状态
sudo rc-service syncthing-relaysrv status

# 重启服务
sudo rc-service syncthing-relaysrv restart

# 停止服务
sudo rc-service syncthing-relaysrv stop

# 启动服务
sudo rc-service syncthing-relaysrv start
```

## 修改配置

### 修改 token

编辑配置文件：
```bash
sudo nano /etc/syncthing-relaysrv/config
```

修改 TOKEN 值，然后重启服务：
```bash
sudo systemctl restart syncthing-relaysrv
```

### 查看日志

```bash
# 实时查看日志（systemd）
sudo journalctl -u syncthing-relaysrv -f

# 查看日志文件
sudo tail -f /var/log/syncthing-relaysrv/relaysrv.log
sudo tail -f /var/log/syncthing-relaysrv/relaysrv-error.log
```

## 支持的架构

- x86_64 (amd64)
- aarch64/arm64
- armv7l (arm)
- i386/i686 (386)

## 支持的 Linux 发行版

- Ubuntu / Debian
- CentOS / RHEL / Rocky Linux / AlmaLinux
- Fedora
- Arch Linux / Manjaro
- openSUSE
- Alpine Linux

## 安全特性

服务配置了以下安全限制：
- `NoNewPrivileges=true` - 禁止提升权限
- `PrivateTmp=true` - 私有临时目录
- `ProtectSystem=strict` - 只读系统目录
- `ProtectHome=true` - 保护用户主目录
- 配置文件权限设置为 600

## 故障排除

### 服务启动失败

1. 查看服务状态：
```bash
sudo systemctl status syncthing-relaysrv
```

2. 查看详细日志：
```bash
sudo journalctl -u syncthing-relaysrv -n 100 --no-pager
```

### 端口被占用

默认情况下，relay server 使用 22067 端口。如果端口被占用：
```bash
sudo lsof -i :22067
```

### 下载失败

如果下载失败，可能是网络问题或 GitHub releases 访问受限。可以尝试：
1. 检查网络连接
2. 使用代理
3. 手动下载文件后放置到 `/usr/local/bin/strelaysrv`

## 许可证

MIT License

## 相关链接

- [Syncthing Relay Server](https://github.com/syncthing/relaysrv)
- [Syncthing 官网](https://syncthing.net/)
- [Release v2.0.13](https://github.com/syncthing/relaysrv/releases/tag/v2.0.13)