rouhim/sons-of-the-forest-server

Sons of the Forest 游戏服务器容器镜像

镜像概述和主要用途

本仓库提供了一个安全的Sons of the Forest游戏服务器容器镜像。该镜像专为Docker Compose设计，旨在简化游戏服务器环境的搭建和管理流程。

核心功能和特性

• 安全性保障：集成trivy安全防护，定期进行安全审计
• 易用性：通过Docker Compose实现一键部署和管理
• 自动配置：首次启动时自动创建所需配置文件和目录结构
• 自动更新：默认每次启动时检查并更新游戏服务器文件
• 灵活配置：支持自定义服务器配置，与官方服务器配置方式兼容
• 数据持久化：游戏数据和配置文件通过宿主机目录持久化存储

使用场景和适用范围

适用于希望快速搭建和管理Sons of the Forest专用游戏服务器的个人或社区，尤其适合缺乏复杂服务器配置经验的用户。支持AMD64架构，需在满足硬件要求的环境中运行。

环境要求

• https://docs.docker.com/engine/install/
• https://docs.docker.com/compose/install/standalone/
• 至少8GB内存

安装步骤

在安装Docker和Docker Compose后，执行以下步骤：

1. 克隆本仓库到本地：

   bash
   git clone https://github.com/RouHim/sons-of-the-forest-container-image.git
   cd sons-of-the-forest-container-image
   

2. 创建所需目录结构并调整权限：

   bash
   mkdir config/ data/ 
   chmod 777 config/ data/
   

推荐使用chmod命令设置权限，以避免容器内用户与宿主机用户不一致导致的权限问题。

使用方法

启动服务器

导航至克隆的仓库目录，使用Docker Compose启动服务器：

bash
docker compose pull
docker compose up -d

该命令会拉取最新镜像并以 detached 模式启动服务器。

首次启动注意事项

• 配置文件和目录将自动在config/文件夹中创建
• 服务器会从Steam下载最新版本的游戏文件至data/文件夹
• 首次启动后需要重启服务器

常用命令

• 重启服务器（配置更改后）：

  bash
  docker compose restart
  

• 查看服务器日志：

  bash
  docker compose logs -f
  

更新方法

重启容器即可更新服务器，默认情况下服务器会在每次启动时检查更新并验证文件：

bash
docker compose restart

若需跳过每次启动时的更新和文件验证，可将环境变量FAST_BOOT设置为true。

配置说明

服务器配置与官方服务器配置一致，可参考官方配置指南，如https://steamcommunity.com/sharedfiles/filedetails/?id=2992700419&snr=1_2108_9__2107%E3%80%82

配置文件

config文件夹包含游戏服务器的配置文件：

• ownerswhitelist.txt：服务器管理员白名单
• dedicatedserver.cfg：游戏服务器配置文件
• Saves文件夹：游戏存档
• SonsGameSettings.cfg：游戏设置文件

所有文件和文件夹会在服务器首次启动时自动创建。

容器环境中SkipNetworkAccessibilityTest参数强制设为true，因为该测试在容器环境中无法正常工作。

数据目录

data/文件夹包含游戏服务器数据：

• 可修改此文件夹中的文件，但需重启服务器使更改生效
• 删除此文件夹可将游戏服务器重置为默认状态

相关资源

• 项目灵感来源：https://github.com/jammsen/docker-sons-of-the-forest-dedicated-server
• 项目代码仓库：https://github.com/RouHim/sons-of-the-forest-container-image
• Docker Hub镜像：https://hub.docker.com/r/rouhim/sons-of-the-forest-server
• 基础镜像：https://github.com/RouHim/steamcmd-wine-container-image
• SteamCMD文档：[***]
• 官方服务器指南：https://steamcommunity.com/sharedfiles/filedetails/?id=2992700419&snr=1_2108_9__2107