SFTP 安全传文件：路径、权限与上传后验证
SFTP 通过 SSH 连接传输文件，适合把配置、发布包或日志副本在电脑与服务器之间移动。本文以 OpenSSH 客户端连接 Ubuntu 24.04 为例，账号已有 SSH 或专用 SFTP 权限；Windows、macOS 和 Linux 都可以使用对应的 OpenSSH 客户端。SFTP 与通过 TLS 保护的 FTP 是不同协议，不能只因为名称相近就沿用 FTP 端口设置。
连接前明确账号与目标目录
先取得正确的主机、SSH 端口、用户名和目标目录。以下使用文档示例地址和 deploy 账号，正式操作要替换。首次连接应核对服务器主机密钥指纹，而不是看到提示就直接接受。
# 本机终端；-P 为大写
sftp -P 22 deploy@203.0.113.10
如果已设置 SSH 主机别名，也可使用 sftp app-demo。专用 SFTP 账号可能不能打开普通 shell，这是管理员设定的权限边界，不是传输故障。SFTP 官方手册提供连接参数及交互命令说明。
分清本地目录和远程目录
进入交互界面后，先分别查看两侧位置：
pwd
lpwd
ls
lls
pwd 与 ls 操作远程位置；前缀带 l 的命令查看本机。cd 改远程目录，lcd 改本地目录。上传前把这四项看清楚，尤其不要把远程家目录误认为站点发布目录。
路径中有空格时按客户端命令语法加引号。服务器启用受限根目录时，界面中的 / 可能只是账号可见范围，不等于整台服务器的系统根目录。应采用管理员给出的可见路径，不尝试通过提升权限绕过限制。
先传到暂存位置，再安排发布
为本次上传选择一个确认未使用的文件名，例如带日期的发布包。不要直接覆盖正在运行的网站配置或程序。交互上传可以这样进行：
put release-20260905.tar.gz release-20260905.tar.gz.uploading
ls -l release-20260905.tar.gz.uploading
本地文件与远程暂存文件的名称不同，便于区分传输中和待验收状态。文件大小看起来一致，只能说明基本长度符合预期，不能代替内容校验。传输被中断时，可以在源文件没有变化、远程部分文件属于同一次传输的前提下使用 reput；不能对来源不明的同名文件直接续传。
传输结束后，保留旧发布版本，再由负责部署的账号完成校验、权限设置和切换。SFTP 的重命名可以帮助组织文件，但真正的发布原子性还受应用和文件系统安排影响，不能把“改名成功”当成整个业务切换已经无风险。
验证文件内容和访问权限
本机 Windows PowerShell 可用 Get-FileHash，macOS 可用 shasum -a 256，Ubuntu 可用 sha256sum 计算同一文件的 SHA-256。若服务器账号可以使用 shell，在服务器对上传结果计算摘要，再与本机逐字符比较。
没有 shell 权限时，可下载暂存文件到独立位置再计算摘要，或使用平台提供的可信校验方式。摘要相同用于确认内容一致；若还需要确认软件来源，应核对可信发布渠道提供的摘要或签名，不能拿来路不明的两个文件相互证明安全。
SFTP 账号能写入暂存目录，不代表应用进程能读取文件。部署完成后检查文件属主、组与权限，并用应用实际身份验证读取。不要为了消除“权限不足”而把整个站点改成全员可写。
常见故障与恢复顺序
认证失败时，先核对客户端最终采用的身份与端口，必要时查看OpenSSH 连接说明中的调试选项。连接正常但上传被拒绝，重点检查远程目录权限、磁盘空间、配额和账号限制；不要马上改 SSH 认证配置。
传到错误目录时，先确认文件确实属于本次操作，再移动到正确的暂存位置。若已覆盖业务文件，应从预先保留的旧版本恢复，并检查服务是否还持有旧文件或需要重新加载。下一次操作应改为独立暂存文件，让错误在发布前就能被发现。