wolveix/satisfactory-server

Satisfactory Server

!https://raw.githubusercontent.com/wolveix/satisfactory-server/main/.github/logo.png "Satisfactory logo"

!Release !Docker Pulls !Docker Stars !Image Size

这是 Satisfactory 专用服务器的 Docker 化版本。

https://github.com/wolveix/satisfactory-server/wiki/Troubleshooting-FAQ

https://github.com/wolveix/satisfactory-server/wiki/Upgrading-for-1.1

安装设置

服务器可以在少于 8GB 内存的环境下运行，但根据 官方 wiki 建议，仍推荐 8GB - 16GB 内存。当游戏进入后期（或有 4 名以上玩家游玩时），可能需要增加容器的 --memory 限制。

需要将本地目录绑定到 Docker 容器的 /config 目录。该目录将包含以下子目录：

• /backups - 容器首次启动时，服务器会自动备份存档
• /gamefiles - 用于存储游戏文件，存储在容器外部可避免每次重建容器时重新下载 8GB 以上的文件
• /logs - 包含 Steam 日志和指向 Satisfactory 日志的链接（除非设置 LOG=true，否则启动时会清空）
• /saved - 包含游戏蓝图、存档和服务器配置

运行服务器镜像前，建议确认运行容器的用户 ID。大多数情况下这不是必需的，但如果遇到 permission denied 错误，通常是由于权限问题。在 Linux 中，可通过运行 id 命令获取用户 ID（通常类似 1000），并通过环境变量 -e PGID=1000 和 -e PUID=1000 传入。

运行 Satisfactory 服务器镜像的命令如下（这是一个完整命令，请确保复制全部内容）：

bash
docker run \
--detach \
--name=satisfactory-server \
--hostname satisfactory-server \
--restart unless-stopped \
--volume ./satisfactory-server:/config \
--env MAXPLAYERS=4 \
--env PGID=1000 \
--env PUID=1000 \
--env STEAMBETA=false \
--memory-reservation=4G \
--memory 8G \
--publish 7777:7777/tcp \
--publish 7777:7777/udp \
--publish 8888:8888/tcp \
wolveix/satisfactory-server:latest

命令说明

• --detach -> 在后台运行容器
  如果需要查看日志，可替换为 --sig-proxy=false
• --name -> 为容器指定唯一名称
• --hostname -> 设置容器的主机名
• --restart unless-stopped -> 除非手动停止，否则容器自动重启
• --volume -> 将本地目录绑定到容器的/config目录
  便于访问存档文件
• 环境变量（--env）的详细说明请参见此处
• --memory-reservation=4G -> 为容器预留 4GB 内存
• --memory 8G -> 限制容器使用最大 8GB 内存
• --publish -> 指定容器暴露的端口
  

Docker Compose

如果使用 Docker Compose：

yaml
services:
  satisfactory-server:
    container_name: 'satisfactory-server'
    hostname: 'satisfactory-server'
    image: 'wolveix/satisfactory-server:latest'
    ports:
      - '7777:7777/tcp'
      - '7777:7777/udp'
      - '8888:8888/tcp'
    volumes:
      - './satisfactory-server:/config'
    environment:
      - MAXPLAYERS=4
      - PGID=1000
      - PUID=1000
      - STEAMBETA=false
    restart: unless-stopped
    deploy:
      resources:
        limits:
          memory: 8G
        reservations:
          memory: 4G

更新

容器启动或重启时，游戏会自动更新（除非设置 SKIPUPDATE=true）。

更新容器镜像本身的方法：

Docker 运行方式

shell
docker pull wolveix/satisfactory-server:latest
docker stop satisfactory-server
docker rm satisfactory-server
docker run ...  # 使用之前的启动命令重新运行

Docker Compose 方式

shell
docker compose pull
docker compose up -d

使用 Certbot 配置 SSL 证书（可选）

可以使用 Certbot 和 Let's Encrypt 为服务器颁发签名 SSL 证书。如果不配置，Satisfactory 将使用自签名 SSL 证书，玩家首次连接时需要手动确认。如果配置证书后遇到连接问题，请查看以下链接了解已知问题。

https://github.com/wolveix/satisfactory-server/tree/main/ssl%E3%80%82

Kubernetes

如果运行 Kubernetes 集群，可在仓库的 https://github.com/wolveix/satisfactory-server/tree/main/cluster 目录下找到 https://github.com/wolveix/satisfactory-server/tree/main/cluster/service.yaml 和 https://github.com/wolveix/satisfactory-server/tree/main/cluster/statefulset.yaml 文件，以及示例 https://github.com/wolveix/satisfactory-server/tree/main/cluster/values.yaml%E3%80%82

如果使用 Helm，可在 ArtifactHUB 找到相关图表。可通过以下命令安装 k8s-at-home 的 Satisfactory Helm 图表（更多信息请参见 cluster/values.yaml）：

bash
helm repo add k8s-at-home https://k8s-at-home.com/charts/
helm repo update
helm install satisfactory k8s-at-home/satisfactory -f values.yaml

环境变量

测试版分支

如果要运行游戏测试版的服务器，将 STEAMBETA 环境变量设置为 true。

模组支持

模组支持仍在完善中，但目前已可工作。此 Docker 容器的功能与独立安装版相同，因此可以参考社区的技术文档进行设置：点击查看。

容器本身未安装 S/FTP 服务器，因为 Docker 镜像旨在仅包含单一功能/进程。你可以通过以下方式管理模组文件：直接 SFTP 连接到运行服务器的主机（如果是 Linux 系统很容易实现），或通过 Docker Compose 启动另一个 S/FTP 容器，示例如下：

yaml
services:
  # 仅用于模组
  sftp-server:
    container_name: 'sftp-server'
    image: 'atmoz/sftp:latest'
    volumes:
      - './satisfactory-server:/home/your-ftp-user/satisfactory-server'
    ports:
      - '2222:22'
    # 设置用户名、密码和用户 UID（应与 satisfactory-server 容器的 PUID 和 PGID 匹配）
    command: 'your-ftp-user:your-ftp-password:1000'

通过此配置，你可以 SFTP 连接到服务器，并通过 /home/your-ftp-user/satisfactory-server/gamefiles 访问游戏文件。

如何提升多人游戏体验

Satisfactory Wiki 推荐了一些客户端配置调整，以获得最佳多人游戏体验：

• 按下 WIN + R
• 输入 %localappdata%/FactoryGame/Saved/Config/WindowsNoEditor
• 将 Wiki 中的配置数据复制到相应文件中
• 右键点击三个配置文件（Engine.ini、Game.ini、Scalability.ini）
• 进入属性 > 在属性下勾选"只读"

以非 root 用户运行

默认情况下，容器以 root 权限运行，但会以 1000:1000 用户身份执行 Satisfactory。如果主机的用户和组 ID 为 1000:1000，可以使用 Docker 的 --user 参数以非 root 用户运行整个容器。对于其他用户/组 ID，需要克隆并重新构建镜像：

构建非 root 镜像

1. 克隆仓库：

shell
git clone https://github.com/wolveix/satisfactory-server.git

2. 创建 docker-compose.yml 文件，通过构建参数指定所需的 UID/GID（注意：此时不再需要 PUID 和 PGID 环境变量）：

yaml
services:
  satisfactory-server:
    container_name: 'satisfactory-server'
    hostname: 'satisfactory-server'
    build:
      context: .
      args:
        UID: 1001  # 所需的 UID
        GID: 1001  # 所需的 GID
    user: "1001:1001"  # 必须与上面的 UID:GID 匹配
    ports:
      - '7777:7777/tcp'
      - '7777:7777/udp'
      - '8888:8888/tcp'
    volumes:
      - './satisfactory-server:/config'
    environment:
      - MAXPLAYERS=4
      - STEAMBETA=false
    restart: unless-stopped
    deploy:
      resources:
        limits:
          memory: 8G
        reservations:
          memory: 4G

3. 构建并运行容器：

shell
docker compose up -d

已知问题

• 容器默认以 root 权限运行。可以使用 Docker 的 --user 参数指定用户，但如果用户和组 ID 不是 1000:1000，需要按上述方法重新构建镜像。
• 服务器日志会显示各种错误，其中大多数可以安全忽略。只要容器持续运行且日志与示例日志相似，服务器应正常工作：https://github.com/wolveix/satisfactory-server/blob/main/server.log

Star 历史

![Star History Chart]([***]===SHORT_DESC=== Satisfactory 专用服务器的 Docker 化版本，便于快速部署和管理，支持自动更新、数据持久化及多环境配置，适用于搭建多人协作的 Satisfactory 游戏服务器。 ===FULL_DESC===# Satisfactory Server

!https://raw.githubusercontent.com/wolveix/satisfactory-server/main/.github/logo.png "Satisfactory logo"

!Release !Docker Pulls !Docker Stars !Image Size

这是 Satisfactory 专用服务器的 Docker 化版本。

https://github.com/wolveix/satisfactory-server/wiki/Troubleshooting-FAQ

https://github.com/wolveix/satisfactory-server/wiki/Upgrading-for-1.1

安装设置

服务器可以在少于 8GB 内存的环境下运行，但根据 官方 wiki 建议，仍推荐 8GB - 16GB 内存。当游戏进入后期（或有 4 名以上玩家游玩时），可能需要增加容器的 --memory 限制。

需要将本地目录绑定到 Docker 容器的 /config 目录。该目录将包含以下子目录：

• /backups - 容器首次启动时，服务器会自动备份存档
• /gamefiles - 用于存储游戏文件，存储在容器外部可避免每次重建容器时重新下载 8GB 以上的文件
• /logs - 包含 Steam 日志和指向 Satisfactory 日志的链接（除非设置 LOG=true，否则启动时会清空）
• /saved - 包含游戏蓝图、存档和服务器配置

运行服务器镜像前，建议确认运行容器的用户 ID。大多数情况下这不是必需的，但如果遇到 permission denied 错误，通常是由于权限问题。在 Linux 中，可通过运行 id 命令获取用户 ID（通常类似 1000），并通过环境变量 -e PGID=1000 和 -e PUID=1000 传入。

运行 Satisfactory 服务器镜像的命令如下（这是一个完整命令，请确保复制全部内容）：

bash
docker run \
--detach \
--name=satisfactory-server \
--hostname satisfactory-server \
--restart unless-stopped \
--volume ./satisfactory-server:/config \
--env MAXPLAYERS=4 \
--env PGID=1000 \
--env PUID=1000 \
--env STEAMBETA=false \
--memory-reservation=4G \
--memory 8G \
--publish 7777:7777/tcp \
--publish 7777:7777/udp \
--publish 8888:8888/tcp \
wolveix/satisfactory-server:latest

命令说明

• --detach -> 在后台运行容器
  如果需要查看日志，可替换为 --sig-proxy=false
• --name -> 为容器指定唯一名称
• --hostname -> 设置容器的主机名
• --restart unless-stopped -> 除非手动停止，否则容器自动重启
• --volume -> 将本地目录绑定到容器的/config目录
  便于访问存档文件
• 环境变量（--env）的详细说明请参见此处
• --memory-reservation=4G -> 为容器预留 4GB 内存
• --memory 8G -> 限制容器使用最大 8GB 内存