timjdfletcher/samba-timemachine
timjdfletcher
轻量级基于SAMBA的Time Machine备份目标容器，支持x86_64、Raspberry Pi 3/4及ARM64系统，可作为Apple Time Capsule替代方案。
11 次收藏下载次数: 0状态：社区镜像维护者：timjdfletcher仓库类型：镜像最近更新：3 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
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运行示例
bashdocker 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：
- 安装avahi-daemon（Debian类系统）：
bashapt install avahi-daemon
- 复制https://github.com/TimJDFletcher/dockerfiles/blob/main/samba-timemachine/timemachine.service%E5%88%B0%60/etc/avahi/services/%60
配置参数
通过环境变量自定义容器行为：
| 变量名 | 功能描述 | 默认值 |
|---|---|---|
USER | Time Machine用户名 | timemachine |
PASS | Time Machine密码 | password |
PUID | 用户Unix ID | 999 |
PGID | 用户组Unix ID | 999 |
LOG_LEVEL | SAMBA日志级别 | 1 |
QUOTA | 备份配额（GB） | 1024 |
安全性
设计假设：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方案
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 samba-timemachine 镜像标签
docker pull docker.xuanyuan.run/timjdfletcher/samba-timemachine:<标签>
DockerHub 原生拉取命令
docker pull timjdfletcher/samba-timemachine:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"