Files
termscp/docs/zh-CN/cli/cli.md
2026-06-08 10:16:00 +02:00

69 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 命令行用法
termscp 可以通过以下调用形式启动:
```sh
termscp [options]... [protocol://user@address:port:wrkdir] [protocol://user@address:port:wrkdir] [local-wrkdir]
```
```sh
termscp [options]... -b [bookmark-name] -b [bookmark-name] [local-wrkdir]
```
以及两者的任意组合。
如果未提供额外参数termscp 会显示身份验证表单。如果提供了地址参数或书签名称termscp 会跳过该表单并直接连接到远程服务器。当提供地址或书签时,你还可以将本地主机的起始工作目录作为最后一个位置参数提供。
## 选项
| Key | 说明 |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `-b <bookmark-name>` | 将位置地址参数解析为书签名称。重复使用该标志可以打开多个书签。 |
| `-D` | 启用 `TRACE` 日志级别(调试/详细日志)。 |
| `-P <password>` | 从命令行提供密码。重复使用该标志可为多个远程主机提供密码;其顺序必须与地址参数一致。不推荐使用。 |
| `-q` | 禁用日志记录。 |
| `-T <ticks>` | 设置 UI 的 tick 间隔(以毫秒为单位)。默认值为 `10`。 |
| `--wno-keyring` | 禁用系统 keyring 支持。 |
| `-v` | 打印版本信息。 |
| `--help` | 打印帮助页面。 |
不推荐使用 `-P` 选项,因为密码可能会保留在 shell 历史记录中。请参阅书签和密码安全章节,了解更安全的凭据提供方式。
## 子命令
termscp 提供以下子命令。
### 导入主题
```sh
termscp theme <theme-file>
```
导入在 `<theme-file>` 中定义的主题。
### 安装最新版本
```sh
termscp update
```
下载并安装 termscp 的最新可用版本。
### 导入 ssh 主机
```sh
termscp import-ssh-hosts [ssh-config-file]
```
将指定 ssh 配置文件中的所有主机作为书签导入到 termscp 中。如果未提供 `[ssh-config-file]`,则使用默认位置 `~/.ssh/config`。身份文件也会作为 ssh 密钥导入到 termscp 中。
### 打开配置
```sh
termscp config
```
直接在配置setup界面中启动 termscp。