Debian下copidar配置方法

Debian下Copidar配置方法

1. 安装Copidar

在Debian系统中，Copidar的安装主要有两种方式：

APT包管理器（推荐）：适用于大多数用户，操作简单且便于后续管理。运行以下命令更新APT源并安装Copidar：
```
sudo apt update
sudo apt install copidar
```
安装完成后，通过copidar --version验证是否安装成功。
源代码编译安装：若需要最新版本或APT仓库中无该软件包，可选择此方式。首先安装依赖项：
```
sudo apt install build-essential git cmake
```
然后克隆Copidar仓库并编译安装：
```
git clone https://github.com/Copidar/Copidar.git
cd Copidar
mkdir build && cd build
cmake ..
make
sudo make install
```
编译安装完成后，同样通过copidar --version验证。

2. 配置Copidar

Copidar的配置文件路径因安装方式和功能需求而异，常见位置包括/etc/copidar/copidar.conf（系统级全局配置）、~/.config/copidar/config.yaml（用户级配置）或项目目录下的copidar.json（项目专用配置）。

常见配置项说明

系统服务配置（/etc/copidar/copidar.conf）：若将Copidar作为系统服务运行，需修改此文件调整服务参数。常见参数包括：

[server]
port = 8080  # 监听端口号（默认8080）
host = 0.0.0.0  # 监听地址（0.0.0.0允许所有IP访问）
max_connections = 100  # 最大连接数
timeout = 30  # 连接超时时间（秒）
log_level = info  # 日志级别（info/debug/error）

项目配置（copidar.json）：若用于监控文件变化（如前端编译），可通过copidar --init生成默认配置文件，或手动创建。示例配置：

{
  "src": ["src/**/*.js", "src/**/*.css"],  # 监控的源文件路径（支持通配符）
  "dest": "dist",  # 编译后文件输出目录
  "watch": true,  # 是否启用文件监控
  "verbose": true,  # 是否输出详细日志
  "ignore": ["node_modules/**"]  # 忽略的文件/目录
}

环境变量配置：可通过环境变量覆盖部分配置，例如指定输入/输出路径：
```
export COPIDAR_INPUT="/path/to/input"
export COPIDAR_OUTPUT="/path/to/output"
```

3. 启动与管理Copidar服务

启动服务：若使用系统级配置，可通过systemctl命令启动Copidar服务：
```
sudo systemctl start copidar
```
设置开机自启：若需要Copidar随系统启动自动运行，执行以下命令：
```
sudo systemctl enable copidar
```

停止/重启服务：

sudo systemctl stop copidar  # 停止服务
sudo systemctl restart copidar  # 重启服务

查看服务状态：

sudo systemctl status copidar  # 查看服务运行状态

4. 防火墙设置

若系统启用了ufw防火墙，需允许Copidar监听的端口通过防火墙，例如端口8080：

sudo ufw allow 8080/tcp

执行后可通过sudo ufw status确认端口是否开放。

5. 自动化与集成（可选）

添加cron定时任务：若需要定期运行Copidar（如每日备份），可编辑cron作业：
```
crontab -e
```
添加以下内容（例如每5分钟运行一次）：
```
*/5 * * * * /usr/bin/copidar -c /path/to/your/config.json >> /var/log/copidar.log 2>&1
```
集成到项目脚本：可将Copidar命令添加到项目的package.json中（适用于Node.js项目），简化启动流程：
```
{
  "scripts": {
    "watch": "copidar"
  }
}
```
之后通过npm run watch启动Copidar。