快速入门指南

# 快速入门指南

本指南将带你从一台全新的机器完成 LarkXR 4.0 的完整部署并投入使用。请按顺序执行以下步骤，每一步都建立在前一步的基础上。

开始之前，请确认本机已满足硬件和软件要求。

## 步骤 1 — 下载并解压安装包

前往官方下载页面：https://www.pingxingyun.com/devCenter.html#devDL

下载 LarkXR 4.0 安装包。

将压缩包解压到任意位置。

建议：解压到磁盘根目录，而不是深层用户目录，例如 `D:\LarkXR`。路径过深、包含空格或非 ASCII 字符，可能导致服务启动失败。

## 步骤 2 — 启动应用

打开解压后的文件夹，双击 `LarkXRLauncher.exe`。

LarkXR 4.0 启动器会打开并进入仪表盘（Dashboard），显示登录面板以及五项核心服务——MySQL、Nginx、Admin、Agent 和 Render——初始状态均为已停止（Stopped）。

## 步骤 3 — 选择授权方式
LarkXR 4.0 支持两种授权方式，请根据部署场景选择其一。

### 方式 A — 订阅登录（在线授权）
1. 在左侧边栏进入「管理端配置」，将「授权类型」选择为「订阅」，点击「保存配置」。 
<img width="600px" src="https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/26/180c1b6541c2487ba9bec67b95a77942.png">

1. 在仪表盘点击「登录」，再点击「注册」。系统会用默认浏览器打开 LarkXR 4.0 平台。
<img width="600px" src="https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/18/74bbac1b69734c8b86ff5c9e8a9788b5.png">

请选择以下两种注册方式之一。

#### 方式 1 — 使用 微信 登录（最快）

在「登录」页签点击「使用 微信 登录」。若此前未注册过，系统会自动创建账号并完成登录，无需单独注册。
<img width="600px" src="https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/25/b6dfd780f0754a85804c9e2057faf1d3.png">

#### 方式 2 — 使用手机号注册

切换到「注册」页签并填写表单：手机号、图形验证码、手机验证码（点击「获取验证码」）以及密码。点击「注册」完成。
<img width="600px" src="https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/25/5d10e10c2eb643758ef12b9935986a1c.png">

#####  注册即赠送 7 天试用

> 在平台打开「个人资料」，查看当前权益，可以直接订阅或者更换档位。
> 
> 更换档位选择套餐以及 CCU 档位。若需求超出所列档位，请使用「需要更多？联系销售」。
> <img width="600px" src="https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/25/ca9a3740eca242d4a7b769a696073bb6.png"><img width="600px" src="https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/25/fcfe8b1df08b4093a8aa7f88660ef2e9.png">
>

### 方式 B — 离线授权码

适用于内网离线部署，无需在启动器中登录在线账号。

1. 在左侧边栏进入「管理端配置」，将「授权类型」选择为「授权码」，点击「保存配置」。 
<img width="600px" src="https://docs.pingxingyun.com/media/202608/658bea5fdf4e47409bd789fe1f0f8f817629.png">
3. 按步骤 6–10 完成环境检测、保存各项配置并启动全部服务。
4. 打开浏览器，访问 http://localhost:8182， 使用默认凭据登录管理控制台（见步骤 9）。
5. 进入「系统设定」，在「授权方式」中填写本地授权码并保存。
<img width="600px" src="https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/21/2bd0b4afcbac447493cc48e820761193.png">
说明：离线授权码需向 LarkXR 官方或销售获取。填写并保存后，管理控制台左下角会显示许可证类型与状态。

## 步骤 4 — 运行环境检测

在左侧边栏进入「设置」，点击「运行检测」。

启动器会校验每一项前置组件：

| 检测项 | 校验内容 |
| --- | --- |
| VC++ Redistributable | 【强制】确认已安装 Visual C++ 运行库，应用运行的基础依赖 |
| DirectX Runtime | 【可选】确认 DirectX 运行时已安装，应用部分功能可能依赖该组件 |
| Virtual Audio Device Endpoint Count |【可选】虚拟音频设备端点数量校验；应用使用音频能力时该条件强制生效。应用输出音频占用 1 路端点，语音输入会额外占用 1 路端点 |
| SteamVR Path | 【可选】检测 SteamVR 已安装且可正常寻址； VR/AR 推流时为强制依赖 |
| 防火墙 |【强制】防火墙规则允许 LarkXR 4.0 的网络流量通行 |

## 步骤 5 — 管理端配置

在左侧边栏进入「管理端配置」。

在「本机 IP」下拉框中，选择希望 LarkXR 4.0 后端对外可达的子网地址。列表包含本机检测到的全部网卡，包括虚拟网卡。

选择正确的地址：请选择物理局域网子网地址（通常为 `192.168.x.x` 或 `10.x.x.x`）。避免选择虚拟网卡地址（`169.254.x.x` 链路本地地址，以及 Hyper-V、VirtualBox 或 WSL 网卡）——局域网中的客户端无法访问这些地址。

除非部署另有要求，请将「服务端口」、「数据库 IP」、「数据库端口」和「用户名」保持为默认值。

## 步骤 6 — 渲染端配置

在左侧边栏进入「渲染端配置」。

确认「本机 IP」与步骤 5 中选择的子网地址相同。Admin 与 Render 地址不一致会导致渲染节点无法向 Admin 服务器注册。

核对其余默认值：

| 字段 | 默认值 |
| --- | --- |
| 管理服务器 Url | http://localhost:8181 |
| 节点名称 | Node-01 |
| 信令端口 | 10002 |
| UDP端口范围 | 10011 – 10040 |

## 步骤 7 — 保存配置

在每个配置页面点击「保存配置」以提交更改。设置只有在保存后才会生效。

## 步骤 8 — 启动服务

返回控制台，点击「全部启动」。五项服务——MySQL、Nginx、Admin、Agent 和 Render——会按正确的依赖顺序启动，状态指示灯变为绿色。

若希望主机应用启动时自动拉起服务，请进入「设置」，将「开机自启」开关设为「开」。

说明：启动过程中可能出现短暂闪屏，具体取决于显示器配置。LarkXR 4.0 在主机分辨率为 1920 × 1080、显示缩放为 100% 时运行效果最佳。

## 步骤 9 — 访问管理控制台

打开浏览器，访问 http://localhost:8182。

使用默认凭据登录：

| 字段 | 值 |
| --- | --- |
| LoginId | admin |
| Password | 123456 |

安全提示：首次登录后，请立即通过账号菜单中的「修改密码」更改默认密码。

登录后会进入「数据中心 → 监控」页面，展示 GPU 服务器资源概览和渲染节点状态。版本号和许可证类型显示在左下角。

至此，LarkXR 4.0 已完成安装、配置并正在运行。

## 后续步骤

平台就绪后，可继续阅读以下章节，了解详细的管理与功能说明：

- **数据中心** — 资源监控、用量统计与客户端错误日志
- **应用** — 应用包管理、应用接入与分享
- **系统设置** — 访问授权、工作空间与参数配置
- **用户** — 账号与权限管理

## 故障排除

| 现象 | 处理方式 |
| --- | --- |
| 「运行检测」中有项目失败 | 按系统要求安装缺失组件，然后重新运行检测。 |
| 「运行检测」中VC安装运行库安装失败 | 退掉360，或看有没有其他安全软件的拦截 |
| 「运行检测」中声卡安装失败 |设备管理器中卸载 所有有关PARAVERSE 相关的声卡，重启服务器，再次安装 |
| 服务启动失败 | 确认没有其他程序占用端口 8181、8182、10002 或 10011–10040 范围。 |
| 控制台中看不到渲染节点 | 确认「配置 Admin」与「配置 Render」中的「本机 IP」一致，并且两个页面都已点击「保存配置」。 |
| http://localhost:8182 无法打开 | 确认仪表盘上 Nginx 和 Admin 服务状态为绿色。 |
| 持续闪屏 | 将主机显示器设置为 1920 × 1080，缩放 100%。 |