apnar/rsync-server

rsync-server

概述和主要用途

Docker中的rsyncd/sshd服务器，用于文件传输。基于axiom的同名容器修改，采用ubuntu:bionic作为基础镜像，支持自动构建，调整了路径和名称，并添加了pipework以满足特殊网络需求。

核心功能和特性

• 同时支持rsyncd和sshd服务
• 基于Ubuntu Bionic，稳定性高
• 可通过环境变量灵活配置用户名、密码、数据目录和允许的客户端IP
• 支持SSH密钥认证，提高安全性
• 包含pipework，适应特殊网络需求

使用场景和适用范围

• 本地或局域网内的文件同步
• 服务器间的文件备份与传输
• 需要同时支持rsync协议和SSH协议的文件传输场景
• 开发环境或测试环境中的临时文件共享服务

使用方法和配置说明

快速启动

启动同时支持rsyncd和sshd的服务器：

bash
$ docker run \
    --name rsync-server \  # 容器名称
    -p 8000:873 \          # 映射rsyncd端口
    -p 9000:22 \           # 映射sshd端口
    -e USERNAME=user \     # rsync用户名
    -e PASSWORD=pass \     # rsync/ssh密码
    -v /your/public.key:/root/.ssh/authorized_keys \  # 挂载SSH公钥
    apnar/rsync-server

rsyncd使用示例

通过rsync协议连接服务器：

bash
$ rsync -av /your/folder/ rsync://user@localhost:8000/data
Password: pass  # 输入设置的PASSWORD
sending incremental file list
./
foo/
foo/bar/
foo/bar/hi.txt

sent 166 bytes  received 39 bytes  136.67 bytes/sec
total size is 0  speedup is 0.00

sshd使用示例

通过SSH协议连接服务器（注意：需使用root用户连接，而非USERNAME变量指定的用户）：

若未挂载密钥文件，将提示输入密码：

bash
$ rsync -av -e "ssh -i /your/private.key -p 9000 -l root" /your/folder/ localhost:/data
sending incremental file list
./
foo/
foo/bar/
foo/bar/hi.txt

sent 166 bytes  received 31 bytes  131.33 bytes/sec
total size is 0  speedup is 0.00

高级用法

变量选项

启动容器时可通过环境变量配置以下参数：

• USERNAME - rsync用户名，默认为user
• PASSWORD - rsync/ssh密码，默认为pass
• VOLUME - rsync数据目录路径，默认为/data
• ALLOW - 允许连接的客户端IP列表（空格分隔），默认为192.168.0.0/16 172.16.0.0/12
• WAIT_INT - 等待指定网络接口出现后再启动服务（用于pipework）

使用示例

简单服务器（默认端口873）

bash
$ docker run -p 873:873 apnar/rsync-server

使用卷挂载默认/data目录

bash
$ docker run -p 873:873 -v /your/folder:/data apnar/rsync-server

设置自定义用户名和密码

bash
$ docker run \
    -p 873:873 \
    -v /your/folder:/data \
    -e USERNAME=admin \
    -e PASSWORD=mysecret \
    apnar/rsync-server

运行在自定义端口

bash
$ docker run \
    -p 9999:873 \
    -v /your/folder:/data \
    -e USERNAME=admin \
    -e PASSWORD=mysecret \
    apnar/rsync-server

验证端口配置：

bash
$ rsync rsync://admin@localhost:9999
data            /data directory

修改默认数据目录位置

bash
$ docker run \
    -p 9999:873 \
    -v /your/folder:/myvolume \
    -e USERNAME=admin \
    -e PASSWORD=mysecret \
    -e VOLUME=/myvolume \
    apnar/rsync-server

验证数据目录配置：

bash
$ rsync rsync://admin@localhost:9999
data            /myvolume directory

允许特定客户端IP访问

bash
$ docker run \
    -p 9999:873 \
    -v /your/folder:/myvolume \
    -e USERNAME=admin \
    -e PASSWORD=mysecret \
    -e VOLUME=/myvolume \
    -e ALLOW=192.168.8.0/24 192.168.24.0/24 172.16.0.0/12 127.0.0.1/32 \
    apnar/rsync-server

通过SSH协议传输（带密钥认证）

挂载SSH公钥文件到/root/.ssh/authorized_keys实现密钥认证：

bash
docker run \
    -v /your/folder:/myvolume \
    -e USERNAME=admin \
    -e PASSWORD=mysecret \
    -e VOLUME=/myvolume \
    -e ALLOW=192.168.8.0/24 192.168.24.0/24 172.16.0.0/12 127.0.0.1/32 \
    -v /my/authorized_keys:/root/.ssh/authorized_keys \
    -p 9000:22 \
    apnar/rsync-server

使用私钥连接：

bash
$ rsync -av -e "ssh -i /your/private.key -p 9000 -l root" /your/folder/ localhost:/data