didstopia/starbound-server

Starbound Docker容器服务器

注意：此镜像在启动时会执行安装/更新操作。可将路径/steamcmd/starbound挂载到主机以实现数据持久化。

镜像概述

该Docker镜像提供了一个在容器中运行的Starbound专用Linux服务器，旨在简化服务器部署和管理流程。通过容器化方式，用户可快速搭建Starbound服务器，并支持数据持久化、自动更新及灵活的配置管理。

核心功能与特性

• 容器化部署：将Starbound服务器封装在Docker容器中，简化环境配置与依赖管理
• 自动安装/更新：启动时自动执行SteamCMD安装或更新Starbound服务器文件
• 数据持久化：支持挂载关键目录（/steamcmd/starbound和/app/.steam）到主机，确保服务器配置、存档和日志安全
• 环境变量配置：通过环境变量灵活控制服务器安装和更新行为
• Steam Guard支持：提供Steam Guard认证流程，确保账号安全

使用场景

• 个人或小型团队快速部署Starbound游戏服务器
• 需要频繁更新服务器版本的场景
• 希望隔离服务器环境并简化数据备份的用户

使用方法

前置准备

1. 准备Steam账号（需拥有Starbound游戏权限）
2. 确保Docker环境已正确安装

基本运行步骤

1. 设置所需环境变量（特别是Steam账号凭据）
2. 可选：将/steamcmd/starbound目录挂载到主机以持久化服务器数据
3. 启动容器并根据需要配置服务器设置

配置文件与数据位置

• 服务器配置文件：/steamcmd/starbound/storage/starbound_server.config（需编辑此文件自定义服务器设置）
• 存档文件：/steamcmd/starbound/storage/universe
• Mod文件：/steamcmd/starbound/mods
• SteamCMD日志等数据：可挂载/app/.steam目录持久化

环境变量说明

Docker部署示例

基本运行命令（无数据持久化）

bash
docker run -d \
  -p 21025:21025/tcp \
  -e STEAM_USERNAME="your_steam_username" \
  -e STEAM_PASSWORD="your_steam_password" \
  --name starbound-server \
  dids/starbound-server

带数据持久化的运行命令

bash
docker run -d \
  -p 21025:21025/tcp \
  -e STEAM_USERNAME="your_steam_username" \
  -e STEAM_PASSWORD="your_steam_password" \
  -v /path/on/host/starbound:/steamcmd/starbound \
  -v /path/on/host/steam:/app/.steam \
  --name starbound-server \
  dids/starbound-server

Docker Compose配置示例

yaml
version: '3'
services:
  starbound-server:
    image: dids/starbound-server
    ports:
      - "21025:21025/tcp"
    environment:
      - STEAM_USERNAME=your_steam_username
      - STEAM_PASSWORD=your_steam_password
    volumes:
      - /path/on/host/starbound:/steamcmd/starbound
      - /path/on/host/steam:/app/.steam
    stdin_open: true
    tty: true
    restart: unless-stopped

Steam Guard 认证流程

若启用了Steam Guard（大多数用户都会启用），需按以下步骤操作：

1. 运行容器时需同时添加-i（交互式）和-t（终端）参数（Compose中对应stdin_open: true和tty: true），以支持直接交互
2. 容器启动后立即附加到容器（例如：docker attach starbound-server），及时输入Steam Guard验证码
3. 输入验证码后，按CTRL-p followed by CTRL-q detach容器，此时认证状态将保持到令牌过期，过期后重复上述步骤即可

注意：未来可能会提供更便捷的认证方式，如通过Web界面管理Steam会话和认证码。

服务器更新

只要已设置STEAM_USERNAME和STEAM_PASSWORD，只需重启容器即可触发服务器更新流程：

bash
docker restart starbound-server

支持与反馈

如需帮助、有问题或提交bug，可通过***联系 @Dids。