```markdown

# Clusterio — 跨服务器管理的未来





![Clusterio Logo](./logo.svg)

[![Discord](https://img.shields.io/badge/Discord-Chat-blue?style=flat-square)](https://discord.gg/5XuDkje)

## 概述

Clusterio 是一款面向开发、支持和游戏的先进集群化 Factorio 服务器管理系统。虽然当前处于2.0版本的Alpha阶段，但上一个稳定版已被废弃且不再受支持。即使在Alpha阶段，Clusterio 现在已经相当稳定，预计在2.0正式发布前不会有重大破坏性的改变。对于新集群的搭建，我们强烈建议您使用2.0 Alpha 版。

### 支持我/该项目的方式：

- 通过代码和文档贡献参与进来。查看[贡献指南](docs/contributing.md)以了解如何提交拉取请求。
- 在[ Patreon ](https://www.patreon.com/danielv123) 或者通过 PayPal（[e-mail]）给予财政支持。

## 功能特性

- **集群化 Factorio 服务器管理**：一键控制多台物理服务器上的 Factorio 实例，统一管理。
- **用户列表同步**：跨服务器的管理员、白名单用户和禁令设置同步。
- **Prometheus 统计数据导出**：提供单一指标端点，将整个集群的统计数据输出给 Prometheus。
- **强大的插件系统**：通过自定义插件为 Factorio 增添跨服功能。

## 插件生态

Clusterio 的核心是其插件系统。它们负责添加 Factorio 服务器或 Clusterio 自身的功能。以下是官方维护的一些插件：

- **全球聊天**（Global Chat）：让所有服务器共享同一个聊天频道。
- **研究同步**（Research Sync）：同步不同服务器间的研发进度和技术解锁。
- **统计导出器**（Statistics Exporter）：收集并输出所有服务器的游戏内统计信息。
- **亚空间存储**（Subspace Storage）：通过传送箱实现跨服务器的物品共享存储。
- **玩家认证**（Player Auth）：提供通过登录 Factorio 服务器的认证机制。
- **库存同步**（Inventory Sync）：保持你在各个服务器中的库存一致。

还有社区开发的插件，如：

- **Discord 桥接**（Discord Bridge）：由 Hornwitser 开发，将游戏内的聊天与 Discord 链接起来。
- **服务器选择**（Server Select）：由 Godmave 原创，Hornwitser 迁移到2.0版本，允许在游戏中选择连接到的其他服务器。

想自己开发插件？查看[编写插件](/docs/writing-plugins.md)文档获取更多信息。

## 安装部署

Clusterio 需要 Node.js 18 及以上版本运行，并通过 npm 分发。提供了自动安装脚本。如果已安装了最新 Node.js，可以按以下步骤进行：

    npm init "@clusterio"

请务必记下安装完成后提供的管理员身份验证令牌，后续会用到。

下面是针对不同操作系统的具体安装方法：

### Ubuntu 安装

1. 安装 Node.js v18 或更高版本。
2. 创建一个新的目录，然后运行 Clusterio 的安装程序。

### Windows 安装

1. 下载并安装最新的 LTS 版本的 Node.js。
2. 创建一个新的空文件夹，打开PowerShell窗口并在该目录中运行命令。

### macOS 安装

1. 从 http://nodejs.org 或使用 Homebrew (`brew install node`) 安装最新 Node.js LTS 版本。
2. 打开终端或命令提示符，在所选目录中运行命令。

### 插件安装

可直接在安装时选择知名插件，无需额外操作。对于非内置插件，执行 `npm install` 来安装插件包，再使用 Clusterio 的 `plugin add` 命令将其添加至系统。

## 控制器配置

默认情况下，控制器会在端口 8080 上监听 HTTP 请求。可以使用以下命令更改端口：

    npx clusteriocontroller config set controller.http_port 1234

当更改端口后，也要更新主机连接的地址。例如：

    npx clusteriohost config set host.controller_url http://localhost:1234/

若打算使控制器对外可用，请设置适当的外部地址。如：

    npx clusteriocontroller config set controller.external_address http://203.0.113.4:1234/

更多配置详情，可运行 `npx clusteriocontroller config list` 查看。

## Factorio 模组管理

Clusterio 目前仅提供手动方式来为服务器添加模组。你可以将模组复制到每个实例的 `mods` 文件夹，或者复制到主安装的 `sharedMods` 文件夹，它会链接/复制模组到同一主机上的每个实例，如果实例的 `mods` 文件夹中尚未存在该模组的话。

---

Clusterio 将跨服务器管理和协作提升到了新的高度，其先进的插件系统和便捷的配置工具使得 Factorio 多服务器管理变得轻松愉快。现在就加入我们的社区，开启您的集群之旅吧！

这是一篇关于 Clusterio 的详细项目推荐，涵盖了项目简介、技术分析、应用场景以及主要特点，旨在吸引用户开始使用这个开源项目。