jaffa/factorio

Factorio服务器Docker镜像

镜像概述

本镜像为Factorio游戏的Docker服务器镜像，基于dtandersen/factorio分叉，支持多个稳定版本（如0.17、0.16等），用于快速搭建Factorio多人联机游戏服务器，提供自动配置、存档管理、Mod支持等功能，便于用户部署和维护游戏环境。

核心功能

• 多版本支持：提供latest（最新实验版）、stable（稳定版）及各分支版本（如0.17.x）；
• 存档管理：自动生成存档，支持自定义地图设置，可加载旧存档或生成新地图；
• Mod支持：通过挂载Mod目录即可加载游戏Mod；
• 远程控制：支持RCON协议，可设置密码进行远程管理；
• 权限管理：支持白名单、黑名单、管理员列表配置；
• 场景支持：可启动自定义场景或转换场景为常规地图；
• 灵活部署：支持Docker run、Docker Compose等方式部署，适配LAN局域网游戏。

使用场景

1. 搭建私人多人游戏服务器，与好友联机游玩；
2. 部署公共游戏服务器，供玩家加入；
3. 测试自定义Mod或场景的游戏环境；
4. LAN局域网内快速搭建游戏服务器，无需复杂配置。

配置说明

快速启动

1. 创建数据目录并设置权限：

bash
sudo mkdir -p /opt/factorio
sudo chown 845:845 /opt/factorio

2. 启动服务器：

bash
sudo docker run -d \
  -p 34197:34197/udp \
  -p 27015:27015/tcp \
  -v /opt/factorio:/factorio \
  --name factorio \
  --restart=always \
  jaffa/factorio

参数说明：

• -d：后台运行；
• -p：映射游戏端口（34197/udp）和RCON端口（27015/tcp）；
• -v：挂载本地数据目录到容器内，保存配置、存档和Mod；
• --restart：自动重启容器；
• --name：指定容器名称。

控制台操作

启动交互式容器并连接控制台：

bash
docker run -d -it --name factorio docker.xuanyuan.run/jaffa/factorio
docker attach factorio

按Ctrl+P+Q退出附着模式（不停止容器）。

升级服务器

1. 停止并删除旧容器：

bash
docker stop factorio
docker rm factorio

2. 拉取最新镜像：

bash
docker pull docker.xuanyuan.run/jaffa/factorio

3. 重新启动服务器（使用原命令）。

存档管理

• 首次启动自动生成_autosave1.zip存档；
• 修改/opt/factorio/config/map-gen-settings.json和map-settings.json可自定义地图生成；
• 加载旧存档：停止服务器，将旧存档放入/opt/factorio/saves目录，重启即可。

Mod安装

将Mod文件（.zip格式）放入/opt/factorio/mods目录，重启服务器即可加载。

场景启动

启动自定义场景：

bash
docker run -d \
  -p 34197:34197/udp \
  -p 27015:27015/tcp \
  -v /opt/factorio:/factorio \
  --name factorio \
  --restart=always \
  --entrypoint "/scenario.sh" \
  docker.xuanyuan.run/jaffa/factorio \
  MyScenarioName

RCON设置

• 容器启动时自动生成/opt/factorio/config/rconpw文件（随机密码）；
• 修改密码：停止服务器，编辑rconpw文件，重启即可；
• 禁用RCON：启动时不映射27015/tcp端口。

权限配置

• 白名单：创建/opt/factorio/config/server-whitelist.json，添加用户列表；
• 黑名单：创建/opt/factorio/config/server-banlist.json，添加用户列表；
• 管理员列表：创建/opt/factorio/config/server-adminlist.json，添加用户列表。

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '2'
services:
  factorio:
    image: docker.xuanyuan.run/jaffa/factorio
    ports:
      - "34197:34197/udp"
      - "27015:27015/tcp"
    volumes:
      - /opt/factorio:/factorio
    restart: always

启动服务：

bash
sudo docker-compose up -d

端口说明

• 34197/udp：游戏服务器端口（必填）；
• 27015/tcp：RCON端口（可选）。

环境变量

• PORT：自定义游戏服务器端口（如-e PORT=34198）；
• RCON_PORT：自定义RCON端口（如-e RCON_PORT=34198）。

LAN游戏设置

1. 修改/opt/factorio/config/server-settings.json中的visibility配置：

json
"visibility": {
  "public": false,
  "lan": true
}

2. 使用host网络启动容器：

bash
sudo docker run -d \
  --network=host \
  -v /opt/factorio:/factorio \
  --name factorio \
  --restart=always \
  jaffa/factorio