安装和使用alist-sync同步数据

alist-sync 是一个用于在 AList 存储之间复制文件的 Python 工具。项目仍处于早期开发阶段，命令和配置格式可能变化；开始前请先阅读 项目 README 和配置模板。本文记录我的用途以及按当前仓库说明整理的安装方法。

起因

我有一些文件需要从我的电脑里不定期地上传到网盘里，以确保这些资料在我电脑坏掉的情况下依然存在这个世界上。这些文件的数量会经常增加，但是已有的文件基本上不会再发生改变。

OneDrive每次启动的时候它都会吃掉我CPU的大量性能，以及让我电脑的风扇准备起飞。所以希望找到一款软件可以用更加轻量的方式来实现将本地文件同步到OneDrive上。

我可以把OneDrive挂载到alist上，并且alist有着不错的生态，最终找到了这个方案——使用alist-sync把本地目录与OneDrive同步。

安装

项目要求 Python 3.10 或更新版本，并需要 Git。建议为它单独创建虚拟环境，避免影响系统 Python：

git clone https://github.com/lee-cq/alist-sync.git
cd alist-sync
python3 -m venv .venv
source .venv/bin/activate
bash ./bootstrap.sh install

在 Windows 上，可使用 Git Bash 或 WSL 运行 Bash 命令。具体依赖安装方式请以仓库当前说明为准。

使用

先复制配置模板，再填入自己的 AList 服务地址、存储和同步目录：

cp config-template.yaml config.yaml
chmod 600 config.yaml

仔细检查配置模板中的示例账号和密码，不要把默认值留在可访问的服务上，也不要把包含凭据的配置文件提交到 Git 仓库。当前项目 README 给出的 Linux 启动命令是：

./bootstrap.sh main sync

具体配置字段请对照仓库的 config-template.yaml。README 将 copy 描述为已实现：它会跳过目标端已有的文件，也不会删除只存在于目标端的文件；镜像删除、多源同步等模式仍在开发或设计中。请先用少量、可恢复的数据验证配置，再用于重要文件。