# PT System Checking

上报硬盘剩余空间到 Uptime Kuma 实例，以 ping 作为空间剩余

## 部署

### 一键部署（推荐）

下载后运行（因为需要交互脚本）：

```bash
wget https://gitea.service.jazzwhom.top/Passthem/pt-disk-report/raw/branch/main/install.sh
sudo bash install.sh
```

安装脚本会：
1. 自动检测系统架构（amd64/arm64）
2. 从 Gitea Releases 下载对应的二进制文件
3. 交互式配置服务参数（服务器 URL、检查间隔、日志级别）
4. 安装并启动 systemd 服务

### 更新服务

```bash
curl -fsSL https://gitea.service.jazzwhom.top/Passthem/pt-disk-report/raw/branch/main/update.sh | sudo bash
```

或者下载后运行：

```bash
wget https://gitea.service.jazzwhom.top/Passthem/pt-disk-report/raw/branch/main/update.sh
sudo bash update.sh
```

### 卸载服务

```bash
sudo bash install.sh uninstall
```

## 本地构建与发布

### 安装交叉编译工具链

```bash
make install-targets
```

### 构建所有架构

```bash
make release
```

### 准备发布文件

```bash
make prepare-release
```

这会在 `release/` 目录生成：
- `pt_system_checking-amd64` - x86_64 架构二进制文件
- `pt_system_checking-arm64` - ARM64 架构二进制文件（适用于香橙派 Zero3）
- `install.sh` - 一键部署脚本
- `update.sh` - 一键更新脚本

### 发布 Gitea Release

```bash
make create-release VERSION=0.1.5
```

## 配置说明

服务支持以下配置项（通过环境变量）：

- `PT__SERVER_URL` - 服务器 URL（用于上报磁盘状态）
- `PT__INTERVAL` - 检查间隔（秒，默认 300）
- `PT__LOG_LEVEL` - 日志级别（trace/debug/info/warn/error，默认 info）

## 服务管理

安装后可使用以下命令管理服务：

```bash
# 查看服务状态
systemctl status pt_system_checking

# 查看实时日志
journalctl -u pt_system_checking -f

# 停止服务
systemctl stop pt_system_checking

# 启动服务
systemctl start pt_system_checking

# 重启服务
systemctl restart pt_system_checking

# 禁用开机自启
systemctl disable pt_system_checking
```

## 手动安装

如果不使用一键脚本，可以手动安装：

1. 下载对应架构的二进制文件
2. 复制到 `/opt/pt_system_checking/`
3. 创建 systemd 服务文件 `/etc/systemd/system/pt_system_checking.service`
4. 配置环境变量
5. 启动服务：`systemctl enable --now pt_system_checking`

## 开发

### 运行测试

```bash
make test
```

### 清理构建文件

```bash
make clean
```