> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clinkbill.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SFTP配置

> 通过 SFTP 下载每日结算文件

## 概述

Clink 会将每日结算文件投递到一个安全的 SFTP 目录。您可以使用 SFTP 客户端
（或您自己的自动化任务）拉取这些文件，用于记账和内部对账。

<Note>
  文件为只读。SFTP 账户按商户单独开通，仅能访问您自己的文件。
</Note>

## 获取 SFTP 凭证

连接仅支持 SSH 密钥认证。

1. 在您本地生成一对 SSH 密钥，并妥善保管私钥：
   ```bash theme={null}
   ssh-keygen -t ed25519 -f clink_sftp
   ```
2. 进入商户后台，打开 **开发者** 菜单
3. 点击 **申请SFTP**，并：
   * 将 **公钥**（`clink_sftp.pub`）内容粘贴进去。公钥必须是**单行**；复制前可
     使用 `tr -d '\r\n' < clink_sftp.pub` 去除换行
   * 支持 Ed25519、ECDSA 和 RSA（至少 2048 位），不支持 DSA
   * 添加 IP 白名单（必填，至少 1 个、最多 5 个网段）。每个网段支持 `/24` 到 `/32` 的 CIDR 前缀（例如 `203.0.113.7/32`、`203.0.113.0/24`）

连接信息：

* **主机**：`sftp.clinkbill.com`
* **端口**：`2022`
* **用户名**：您的商户 ID
* **认证方式**：仅 SSH 密钥

## 管理 SFTP 配置

### 更换公钥

如需定期轮换密钥或替换已泄露的密钥，请在 **开发者** 菜单中打开 SFTP 配置，
点击 **编辑** 并更换公钥。

<Warning>
  更换公钥会立即断开当前 SFTP 连接并中断正在进行的下载。请避开定时跑批或
  下载时段操作，之后使用与新公钥匹配的私钥重新连接。
</Warning>

### 申请历史文件

定时任务只生成前一天的结算文件。首次申请 SFTP 之前的历史文件不会自动补充到
`/statements`，如有需要，请联系 Clink 支持团队。

## 建立连接

使用 OpenSSH 客户端：

```bash theme={null}
sftp -P 2022 -i clink_sftp <merchant_id>@sftp.clinkbill.com
```

也可以使用 SFTP 客户端应用程序（FileZilla、WinSCP 或 Cyberduck）连接，填入上述
主机、端口、商户 ID 和私钥。

## 结算文件

结算文件放在根目录下的 `/statements` 目录中：

```
/statements/settlement_report_20260804.csv
```

每天 **UTC 时间 02:00** 会生成一份前一天的结算文件，命名规则为
`settlement_report_YYYYMMDD.csv`。

## 下载文件

```bash theme={null}
sftp -P 2022 -i clink_sftp <merchant_id>@sftp.clinkbill.com <<'EOF'
cd /statements
get settlement_report_20260804.csv
bye
EOF
```