daxiongmao87/dwarf-fortress

Dwarf Fortress容器镜像

镜像概述

本镜像提供在容器中运行可SSH访问的Dwarf Fortress游戏能力，支持自定义游戏版本、SSH账号密码，且可持久化存储游戏存档与初始化配置，适用于容器或Kubernetes环境下的远程游戏场景。

核心功能

1. SSH远程访问：暴露22端口，通过指定账号密码远程连接容器游玩；
2. 版本定制：通过环境变量指定游戏版本（格式MAJOR.MINOR，如47.05）；
3. 持久化存储：支持游戏存档和初始化配置的持久化保存。

使用场景

• 个人在容器环境中远程访问Dwarf Fortress；
• 小团队共享游戏实例，通过SSH协作游玩；
• Kubernetes集群部署游戏服务，保障可用性。

配置说明

环境变量

• USERNAME：SSH登录用户名（必填）；
• PASSWORD：SSH登录密码（必填）；
• DF_VERSION：游戏版本（格式MAJOR.MINOR，如47.05，必填）。

持久化路径

• 存档目录：/df/df_linux/data/save；
• 配置目录：/df/df_linux/data/init。

暴露端口

• 22（SSH端口）。

部署示例

Docker Run命令

bash
docker run -d \
  -p 2222:22 \
  -e USERNAME=df_user \
  -e PASSWORD=df_pass123 \
  -e DF_VERSION=47.05 \
  -v df_save:/df/df_linux/data/save \
  -v df_init:/df/df_linux/data/init \
  daxiongmao87/dwarf-fortress

说明：映射本地2222端口到容器22端口，使用自定义账号密码与游戏版本，挂载卷保存数据。

### Docker Compose示例
```yaml
version: "3"
services:
  dwarf-fortress:
    image: daxiongmao87/dwarf-fortress
    ports:
      - "2222:22"
    environment:
      - USERNAME=df_user
      - PASSWORD=df_pass123
      - DF_VERSION=47.05
    volumes:
      - df_save:/df/df_linux/data/save
      - df_init:/df/df_linux/data/init
volumes:
  df_save:
  df_init: