elvith/terraforming-mars

Terraforming Mars (arm64非官方构建) Docker镜像文档

镜像概述

本Docker镜像是基于开源项目https://github.com/terraforming-mars/terraforming-mars/%E7%9A%84%E9%9D%9E%E5%AE%98%E6%96%B9%E6%9E%84%E5%BB%BA%E7%89%88%E6%9C%AC%EF%BC%8C%E4%B8%93%E9%97%A8%E9%92%88%E5%AF%B9arm64%E6%9E%B6%E6%9E%84%E4%BC%98%E5%8C%96%E3%80%82%E6%97%A8%E5%9C%A8%E8%A7%A3%E5%86%B3arm64%E6%9E%B6%E6%9E%84%E8%AE%BE%E5%A4%87%EF%BC%88%E5%A6%82%E6%A0%91%E8%8E%93%E6%B4%BE%E3%80%81AWS Graviton实例、Apple Silicon设备等）上部署该项目的需求，提供与原项目功能一致的运行环境。

核心功能与特性

• arm64架构支持：专为arm64处理器构建，兼容各类arm64设备，解决原项目可能缺乏官方arm64支持的问题。
• 功能一致性：基于原项目代码构建，保留其全部核心功能，包括应用程序运行、服务部署等。
• 轻量化部署：通过Docker容器化封装，简化部署流程，减少环境依赖冲突。
• 版本同步：定期同步原项目更新，提供与官方版本功能匹配的非官方arm64构建。

使用场景

• 嵌入式设备部署：在arm64架构的嵌入式设备（如树莓派、NVIDIA Jetson等）上运行Terraforming Mars相关应用。
• 云服务器部署：在基于arm64的云服务器（如AWS Graviton2/3、阿里云ARM实例等）上部署该项目服务，降低算力成本。
• 开发测试环境：为arm64架构开发环境提供一致的运行容器，便于跨平台测试。
• 边缘计算场景：在arm64边缘节点部署轻量级服务，满足低功耗、高性价比需求。

使用方法

前提条件

• 设备架构为arm64（可通过uname -m命令验证，输出应为aarch64）。
• 已安装Docker Engine（推荐20.10+版本，确保支持arm64镜像）。

基本运行命令

拉取并运行镜像的基础命令：

bash
docker run -d \
  --name terraforming-mars-arm64 \
  [镜像名称]:[版本标签]

说明：请将[镜像名称]替换为实际镜像仓库地址（如username/terraforming-mars-arm64），[版本标签]替换为所需版本（如latest或具体版本号）。

数据持久化配置

如需持久化存储项目数据（如配置文件、日志等），可通过数据卷挂载实现：

bash
docker run -d \
  --name terraforming-mars-arm64 \
  -v /本地数据路径:/app/data \  # 挂载数据目录
  -v /本地配置路径:/app/config \  # 挂载配置目录（如有）
  [镜像名称]:[版本标签]

端口映射（如适用）

若项目包含网络服务（如Web界面、API接口等），需映射容器端口到主机：

bash
docker run -d \
  --name terraforming-mars-arm64 \
  -p 8080:8080 \  # 示例：映射主机8080端口到容器8080端口
  [镜像名称]:[版本标签]

环境变量配置

根据原项目需求，可通过-e参数传递环境变量（具体变量需参考原项目文档）：

bash
docker run -d \
  --name terraforming-mars-arm64 \
  -e APP_PORT=8080 \  # 示例：设置应用监听端口
  -e LOG_LEVEL=info \  # 示例：设置日志级别
  [镜像名称]:[版本标签]

注意事项

• 非官方构建：本镜像为社区非官方构建，不代表原项目团队立场，使用前请评估稳定性与安全性。
• 功能依赖：功能完全依赖原项目，如有使用问题，建议优先参考https://github.com/terraforming-mars/terraforming-mars/%E6%88%96%E6%8F%90%E4%BA%A4issue%E3%80%82
• 版本兼容性：建议使用与原项目官方版本匹配的镜像标签，避免版本差异导致功能异常。
• 资源需求：根据原项目运行需求，可能需要调整容器CPU/内存限制（通过--cpus、--memory参数）。

参考链接

• 原项目地址：https://github.com/terraforming-mars/terraforming-mars/
• Docker官方arm64支持文档：https://docs.docker.com/desktop/multi-arch/