Starbound 服务器设置指南

本指南介绍如何在 Legion Hosting 上设置和配置您的 Starbound 专用服务器，包括 Steam 身份验证前提条件、首次启动、服务器配置、宇宙设置、玩家连接和存档管理。有关模组安装，请参阅 Starbound 模组安装。有关管理员命令和权限，请参阅 Starbound 管理员命令。

---

前提条件

在启动 Starbound 服务器之前，您必须满足以下条件：

• 拥有 Starbound 的 Steam 账户。服务器二进制文件不提供匿名下载——您提供的账户必须在其游戏库中拥有 Starbound。
• Steam Guard 注意事项。如果您的 Steam 账户启用了 Steam Guard（双重身份验证），您需要在首次安装时通过 STEAM_AUTH 启动变量提供验证码。初始验证后，SteamCMD 会缓存会话，后续启动通常不再需要验证码，除非缓存过期。
• 建议使用专用 Steam 账户。出于安全考虑，建议使用一个单独的拥有 Starbound 的 Steam 账户专门用于服务器托管。这样可以避免共享您的主账户凭据，并防止您想同时玩游戏时发生冲突。

---

首次启动

从 Legion Hosting 购买 Starbound 服务器后，请按照以下步骤首次运行：

1. 登录 GPanel 并选择您的 Starbound 服务器。
2. 前往 Startup 选项卡。
3. 填写所需的 Steam 凭据：
   • STEAM_USER——您的 Steam 账户用户名（必填）。
   • STEAM_PASS——您的 Steam 账户密码（必填）。
   • STEAM_AUTH——您的 Steam Guard 双重验证码，如果有提示（可选，仅在首次安装或缓存会话过期时需要）。
4. 前往 Console 选项卡并点击 Start。
5. 服务器将通过 SteamCMD 下载 Starbound 专用服务器文件。首次启动可能需要几分钟。
6. 下载完成后，服务器将生成默认宇宙并开始监听连接。

GPanel 启动变量

变量	必填	说明
STEAM_USER	是	Steam 账户用户名。必须拥有 Starbound。不能为 anonymous。
STEAM_PASS	是	上述用户名对应的 Steam 账户密码。
STEAM_AUTH	否	Steam Guard 双重身份验证码。仅在初始设置或缓存会话过期时需要。
WORKSHOP	否	设置为 1 以启用 Steam Workshop 模组支持，或设置为 0 以禁用。默认为 0。详情请参阅 Starbound 模组安装。

---

starbound_server.config

主要服务器配置文件位于：

storage/starbound_server.config

此文件使用 JSON 格式。通过 GPanel 中的文件管理器或通过 SFTP 编辑它。编辑前必须停止服务器，因为更改在启动时加载。

关键服务器设置

设置	默认值	说明
serverName	"A Starbound Server"	在服务器浏览器中显示的名称以及玩家连接时看到的名称。
maxPlayers	8	可同时连接的最大玩家数。
gameServerPort	21025	游戏服务器监听的端口。在 Legion Hosting 上，此端口自动设置——除非支持团队指示，否则不要更改。
gameServerBind	"::"	要绑定的网络接口。默认值 "::" 绑定到所有接口（IPv4 和 IPv6）。保持此设置不变。
serverPassword	""	加入服务器所需的密码。留空则无需密码（公开访问）。
allowAnonymousConnections	true	设置为 true 时，玩家无需 Starbound 账户即可连接。设置为 false 则要求所有玩家进行账户验证。
allowAssetsMismatch	true	设置为 true 时，安装了不同模组的玩家仍然可以连接。设置为 false 则强制服务器和客户端之间的资源匹配（推荐用于模组服务器）。
maxTeamSize	4	每个队伍/团队的最大玩家数。
clientIPJoinable	false	服务器是否可以通过直接 IP 加入。专用服务器应设置为 true。
clientP2PJoinable	false	是否允许点对点连接。专用服务器通常设置为 false。

示例 starbound_server.config

{
  "serverName" : "My Legion Starbound Server",
  "maxPlayers" : 8,
  "gameServerBind" : "::",
  "serverPassword" : "",
  "allowAnonymousConnections" : true,
  "allowAssetsMismatch" : true,
  "maxTeamSize" : 4,
  "clientIPJoinable" : true,
  "clientP2PJoinable" : false,
  "allowAdminCommands" : true,
  "allowAdminCommandsFromAnyone" : false,
  "serverUsers" : {
    "YourUsername" : {
      "admin" : true,
      "password" : "your-admin-password"
    }
  }
}

---

世界和宇宙设置

Starbound 使用程序化生成的宇宙。每当玩家访问新的星系或行星时，游戏会根据宇宙种子和坐标系统生成它。服务器的宇宙数据存储在：

storage/universe/

此目录包含所有已生成的世界数据，包括行星、空间站和玩家在世界中建造的结构。

宇宙配置

宇宙生成参数可以在 starbound_server.config 文件或宇宙相关的资源文件中调整。关键概念：

概念	说明
宇宙种子	宇宙基于坐标程序化生成。所有运行相同游戏版本的服务器将在相同坐标生成相同的行星，但玩家放置的物体和修改对每个服务器是唯一的。
起始行星	新玩家在一个程序化选择的起始行星上出生。起始世界是适合早期游戏进程的花园类型行星。
世界文件	每个访问过的行星会在 storage/universe/ 中生成一个 .world 文件。这些文件包含玩家所做的地形修改、放置的物体和方块更改。
天体数据	宇宙目录中的 universe.chunks 和 universe.dat 文件存储宇宙地图的整体状态。

---

如何连接

玩家使用游戏内的多人游戏菜单连接到您的 Starbound 服务器。

通过 IP 直接连接

1. 启动 Starbound。
2. 从主菜单点击 Multiplayer。
3. 选择您的角色。
4. 在 Server Address 字段中，以 IP:Port 格式输入您服务器的 IP 地址和端口。
5. 如果服务器设置了密码，请输入与服务器配置中 serverUsers 条目匹配的 Account Name 和 Password。如果 allowAnonymousConnections 为 true 且未设置服务器密码，这些字段可以留空。
6. 点击 Join Server。

Steam 好友（不适用）

Steam 的"加入游戏"功能适用于点对点托管的游戏，而非专用服务器。玩家必须使用上述直接 IP 连接方法加入您的 Legion Hosting 服务器。

---

存档管理

Starbound 将所有服务器数据存储在 storage/ 目录中。了解文件结构有助于备份、迁移和故障排除。

关键存储目录和文件

路径	说明
storage/universe/	包含所有已生成的世界数据——行星、空间站和玩家对世界的修改。每个访问过的行星都有一个 .world 文件。
storage/player/	包含玩家存档文件。每个玩家都有一个 .player 文件，存储其背包、进度、任务状态和飞船数据。
storage/starbound_server.config	主要服务器配置文件。
storage/starbound_server.log	服务器日志文件。用于诊断崩溃、错误和连接问题。

创建备份

定期备份可保护您服务器的宇宙、玩家数据和配置免受意外丢失或损坏。

1. 在 GPanel 中停止您的服务器，以确保所有数据已写入磁盘。
2. 通过 SFTP 连接到您的服务器或使用文件管理器。
3. 将整个 storage/ 目录下载到您的本地计算机。
4. 将备份存储在安全的位置，并加上日期标签（例如 storage-backup-2026-02-26）。

从备份恢复

1. 停止您的服务器。
2. 将备份文件上传到 storage/ 目录中的相应位置，覆盖现有文件。
3. 启动服务器。

从其他服务器迁移世界

要将您的 Starbound 宇宙从其他服务器或本地游戏迁移过来：

1. 停止源服务器和目标服务器。
2. 将源服务器的 storage/universe/ 目录复制到目标服务器。
3. 如果需要迁移玩家数据，可以选择复制 storage/player/。
4. 复制您的 starbound_server.config 以保留服务器设置。
5. 启动目标服务器并验证世界是否正确加载。

---

相关文章

• Starbound 模组安装
• Starbound 管理员命令
• 如何查找您的服务器 IP 和端口
• 如何通过 SFTP 上传文件
• 服务器启动指南

---

需要帮助？

如果您遇到本指南未涵盖的问题，我们的支持团队随时为您提供帮助。请在 legionhosting.net/submitticket.php 提交工单，并附上您的服务器详情和问题描述。