goofball222/factorio

Factorio 无头服务器 Docker 镜像

https://github.com/goofball222/factorio/actions/workflows/build-latest.yml/badge.svg](https://github.com/goofball222/factorio/actions/workflows/build-latest.yml)

镜像概述和主要用途

本镜像提供 Factorio 游戏的无头服务器（Headless Server）容器化部署方案，支持快速搭建和运行 Factorio 多人游戏服务器。镜像基于官方 Factorio 无头服务器构建，包含完整的服务器功能，并通过容器化技术简化部署流程，确保数据持久化和配置灵活性。

核心功能和特性

• 安全运行环境：默认使用内部 factorio 用户（UID/GID 999）运行服务，避免直接使用 root 权限，降低***面
• 自动权限调整：启动时自动调整挂载卷和数据的权限，确保服务正常访问
• 灵活配置：支持通过环境变量或配置文件自定义服务器参数、RCON 密码、端口等
• 持久化存储：核心数据（配置、模组、存档、场景）集中存储在 /factorio 卷，便于备份和迁移
• 多版本支持：提供 stable（稳定版）、experimental（实验版）及特定版本标签，满足不同需求
• 日志集成：服务器日志直接输出到容器日志，便于通过 docker logs 查看

使用场景和适用范围

• 个人或小型团队快速搭建 Factorio 多人游戏服务器
• 需要持久化服务器配置、存档和模组的场景
• 希望通过容器化简化部署和版本管理的用户
• 对服务器安全性有基本要求，需限制服务权限的场景

Docker 标签信息

使用方法和配置说明

卷结构

容器仅有一个核心卷 /factorio，包含服务器所有关键数据，结构如下：

factorio
├── config                  # 配置文件目录
│   ├── map-gen-settings.json           # 地图生成配置
│   ├── map-gen-settings.example.json   # 地图生成配置示例
│   ├── map-settings.json               # 地图设置
│   ├── map-settings.example.json       # 地图设置示例
│   ├── RCON.pw                         # RCON 密码文件
│   ├── server-adminlist.json           # 管理员列表
│   ├── server-banlist.json             # 封禁列表
│   ├── server-settings.json            # 服务器设置
│   └── server-whitelist.json           # 白名单
├── mods                    # 模组目录（存放 .zip 格式模组）
│   └── mod.zip
├── saves                   # 存档目录（存放 .zip 格式存档）
│   └── save.zip
└── scenarios               # 场景目录（存放 .zip 格式场景）
    └── scenario.zip

暴露端口

容器默认暴露以下端口，需根据实际需求映射到主机：

• 27015/tcp：RCON 管理端口（用于远程管理服务器）
• 34197/udp：Factorio 游戏默认端口（客户端连接用）

基本运行命令

最简单的启动方式（仅映射游戏端口，数据存储在容器内部，重启后可能丢失）：

bash
docker run --name factorio -d \
    -p 34197:34197/udp \
    goofball222/factorio

推荐：使用 Docker Compose 部署

为确保数据持久化和配置灵活性，推荐使用 docker-compose.yml 管理服务。以下示例将数据存储在当前目录（需确保目录权限正确），并映射 RCON 端口以便管理：

yaml
version: '3'

services:
  factorio:
    image: goofball222/factorio
    container_name: factorio
    restart: unless-stopped  # 除非手动停止，否则自动重启
    ports:
      - "27015:27015"         # RCON 端口映射
      - "34197:34197/udp"     # 游戏端口映射
    volumes:
      - /etc/localtime:/etc/localtime:ro  # 同步主机时间
      - ./factorio:/factorio              # 数据持久化到当前目录的 factorio 子目录
    environment:
      - TZ=UTC                            # 设置时区（如 Asia/Shanghai）
      # 可选：添加其他环境变量，如 FACTORIO_RCON_PASSWORD=your_password

保存为 docker-compose.yml 后，通过以下命令启动：

bash
docker-compose up -d

日志查看

服务器运行日志可通过容器日志直接查看：

bash
docker logs factorio  # 查看当前日志
docker logs -f factorio  # 实时跟踪日志

环境变量配置

通过环境变量可自定义服务器行为，以下是支持的变量列表：

首次启动说明

• 配置文件生成：首次启动时，若 /factorio/config 目录下无配置文件，容器会自动生成默认的 server-settings.json、map-gen-settings.json 等文件，建议启动后编辑这些文件自定义服务器参数（如服务器名称、最大玩家数等）。
• 存档生成：若 /factorio/saves 目录下无存档，服务器会自动生成默认地图（save.zip）。
• RCON 密码：若未通过 FACTORIO_RCON_PASSWORD 设置密码且 RCON.pwd 文件不存在，容器会生成随机密码并保存到 /factorio/config/RCON.pwd，同时输出到启动日志。

可选配置示例

白名单配置（config/server-whitelist.json）

仅允许列表中的用户连接服务器（文件存在时生效）：

json
[
    "user1",
    "user2",
    "user3"
]

封禁列表配置（config/server-banlist.json）

阻止列表中的用户连接服务器：

json
[
    "banneduser1",
    "banneduser2",
    "banneduser3",
    "banneduser4"
]

管理员列表配置（config/server-adminlist.json）

授予列表中的用户管理员权限：

json
[
    "adminuser1",
    "adminuser2"
]

重要注意事项

1. 数据备份：升级镜像前，务必停止容器并备份 /factorio 目录数据，避免版本兼容问题导致数据丢失。
2. 权限调整：若使用自定义 PUID/PGID 或通过 --user 指定用户启动容器，需确保挂载的 /factorio 目录权限对应用户可读写（可通过 chown -R 999:999 ./factorio 调整默认权限）。
3. 安全性：除非特殊需求，禁止设置 RUNAS_UID0=true（以 root 运行），避免扩大***面。
4. 版本兼容性：不同 Factorio 版本存档可能不兼容，升级前请确认版本说明。

相关链接

• https://github.com/goofball222/factorio/blob/main/CHANGELOG.md
• https://github.com/goofball222/factorio/issues
• Factorio 官方论坛

---

许可协议：https://github.com/goofball222/factorio/blob/main/LICENSE
版权所有：2019 The Goofball - ***