samba-timemachine-docker 镜像文档

镜像概述和主要用途

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

开发代码位于GitHub仓库，Docker Hub镜像支持多架构部署。

网络配置

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

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

Docker运行示例

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

Docker Compose示例

仓库包含docker-compose.yml示例，配置本地卷和健康检查：

yaml
# 示例docker-compose.yml内容（具体请参考仓库文件）
version: '3'
services:
  timemachine:
    image: timjdfletcher/samba-timemachine:latest
    volumes:
      - /backups/timemachine:/backups
    ports:
      - "***:***"
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "smbclient", "-L", "//localhost", "-p", "***", "-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. 复制服务文件到/etc/avahi/services/

配置参数

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

安全性

设计假设：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需额外安装）。

测试

包含Goss测试用例，执行测试：

bash
./run test

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

调试

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

存储注意事项

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

使用的软件

• Debian Bookworm
• SAMBA
• GOSS

改进方向

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