Skip to content

Commit

Permalink
rsync-guide: We "disallow" HTTP syncing, not "discourage"
Browse files Browse the repository at this point in the history
  • Loading branch information
iBug committed Nov 28, 2024
1 parent 47c29c4 commit c2d06ec
Showing 1 changed file with 9 additions and 9 deletions.
18 changes: 9 additions & 9 deletions docs/rsync-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,30 +5,30 @@
中科大开源镜像站允许下游站点使用 [rsync](https://www.samba.org/rsync/)
协议同步站点上的内容。

因可能消耗大量服务器资源,我们非常不推荐下游镜像站点或个人用户使用
`HTTP` / `HTTPS` / `FTP` 协议从站点大规模同步数据。
我们可能采取技术措施对使用非 `rsync`
因可能消耗大量服务器资源,我们不允许下游镜像站点或个人用户使用
HTTP / HTTPS 协议从站点大规模同步数据。
我们会采取技术措施对使用非 rsync
协议进行大量内容同步的用户进行限流或封禁。

## rsync 同步方式

### 同步专用域名

如需使用 `rsync` 协议访问科大开源镜像站,请使用 `rsync` 专用的域名:`rsync.mirrors.ustc.edu.cn`
如需使用 rsync 协议访问科大开源镜像站,请使用 rsync 专用的域名:`rsync.mirrors.ustc.edu.cn`

!!! warning

使用非标准域名 `rsync` 访问站点的用户可能无法进行同步
使用非标准域名访问站点的用户可能无法通过 rsync 进行同步

### 同步路径

!!! warning

由于 `rsync` 协议实现的限制,原有的使用 `/repo/` 前缀同步的方式难以进行负载均衡。因此从 2022 年 4 月 2 日后,同步将不再需要添加 `/repo/` 前缀。例如,`ubuntu` 仓库的实际路径即为 `rsync://rsync.mirrors.ustc.edu.cn/ubuntu`。原有的 `/repo/` 仍然保留,但是其中的部分仓库之后会迁移出去,我们建议用户尽快更换为新的路径。
由于 rsync 协议实现的限制,原有的使用 `/repo/` 前缀同步的方式难以进行负载均衡。因此从 2022 年 4 月 2 日后,同步将不再需要添加 `/repo/` 前缀。例如,`ubuntu` 仓库的实际路径即为 `rsync://rsync.mirrors.ustc.edu.cn/ubuntu`。原有的 `/repo/` 仍然保留,但是其中的部分仓库之后会迁移出去,我们建议用户尽快更换为新的路径。

!!! tip

我们强烈推荐用户在实际进行 `rsync` 同步之前先使用 `rsync`
我们强烈推荐用户在实际进行 rsync 同步之前先使用 `rsync`
工具列出目录内容以实际观察目录结构。例如,用户可以使用如下命令列出
`ubuntu` 仓库根目录的具体内容:

Expand All @@ -44,7 +44,7 @@

如需获取完整的可同步仓库列表,请使用 rsync 列出根路径下
的目录(模块)列表:

```shell
rsync rsync://rsync.mirrors.ustc.edu.cn/
```
Expand All @@ -67,7 +67,7 @@

!!! warning

为避免占用服务器过多资源,我们对单 IP 地址的 `rsync` 连接数做出了限制,
为避免占用服务器过多资源,我们对单 IP 地址的 rsync 连接数做出了限制,
在 2021 年 2 月 6 日后,限制从单 IP 2 个连接提升为 5 个连接,
过多的连接将被拒绝访问。请合理安排同步方式以达到最大的同步效率。

Expand Down

0 comments on commit c2d06ec

Please sign in to comment.