xjxjin/alist-sync Docker Image Overview

xjxjin/alist-sync

xjxjin

Alist-Sync是一个基于Web界面的Alist存储同步工具，支持多任务管理、Cron定时任务、数据/文件同步两种模式，以及多种差异处理策略，可通过Docker轻松部署。

2 收藏0 次下载

😅 镜像要是出问题，背锅的一定是你

中文简介版本下载

😅 镜像要是出问题，背锅的一定是你

Alist-Sync

镜像概述

Alist-Sync是一个基于Web界面的Alist存储同步工具，支持多任务管理、定时同步、差异处理等功能。它提供了直观的用户界面，方便用户在不同的Alist存储之间同步文件和数据。

!docker pulls !docker image size

核心功能和特性

📱 美观的Web管理界面
🔄 支持多任务管理
⏰ 支持Cron定时任务
📂 支持数据同步和文件同步两种模式
🗑️ 支持多种差异处理策略（保留/移动到回收站/删除）
📝 详细的同步日志记录
🔒 支持用户认证和密码管理
🐳 支持Docker部署
🐉 支持青龙面板定时任务

使用场景和适用范围

Alist存储之间的文件同步与备份
多存储之间的数据迁移
定时自动同步重要文件
需要保持多个存储中文件一致性的场景
青龙面板环境下的定时文件管理任务

部署与使用方法

Docker部署（推荐）

1. 创建必要的目录

bash
mkdir -p /DATA/AppData/alist-sync/data

2. 创建docker-compose.yml

yaml
version: '3'

services:
  alist-sync-web:
    image: xjxjin/alist-sync:latest
    container_name: alist-sync
    restart: unless-stopped
    ports:
      - "52441:52441"
    volumes:
      - /DATA/AppData/alist-sync/data:/app/data
    environment:
      - TZ=Asia/Shanghai

3. 启动服务

bash
docker-compose up -d

4. 访问Web界面

打开浏览器访问: http://localhost:52441

默认登录账号:

用户名: admin
密码: admin

基础配置

首次使用需要配置Alist的基本连接信息:

服务地址: Alist服务的访问地址
用户名: Alist管理员账号
密码: Alist管理员密码
令牌: Alist令牌（从Alist的管理-设置-其他获取）

同步任务配置

支持三种同步模式:

数据同步模式

各个网盘之间同目录数据备份
选择源存储器和目标存储器
配置同步目录
支持排除目录
支持多目标存储同步

文件同步模式

需要填写全路径
手动配置源路径和目标路径
支持多个路径对
支持排除目录

文件移动模式

需要填写全路径
手动配置源路径和目标路径
支持多个路径对
支持排除目录
注：文件移动实现方式是先复制到目标路径，然后在下次自动执行任务时，判断目标路径是否已存在文件，如果存在则删除源路径文件

差异处理策略

提供三种差异处理方式:

不处理：保留目标目录中的差异文件
移动到回收站：将差异文件移动到目标存储的回收站(trash)
删除：直接删除目标目录中的差异文件
注意：移动/删除在某些存储源可能会失效，建议测试后再使用

定时任务

支持Cron表达式配置定时任务
可查看未来5次执行时间
支持立即执行功能

日志查看

支持查看当前日志
支持查看历史日志
日志自动按天切割

配置文件说明

所有配置文件存储在data/config目录:

alist_sync_base_config.json：基础连接配置
alist_sync_sync_config.json：同步任务配置
alist_sync_users_config.json：用户认证配置

日志文件存储在data/log目录:

alist_sync.log：当前日志
alist_sync.log.YYYY-MM-DD：历史日志

青龙面板使用

参数说明

bash
BASE_URL: 服务器基础URL(结尾不带/)
USERNAME: 用户名
PASSWORD: 密码
TOKEN: 令牌
DIR_PAIRS: 源目录和目标目录的配对(用分号隔开，冒号分隔)
CRON_SCHEDULE: 调度日期，参考cron语法 "分 时 日 月 周"（非必填，不填为一次调度）
--以下参数用于目标目录有，但源目录不存在的文件处理--
SYNC_DELETE_ACTION: 同步删除动作，可选值为move,delete。当设置为move时，文件将移动到trash目录下
EXCLUDE_DIRS: 排除目录
MOVE_FILE: 是否移动文件，会删除源目录，且与SYNC_DELETE_ACTION不能同时生效
REGEX_PATTERNS: 用于匹配文件名的正则表达式