30款热门AI模型一站整合DeepSeek/GLM/Qwen 随心用限时 5 折。 点击领海量免费额度这次我们来看一个基于 Linux 服务器部署并使用 Mirror 组件实现网络同步的 Unity 游戏项目。这是一个典型的实习作品或毕业设计级别的实战案例核心目标是将一个本地多人游戏通过 Mirror 网络库和 Linux 服务器部署变成一个可远程联机的在线游戏。对于想学习 Unity 网络同步、服务器部署和完整项目上线的开发者来说这是一个非常值得参考的实践路径。项目的核心逻辑并不复杂在 Unity 编辑器内使用 Mirror 网络库处理客户端与服务器之间的数据同步在开发完成后将游戏服务器端程序交叉编译为 Linux 可执行文件并部署到云服务器或本地 Linux 主机上最后玩家运行 Windows 或 Mac 的客户端程序通过网络连接到这台 Linux 服务器进行游戏。整个过程会涉及到 Unity 网络编程、Linux 环境配置、服务端守护进程管理以及网络调试等多个环节。本文将带你完整走通这个流程。我们会先梳理 Mirror 网络同步的核心概念和项目架构然后详细说明如何在 Unity 中集成和测试 Mirror。接着重点讲解如何将服务器端构建为 Linux 版本并部署到 CentOS/Ubuntu 等常见服务器系统上。最后我们会测试客户端与远程服务器的连接并给出常见问题的排查方法。无论你是想完成一个课程设计还是为小型独立游戏搭建联机服务这篇文章都能提供一套可直接复用的方案。1. 核心能力速览在深入细节之前我们先通过一个表格快速了解这个技术方案的核心要点、门槛和能实现的效果。能力项说明项目类型Unity 多人游戏服务器部署方案核心技术栈Unity Engine, Mirror Networking API, Linux Server主要功能游戏状态网络同步、客户端-服务器架构、远程联机硬件门槛服务器端对显卡无要求依赖 CPU 和内存客户端需能运行 Unity 游戏服务器要求推荐 1核2G 及以上配置的云服务器或虚拟机系统为 CentOS 7/Ubuntu 20.04网络要求服务器需有公网 IP 或处于同一内网并开放指定端口如 7777开发环境Unity 2020.3 LTS 或更高版本Visual Studio / VS Code部署方式通过 Unity 构建 Linux 服务器版本使用 SCP 上传通过 systemd 或 screen 守护进程是否支持 API游戏逻辑本身不提供 HTTP API但可通过额外开发实现管理接口是否支持批量任务通常指部署多台游戏服务器实例可通过脚本和容器化技术实现适合场景小型多人联机游戏、毕业设计/实习作品、独立游戏原型测试2. 适用场景与使用边界这个方案最适合以下几类开发者和场景适合谁Unity 初学者到中级开发者希望从单机游戏迈入网络游戏开发理解客户端-服务器模型。学生或实习生需要完成一个包含网络功能的课程设计或实习作品展示完整的上线流程。独立游戏开发者开发了本地多人游戏原型希望快速搭建一个可让朋友远程测试的服务器环境。技术负责人为小团队探索一套轻量、低成本、可控的多人游戏服务器部署方案。能解决什么问题实现基础网络同步解决玩家位置、动作、状态等基础游戏数据在多个客户端间的一致性问题。脱离局域网限制让身处不同网络的玩家能够连接到同一台服务器进行游戏。理解完整部署流程从开发、构建、上传到服务端运维获得全链路实践经验。降低初期成本相比使用成熟的游戏服务器解决方案如 Photon、Unity Netcode for GameObjects 的 Relay 服务自建服务器前期成本更低且完全可控。不适合什么场景大型商业游戏Mirror 作为高层网络库在极端性能、海量玩家同步、复杂反作弊等方面需要大量额外工作大型项目建议评估更专业的解决方案。完全无服务器架构本方案需要你自行维护一台 Linux 服务器。如果你希望完全托管免运维应选择 Unity Relay、Photon Cloud 等 SaaS 服务。实时性要求极高的游戏如硬核竞技 FPS网络延迟和同步精度严重依赖于服务器物理位置和网络质量自建服务器需要优化网络栈和选择优质机房。版权与合规边界游戏内容确保你部署的游戏内容美术、音频、代码拥有合法版权或使用授权。服务器合规如果部署在云服务器上需遵守云服务商的内容政策。不得部署含违法、侵权内容的游戏。用户数据如果游戏涉及用户账号、聊天记录等信息需考虑数据安全和隐私保护法规。网络端口在服务器防火墙和安全组中开放端口时应遵循最小权限原则仅开放游戏服务所需端口。3. 环境准备与前置条件开始之前请确保你的开发环境和目标服务器环境满足以下要求。3.1 开发机环境 (Windows / macOS)Unity Hub Unity Editor: 版本 2020.3 LTS 或更高版本。建议使用 LTS (长期支持) 版本以保证稳定性。从 Unity Hub 中安装时务必勾选Linux Build Support (Mono)模块这是后续构建 Linux 服务器版本的关键。Visual Studio / VS Code: 用于编写和调试 C# 脚本。Unity 安装时会默认推荐安装 Visual Studio。Git(可选): 用于版本管理方便团队协作和代码回溯。网络环境: 开发机需要能正常访问互联网以下载 Unity Package Manager 中的 Mirror 等包。3.2 目标服务器环境 (Linux)操作系统: CentOS 7/8, Ubuntu 20.04/22.04 等常见发行版。本文以Ubuntu 22.04 LTS为例。基础软件:sudo apt update sudo apt upgrade -y(Ubuntu/Debian)sudo yum update -y(CentOS/RHEL)运行依赖: Unity 构建的 Linux 独立程序通常依赖一些基础库。建议安装# Ubuntu/Debian sudo apt install -y libc6-dev libgcc1 libstdc6 # CentOS/RHEL sudo yum install -y glibc libgcc libstdc网络配置:公网 IP: 如果你希望玩家从互联网连接服务器需要拥有公网 IP 地址。防火墙: 确保服务器防火墙如ufw或firewalld开放游戏服务器监听的端口例如默认的 7777。# Ubuntu 使用 ufw 开放 7777 端口 (TCP/UDP) sudo ufw allow 7777/tcp sudo ufw allow 7777/udp sudo ufw reload安全组 (云服务器): 如果你使用的是阿里云、腾讯云等云服务器还需在控制台的安全组规则中添加入站规则允许 TCP/UDP 7777 端口。3.3 Unity 项目初始准备在 Unity Hub 中创建一个新的 3D 或 2D 项目。进入项目后通过Window - Package Manager打开包管理器。点击左上角 “” 号选择 “Add package from git URL...”。输入 Mirror 的 Git URL:https://github.com/vis2k/Mirror.git。等待其下载并导入到项目中。这是最常用的 Mirror 网络库安装方式。4. 在 Unity 项目中集成与测试 Mirror安装好 Mirror 后我们开始构建一个最简单的网络同步示例并先在编辑器内进行本地测试。4.1 创建基础的 Network Manager在场景中创建一个空的 GameObject命名为 “NetworkManager”。选中该对象在 Inspector 面板中点击 “Add Component”搜索并添加Network Manager组件。Mirror 的 NetworkManager 会自动添加Kcp Transport组件作为默认传输层。对于本地测试和后续的 Linux 部署KCP 是一个可靠的选择。4.2 创建一个可同步的玩家预制体创建一个 Cube 或 Capsule命名为 “PlayerPrefab”。为其添加Network Identity组件。勾选 “Local Player Authority”这表示该预制体由对应的客户端控制。为其添加Network Transform组件。这将自动同步该游戏对象的位置、旋转和缩放信息到所有客户端。将这个游戏对象拖入 Project 窗口的 Assets 文件夹将其制作成预制体。回到场景中的 NetworkManager 对象在其Network Manager组件的 “Spawn Info - Player Prefab” 字段中拖入刚刚创建的 PlayerPrefab。4.3 编写简单的玩家移动脚本创建一个名为PlayerMovement.cs的脚本并挂载到 PlayerPrefab 预制体上。using UnityEngine; using Mirror; public class PlayerMovement : NetworkBehaviour { public float moveSpeed 5f; void Update() { // 确保只有本地玩家控制的角色才能执行移动输入 if (!isLocalPlayer) return; float moveX Input.GetAxis(Horizontal) * moveSpeed * Time.deltaTime; float moveZ Input.GetAxis(Vertical) * moveSpeed * Time.deltaTime; transform.Translate(moveX, 0, moveZ); } }这个脚本的关键在于[NetworkBehaviour]和isLocalPlayer判断。它确保了移动逻辑只在本地客户端执行而Network Transform组件会将移动的结果同步给服务器和其他所有客户端。4.4 编辑器内本地测试保存场景例如MainScene。在 NetworkManager 的Network Manager组件中确保 “Offline Scene” 和 “Online Scene” 都设置为你的主场景。点击 Unity 编辑器上的播放按钮。此时第一个运行的游戏实例会作为主机 (Host)同时扮演服务器和第一个客户端。为了模拟第二个玩家我们需要再启动一个游戏实例。在 Unity 编辑器中点击菜单栏的File - Build Settings。点击 “Build And Run”将游戏构建为一个独立的可执行文件例如TestGame.exe并运行它。现在你有两个窗口一个是 Unity 编辑器内的主机一个是独立的客户端。在独立客户端中点击游戏内的 “LAN Client” 或类似的连接按钮Mirror NetworkManager HUD 组件会提供这个UI。你应该能看到两个玩家角色并且可以分别用 WASD 控制观察它们的移动是否同步。这一步的成功验证了你的 Mirror 基础网络同步功能是正常的这是后续部署到 Linux 服务器的前提。5. 构建 Linux 服务器版本在本地测试通过后下一步就是将游戏的服务器部分单独构建为一个 Linux 可执行文件。5.1 配置构建设置在 Unity 编辑器中打开File - Build Settings。在 “Platform” 列表中选择Linux。如果 Linux 选项是灰色的说明你最初安装 Unity 时没有包含 “Linux Build Support (Mono)” 模块需要回到 Unity Hub 添加该模块。在左下角勾选Server Build选项。这个选项至关重要它会构建一个没有图形界面、专用于作为专用服务器运行的游戏版本。点击 “Player Settings...”在打开的 Inspector 中找到 “Resolution and Presentation” 部分确保 “Fullscreen Mode” 设置为 “Windowed” 或 “Exclusive Fullscreen” 对于服务器来说影响不大但最好设为窗口化。回到 Build Settings 窗口点击 “Build”。选择一个输出目录例如Builds/LinuxServer并为可执行文件命名如MyGameServer.x86_64。Unity 会开始构建过程。5.2 理解构建产物构建完成后在输出目录如Builds/LinuxServer中你会看到类似以下结构的文件MyGameServer.x86_64 # 主可执行文件 MyGameServer_Data/ # 包含游戏资源、库文件等 UnityPlayer.so # Unity 运行时库 ...这个文件夹包含了在 Linux 系统上运行游戏服务器所需的所有文件。你需要将整个文件夹上传到你的 Linux 服务器。6. 部署到 Linux 服务器我们将使用 SCP 命令将构建好的文件上传到服务器并配置一个守护进程来保持服务器稳定运行。6.1 上传文件到服务器在本地开发机的终端或 PowerShell/Git Bash中使用scp命令进行上传。# 将整个构建文件夹上传到服务器用户主目录下的 game_server 文件夹 # 替换 YOUR_SERVER_IP 为你的服务器公网IP /path/to/Builds/LinuxServer 为你的本地路径 scp -r /path/to/your/local/Builds/LinuxServer userYOUR_SERVER_IP:~/game_server/输入服务器密码后文件开始传输。如果文件较多传输可能需要一些时间。6.2 在服务器上配置和运行通过 SSH 连接到你的 Linux 服务器。ssh userYOUR_SERVER_IP1. 进入目录并赋予执行权限cd ~/game_server/LinuxServer chmod x MyGameServer.x86_642. 首次测试运行直接运行可执行文件检查是否有缺少依赖库等错误。./MyGameServer.x86_64 -batchmode -nographics-batchmode: 以批处理模式运行不弹出任何对话框。-nographics: 不初始化图形设备对于无界面的服务器环境是必须的。如果运行成功你应该能看到 Unity 的日志输出并且服务器开始监听网络端口默认可能是 7777。按CtrlC可以停止服务器。3. 使用 systemd 创建守护进程推荐为了让服务器在后台稳定运行并在系统重启后自动启动我们使用 systemd。 创建一个服务配置文件sudo nano /etc/systemd/system/my-unity-game.service将以下内容粘贴进去注意修改ExecStart的路径和User[Unit] DescriptionMy Unity Game Server Afternetwork.target [Service] Typesimple # 替换为你的实际用户名和路径 Useryour_username WorkingDirectory/home/your_username/game_server/LinuxServer ExecStart/home/your_username/game_server/LinuxServer/MyGameServer.x86_64 -batchmode -nographics Restarton-failure RestartSec10 StandardOutputjournal StandardErrorjournal # 可选设置进程可用的内存限制等 # LimitNOFILE65536 [Install] WantedBymulti-user.target保存并退出编辑器在 nano 中按CtrlX, 然后Y, 然后回车。4. 启动并启用服务# 重新加载 systemd 配置 sudo systemctl daemon-reload # 启动服务 sudo systemctl start my-unity-game # 设置开机自启 sudo systemctl enable my-unity-game # 查看服务状态和日志 sudo systemctl status my-unity-game sudo journalctl -u my-unity-game -f如果状态显示为active (running)并且日志中没有报错说明你的 Unity 游戏服务器已经在 Linux 上成功运行了7. 客户端连接远程服务器测试服务器部署好后最后一步是让客户端程序连接到它。7.1 构建 Windows/Mac 客户端回到 Unity 编辑器打开File - Build Settings。将平台切换回PC, Mac Linux Standalone并选择你的目标平台如 Windows。务必取消勾选 “Server Build”。点击 “Build”生成客户端可执行文件例如MyGameClient.exe。7.2 修改客户端连接地址默认情况下Mirror NetworkManager HUD 或你的连接脚本可能连接的是localhost。你需要修改代码让客户端能够指定要连接的服务器 IP 地址。 一个简单的方法是修改你的连接 UI 脚本或者直接修改 NetworkManager HUD 的networkAddress字段。 例如创建一个简单的连接管理器脚本using UnityEngine; using Mirror; using UnityEngine.UI; public class CustomNetworkHUD : MonoBehaviour { public NetworkManager networkManager; public InputField addressInput; // 在UI中拖入一个InputField组件 public void StartHostButton() { networkManager.StartHost(); } public void StartClientButton() { // 从输入框获取服务器地址如果为空则使用默认地址 if (!string.IsNullOrEmpty(addressInput.text)) { networkManager.networkAddress addressInput.text; } networkManager.StartClient(); } public void StopButton() { networkManager.StopHost(); } }将这个脚本挂载到 Canvas 下的一个空对象上并将 NetworkManager 对象和 UI InputField 拖拽赋值。7.3 进行连接测试运行你刚刚构建的 Windows 客户端程序。在地址输入框中输入你的Linux 服务器的公网 IP 地址。点击 “Client” 或 “连接” 按钮。观察客户端日志和服务器日志 (sudo journalctl -u my-unity-game -f)。如果连接成功你将在服务器日志中看到客户端连接的信息并且在游戏场景中看到玩家角色生成。恭喜至此你已经完成了一个 Unity 游戏从本地开发、网络同步到 Linux 服务器部署、远程客户端连接的完整闭环。8. 资源占用与性能观察对于自建游戏服务器监控其资源使用情况至关重要这关系到服务器的稳定性和能承载的玩家数量。8.1 服务器端资源监控在 Linux 服务器上可以使用以下命令进行监控查看进程与 CPU/内存占用:top -p $(pgrep -f MyGameServer)或者使用更直观的htop需安装。查看网络连接:# 查看游戏服务器进程占用的端口和连接状态 sudo netstat -tulpn | grep :7777 # 或使用 ss 命令 sudo ss -tulpn | grep :7777查看日志实时输出:sudo journalctl -u my-unity-game -f8.2 性能影响因素玩家数量: Mirror 的同步开销与活跃的游戏对象数量成正比。玩家越多需要同步的数据量越大服务器 CPU 和网络带宽消耗越高。同步频率: 在Network Transform等组件上可以设置同步间隔。降低频率可以减少网络流量但会降低同步平滑度。游戏逻辑复杂度: 服务器上运行的游戏逻辑如 AI 计算、物理模拟会消耗 CPU 资源。网络延迟: 物理距离和网络路由会影响客户端与服务器之间的延迟Ping值这是影响游戏体验的关键因素。对于实习作品或小型游戏一台 1核2G 的云服务器通常可以支撑 10-20 名玩家同时在线进行基础同步。具体容量需要通过压力测试来确定。9. 常见问题与排查方法部署过程中难免会遇到问题下表列出了常见问题及其解决方法。问题现象可能原因排查方式解决方案构建 Linux 版本时无 Linux 选项Unity 安装时未包含 Linux 构建支持模块。检查 Unity Hub 中已安装编辑器的模块列表。在 Unity Hub 中找到对应编辑器版本点击设置齿轮图标选择 “Add Modules”勾选 “Linux Build Support (Mono)”完成安装。服务器程序运行后立即退出缺少运行依赖库或程序在-batchmode下遇到致命错误。1. 在服务器上直接运行./MyGameServer.x86_64查看终端输出错误信息。2. 检查MyGameServer_Data/Player.log文件。1. 根据错误信息安装缺失的库如libicu。2. 确保命令行参数正确游戏初始场景设置无误。客户端无法连接到服务器1. 服务器防火墙/安全组未开放端口。2. 服务器程序未成功监听端口。3. 客户端连接地址错误。1. 在服务器本地运行sudo ss -tulpn | grep :7777检查端口监听状态。2. 从服务器本地使用telnet 127.0.0.1 7777测试端口是否可达。3. 从客户端网络使用telnet 服务器公网IP 7777测试。1. 配置防火墙和安全组开放 TCP/UDP 7777 端口。2. 检查服务器日志确认 NetworkManager 已启动并监听。3. 确认客户端输入的 IP 地址和端口号正确。连接成功但玩家不同步1. 玩家预制体未正确设置 Network Identity 和 Network Transform。2. 移动等脚本未正确判断isLocalPlayer。3. 服务器和客户端版本不一致。1. 检查服务器和客户端的日志看是否有生成玩家预制体的错误。2. 在编辑器中用两个实例进行本地 LAN 测试验证同步逻辑。1. 确保预制体在 NetworkManager 的 Spawn Prefabs 列表中注册或通过代码正确生成。2. 确保控制移动的脚本继承了NetworkBehaviour并使用了if (!isLocalPlayer) return;。3. 确保服务器和客户端是从同一代码版本、同一 Unity 项目构建的。服务器运行一段时间后崩溃内存泄漏逻辑错误导致异常系统资源不足。1. 使用top或htop观察崩溃前内存和 CPU 使用趋势。2. 查看journalctl -u my-unity-game --since “1 hour ago”获取崩溃前的详细日志。1. 检查代码中是否有未销毁的动态生成对象。2. 增加服务器虚拟内存Swap。3. 使用Restarton-failure的 systemd 配置可让服务自动重启。systemd 服务启动失败ExecStart 路径错误文件权限不足依赖服务未启动。使用sudo systemctl status my-unity-game查看详细错误信息。1. 检查ExecStart和WorkingDirectory的路径是否正确确保User有权限访问。2. 使用chmod x确保可执行文件有执行权限。3. 确保Afternetwork.target使得服务在网络就绪后启动。10. 最佳实践与使用建议为了让你的项目更健壮、更易于维护可以参考以下建议版本控制与自动化构建将整个 Unity 项目排除 Library、Temp 等文件夹纳入 Git 管理。考虑使用 CI/CD 工具如 GitHub Actions, Jenkins自动化构建 Linux 服务器版本和客户端版本确保每次部署的版本一致。配置文件化将服务器监听端口、最大玩家数、游戏模式等参数提取到外部配置文件如server_config.json中。这样无需重新构建只需修改配置文件和重启服务即可调整参数。日志分级与轮转Unity 的Debug.Log在服务器上会输出到标准输出或日志文件。建议对日志进行分级Info, Warning, Error并使用 Linux 的logrotate工具配置日志轮转避免日志文件无限增大占满磁盘。监控与告警对于正式运营的小型游戏可以配置简单的监控。例如使用crontab定时任务检查游戏进程是否存在如果不存在则重启服务并发送邮件或钉钉告警。安全加固非 root 用户运行如上文所述使用 systemd 服务时务必指定一个普通用户来运行游戏进程降低安全风险。最小化开放端口只开放游戏服务必需的端口如 7777并考虑使用非默认端口。定期更新系统定期对 Linux 系统执行安全更新sudo apt update sudo apt upgrade -y。备份与回滚在每次重大更新前备份服务器上的游戏可执行文件和数据目录。如果新版本出现问题可以快速回滚到旧版本。通过这个基于 Linux 服务器部署的 Mirror 网络同步 Unity 游戏项目你不仅掌握了一套可用的技术方案更重要的是走通了一个完整的“开发-构建-部署-运维”流程。这套流程是游戏后端开发的基础无论是用于个人作品展示还是作为更复杂项目的起点都具有很高的实践价值。建议在成功部署基础版本后尝试加入房间系统、玩家匹配、数据库存储如玩家分数等更高级的功能来不断完善你的作品。 30款热门AI模型一站整合DeepSeek/GLM/Qwen 随心用限时 5 折。 点击领海量免费额度