spidegames/nitrox_server

Nitrox专用服务器

Ubuntu 22.04 · .NET 9

适用于Subnautica的多人Nitrox服务器，支持持久化存储，可通过环境变量完成服务器的完整配置。

快速启动

bash
docker run -d --name nitrox \
  -p 11000:11000/udp -p 11000:11000/tcp \
  -e SUBNAUTICA_INSTALLATION_PATH=/subnautica \
  -e NITROX_WORKDIR=/opt/nitrox \
  -e NITROX_SAVES_DIR=/opt/nitrox/Nitrox/saves \
  -e SERVER_WORLD_NAME="我的世界" \
  -v /本地/Subnautica路径:/subnautica:ro \
  -v nitrox_data:/opt/nitrox \
  -v /本地/存档路径:/opt/nitrox/Nitrox/saves \
  docker.xuanyuan.run/spidegames/nitrox_server:latest

端口

• 11000/udp、11000/tcp — Nitrox服务器默认端口。

卷

• NITROX_WORKDIR（默认 /opt/nitrox）
  存储Nitrox二进制文件和运行时文件。挂载卷可避免每次启动重新下载。

• NITROX_SAVES_DIR
  存档根目录（实际路径为 /opt/nitrox/Nitrox/saves）。若需在主机管理存档，直接挂载本地文件夹到此路径。

docker-compose卷示例：

yaml
volumes:
  nitrox_data:

环境变量

（除非标记为必填，否则均为可选）

必填项

• SUBNAUTICA_INSTALLATION_PATH — 已挂载的Subnautica安装路径。

核心配置

• NITROX_WORKDIR（默认 /opt/nitrox）— Nitrox工作目录。
• NITROX_VERSION（默认 1.8.1.0）— 安装的Nitrox版本。
• NITROX_DOWNLOAD_URL — 自定义压缩包URL（覆盖版本下载）。
• NITROX_FORCE_REINSTALL（默认 false）— 强制重新下载（即使已安装）。

存档/世界配置

• NITROX_SAVES_DIR — 存档根目录（推荐 /opt/nitrox/Nitrox/saves）。
• SERVER_WORLD_NAME（默认 我的世界）— 存档下的世界文件夹名称。
• SERVER_CFG_PATH — 显式指定server.cfg路径（覆盖存档+世界名称的组合路径）。

服务器配置（server.cfg）

以下变量映射到server.cfg的常见设置：

• SERVER_PASSWORD — 服务器密码。
• SERVER_GAMEMODE — 游戏模式（1=生存、2=自由、3=硬核、4=创意或自定义字符串）。
• SERVER_COMMANDS_ENABLED — 是否启用控制台命令（映射到DisableConsole，值为true/false）。
• SERVER_PVP_ENABLED — 是否启用PVP（值为true/false）。
• SERVER_KEEP_INVENTORY — 死亡是否保留物品（映射到KeepInventoryOnDeath，值为true/false）。

完整配置传递

前缀为NITROX_CFG_的变量会直接写入server.cfg（格式为Key=Value）：

yaml
environment:
  NITROX_CFG_SaveInterval: "60000"
  NITROX_CFG_MaxConnections: "50"
  NITROX_CFG_AutoPortForward: "False"

行为特性

• 首次启动时，下载对应版本的Nitrox压缩包到工作目录。
• 安装版本缓存于.nitrox_version文件。
• 依赖仅安装一次（标记文件：/var/lib/nitrox/.deps_installed）。
• 入口点存储在工作目录外，避免被挂载卷覆盖。
• 以nitrox用户（UID ***）运行，若以root启动则通过gosu切换。
• server.cfg写入存档下的世界文件夹。

docker-compose示例

yaml
services:
  nitrox:
    image: docker.xuanyuan.run/spidegames/nitrox_server:latest
    environment:
      SUBNAUTICA_INSTALLATION_PATH: /subnautica
      NITROX_WORKDIR: /opt/nitrox
      NITROX_SAVES_DIR: /opt/nitrox/Nitrox/saves
      SERVER_WORLD_NAME: "我的世界"
      SERVER_PASSWORD: "secret"
      SERVER_GAMEMODE: "1"
      # SERVER_COMMANDS_ENABLED: "false"
      # SERVER_PVP_ENABLED: "false"
      # SERVER_KEEP_INVENTORY: "true"
      # SERVER_CFG_PATH: /opt/nitrox/Nitrox/saves/我的世界/server.cfg
      # NITROX_CFG_SaveInterval: "60000"
    volumes:
      - /本地/Subnautica路径:/subnautica:ro
      - nitrox_data:/opt/nitrox
      - /本地/存档路径:/opt/nitrox/Nitrox/saves
    ports:
      - "11000:11000/udp"
      - "11000:11000/tcp"
    restart: unless-stopped

volumes:
  nitrox_data:

提示

• 升级/降级版本：使用--build-arg NITROX_VERSION=...重建镜像后重启。
• 强制重新下载：设置NITROX_FORCE_REINSTALL=true或删除nitrox_data卷。
• 重置存档：删除主机上的存档文件夹（绑定挂载）或移除项目卷（docker compose down -v）。