robpc/godot-headless

docker-godot-headless

镜像概述

docker-godot-headless是https://godotengine.org/%E6%97%A0%E5%A4%B4%E7%89%88%EF%BC%88headless%EF%BC%89%E7%9A%84Docker%E9%95%9C%E5%83%8F%EF%BC%8C%E5%8C%85%E5%90%AB%E5%AF%BC%E5%87%BA%E6%A8%A1%E6%9D%BF%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E5%91%BD%E4%BB%A4%E8%A1%8C%E7%8E%AF%E5%A2%83%E4%B8%8B%E7%9A%84%E6%B8%B8%E6%88%8F%E9%A1%B9%E7%9B%AE%E5%AF%BC%E5%87%BA%E5%92%8C%E8%87%AA%E5%8A%A8%E5%8C%96%E6%9E%84%E5%BB%BA%E3%80%82%E9%95%9C%E5%83%8F%E5%85%A5%E5%8F%A3%E7%82%B9%E9%BB%98%E8%AE%A4%E8%B0%83%E7%94%A8Godot Engine可执行文件（/usr/local/bin/godot），可通过覆盖command参数传递任意命令行参数（默认参数为--help）。

核心功能和特性

• 无头运行模式：无需图形界面，支持纯命令行环境下的Godot Engine调用
• 内置导出模板：包含完整的平台导出模板，可直接用于Windows、Linux、macOS、移动设备等平台的项目导出
• 多版本支持：同时维护Godot 3.x和4.x系列版本，满足不同项目需求
• 灵活标签策略：提供细分标签（如4.3-desktop、3.5.3-mobile），可按需选择特定版本和功能集
• CI/CD友好：支持与自动化工作流集成，简化游戏项目的持续集成和部署流程

使用场景

• CI/CD流程中的游戏项目自动化导出（如GitHub Actions、GitLab CI等）
• 命令行环境下的项目构建、测试和打包
• 服务器或无图形界面环境中的Godot项目运行和导出
• 需要统一构建环境的团队协作场景

使用方法

docker-compose示例

yaml
version: '2'
services:
  godot:
    image: docker.xuanyuan.run/godot-headless:4.3-desktop
    volumes:
      - ./:/project  # 将本地项目目录挂载到容器内的/project
    command: --path /project --export win64 bin/win64/maze-test.exe  # 导出Windows 64位可执行文件

基本命令说明

容器默认入口点为/usr/local/bin/godot，可通过command参数传递任意Godot命令行参数，例如：

• 查看帮助：docker run --rm godot-headless:4.3 --help
• 导出项目：docker run --rm -v $(pwd):/project godot-headless:4.3 --path /project --export linux bin/linux/game

更新Godot版本

手动更新步骤

1. 修改版本配置：每个主版本（3.x和4.x）的godot3/和godot4/目录下包含Dockerfile和versions.yml。更新对应版本的versions.yml（仅为应发布latest标签的主版本设置provides_latest: true）。

2. 运行更新脚本：本地执行bash scripts/update-godot.sh <version> <previous>更新godot4/Dockerfile、godot4/versions.yml和README占位符（如需更新旧版godot3，可添加类似辅助脚本）。

自动化更新流程

1. 触发GitHub Actions工作流：在GitHub仓库的Actions → Update Godot Version中触发工作流，输入版本和先前标签，工作流将自动运行上述脚本并创建包含变更的拉取请求。

2. 构建与发布：DockerHub发布工作流会在对应目录文件变更时自动运行：Docker Godot 4工作流构建4.x镜像，Docker Godot 3构建3.x镜像。也可从Actions标签手动触发工作流以重建或刷新文档。

3. 文档同步：DockerHub描述会自动从README同步，需保持摘要部分简洁以适配展示需求。

Docker标签

标签遵循Godot版本号，按功能集细分（以减小镜像体积）。默认推荐使用包含完整模板的基础版本。

Godot 4 系列标签

• 4.3, 4.3-all, latest
  • 4.3-desktop
    • 4.3-linux
    • 4.3-macos
    • 4.3-windows
      • 4.3-win32
      • 4.3-win64
  • 4.3-mobile
    • 4.3-android
    • 4.3-ios
  • 4.3-web

旧版Godot 4 标签

• 4.2.2
• 4.2.1
• 4.2
• 4.1.3
• 4.1.2
• 4.1.1
• 4.1
• 4.0.3
• 4.0.2
• 4.0.1
• 4.0

Godot 3 系列标签（ legacy ）

• 3.5.3, 3.5.3-all
  • 3.5.3-desktop
    • 3.5.3-linux
    • 3.5.3-osx
    • 3.5.3-windows
      • 3.5.3-win
        • 3.5.3-win32
        • 3.5.3-win64
      • 3.5.3-uwp
        • 3.5.3-uwp32
        • 3.5.3-uwp64
  • 3.5.3-mobile
    • 3.5.3-android
    • 3.5.3-iphone
  • 3.5.3-html

旧版Godot 3 标签

• 3.5.2
• 3.5.1
• 3.5
• 3.4.5
• 3.4.4
• 3.4.3
• 3.4.2
• 3.4.1
• 3.4
• 3.3.4
• 3.3.3
• 3.3.2
• 3.3.1
• 3.3
• 3.2.3