IriX（X Minecraft Server Launcher）

Minecraft 服务器管理工具。Flutter 构建跨平台 UI，Rust 提供高性能底层支持（压缩、下载、HTTP、数据库、编排、NBT、日志），覆盖实例管理、核心下载、插件市场、备份压缩、文件管理、内网穿透、节点与集群编排、远程数据库、NBT 编辑与 AI 助手等完整工作流。

AI作品轻喷

功能

• 服务器实例管理 —— 创建、导入、配置多个 Minecraft 服务端实例，一键启停
• 核心下载 —— 从 MSL API 获取 Paper、Purpur、Folia 等服务端核心
• 插件 & Mod 市场 —— 浏览和安装 Modrinth / Hangar 上的资源，支持关键词搜索与版本筛选
• 节点管理 —— 统一管理 MCSManager 面板与 IriX 本地 Go 守护进程节点，支持控制台 WebSocket、实例快照、Java 运行时、回收站、FRP、账户与集群等新 API
• 集群编排 —— K8s 风格的 MC 服务器编排引擎（Rust orchestrator）：期望状态对账、崩溃自愈、按在线人数弹性扩缩容、跨物理机存档迁移
• 配置文件编辑器 —— 内置 YAML 语法高亮、行号、撤销/重做、注释说明
• 文件管理器 —— 本地与远程文件树的复制、粘贴、移动、重命名，含回收站（7 天自动清理）
• 备份 & 压缩 —— Rust 驱动的 ZIP 并行压缩与解压，支持大文件流式下载（分片 + 断点续传）
• NBT 编辑器 —— 复刻 AnkiNBT 的通用树 / 物品 / 实体 / 村民交易四领域双模式（高级树 + 简易字段）编辑，支持文件与 RCON 连接运行中服务器，Rust 实现 gzip 大端二进制 ↔ SNBT 双向编解码
• 内网穿透 —— 集成 OpenFrp、SakuraFrp、HayFrp、ChmlFrp、OFrp 与自建 frps 等隧道服务
• 远程数据库管理 —— 连接 MySQL / MariaDB / PostgreSQL / Redis（Rust 驱动，无 OpenSSL），浏览库表并执行查询
• AI 助手 —— 本地 Ollama 对话，内置 MCP 服务器（可查看/操作实例、备份等）
• 知识库（RAG） —— 导入 .txt/.md 文档，向量存入远程 Milvus 库，AI 对话自动检索相关内容作答
• 开发者模式 —— 开发者日志（devlog）全量落盘，记录运行日志流、操作轨迹、网络明细与崩溃堆栈
• 多语言 —— 简体中文 / English（gen-l10n）
• 暗色主题 —— 全局暗色 UI

技术栈

层	技术
UI	Flutter 3.x, Provider
网络	ureq + rustls（Rust，Dart 侧禁用 package:http）
存储	SQLite（sqflite_common_ffi），无 SharedPreferences
压缩	flate2 (zlib-ng) + crc32fast, rayon 并行
文件操作	walkdir, serde_json, Rust FFI
远程数据库	Rust mysql / postgres / redis 驱动（db_client FFI）
知识库	milvus-sdk-rust（vector_store FFI，远程 Milvus 存取与相似检索）；embedding 由 Rust HTTP 调 AI 模型 API 生成（Dart 侧组装请求）
NBT	纯 Rust 编解码（gzip 大端二进制 + SNBT，nbt FFI）
编排	orchestrator crate（K8s 风格期望状态对账、弹性扩缩容、跨机迁移）
开发者日志	devlog crate（后台线程全量落盘）

构建

前置条件

• Flutter SDK >= 3.12
• Rust 工具链（rustc, cargo）
• Windows：Visual Studio 2022（C++ 桌面开发）
• macOS：Xcode 15+
• Linux：GTK 3, CMake

步骤

# 1. 编译 Rust 动态库（workspace 一次编译全部 crate）
cargo build --release --manifest-path rust/Cargo.toml
# 或 Windows 下双击 build_rust.bat，Linux/macOS 运行 ./build_rust.sh
# （脚本会自动复制产物到 windows/runner/、linux/、macos/）

# 2. 获取 Flutter 依赖
flutter pub get

# 3. 运行
flutter run

测试

flutter test            # FFI 集成测试（*_ffi_test.dart）需先编译并复制 Rust 动态库
flutter test test/knowledge_ffi_test.dart   # 只跑单个 FFI 测试

构建发行版

# Windows (.exe)
flutter build windows --release

# macOS (.app)
flutter build macos --release

# Linux
flutter build linux --release

项目结构

irix/
├── lib/                     # Flutter 应用层
│   ├── main.dart
│   ├── l10n/                # 多语言（简体中文 / English，gen-l10n）
│   ├── models/              # 数据模型（实例、节点、市场、远程）
│   ├── screens/             # 页面（首页、节点、集群、市场、文件、配置、FRP、AI、数据库、NBT 编辑器等）
│   ├── services/            # API 服务与 FFI 封装（Modrinth、Hangar、MSL、节点、FRP、备份、知识库等）
│   ├── state/               # 状态管理（AppState、NodeState）
│   ├── utils/               # 工具（语法高亮、命名、Apple 风格组件等）
│   ├── widgets/             # 通用组件
│   └── data/                # 静态数据（配置注释说明、服务端核心）
├── rust/                    # Rust 原生库（FFI 动态库）
│   ├── backup/              # ZIP 并行压缩
│   ├── downloader/          # HTTP 流式/分片下载（断点续传）
│   ├── http_client/         # 通用 HTTP 请求（ureq + rustls）
│   ├── file_ops/            # 文件扫描、移动、回收站
│   ├── db_client/           # 远程数据库客户端（MySQL/MariaDB/PostgreSQL/Redis）
│   ├── vector_store/        # 向量知识库（milvus-sdk-rust，远程 Milvus）
│   ├── orchestrator/        # K8s 风格 MC 服务器编排引擎
│   ├── nbt/                 # NBT 编解码与树编辑
│   ├── devlog/              # 开发者日志落盘
│   └── logger/              # 日志
├── windows/                 # Windows 平台代码
├── macos/                   # macOS 平台代码
├── linux/                   # Linux 平台代码
└── test/                    # 测试

打包

使用 Fastforge 进行各平台打包：

# Windows MSIX
fastforge config --platform windows --format msix

# macOS DMG
fastforge config --platform macos --format dmg

# Linux (AppImage / deb / rpm)
fastforge config --platform linux --format appimage

各平台打包配置位于对应 dist 目录下。

许可

MIT License, Copyright (c) 2026 MCFSO