Copidar在Debian系统中的使用教程

一、安装Copidar

Copidar的安装分为APT包管理器安装（推荐，适合大多数用户）和源代码编译安装（适合需要最新版本的用户）两种方式。

1. APT包管理器安装（推荐）

更新APT源列表：确保系统软件包信息最新。
```
sudo apt update
```
安装Copidar：通过APT直接安装Copidar及其依赖。
```
sudo apt install copidar
```
验证安装：检查Copidar版本，确认安装成功。
```
copidar --version
```

2. 源代码编译安装（可选）

若APT仓库中没有所需版本，可通过源码编译安装：

安装依赖项：编译前需安装构建工具和依赖库。
```
sudo apt install build-essential git cmake
```

克隆仓库：从GitHub获取Copidar源代码。

git clone https://github.com/Copidar/Copidar.git
cd Copidar

编译并安装：通过CMake构建并安装到系统。

mkdir build && cd build
cmake ..
make
sudo make install

验证安装：同样通过copidar --version确认版本。

二、基本使用方法

Copidar的核心功能是文件监控与同步，以下是常用命令：

1. 监控目录变化

监控指定目录（如/path/to/directory），当文件发生创建、修改或删除时输出通知：

copidar /path/to/directory

2. 同步目录

将源目录（/path/to/source/）的内容同步到目标目录（/path/to/destination/）：

递归同步（包含子目录）：使用-r选项。
```
copidar -r /path/to/source/ /path/to/destination/
```
删除多余文件：同步时删除目标目录中存在但源目录中不存在的文件，使用-d选项。
```
copidar -r -d /path/to/source/ /path/to/destination/
```
详细模式：启用-v选项，查看同步的文件详情。
```
copidar -r -v /path/to/source/ /path/to/destination/
```

3. 排除特定文件/目录

同步时忽略指定模式的文件（如*.tmp）或目录（如cache/），使用--exclude选项：

copidar -r --exclude '*.tmp' --exclude 'cache/' /path/to/source/ /path/to/destination/

4. 定时同步

通过cron设置定时任务，例如每5分钟同步一次，并将输出重定向到日志文件：

crontab -e

添加以下内容：

*/5 * * * * copidar -r -v /path/to/source/ /path/to/destination/ > /var/log/copidar.log 2>&1

三、配置文件设置

Copidar支持通过配置文件实现高级定制，配置文件通常位于~/.config/copidar/config.yaml（用户级）或/etc/copidar/config.yaml（系统级）。

1. 创建配置文件

若配置文件不存在，可手动创建或通过--init命令生成默认配置：

copidar --init

2. 配置示例

以下是一个典型的config.yaml示例，用于监控多个目录并在文件变化时执行脚本：

watch_directories:
  - /path/to/directory1
  - /path/to/directory2
event_handlers:
  - command: /path/to/script.sh  # 文件变化时执行的脚本
    events:                      # 触发事件类型
      - create                   # 文件创建
      - modify                   # 文件修改
      - delete                   # 文件删除

3. 使用配置文件启动

通过-c选项指定配置文件路径，启动Copidar：

copidar -c ~/.config/copidar/config.yaml

四、自动化与集成

1. 与Cron集成

将Copidar命令添加到cron中，实现定期同步（如每小时同步一次）：

crontab -e