dr34m/tao-sync
dr34m
tao-sync是一款运行于Docker容器环境中、专为 V3版本设计的自动化同步工具，主要用于帮助用户实现 V3中各类存储服务（如本地存储、云存储等）之间的文件数据自动同步，支持定时同步、增量同步等多种模式，无需手动干预即可保持数据一致性，有效提升 V3用户的文件管理效率与数据同步便捷性。
14 次收藏下载次数: 0状态：社区镜像维护者：dr34m仓库类型：镜像最近更新：1 天前
让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
tao-sync： v3 自动化同步工具
工具简介
tao-sync 是一款针对 v3 设计的自动化同步备份工具，支持两种同步模式：
- 全同步模式：定时扫描指定目录，确保目标目录与源目录完全一致；
- 仅新增模式：仅同步源目录中存在、但目标目录中缺失的文件。
工具名称中的“桃桃”，取自开发者女儿的名字，意为“桃桃的自动同步工具”。
最新功能、截图等内容请以 [Github 仓库] 为准（此处内容可能滞后）。若觉得工具实用，欢迎 Star 支持！
重要提醒
切勿在外网暴露本系统，否则后果自负！
系统已做基础安全防护，但无法保证绝对安全。若确需公网访问，务必使用强密码并启用 SSL 加密。
前置须知
- 工具基于 v3 API 实现功能，不依赖 源码，需用户自行额外启动 `` 服务；
- 使用前需确保已了解并会基本操作 。
使用步骤
1. 启动容器
通过 Docker 快速部署，命令如下（替换 /opt/data 为实际需挂载的目录）：
bashdocker run -d --restart=always -p 8023:8023 -v /opt/data:/app/data --name=taoSync docker.xuanyuan.run/dr34m/tao-sync:latest
参数说明：
-d：后台运行；--restart=always：容器开机自启；-p 8023:8023：端口映射（默认端口 8023）；-v /opt/data:/app/data：挂载数据目录（日志、配置等存储于此）。
2. 登录系统
部署后访问 [] admin`，初始密码需查看日志获取：
- 若 Docker 控制台未显示日志，可在挂载目录的
/log/sys_xxx.log文件中查看（通常在第一行）。
3. 初始配置
登录后建议立即前往 系统设置 修改密码，避免默认密码泄露。
4. 创建同步任务
进入系统后，需依次完成：
- 引擎管理：创建同步引擎（配置连接信息）；
- 作业管理：创建同步作业（选择源/目标目录、同步模式、定时规则等）。
绿联 NAS 用户参考
绿联 NAS 环境下的使用方法可参考：[《如何在绿联NAS中使用TaoSync同步我的文件到各个网盘》]
环境变量配置
环境变量用于自定义工具运行参数，修改后需重启 Docker 容器生效。具体变量说明如下：
| 环境变量名 | 描述 | 默认值 |
|---|---|---|
TAO_PORT | 工具运行端口号 | 8023 |
TAO_EXPIRES | 登录会话有效期（单位：天） | 2 |
TAO_LOG_LEVEL | 日志等级（0-DEBUG/1-INFO/2-WARNING/3-ERROR/4-CRITICAL，数值越大日志越少，推荐 1 或 2） | 1 |
TAO_CONSOLE_LEVEL | 控制台日志等级（v0.2.3 及以上版本支持，规则同上） | 2 |
TAO_LOG_SAVE | 系统日志自动清理周期（单位：天，0 表示不清理） | 7 |
TAO_TASK_SAVE | 任务记录自动清理周期（单位：天，0 表示不清理） | 0 |
TAO_TASK_TIMEOUT | 任务执行超时时间（单位：小时，建议设长些，避免大文件同步中断） | 72 |
TZ | 时区 | Asia/Shanghai |
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull dr34m/tao-sync:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"