nerodon/icarus-dedicated

Icarus专用服务器 Docker镜像

!Docker Pulls !Docker Stars !Docker Image Size (tag) !GitLab (self-managed)

如需帮助，请在官方Icarus *上联系@Nerodon**或在Gitlab上提交issue。

[]([] []([]

镜像概述

本专用服务器在启动时会自动下载/更新至最新可用的服务器版本，运行于Ubuntu 24.04和Wine环境，为生存游戏《Icarus》提供稳定的多人游戏服务。

核心功能与特性

• 自动更新：启动时自动下载并更新至最新服务器版本
• 灵活配置：通过环境变量自定义服务器参数（名称、端口、密码、玩家数量等）
• 数据持久化：支持通过卷挂载保存游戏数据和服务器二进制文件
• 多场景支持：可配置自动关闭策略、玩家权限管理、游戏存档频率等

使用场景

• 搭建《Icarus》私人或公共多人游戏服务器
• 管理多个游戏存档和前景任务（Prospect）
• 自定义服务器规则和玩家访问权限

环境变量配置

有关服务器配置的更多详细信息，请参考https://github.com/RocketWerkz/IcarusDedicatedServer/wiki/Server-Config-&-Launch-Parameters

端口要求

服务器需要2个UDP端口：

• 游戏端口（默认***）
• 查询端口（默认27015）

可通过PORT和QUERYPORT环境变量修改端口号。

卷挂载

• 服务器二进制文件存储路径：/game/icarus
• 服务器存档存储路径：/home/steam/.wine/drive_c/icarus

注意：默认情况下，卷的所有者为1000:1000，请相应设置卷权限。如需更改用户和组ID，可定义STEAM_USERID和STEAM_GROUPID环境变量。

Docker运行示例

bash
docker run -p 17777:17777/udp -p 27015:27015/udp -v data:/home/steam/.wine/drive_c/icarus -v game:/game/icarus -e SERVERNAME=AmazingServer -e JOIN_PASSWORD=mypassword -e ADMIN_PASSWORD=mysupersecretpassword  nerodon/icarus-dedicated:latest

Docker Compose示例

yaml
version: "3.8"

services:
 
  icarus:
    container_name: icarus-dedicated
    image: nerodon/icarus-dedicated:latest
    hostname: icarus-dedicated
    init: true
    restart: "unless-stopped"
    ports:
      - 17777:17777/udp
      - 27015:27015/udp
    volumes:
      - data:/home/steam/.wine/drive_c/icarus
      - game:/game/icarus
    environment:
      - SERVERNAME=myAmazingServer
      - BRANCH=public
      - PORT=17777
      - QUERYPORT=27015
      - JOIN_PASSWORD=mypassword
      - ADMIN_PASSWORD=mysupersecretpassword
      - STEAM_USERID=1000
      - STEAM_GROUPID=1000
      - STEAM_ASYNC_TIMEOUT=60

volumes:
  data: {}
  game: {}

许可证

MIT许可证

已知问题

• 内存不足错误：Freeing x bytes from backup pool to handle out of memory 和 Fatal error: [File: Unknown] [Line: 197] \nRan out of memory allocating 0 bytes with alignment 0\n，但系统有足够内存。

  解决方案：增加最大内存映射区域数量（vm.max_map_count），建议设置为262144

  临时设置：

  bash
  sysctl -w vm.max_map_count=262144
  

  永久设置：

  bash
  echo "vm.max_map_count=262144" >> /etc/sysctl.conf && sysctl -p
  

  鸣谢：感谢Icarus *用户Fabiryn**提供此解决方案。