odarriba/timemachine

docker-timemachine

一个Docker容器，编译最新版本的Netatalk以运行Time Machine服务器，支持ARM设备（如树莓派）和x86架构，方便配置用户账户和存储卷。

在ARM/RPi上运行

若要在ARM设备（如树莓派）上使用，有两种选择：

• 获取预编译镜像（最新编译于2018-03-29）：

  $ docker run -h timemachine --name timemachine --restart=unless-stopped -d -v /external_volume:/timemachine -it -p 548:548 -p 636:636 odarriba/timemachine-rpi
  

• 在设备上直接构建镜像：

  $ docker build -t timemachine-rpi:latest -f Dockerfile .
  $ docker run -h timemachine --name timemachine --restart=unless-stopped -d -v /external_volume:/timemachine -it -p 548:548 -p 636:636 timemachine-rpi
  

安装步骤

步骤1 - 启动服务器

下载并运行Docker容器：

$ docker run -h timemachine --name timemachine --restart=unless-stopped -d -v /external_volume:/timemachine -it -p 548:548 -p 636:636 --ulimit nofile=65536:65536 odarriba/timemachine

将external_volume替换为本地存储数据的路径。由于使用--restart=unless-stopped，容器会在系统启动时自动运行。

步骤2 - 添加用户

添加用户：

$ docker exec timemachine add-account USERNAME PASSWORD VOL_NAME VOL_ROOT [VOL_SIZE_MB]

若需指定UID/GID：

$ docker exec timemachine add-account -i 1000 -g 1000 USERNAME PASSWORD VOL_NAME VOL_ROOT [VOL_SIZE_MB]

注意：

• VOL_NAME是OSX中显示的网络驱动器名称；
• VOL_ROOT应为绝对路径，建议是/timemachine的子路径（如/timemachine/backup）；
• VOL_SIZE_MB是可选参数，指定用户卷的最大大小。

步骤3 - 启用自动发现

Avahi守护进程用于帮助计算机发现服务器提供的服务。由于Docker网络限制，Avahi未内置在镜像中，需在主机安装：

（Ubuntu系统步骤）：

1. 安装avahi-daemon：sudo apt-get install avahi-daemon avahi-utils；
2. 将avahi/nsswitch.conf复制到/etc/nsswitch.conf；
3. 将avahi/afpd.service复制到/etc/avahi/services/afpd.service；
4. 重启Avahi：sudo /etc/init.d/avahi-daemon restart。

步骤4 - 配置防火墙

确保服务器允许端口548和636的流量（如ufw allow 548和ufw allow 636），且Mac设备允许 outgoing 连接。

步骤5 - 使用方法

1. 若启用Avahi，打开Finder→共享→连接到服务器（输入用户名密码）；
2. 或按CMD-K，输入afp://your-server（your-server为服务器名称或IP）；
3. 打开系统偏好设置→Time Machine→添加或移除备份磁盘→选择新卷。

高级用法

环境变量配置

可通过环境变量配置容器（适合docker-compose）：

• AFP_LOGIN: 用户名；
• AFP_PASSWORD: 密码；
• AFP_NAME: 卷名称；
• AFP_SIZE_LIMIT: 卷大小（MB，可选）；
• PUID: 用户UID；
• PGID: 用户GID。

使用这些变量时，容器启动时会创建一个用户，数据直接存储在/timemachine（无 subfolders）。获取PUID/GID：id <dockeruser>。

FAQ

容器运行后，防火墙已配置，但Time Machine找不到服务？

确保先手动挂载服务器卷（步骤5），再在Time Machine设置中查找。

容器重启后无法登录？

用户账户是临时的，需重新执行步骤2添加；或自定义entrypoint.sh脚本自动创建账户：

bash
#!/bin/bash
set -e
# 重复添加所有账户
add-account USERNAME PASSWORD VOL_NAME VOL_ROOT [VOL_SIZE_MB]
/usr/bin/supervisord -c /etc/supervisor/conf.d/supervisord.conf

保存为entrypoint.sh（chmod +x），运行容器时挂载：

$ docker run -h timemachine --name timemachine --restart=unless-stopped -d -v /external_volume:/timemachine -it -p 548:548 -p 636:636 -v entrypoint.sh:/entrypoint.sh odarriba/timemachine-rpi

仍有问题？

• 可尝试用--net=host运行容器（注意安全风险）；
• Time Machine网络磁盘需手动挂载一次，才能被系统识别。

为何Avahi需安装在主机而非容器？

因Docker网络限制，容器内的Avahi无法广播发现消息到其他设备。

贡献者

• Óscar de Arriba (***)
• Daniel Iñigo (***)
• Josef Friedrich (https://github.com/Josef-Friedrich)