SFTP（安全文件传输协议）允许您连接到游戏服务器并直接从电脑传输文件——包括大文件、完整的模组文件夹和备份。如果您需要上传 GPanel 文件管理器无法处理的内容（例如整个目录或超过浏览器大小限制的文件），SFTP 是正确的工具。
何时使用 SFTP： 当您需要上传文件夹、大文件（例如世界存档、模组包、备份）或一次上传多个文件时，请使用 SFTP。对于快速的单文件编辑，GPanel 文件管理器可能就足够了。
连接详情
您的 SFTP 连接使用服务器的 IP 地址和 GPanel 中的凭据。
您的 SFTP 连接详情
| 主机/地址 | 您的服务器 IP 地址（显示在 GPanel 仪表板或 Console 选项卡上） |
|---|---|
| 端口 | 2022 |
| 协议 | SFTP (SSH File Transfer Protocol) |
| 用户名 | 您的 GPanel 用户名 |
| 密码 | 在 GPanel 的 Settings 选项卡中找到 |
重要： 始终使用端口 2022，而不是默认的 SFTP 端口 22。端口 22 上的连接将无法工作。
选项 1 — FileZilla（推荐）
FileZilla 是一款免费的跨平台 FTP/SFTP 客户端，适用于 Windows、macOS 和 Linux。
步骤 1 — 下载并安装 FileZilla
- 访问 filezilla-project.org 并下载 FileZilla Client（不是 FileZilla Server）。
- 运行安装程序并按照屏幕提示操作。
步骤 2 — 打开站点管理器
- 启动 FileZilla。
- 点击 File → Site Manager（或按 Ctrl+S）。
- 点击 New Site 并为其命名，例如 Legion Hosting。
步骤 3 — 输入连接设置
- 将 Protocol 设置为
SFTP - SSH File Transfer Protocol。 - 将 Host 设置为您的服务器 IP 地址（在 GPanel 仪表板上找到）。
- 将 Port 设置为
2022。 - 将 Logon Type 设置为
Normal。 - 输入您的 GPanel Username 和 Password（密码在 GPanel 的 Settings 选项卡中）。
- 点击 Connect。
步骤 4 — 接受主机密钥
- 首次连接时，FileZilla 将显示一个 Unknown host key 对话框。
- 勾选 Always trust this host 并点击 OK。
步骤 5 — 上传文件
- 左侧面板显示您的本地电脑。导航到您要上传的文件或文件夹。
- 右侧面板显示您的服务器文件系统。导航到目标文件夹（例如
/home/container/mods/）。 - 将文件或文件夹从左侧面板拖放到右侧面板，或右键点击文件并选择 Upload。
- 在底部队列面板中监控传输进度。
选项 2 — WinSCP（仅限 Windows）
WinSCP 是一款流行的免费 Windows SFTP 客户端，具有熟悉的双面板文件浏览器界面。
步骤 1 — 下载并安装 WinSCP
- 访问 winscp.net 并下载安装程序。
- 运行安装程序。当询问界面样式时，选择 Commander 获取双面板视图，或选择 Explorer 获取单面板视图。
步骤 2 — 创建新会话
- 启动 WinSCP。Login 对话框将自动打开。
- 将 File protocol 设置为
SFTP。 - 在 Host name 字段中输入您的服务器 IP 地址（在 GPanel 仪表板上找到）。
- 将 Port number 设置为
2022。 - 输入您的 GPanel User name 和 Password（密码在 GPanel 的 Settings 选项卡中）。
- 点击 Login。
步骤 3 — 接受主机密钥并上传
- 首次连接时接受服务器主机密钥警告。
- 您的本地文件显示在左侧；服务器文件显示在右侧。
- 在服务器上导航到目标文件夹，然后将文件从左侧面板拖到右侧，或使用 F5 复制选定的文件。
常见上传任务
上传配置文件
配置文件（例如 servertest.ini、server.properties）通常位于服务器主目录的特定子文件夹中。常见路径：
- Project Zomboid:
/home/container/.cache/server/ - ARK: Survival Ascended:
/home/container/ShooterGame/Saved/Config/WindowsServer/ - Minecraft:
/home/container/
在 SFTP 客户端中导航到正确的路径，然后将编辑好的配置文件拖到服务器面板以替换现有文件。
请先停止服务器，然后再替换活动的配置文件。在服务器运行时上传配置文件可能会导致服务器在关闭时覆盖您的文件。
上传模组
- 从 GPanel 停止您的服务器。
- 通过 SFTP 连接并导航到游戏的模组文件夹（例如
/home/container/mods/或游戏特定的路径）。 - 将整个模组文件夹或
.jar/.pak文件从本地电脑拖到服务器模组目录。 - 上传完成后，从 GPanel 启动服务器。
上传世界存档或备份
- 从 GPanel 停止您的服务器。
- 通过 SFTP 连接并导航到游戏的存档目录。
- 上传整个存档文件夹（拖动文件夹本身，而不仅仅是其内容，除非您要合并到现有存档中）。
- 确认文件夹结构与之前的一致。
- 从 GPanel 启动服务器。
提示： 在覆盖存档之前，先重命名服务器端的现有文件夹（例如，在末尾添加
_backup），这样如果出现问题，您可以恢复它。
故障排除
- 仔细检查端口是否设置为 2022，而不是 22。
- 验证 IP 地址是否与 GPanel 仪表板上显示的一致。
- 确保您的服务器正在运行——在某些方案中，SFTP 访问可能需要游戏服务器进程处于活动状态。
- 检查您的防火墙或杀毒软件是否阻止了端口 2022 上的出站连接。
- 使用您登录 gpanel.legionhosting.net 时相同的用户名和密码。
- 用户名区分大小写。如不确定，请直接从 GPanel 复制用户名。
- 如果您最近更改了 GPanel 密码，请在 SFTP 客户端的已保存会话中更新密码。
- 如果您忘记了密码，请从客户区重置您的 GPanel 密码。
- 大型模组包或世界存档可能需要几分钟。让传输运行完成。
- 在 FileZilla 中，您可以增加同时传输的数量：转到 Edit → Settings → Transfers 并将最大同时传输数设置为 3。
- 如果连接在传输过程中断开，FileZilla 可以恢复：右键点击队列中失败的文件并选择 Reset and requeue failed transfers。
- 您的主目录是
/home/container/。如果客户端将您放在不同的目录中，请在远程路径栏中手动输入此路径。 - 确保您使用正确的用户名连接——每个 GPanel 账户只能访问其自己服务器的文件。
仍然需要帮助？ 提交工单，并附上您的服务器 IP 地址、您使用的 SFTP 客户端以及错误描述。
