89 lines
2.1 KiB
Markdown
89 lines
2.1 KiB
Markdown
# archive - 压缩文件
|
||
|
||
创建、查看、解压压缩文件，不用记 `tar -czf` / `tar -xzf` / `unzip` 的区别。
|
||
|
||
## 命令
|
||
|
||
| 命令 | 作用 |
|
||
| --- | --- |
|
||
| `kopsc archive create <路径> [选项]` | 创建压缩文件 |
|
||
| `kopsc archive list <文件>` | 列出压缩文件内容（不解压） |
|
||
| `kopsc archive extract <文件> [--dir 目录]` | 自动识别格式并解压 |
|
||
|
||
别名：`kopsc archive unzip`、`kopsc archive untar`
|
||
|
||
## 支持的格式
|
||
|
||
| 扩展名 | 创建 | 查看 | 解压 |
|
||
| --- | --- | --- | --- |
|
||
| `.tar.gz` / `.tgz` | ✓ | ✓ | ✓ |
|
||
| `.tar` | ✓ | ✓ | ✓ |
|
||
| `.zip` | ✓ | ✓ | ✓ |
|
||
| `.tar.bz2` / `.tbz2` | - | - | ✓ |
|
||
| `.tar.xz` / `.txz` | - | - | ✓ |
|
||
| `.gz` | - | - | ✓ |
|
||
|
||
## 创建压缩文件（archive.create）
|
||
|
||
```bash
|
||
# 压缩目录为 tar.gz（默认格式）
|
||
kopsc archive create ./mydir
|
||
|
||
# 压缩为 zip 格式
|
||
kopsc archive create ./mydir --format zip
|
||
|
||
# 指定输出文件名
|
||
kopsc archive create ./mydir -o backup.tar.gz
|
||
|
||
# 压缩单个文件
|
||
kopsc archive create config.yaml
|
||
```
|
||
|
||
### 选项
|
||
|
||
| 选项 | 默认值 | 说明 |
|
||
| --- | --- | --- |
|
||
| `--format` / `-f` | `tar.gz` | 压缩格式（`tar.gz` / `tgz` / `tar` / `zip`） |
|
||
| `--output` / `-o` | `<目录名>.<格式>` | 输出文件名 |
|
||
|
||
## 查看压缩文件内容（archive.list）
|
||
|
||
```bash
|
||
# 列出 tar.gz 内容
|
||
kopsc archive list backup.tar.gz
|
||
|
||
# 列出 zip 内容
|
||
kopsc archive list app.zip
|
||
```
|
||
|
||
输出示例：
|
||
|
||
```
|
||
权限 大小 修改时间 名称
|
||
------------------------------------------------------------
|
||
d0755 0 2026-11-05 10:30:00 mydir/
|
||
-0644 1234 2026-11-05 10:30:00 mydir/file1.txt
|
||
-0755 5678 2026-11-05 10:30:00 mydir/script.sh
|
||
------------------------------------------------------------
|
||
共 3 项，总大小 6.9K
|
||
```
|
||
|
||
## 解压文件（archive.extract）
|
||
|
||
```bash
|
||
# 解压到当前目录
|
||
kopsc archive extract app.tar.gz
|
||
|
||
# 解压到指定目录
|
||
kopsc archive extract backup.zip --dir /opt/backup
|
||
|
||
# 解压 tar.bz2
|
||
kopsc archive extract data.tar.bz2
|
||
```
|
||
|
||
### 选项
|
||
|
||
| 选项 | 说明 |
|
||
| --- | --- |
|
||
| `--dir` / `-d` / `-C` | 目标目录（默认当前目录） |
|