timjdfletcher/samba-timemachine

samba-timemachine-docker 镜像文档

镜像概述和主要用途

本镜像基于Debian bookworm，配置了SAMBA服务以提供类似Apple "Time Capsule"的备份功能。支持x86_64、Raspberry Pi 3/4及其他现代ARM64架构系统，可作为macOS设备的Time Machine备份目标。

开发代码位于https://github.com/TimJDFletcher/dockerfiles/tree/main/samba-timemachine%EF%BC%8CDocker Hub镜像支持多架构部署。

网络配置

v2.9+重大变更：容器默认监听端口变更为***

容器默认使用***端口，可与现有SAMBA服务器共存，且无需容器内root权限。

Docker运行示例

bash
docker run -d -t \
    -v /backups/timemachine:/backups \
    -p 10445:10445 \
    --restart unless-stopped timjdfletcher/samba-timemachine:latest

Docker Compose示例

仓库包含https://github.com/TimJDFletcher/dockerfiles/blob/main/samba-timemachine/docker-compose.yml%E7%A4%BA%E4%BE%8B%EF%BC%8C%E9%85%8D%E7%BD%AE%E6%9C%AC%E5%9C%B0%E5%8D%B7%E5%92%8C%E5%81%A5%E5%BA%B7%E6%A3%80%E6%9F%A5%EF%BC%9A

yaml
# 示例docker-compose.yml内容（具体请参考仓库文件）
version: '3'
services:
  timemachine:
    image: timjdfletcher/samba-timemachine:latest
    volumes:
      - /backups/timemachine:/backups
    ports:
      - "10445:10445"
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "smbclient", "-L", "//localhost", "-p", "10445", "-U", "timemachine%password"]
      interval: 30s
      timeout: 10s
      retries: 3

网络发现

容器仅在非标准端口运行smbd服务，需通过mDNS工具（如avahi）在本地网络公告服务。推荐在Docker主机运行avahi-daemon：

1. 安装avahi-daemon（Debian类系统）：

bash
apt install avahi-daemon

2. 复制https://github.com/TimJDFletcher/dockerfiles/blob/main/samba-timemachine/timemachine.service%E5%88%B0%60/etc/avahi/services/%60

配置参数

通过环境变量自定义容器行为：

安全性

设计假设：Time Machine备份在macOS源端已加密。默认配置创建Unix用户timemachine（UID/GID 999）及同名SAMBA用户（密码password）。可通过USER和PASS环境变量自定义用户凭证。

存储配额

v2.7+变更：配额单位改为GB

容器支持设置备份大小限制（默认1024GB/1TB），通过SAMBA的disk max size配置报告磁盘大小，为软限制（实际效果可能受macOS版本影响）。

构建镜像

需安装docker和docker buildx（Docker Desktop默认包含，Colima需额外https://github.com/abiosoft/colima/issues/44%EF%BC%89%E3%80%82

测试

包含https://github.com/goss-org/goss%E6%B5%8B%E8%AF%95%E7%94%A8%E4%BE%8B%EF%BC%8C%E6%89%A7%E8%A1%8C%E6%B5%8B%E8%AF%95%EF%BC%9A

bash
./run test

同时配置Trivy进行容器漏洞扫描。

调试

• 启动时添加SAMBA调试标志，如--debuglevel=4
• 查看macOS Time Machine日志：./run timemachineLogs（跟踪实时日志）

存储注意事项

Time Machine备份为元数据密集型工作负载。曾报告ZFS作为后端存储时（搭配SMR硬盘）在Catalina版本存在性能问题（可能与ZFS的写时复制机制和APFS交互有关），推荐使用ext4作为后端存储。

使用的软件

• https://hub.docker.com/_/debian?tab=tags&page=1&name=bookworm-slim
• SAMBA
• https://github.com/goss-org/goss

改进方向

• Rootless运行支持（开发中）：
  • 备份目录所有权配置
  • 用户配置（如何支持UID/GID映射？）
  • 可能采用固定UID/GID方案