SFTP 连接:用桌面客户端管理服务器文件

说明在哪里获取 SFTP 主机、端口、用户名和密码,如何用 FileZilla、WinSCP 或命令行连接,以及重置密码和常见连接问题。

平台面板 · 更新于

SFTP 适合批量上传模组、传输大文件、整目录下载存档等场景。每个实例都有独立的 SFTP 账号,登录后看到的就是该实例的数据目录,与「文件管理」标签页中的「根目录」相同。

获取连接信息

以下两种方式都能打开「SFTP 连接信息」窗口:

  1. 在实例详情页右上角点击「SFTP」按钮。
  2. 在「概览」标签页的「SFTP 文件访问」卡片中点击「查看连接信息」。

窗口中有四项信息:

项目 说明
主机地址 实例所在节点的公网地址
端口 SFTP 服务端口,不是游戏端口
用户名 该实例专属的 SFTP 用户名
密码 默认隐藏,点击眼睛图标显示

每一行右侧都有复制按钮。点击「复制全部信息」会一次性复制 Host、Port、Username、Password 四行内容。

如果窗口提示「SFTP 信息暂不可用,请确认实例已就绪」,通常是实例还在创建中,请稍后点击「重试」。

使用 FileZilla 连接

  1. 打开 FileZilla,在顶部快速连接栏填写:
    • 主机:sftp:// 加上主机地址,例如 sftp://你的主机地址
    • 用户名、密码:从连接信息窗口复制
    • 端口:连接信息窗口中的端口
  2. 点击「快速连接」。
  3. 首次连接时会提示未知主机密钥,确认信任即可。
  4. 右侧窗格即为服务器上的数据目录,左侧为本地文件,拖拽即可上传或下载。

也可以在「站点管理器」中新建站点保存配置,协议选择 SFTP。

使用 WinSCP 连接

  1. 新建会话,文件协议选择 SFTP。
  2. 填写主机名、端口号、用户名、密码。
  3. 点击「登录」,首次连接时确认主机密钥。

使用命令行连接

macOS、Linux 和较新版本的 Windows 都自带 sftp 命令:

sftp -P 端口 用户名@主机地址

注意端口参数是大写的 -P。登录后可以使用以下常用命令:

ls                 列出文件
cd world           进入目录
get server.properties     下载文件
put mods.zip       上传文件
get -r world       下载整个目录
exit               退出

重置密码

如果密码可能已泄露,或者想更换密码:

  1. 在「SFTP 连接信息」窗口点击「重置密码」。
  2. 确认对话框提示:重置后旧密码立即失效,正在使用旧密码的连接需要重新配置。
  3. 点击「确认重置」,窗口会显示新的随机密码。

密码由平台随机生成,不能自定义。重置后,记得更新客户端中保存的密码。

安全建议

  • 连接信息只能在登录控制台后查看。请勿通过聊天工具或其他不安全渠道分享密码。
  • 需要让朋友帮忙管理文件时,用完后建议重置一次密码。
  • 「切换游戏」后 SFTP 账号保持不变,见 重新安装与切换游戏。

使用建议

  • 上传或覆盖游戏正在读写的文件(存档、配置)前,建议先关机。
  • 「文件管理」中单个文件的上传大小有限制,大文件请使用 SFTP 上传。
  • SFTP 不支持创建符号链接。
  • 平台暂不提供自动备份,可以定期用 SFTP 把存档目录下载到本地保存。
  • 实例到期后,在线「文件管理」只能逐个下载文件,而 SFTP 账号目前仍可登录,适合用来整目录取回存档。实例删除后 SFTP 账号随之失效。

常见问题

连接超时或被拒绝?

  • 确认填写的是连接信息窗口中的 SFTP 端口,而不是游戏端口。
  • 确认协议是 SFTP,而不是 FTP 或 FTPS。
  • 公司或校园网络可能限制非常用端口,可以换一个网络再试。

提示认证失败?

  • 复制密码时注意不要带上多余的空格。
  • 如果最近重置过密码,请使用新密码。

看不到某些文件? 部分客户端默认隐藏以 . 开头的文件,请在客户端设置中开启“显示隐藏文件”。

更多在线操作方式见 文件管理。