dtandersen/factorio

Factorio

• 0.17.33, 0.17, latest https://github.com/dtandersen/docker_factorio_server/blob/master/0.17/Dockerfile
• 0.16.51, 0.16, stable https://github.com/dtandersen/docker_factorio_server/blob/master/0.16/Dockerfile
• 0.15.40, 0.15 https://github.com/dtandersen/docker_factorio_server/blob/master/0.15/Dockerfile
• 0.14.23, 0.14 https://github.com/dtandersen/docker_factorio_server/blob/master/0.14/Dockerfile
• 0.13.20, 0.13 https://github.com/dtandersen/docker_factorio_server/blob/master/0.13/Dockerfile

标签说明

• latest - 最新版本（可能为实验性版本）
• stable - Factorio官网factorio.com声明的稳定版本
• 0.x - 对应分支的最新版本
• 0.x.y - 特定版本
• 0.x-dev - 对应分支master分支的开发版本

什么是Factorio？

Factorio是一款建造和维护工厂的游戏。你需要开采资源、研究技术、搭建基础设施、自动化生产并对抗敌人。发挥想象力设计工厂，将简单元素组合成巧妙结构，运用管理技能维持运转，并保护工厂免受不友好生物的***。游戏稳定且针对大型工厂优化，支持自定义地图、Lua mod编写和多人联机。注意：此镜像仅包含服务器，游戏本体需从factorio.com或Steam获取。

使用方法

快速启动

运行服务器以创建必要的文件夹结构和配置文件。以下示例将数据存储在/opt/factorio：

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

选项说明：

• -d - 后台运行
• -p - 暴露端口
• -v - 挂载本地/opt/factorio到容器内/factorio
• --restart - 崩溃或系统启动时自动重启
• --name - 容器命名为factorio（避免随机名称）

chown命令用于设置权限：0.16+版本中服务器以用户ID 845的factorio用户运行，需确保本地目录可被该用户写入。

查看日志：

bash
docker logs factorio

停止服务器：

bash
docker stop factorio

修改/opt/factorio/config/server-settings.json配置后重启：

bash
docker start factorio

控制台操作

以交互模式启动服务器，使用docker attach进入控制台执行命令：

bash
docker run -d -it \
  --name factorio \
  dtandersen/factorio
docker attach factorio

版本升级

升级前备份存档（客户端可直接创建存档）。确保使用-v挂载数据卷（否则存档会随容器删除丢失）：

bash
docker stop factorio
docker rm factorio
docker pull dtandersen/factorio
# 重新运行服务器（使用之前的命令）

存档管理

首次启动会生成_autosave1.zip存档，使用map-gen-settings.json和map-settings.json配置地图。后续启动将加载最新存档。

• 加载旧存档：停止服务器，执行touch oldsave.zip（重置修改时间）后重启。
• 生成新地图：停止服务器，删除所有存档后重启。

Mod支持

将Mod文件复制到mods文件夹后重启服务器。

场景启动

从场景启动（而非存档）需使用替代入口点：

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

场景转地图

将场景导出为存档：

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

重启服务器将加载生成的存档。

RCON配置

在rconpw文件中设置RCON密码（未存在则生成随机密码）。修改密码需停止服务器后编辑文件并重启。若不暴露27015端口则RCON无法被外部访问。

白名单（0.15.3+）

创建config/server-whitelist.json：

json
["you", "friend"]

黑名单（0.17.1+）

创建config/server-banlist.json：

json
["bad_person", "other_bad_person"]

管理员列表（0.17.1+）

创建config/server-adminlist.json：

json
["you", "friend"]

自定义配置（0.17.x+）

使用envsubst通过环境变量动态生成配置文件。示例docker-compose.yml：

yaml
factorio_1:
  image: dtandersen/factorio
  ports:
    - "34197:34197/udp"
  volumes:
   - /opt/factorio:/factorio
   - ./server-settings.json:/server-settings.json
  environment:
    - INSTANCE_NAME=你的服务器名称
    - INSTANCE_DESC=你的服务器描述
  entrypoint: /bin/sh -c "mkdir -p /factorio/config && envsubst < /server-settings.json > /factorio/config/server-settings.json && exec /docker-entrypoint.sh"

server-settings.json中使用变量：

json
"name": "${INSTANCE_NAME}",
"description": "${INSTANCE_DESC}"

容器细节

数据卷

容器使用单个数据卷/factorio存储配置、Mod和存档，目录需属于UID 845的factorio用户：

factorio
├── config
│   ├── map-gen-settings.json
│   ├── map-settings.json
│   ├── rconpw
│   ├── server-adminlist.json
│   ├── server-banlist.json
│   ├── server-settings.json
│   └── server-whitelist.json
├── mods
│   └── fancymod.zip
└── saves
    └── _autosave1.zip

Docker Compose

创建docker-compose.yml：

yaml
version: '2'
services:
  factorio:
    image: dtandersen/factorio
    ports:
     - "34197:34197/udp"
     - "27015:27015/tcp"
    volumes:
     - /opt/factorio:/factorio

运行：

bash
sudo mkdir -p /opt/factorio
sudo chown 845:845 /opt/factorio
sudo docker-compose up -d

端口

• 34197/udp - 游戏服务器（必需）
• 27015/tcp - RCON（可选）

环境变量

• PORT（0.15+）- 自定义游戏端口，如-e "PORT=34198"
• RCON_PORT（0.16+）- 自定义RCON端口，如-e "RCON_PORT=34198"

LAN游戏

设置server-settings.json中lan为true：

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

使用--network=host启动容器：

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

故障排除

• 服务器在浏览器中显示但无法连接：检查日志是否有Own address is RIGHT IP:WRONG PORT，可能是Docker代理问题。需将Docker服务启动参数设为--userland-proxy=false。
• 非默认端口无法从浏览器连接：使用PORT环境变量指定端口，如-e "PORT=34198"。

贡献者

• https://github.com/dtandersen/docker_factorio_server - 维护者
• https://github.com/Fankserver/docker-factorio-watchdog - Factorio版本更新监控
• https://github.com/DBendit/docker_factorio_server - 管理员列表、黑名单、版本更新
• https://github.com/zopanix/docker_factorio_server - 原始作者
• https://github.com/Rfvgyhn/docker-factorio - RCON随机密码生成
• https://github.com/gnomus/docker_factorio_server - 白名单支持
• https://github.com/bplein/docker_factorio_server - 场景支持
• https://github.com/jaredledvina/docker_factorio_server - 版本更新