Debian升级后调整 copidar 的实用步骤
一 版本与安装方式核验
- 确认当前可执行文件与版本：运行 which copidar 与 copidar --version，确保路径与版本符合预期（如 /usr/bin/copidar 或 /usr/local/bin/copidar）。
- 判断安装来源：
- APT 安装：运行 dpkg -l | grep copidar，若存在则属于 APT 包管理。
- pip 安装：运行 pip3 show copidar，若存在则为 Python 包。
- 升级后常见变化：可执行文件路径变更、服务文件参数未同步、配置文件格式或路径改变、环境变量未设置、端口被占用等。
二 配置调整路径
- 配置文件位置（按常见优先级）：
- 系统级：/etc/copidar/ 下的 copidar.conf / config.json / config.yaml
- 用户级：~/.config/copidar/config.yaml 或项目根目录 .copidar.json
- 查找配置文件：
- 全盘搜索：sudo find / -name “copidar.conf” -o -name “copidar.json” -o -name “copidar.yaml” 2>/dev/null
- 编辑示例：
- 使用 sudo nano /etc/copidar/copidar.conf 或 nano ~/.config/copidar/config.yaml 打开并调整参数。
- 命令行覆盖：多数场景下可用命令行参数直接覆盖配置，便于快速验证（见下文示例）。
- 环境变量（若版本支持）：
- 例如：COPIDAR_WATCH、COPIDAR_IGNORE、COPIDAR_EXEC、COPIDAR_DELAY、COPIDAR_VERBOSE 等，设置后再启动 copidar 生效。
三 systemd 服务调整
- 查看与备份现有服务：
- 检查：sudo systemctl cat copidar 与 sudo systemctl status copidar
- 备份：sudo cp /etc/systemd/system/copidar.service /etc/systemd/system/copidar.service.bak_$(date +%F)
- 编辑服务文件（示例要点）：
- 确保 ExecStart 指向正确的可执行文件路径（如 /usr/bin/copidar 或 /usr/local/bin/copidar）。
- 在 [Service] 中显式写入你需要的参数，例如：
- 文件监控示例：ExecStart=/usr/bin/copidar -w src -i node_modules -e “nodemon app.js” -d 1000 -v
- 端口监听示例：ExecStart=/usr/bin/copidar -p 8080 -l 0.0.0.0
- 设置合适的 User/Group、Restart=always，日志建议用 journald（避免仅依赖文件）。
- 重新加载并生效：
- sudo systemctl daemon-reload
- sudo systemctl restart copidar
- 验证：sudo systemctl status copidar 与 journalctl -u copidar -f
四 常见调整场景与命令示例
- 修改监听端口或地址：
- 命令行：copidar -p 9090 -l 0.0.0.0
- 配置文件：在相应配置段将 port 改为 9090、host 设为 0.0.0.0。
- 文件监控与忽略：
- 示例：copidar -w src -i node_modules -e “nodemon app.js” -d 1000 -v（监控 src、忽略 node_modules、变更后执行命令、延迟 1000ms、详细输出）。
- 同步任务（若你的版本支持）：
- 递归同步：copidar -r /path/to/source/ /path/to/dest/
- 同步并删除多余文件：copidar -r -d /path/to/source/ /path/to/dest/
- 定时同步（cron）：
- 每 5 分钟：*/5 * * * * copidar -r -v /src /dst > /var/log/copidar.log 2>&1
- 日志与排错：
- 实时查看：journalctl -u copidar -f
- 文件日志（若配置）：tail -f /var/log/copidar.log 或 tail -f /var/log/copidar/copidar.log。
五 升级后的兼容性检查与回退
- 兼容性与依赖：
- 若出现异常，先检查依赖与可用更新：sudo apt update && sudo apt install build-essential cmake git libssl-dev libboost-all-dev
- 必要时从源码重装特定版本：git clone https://github.com/copidar/copidar.git && mkdir build && cd build && cmake … && make && sudo make install
- 确认 PATH 包含安装路径（如 /usr/local/bin）：echo $PATH；必要时添加到 ~/.bashrc 并执行 source ~/.bashrc。
- 回退方案：
- APT 包：使用 sudo apt install --reinstall copidar=<旧版本号> 回退到升级前版本。
- pip 包：使用 pip3 install copidar==<旧版本号> 回退；如使用了虚拟环境，请在对应 venv 中执行。
- 防火墙与端口：
- 若修改了监听端口（如 8080 → 9090），放行新端口：sudo ufw allow 9090/tcp；同时确保旧端口不再暴露。