SFTP 连接:用桌面客户端管理服务器文件
说明在哪里获取 SFTP 主机、端口、用户名和密码,如何用 FileZilla、WinSCP 或命令行连接,以及重置密码和常见连接问题。
平台面板 · 更新于
SFTP 适合批量上传模组、传输大文件、整目录下载存档等场景。每个实例都有独立的 SFTP 账号,登录后看到的就是该实例的数据目录,与「文件管理」标签页中的「根目录」相同。
获取连接信息
以下两种方式都能打开「SFTP 连接信息」窗口:
- 在实例详情页右上角点击「SFTP」按钮。
- 在「概览」标签页的「SFTP 文件访问」卡片中点击「查看连接信息」。
窗口中有四项信息:
| 项目 | 说明 |
|---|---|
| 主机地址 | 实例所在节点的公网地址 |
| 端口 | SFTP 服务端口,不是游戏端口 |
| 用户名 | 该实例专属的 SFTP 用户名 |
| 密码 | 默认隐藏,点击眼睛图标显示 |
每一行右侧都有复制按钮。点击「复制全部信息」会一次性复制 Host、Port、Username、Password 四行内容。
如果窗口提示「SFTP 信息暂不可用,请确认实例已就绪」,通常是实例还在创建中,请稍后点击「重试」。
使用 FileZilla 连接
- 打开 FileZilla,在顶部快速连接栏填写:
- 主机:
sftp://加上主机地址,例如sftp://你的主机地址 - 用户名、密码:从连接信息窗口复制
- 端口:连接信息窗口中的端口
- 主机:
- 点击「快速连接」。
- 首次连接时会提示未知主机密钥,确认信任即可。
- 右侧窗格即为服务器上的数据目录,左侧为本地文件,拖拽即可上传或下载。
也可以在「站点管理器」中新建站点保存配置,协议选择 SFTP。
使用 WinSCP 连接
- 新建会话,文件协议选择
SFTP。 - 填写主机名、端口号、用户名、密码。
- 点击「登录」,首次连接时确认主机密钥。
使用命令行连接
macOS、Linux 和较新版本的 Windows 都自带 sftp 命令:
sftp -P 端口 用户名@主机地址
注意端口参数是大写的 -P。登录后可以使用以下常用命令:
ls 列出文件
cd world 进入目录
get server.properties 下载文件
put mods.zip 上传文件
get -r world 下载整个目录
exit 退出
重置密码
如果密码可能已泄露,或者想更换密码:
- 在「SFTP 连接信息」窗口点击「重置密码」。
- 确认对话框提示:重置后旧密码立即失效,正在使用旧密码的连接需要重新配置。
- 点击「确认重置」,窗口会显示新的随机密码。
密码由平台随机生成,不能自定义。重置后,记得更新客户端中保存的密码。
安全建议
- 连接信息只能在登录控制台后查看。请勿通过聊天工具或其他不安全渠道分享密码。
- 需要让朋友帮忙管理文件时,用完后建议重置一次密码。
- 「切换游戏」后 SFTP 账号保持不变,见 重新安装与切换游戏。
使用建议
- 上传或覆盖游戏正在读写的文件(存档、配置)前,建议先关机。
- 「文件管理」中单个文件的上传大小有限制,大文件请使用 SFTP 上传。
- SFTP 不支持创建符号链接。
- 平台暂不提供自动备份,可以定期用 SFTP 把存档目录下载到本地保存。
- 实例到期后,在线「文件管理」只能逐个下载文件,而 SFTP 账号目前仍可登录,适合用来整目录取回存档。实例删除后 SFTP 账号随之失效。
常见问题
连接超时或被拒绝?
- 确认填写的是连接信息窗口中的 SFTP 端口,而不是游戏端口。
- 确认协议是 SFTP,而不是 FTP 或 FTPS。
- 公司或校园网络可能限制非常用端口,可以换一个网络再试。
提示认证失败?
- 复制密码时注意不要带上多余的空格。
- 如果最近重置过密码,请使用新密码。
看不到某些文件?
部分客户端默认隐藏以 . 开头的文件,请在客户端设置中开启“显示隐藏文件”。
更多在线操作方式见 文件管理。
