escaping/core-keeper-dedicated

Core Keeper 专用服务器

!corekeeper

在这款支持1-8人游玩的采矿沙盒冒险游戏中，探索充满生物、遗迹和资源的无尽洞穴。通过采矿、建造、战斗、制作和耕种，揭开古老核心的秘密。在Steam商店获取Core Keeper

https://github.com/escapingnetwork/core-keeper-dedicated/actions/workflows/docker-image.yml/badge.svg?branch=main](https://github.com/escapingnetwork/core-keeper-dedicated/actions/workflows/docker-image.yml)

支持的标签及对应 Dockerfile 链接

• latest (Dockerfile)

如何运行

ARM架构配置

此镜像当前包含以下Box64构建变体，适用于以下设备：

• 通用设备 [generic]
• 树莓派3 [rpi3]
• 树莓派4 [rpi4-pre3]
• 树莓派5（4K页面大小）[rpi5]
• 树莓派5（16K页面大小）[rpi5_16k]
• M1（M系列）Mac [m1]
• ADLink Ampere Altra（Oracle ARM CPU）[adlink]

默认使用generic。如需使用其他变体，在core.env文件中修改环境变量ARM64_DEVICE。

卷

在运行服务器的位置创建两个目录：

• server-data：必需，用于在每次重启之间保留配置
• server-files：可选，包含应用程序的所有文件

然后在以下示例中修改/host/path/to/server-data和/或/host/path/to/server-files，以匹配你创建的文件夹路径。

使用Docker CLI：

bash
docker run -d \
  --name core-keeper-dedicated \
  -e WORLD_NAME="Core Keeper Server" \
  -e MAX_PLAYERS=5 \
  -v /host/path/to/server-data:/home/steam/core-keeper-data \
  -v /host/path/to/server-files:/home/steam/core-keeper-dedicated \
  escaping/core-keeper-dedicated:latest

使用Docker Compose

创建docker-compose.yml，内容如下：

yml
services:
  core-keeper:
    image: escaping/core-keeper-dedicated:latest
    container_name: core-keeper-dedicated
    restart: unless-stopped
    stop_grace_period: 2m
    # 仅在使用直接连接模式时需要端口
    # ports:
    #   - "$SERVER_PORT:$SERVER_PORT/udp"
    volumes:
      - /host/path/to/server-files:/home/steam/core-keeper-dedicated
      - /host/path/to/server-data:/home/steam/core-keeper-data
    env_file:
      - path: core.env
        required: false

创建core.env文件，覆盖专用服务器所需的环境变量，参考配置部分。示例：

env
ARM64_DEVICE=rpi5
MAX_PLAYERS=3

在包含这些文件的文件夹中运行docker compose up -d。

可执行文件旁会创建GameID.txt文件，包含游戏ID。若未出现，可查看Docker日志（docker logs core-keeper-dedicated或docker compose logs）排查错误。

查询游戏ID： docker exec -it core-keeper-dedicated cat /home/steam/core-keeper-dedicated/GameID.txt

配置

以下是可用于自定义服务器行为的参数及默认值。

Mod支持

容器支持从mod.io自动安装mod。

1. 从mod.io/me/access获取mod.io API密钥
   • 需同时获取生成的API路径（如[***]
2. 在core.env文件（或docker-compose.yml）中设置必要环境变量

• MODS_ENABLED=true
• MODIO_API_KEY=你的API密钥
• MODIO_API_URL=你的API路径
• MODS=mod1,mod2（见下文）

指定要安装的mods

[!警告] 安装客户端专用mod可能导致服务器无法启动。不要安装客户端专用mod（它们在服务器上也不起作用）。

[!重要] mod依赖不会自动安装。你必须查看每个要安装的mod的依赖项，并将其依赖添加到列表中。

需从mod.io获取每个mod的字符串ID，最简单的方法是从URL中提取。

例如，CoreLib的URL为https://mod.io/g/corekeeper/m/core-lib，使用core-lib。

mods指定为逗号分隔列表，可选择指定版本：

sh
# 格式：<mod_id>[:<版本>], ...
MODS=core-lib,coreliblocalization,corelibrewiredextension,ck-qol

指定版本示例：

sh
MODS=core-lib,coreliblocalization,corelibrewiredextension:3.0.1,ck-qol:1.9.4

• 若未指定版本，将安装最新版本。
• 容器启动时会重新安装mods，因此要更新mod到最新版本，只需重启容器。

网络模式

Core Keeper目前支持两种网络模式：SDR（Steam Datagram Relay）和直接连接。

SDR（Steam Datagram Relay）

此模式下，服务器使用Valve的虚拟网络通过Steam的中继基础设施路由流量。玩家不直接连接服务器IP，所有通信通过Steam管理的安全中继节点进行。这隐藏了服务器的真实IP，防止DDoS***，并改善NAT穿透。

由于使用中继系统，服务器管理员无需在路由器或防火墙上开放端口——只要允许出站连接到Steam，服务器即可与客户端可靠通信。

直接连接

直接连接模式下，玩家直接连接服务器的公网IP，不通过Steam中继网络。这可能降低延迟并实现更直接的通信，但要求服务器可从互联网访问。

服务器管理员必须在路由器或防火墙上开放并转发必要端口，以允许入站连接。与SDR不同，此模式向客户端暴露服务器IP，可能更容易出现连接问题或受到***。

[!重要]
SERVER_PORT环境变量决定服务器的网络模式。
留空使用SDR（无需端口转发）。
设置值则切换到直接连接模式，需要开放并转发端口。
仅在明确需要直接连接时设置。

贡献者

https://github.com/escapingnetwork/core-keeper-dedicated/graphs/contributors

使用contrib.rocks制作。