FunMC e73c8e536e feat: v1.1.0 全平台客户端打包 + 详细服务端部署教程
Client:
- 支持 Windows (NSIS安装包+免安装版), macOS (DMG x64/arm64), Linux (AppImage+deb)
- 添加 dist:win / dist:mac / dist:linux / dist:all 打包脚本
- 生成应用图标 (icon.png + icon.ico)
- Windows x64 安装包已编译: release/FunConnect-1.1.0-Win-x64.exe
- 更新 README 包含完整的跨平台构建指南和国内镜像加速说明

Server:
- 新增 DEPLOY.md 详细部署教程 (400+行)
  - Ubuntu主节点完整部署流程
  - 工作节点部署和注册
  - Web管理面板生产部署
  - 防火墙配置
  - Nginx反向代理配置
  - SSL证书(Let's Encrypt)配置
  - 多节点集群架构说明
  - 运维管理命令和监控
  - 常见问题排查
  - 快速部署清单
2026-02-23 08:02:08 +08:00

FunConnect - Minecraft 联机平台

一个支持多节点中继的 Minecraft 联机平台让玩家无需公网IP即可轻松联机。

本仓库包含 两个独立项目,可分别独立开发、部署和运行。

项目结构

FunConnect/
├── server/        # 服务端(中继服务器 + Web 管理面板 + 部署脚本)
└── client/        # 客户端Electron 桌面应用)

服务端 (server/)

中继服务器 + Web 管理面板,部署在 Ubuntu 服务器上。

  • TCP 中继引擎 - 转发 Minecraft 流量,支持 Java 版和基岩版
  • 多节点集群 - 主节点 + 工作节点架构,水平扩展
  • 房间系统 - 创建/加入/密码保护/过期清理
  • 流量监控 - 实时统计各房间流量
  • Token 认证 - 保护写操作 API
  • Web 管理面板 - React + TailwindCSS 可视化管理
  • 一键部署 - Ubuntu 自动安装脚本 + systemd 服务
cd server
npm install
cp .env.example .env
npm run dev

详细文档见 server/README.md

客户端 (client/)

Electron 跨平台桌面客户端,支持 Windows / macOS / Linux。

  • 连接服务器 - 输入中继地址一键连接
  • 房间管理 - 浏览/创建/加入联机房间
  • 本地代理 - 自动建立本地代理MC 添加 127.0.0.1:25566 即可联机
  • 设置持久化 - 记住服务器地址、玩家名等偏好
  • 系统托盘 - 最小化到托盘后台运行
cd client
npm install
npm run dev

详细文档见 client/README.md

架构

┌───────────────┐       ┌──────────────────────────┐
│  FunConnect   │  TCP  │     中继服务器 (Ubuntu)     │
│  桌面客户端    │◄─────►│  server/ 项目独立部署       │
│  client/      │       │  ┌─────────┐ ┌──────────┐ │
└───────────────┘       │  │ TCP中继  │ │ REST API │ │
                        │  └─────────┘ └──────────┘ │
┌───────────────┐       │  ┌──────────────────────┐ │
│  Minecraft    │  TCP  │  │    Web 管理面板        │ │
│  游戏客户端    │◄─────►│  │    (React + Vite)    │ │
└───────────────┘       │  └──────────────────────┘ │
                        └──────────────────────────┘

License

MIT

Description
No description provided
Readme MIT 734 KiB
Languages
TypeScript 52.9%
Rust 27.2%
Shell 6.7%
PowerShell 4.2%
CSS 3.7%
Other 5.2%