iceflower/redeclipse-server

Red Eclipse Server Docker

https://github.com/IceflowRE/redeclipse-server-docker/actions/workflows/update_docker_images.yml

本文档提供了Red Eclipse服务器的Docker镜像源码，该镜像易于操作和维护。
此外，还包含一个Go控制台应用程序，用于更新DockerHub镜像。
目前，Docker镜像基于最新提交构建，每天检查一次更新。

支持的标签及对应的Dockerfile链接

• https://github.com/IceflowRE/redeclipse-server-docker/blob/main/Dockerfile_master
• https://github.com/IceflowRE/redeclipse-server-docker/blob/main/Dockerfile_stable
• https://github.com/IceflowRE/redeclipse-server-docker/blob/main/Dockerfile_stable
• https://github.com/IceflowRE/redeclipse-server-docker/blob/main/Dockerfile_stable
• https://github.com/IceflowRE/redeclipse-server-docker/blob/main/Dockerfile_stable
• https://github.com/IceflowRE/redeclipse-server-docker/blob/main/Dockerfile_stable
• https://github.com/IceflowRE/redeclipse-server-docker/blob/main/Dockerfile_stable
• https://github.com/IceflowRE/redeclipse-server-docker/blob/main/Dockerfile_2_0_0

* stable标签不表示最新的稳定版本，它标记最新的旧版本（v1.x.x）

可用架构为amd64。

如果您的架构不可用，请检查Red Eclipse是否可在该架构上构建，并参考我的架构没有可用镜像。

如何使用此镜像

我们将使用Docker Compose，因为它是管理运行中容器的最简单方式。

创建一个Docker Compose文件并命名为docker-compose.yml，您可以使用https://github.com/IceflowRE/redeclipse-server-docker/blob/main/docker-compose-template.yml%E4%BD%9C%E4%B8%BA%E8%B5%B7%E7%82%B9%E3%80%82

替换包含括号的<variable>。

yml
services:
    # <service_name>：用于后续访问的服务名称（例如 `master`、`v2_0_0`）
    <service_name>:
        # <tag>：要使用的镜像标签（例如 `master`、`v2.0.0`）
        image: iceflower/redeclipse-server:<tag>
        ports:
            # <serverport>：将发布并可从外部访问的端口，
            # 端口号必须与RE的`servinit.cfg`中定义的端口匹配
            - "<serverport>:<serverport>/udp"
            # <serverport + 1>：上述服务器端口加1
            - "<serverport + 1>:<serverport + 1>/udp"
        restart: unless-stopped
        volumes:
            # <RE home dir>：主机系统上RE主目录/配置目录的路径
            # （例如 `/home/iceflower/re-master/home`）
            - type: bind
              source: <RE home dir>
              target: /re-server-config/home
              read_only: true
            # <RE package dir>：主机系统上RE包目录的路径，可在此放置自定义地图
            # 如果不需要，只需删除此部分（例如 `/home/iceflower/redeclipse-config/package`）
            - type: bind
              source: /home/iceflower/redeclipse-config/package
              target: /re-server-config/package
              read_only: true
            # <sauerbraten dir>：Sauerbraten目录/安装的路径
            # 如果使用版本高于或等于 `v2.0.0` 或 `master`，请删除此部分
            # （例如 `/home/iceflower/sauerbraten`）
            - type: bind
              source: <sauerbraten dir>
              target: /re-server-config/sauer
              read_only: true
        logging:
            options:
                max-size: "2000k"
                max-file: "10"

要拉取/启动/停止特定服务，请在命令末尾添加服务名称，否则将应用于所有服务。

• 为所有定义的服务从Docker Hub拉取最新镜像
  docker compose pull

• 启动/重启容器
  docker compose up -d

• 关闭并等待最多10分钟后强制停止
  docker compose stop --time=600

多个服务器

复制粘贴上述整个服务部分并修改值（服务名称、端口、主目录等）。

我的架构没有可用镜像

首先检查Red Eclipse是否可在您的架构上构建。如果可以，请继续。

按照下表复制所需的Dockerfile到docker-compose.yml旁边。记住所选的Dockerfile。

在Dockerfile旁边创建一个名为.dockerignore的文件，内容为**。

编辑您的docker-compose.yml，将想要构建的服务中的image: ...部分替换为

yml
build:
    # <dockerfile>：所选标签对应的Dockerfile名称
    dockerfile: <dockerfile>
    args:
        # <tag>：可以是任何Git引用（分支名、标签、SHA）（例如 `master`、`v2.0.0` 等）
        TAG: <tag>
        RE_COMMIT: ""
        ALPINE_SHA: ""
        DOCKERFILE_SHA: ""

然后使用docker compose build构建自定义镜像。

自动更新服务器

创建一个名为update-server.sh的文件（确保它具有可执行权限）。您可以将其放在docker-compose.yml旁边。

根据放置文件的位置调整目录路径。

bash
#!/bin/bash -e

# 编辑下一行
cd /home/iceflower/re/
docker compose stop -t 600
# docker compose build
docker compose pull
docker compose up -d

要定期更新，您可以创建一个cron任务，具体方法请参考与您的操作系统匹配的指南。

cron
0 3 * * * /home/iceflower/re/update-server.sh > /home/iceflower/re/cron.log 2>&1

这将每天3:00更新。

DockerHub镜像更新器

构建命令

shell
cd go-docker-updater
go build -x -o updater ./cmd/updater/

更多选项请参见--help。

此更新器用于更新DockerHub镜像。

Web

https://github.com/IceflowRE/redeclipse-server-docker

credits

• 开发者
  • Iceflower S

    • ---

许可证

Copyright 2017-present Iceflower S

特此授予任何获得本软件及相关文档文件（“软件”）副本的人免费许可，不受限制地处理本软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本的权利，并允许向其提供软件的人这样做，但须符合以下条件：

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

本软件按“原样”提供，不提供任何明示或暗示的担保，包括但不限于适销性、特定用途适用性和非侵权性的担保。在任何情况下，作者或版权持有人均不对因软件或软件的使用或其他交易引起的任何索赔、损害或其他责任承担责任，无论是合同诉讼、侵权行为还是其他方式。

Red Eclipse服务器文件使用https://github.com/redeclipse/base/blob/master/doc/license.txt%E3%80%82