开始之前
- 准备自己有权访问的 SFTP 服务器、账号,以及密码或私钥等认证信息。
- 服务器必须可从当前网络访问,账号需具备目标文件的读取和写入权限。
- 首次连接前,从服务器管理员处取得 SSH 主机指纹,用于核对服务器身份。
操作步骤
新建 SFTP 连接
打开服务器连接入口,选择 SFTP,填写服务器地址、端口、远程路径和用户名。端口要使用服务器实际配置值;常见值是 22,但可能已经被管理员修改。
配置认证并核对身份
按服务器配置选择密码或私钥认证。首次出现主机信任提示时,先与管理员提供的 SSH 指纹核对,一致后再继续;指纹发生变化时也应重新核实。
测试并保存连接
点“测试连接”,测试通过后保存。测试只说明当前连接配置可用,不代表账号对每个目录都有写入权限。
打开远程文件进行编辑
在连接中浏览目录,用远程编辑入口打开支持的文本、Markdown、代码或配置文件。若只是导入到内部空间,打开的是本地副本,后续编辑不会自动写回服务器。
保存回服务器并核对
完成修改后选择“保存”,等待保存成功提示,再重新打开远程文件检查内容。遇到外部修改冲突时,先比较或另存副本,再决定是否覆盖。
连接字段示例
SFTP协议 SFTP
服务器 example.com
端口 22(以服务器配置为准)
路径 /home/example/documents
认证 密码或私钥这是示例配置。请使用自己的服务器地址与有权限的目录,不要把密码或私钥贴到公开页面。
完成后检查
在同一 SFTP 连接的原路径重开文件,确认修改已落到服务器。另存为或导入的本地文件要与远程原件区分。
支持范围与限制
- 远程编辑与保存需要网络,且受服务器权限、配额和连接状态影响。
- WebDAV / FTP 当前用于只读浏览并导入;它们不提供与 SFTP 相同的直接回写流程。
- 代码与配置文件可编辑,但文本编辑器本身不编译或运行代码;运行命令属于独立的 SSH 终端功能。
遇到问题时
连接测试失败
依次检查网络、服务器地址、端口、防火墙及认证方式。远程路径必须是该账号可访问的路径。
能读取但保存失败
检查目标文件和目录的写权限、服务器可用空间,以及连接是否中断。保留本地副本,确认服务端状态后再重试。
保存后服务器文件没有变化
确认打开的是远程编辑会话,而非导入副本;检查保存成功提示,并在同一个远程路径重开文件核对。
常见问题
SFTP 和 FTP 的保存方式一样吗?
不一样。改阅支持 SFTP 远程文件回写;WebDAV / FTP 目前以只读浏览和导入为主。
离线修改会自动同步吗?
不要把远程编辑当作离线自动同步。远程保存需要有效连接,并应在成功后重新检查服务器文件。
操作说明按当前功能核对;不同版本的入口位置可能略有差异。