samba-timemachine-docker

镜像概述与主要用途

samba-timemachine-docker是一个集成SAMBA服务的Docker容器，专为MacOS设备设计，提供类似Apple Time Capsule的TimeMachine备份功能。容器通过优化的SAMBA配置实现与TimeMachine的兼容，支持自定义存储路径、访问权限及备份配额。

核心功能与特性

• TimeMachine兼容：预配置SAMBA服务以支持MacOS TimeMachine备份协议
• 跨架构支持：包含ARM架构构建，适配x86及ARM硬件平台
• 灵活访问控制：支持自定义用户账户、密码及权限（UID/GID）
• 备份配额管理：通过环境变量设置单设备备份存储上限（TMSIZE）
• 服务共存性：默认使用***端口映射，可与系统原生SAMBA服务并行运行
• 自动随机密码：未指定密码时自动生成随机凭证，通过日志查看

使用场景与适用范围

适用于家庭服务器、小型办公环境等场景，为MacOS设备提供轻量化TimeMachine备份解决方案。尤其适合需要快速部署备份服务、或在现有系统中隔离部署TimeMachine功能的用户。

使用方法与配置说明

基础部署

容器默认使用/backups作为备份数据存储路径，基础部署命令如下：

docker pull awlnx/samba-timemachine
docker run -d -t \
    -v /backups/timemachine:/backups:z \  # 宿主机备份目录映射
    -p ***:445 \                       # 端口映射（避免与系统SAMBA冲突）
    --restart unless-stopped \            # 自动重启策略
    --name timemachine \                  # 容器名称
    awlnx/samba-timemachine

自定义配置（环境变量）

通过环境变量覆盖默认配置参数，支持以下变量：

自定义配置示例：

docker run -d -t \
    -e USER=macbackup \           # 自定义用户名
    -e PASS=SecurePass123 \       # 自定义密码
    -e USERID=1000 \              # 匹配宿主机用户ID
    -e GROUPID=1000 \             # 匹配宿主机组ID
    -e SHARENAME=MacBackups \     # 自定义共享名称
    -e TMSIZE=2048000 \           # 设置2000GB备份配额
    -v /data/backups:/backups:z \
    -p ***:445 \
    --name timemachine \
    --restart unless-stopped \
    awlnx/samba-timemachine

查看访问凭证

默认配置下，用户timemachine的随机密码通过容器日志输出，查看命令：

docker logs timemachine

网络发现配置

需配置avahi服务实现MacOS网络发现，示例服务文件（/etc/avahi/services/timemachine.service）：

<?xml version="1.0" standalone='no'?>
<!DOCTYPE service-group SYSTEM "avahi-service.dtd">
<service-group>
  <name replace-wildcards="yes">%h</name>
  <service>
    <type>_smb._tcp</type>
    <port>***</port>
  </service>
  <service>
    <type>_device-info._tcp</type>
    <port>0</port>
    <txt-record>model=TimeCapsule8,119</txt-record>
  </service>
  <service>
    <type>_adisk._tcp</type>
    <port>0</port>
    <txt-record>sys=waMa=0,adVF=0x100</txt-record>
    <txt-record>dk0=adVN=Data,adVF=0x82</txt-record>  <!-- 此处Data需与SHARENAME一致 -->
  </service>
</service-group>

环境变量详细说明

• USERID/GROUPID：默认值1311可能与系统用户冲突，建议设置为宿主机实际用户ID（可通过id命令查看）
• TMSIZE：单位为MB，例如TMSIZE=***表示1000GB配额
• :z挂载选项：用于SELinux系统，自动调整文件上下文权限，非SELinux环境可省略

参考链接

• 项目代码仓库：GitHub
• Bonjour记录配置参考：netatalk Wiki
• 设备发现配置：OpenWrt文档