mbentley/timemachine

用于运行Samba或AFP（netatalk）的Docker镜像，提供与macOS兼容的Time Machine备份服务。

镜像标签

多架构标签

以下标签支持amd64、armv7l和arm64架构，将根据系统架构自动拉取正确的镜像：

latest、smb

注意：afp标签在新功能更新方面已被弃用，且仅支持amd64架构。

日期特定标签

smb标签还包含每日生成的唯一清单，格式为smb-YYYYMMDD（例如smb-20210730），可在Docker Hub查看。这些标签每日生成，本质上是smb标签清单的时间点快照，可固定使用。请注意，这些标签在Docker Hub上仅保留6个月，且不会接收安全修复。若无需固定特定镜像摘要，建议直接使用smb标签。

显式架构标签

这些标签将显式拉取指定架构的镜像，与多架构标签的镜像完全一致。

amd64

• latest-smb-amd64、smb-amd64 - 基于alpine:latest的SMB镜像
• afp、afp-amd64 - 基于debian:jessie的AFP镜像
  • 已弃用但仍可用；不再定期构建 - 此镜像可能存在未修补的安全漏洞

armv7l

• latest-smb-armv7l、smb-armv7l - 基于alpine:latest的armv7l架构SMB镜像

arm64

• latest-smb-arm64、smb-arm64 - 基于alpine:latest的arm64架构SMB镜像

警告：强烈建议迁移到SMB镜像，因为AFP已被Apple弃用，且SMB稳定性更高。2020年10月15日起，latest标签默认指向SMB变体。

拉取镜像命令： docker pull mbentley/timemachine:smb

SMB示例用法

注意：若修改TM_USERNAME值，持久化卷的路径会随之改变。详见持久化数据路径。

使用--net=host启用Avahi发现（推荐）

通过--net=host允许Avahi广播发现，常用环境变量设为默认值：

docker run -d --restart=always \
  --name timemachine \
  --net=host \
  -e TM_USERNAME="timemachine" \
  -e TM_GROUPNAME="timemachine" \
  -e PASSWORD="timemachine" \
  -e TM_UID="1000" \
  -e TM_GID="1000" \
  -e SET_PERMISSIONS="false" \
  -e VOLUME_SIZE_LIMIT="0" \
  -v /主机备份路径:/opt/timemachine \
  --tmpfs /run/samba \
  mbentley/timemachine:smb

暴露端口（不启用Avahi发现）

暴露端口但不使用Avahi，需手动在Finder中映射共享：

docker run -d --restart=always \
  --name timemachine \
  --hostname timemachine \
  -p 137:137/udp \
  -p 138:138/udp \
  -p 139:139 \
  -p 445:445 \
  -e TM_USERNAME="timemachine" \
  -e TM_GROUPNAME="timemachine" \
  -e PASSWORD="timemachine" \
  -e TM_UID="1000" \
  -e TM_GID="1000" \
  -e SET_PERMISSIONS="false" \
  -e VOLUME_SIZE_LIMIT="0" \
  -v /主机备份路径:/opt/timemachine \
  --tmpfs /run/samba \
  mbentley/timemachine:smb

Kubernetes支持

镜像兼容Kubernetes。参考timemachine-k3s.yaml示例，可在单节点k3s集群（如树莓派4）上部署TimeMachine服务器。

Avahi自动发现提示

--net=host模式下发现功能最佳，可广播服务。若不使用该模式，需暴露上述端口并手动在Finder中映射共享（打开Finder→点击"共享"→通过smb://主机名或IP/TimeMachine连接）。--net=host仅在主机未运行Samba或Avahi时可用！也可通过SMB_PORT修改Samba端口。

已知问题

进程启动失败；容器CPU使用率高

若容器无法启动且日志显示Failed to start message bus: Failed to bind socket，可能是nofile资源限制过低。需在docker run或compose文件中调整nofile限制：

--ulimit nofile=65536:65536

armv7l镜像启动失败

运行armv7l镜像时若出现以下错误：

s6-svscan: warning: unable to iopause: Operation not permitted

原因是libseccomp2包版本问题，解决方法：

1. 为容器禁用seccomp（有安全风险）：

   --security-opt seccomp=unconfined
   

2. 安装backport版本的libseccomp2：

   wget [***]
   sudo dpkg -i libseccomp2_2.5.1-1~bpo10+1_armhf.deb
   

与主机Samba/Avahi冲突

若主机已运行Samba/Avahi（如树莓派OS默认mDNS响应器），--net=host会导致冲突。解决方法：

配置Avahi反射器

在主机编辑/etc/avahi/avahi-daemon.conf：

• 设置enable-reflector=yes
• 设置cache-entries-max=0（避免设备名称重复）

然后在容器中设置ADVERTISED_HOSTNAME为主机mDNS主机名（不含.local后缀）。

使用macvlan网络

创建macvlan网络（假设子网192.168.1.0/24，网关192.168.1.1，主机网卡eth0）：

docker network create -d macvlan --subnet=192.168.1.0/24 --gateway=192.168.1.1 -o parent=eth0 macvlan1

在docker run中添加：

--network macvlan1 --ip 192.168.1.x

docker-compose macvlan示例

services:
  timemachine:
    hostname: timemachine
    mac_address: "AA:BB:CC:DD:EE:FF"
    networks:
      timemachine:
        ipv4_address: 192.168.1.x

networks:
  timemachine:
    driver: macvlan
    driver_opts:
      parent: eth0
    ipam:
      config:
        - subnet: 192.168.1.0/24
          gateway: 192.168.1.1

卷和文件系统权限

持久化存储需支持扩展文件属性（xattr），NFS等远程文件系统可能不支持。镜像会检查/opt/${TM_USERNAME}中的测试文件xattr支持并警告。默认timemachine用户UID/GID为1000:1000。

持久化数据路径

修改TM_USERNAME后，容器内数据路径会变为/opt/<TM_USERNAME>，需确保卷映射正确，否则数据会存储在容器内。

默认凭据

• 用户名：timemachine
• 密码：timemachine

SMB可选环境变量

多用户和共享

通过EXTERNAL_CONF指定包含用户配置文件（.conf后缀）的目录，每个文件定义一个用户及共享。

示例EXTERNAL_CONF文件

创建foo.conf定义用户foo：

TM_USERNAME=foo
TM_GROUPNAME=foogroup
PASSWORD=foopass
SHARE_NAME=foo
VOLUME_SIZE_LIMIT="1 T"
TM_UID=1000
TM_GID=1000

EXTERNAL_CONF运行示例

docker run -d --restart=always \
  --name timemachine \
  --net=host \
  --ulimit nofile=65536:65536 \
  -e EXTERNAL_CONF="/users" \
  -v /主机备份路径:/opt \
  -v /用户配置目录:/users \
  --tmpfs /run/samba \
  mbentley/timemachine:smb

使用密码文件

通过Docker secrets传递密码，示例compose配置：

version: "3.3"
services:
  timemachine:
    environment:
      - PASSWORD_FILE=/run/secrets/password
    secrets:
      - password

secrets:
  password:
    file: ./password.txt

AFP示例和变量

docker compose -f timemachine-compose.yml up -d

docker run -d --restart=always \
  --net=host \
  --name timemachine \
  -e CUSTOM_AFP_CONF="false" \
  -e CUSTOM_USER="false" \
  -e LOG_LEVEL="info" \
  -e MIMIC_MODEL="TimeCapsule6,106" \
  -e TM_USERNAME="timemachine" \
  -e TM_GROUPNAME="timemachine" \
  -e TM_UID="1000" \
  -e TM_GID="1000" \
  -e PASSWORD="timemachine" \
  -e SET_PERMISSIONS="false" \
  -e SHARE_NAME="TimeMachine" \
  -e VOLUME_SIZE_LIMIT="0" \
  -v /主机备份路径:/opt/timemachine \
  -v timemachine-netatalk:/var/netatalk \
  -v timemachine-logs:/var/log/supervisor \
  mbentley/timemachine:afp

docker run -d --restart=always \
  --name timemachine \
  --hostname timemachine \
  -p 548:548 \
  -p 636:636 \
  -e CUSTOM_AFP_CONF="false" \
  -e CUSTOM_USER="false" \
  -e LOG_LEVEL="info" \
  -e MIMIC_MODEL="TimeCapsule6,106" \
  -e TM_USERNAME="timemachine" \
  -e TM_GROUPNAME="timemachine" \
  -e TM_UID="1000" \
  -e TM_GID="1000" \
  -e PASSWORD="timemachine" \
  -e SET_PERMISSIONS="false" \
  -e SHARE_NAME="TimeMachine" \
  -e VOLUME_SIZE_LIMIT="0" \
  -v /主机备份路径:/opt/timemachine \
  -v timemachine-netatalk:/var/netatalk \
  -v timemachine-logs:/var/log/supervisor \
  mbentley/timemachine:afp