LarkXR Troubleshooting Reference
Deployment
Troubleshooting Backend Intranet Access Failure
Troubleshooting Backend External Access Failure
Troubleshooting Database Startup Failure
Troubleshooting Black Screen on Server Startup
Troubleshooting Service Startup Failure
Cluster Edition (Linux)
Troubleshooting “not found” Errors in sh Startup Scripts
Public Cloud
Tesla GPU GRID Driver and License Requirements
Configuring a Virtual Display for the Second vGPU
Troubleshooting Resolution Below 1080p on Tesla GPUs
Error Code Explanation
Web Client
Troubleshooting “No available render server, Please try again later.”
Code 102
Code 103
Code 202
Code 203
Code 401
Code 402
Code 403
Code 404
Code 500
Code 501
Code 502
Code 504
Code 601
Stuck on 5/5 Loading Page
Cloud Application Exit Detected
Point-to-Point Connection Disconnected
Frontend & Backend Inaccessible
VR Client
Code 11
Code 900
Code 1001
Continuous Loading
UDP Connection Failure
Other Issues
Code 1002
AR Client
UDP Connection Failure
Secondary Development
Data Channel
Unable to Communicate — Troubleshooting Guide
Failed to Pass the Message Body
Incorrect Message Delivery
Delay in Receiving Messages
UE5 Plugin Packaging: Possible Reasons for "Unknown Cook Failure"
WebSDK
1-5 Cards Loading
SDK License Does Not Exist
vue2-react Running Error (Node v18.12.1)
H.265 WebCodec Not Supported by Browser
Interface call
No Access Permissions
Signature and Timestamp Cannot Be Empty
Invalid Key Pair
Others
Apps Can't Sync
LarkXR Launcher: Check Environment Error
User Experiences
Live Streaming Screen is Black
Picture Quality is Not Clear
SN
Local SN
Invalid Authorization Code
Cloud SN
Authorization Code Is Disabled
Authorization Code Does Not Exist
-
+
首页
Code 103
The `code103` error usually indicates that, in direct connection mode, the web client cannot communicate with TCP port `10002` on the render node. For an overview of direct connection mode, refer to: [What is direct connection mode?](https://www.pingxingyun.com/contribute/detail?topicId=10105&categoryId=3) ## Cause In direct connection mode, the client must be able to reach TCP port `10002` on the render node. If that port is blocked, the public IP is incorrect, or the deployment mode is not appropriate for the network topology, the session may fail with `code103`. ## Solutions by Scenario | Usage Scenario | Recommended Action | |---|---| | Intranet deployment | Check whether the firewall is disabled or whether TCP port `10002` is allowed through the firewall. | | Public network deployment where the render node has a public IP address | Check whether TCP port `10002` is open and confirm that the configured public IP address is correct. See: [How to configure a public IP address](https://www.pingxingyun.com/contribute/detail?topicId=10106&categoryId=3). | | Public network deployment where the render node does not have a public IP address, but is on the same LAN as the primary node and can communicate over TCP port `10002` | Set the management server to proxy mode and configure the render server local IP as its intranet IP address. See: [How to configure proxy mode](https://www.pingxingyun.com/contribute/detail?topicId=10105&categoryId=3) and [How to configure a public IP address](https://www.pingxingyun.com/contribute/detail?topicId=10106&categoryId=3). | ## Recommended Checks 1. Confirm whether the current deployment is using direct connection mode. 2. Verify whether TCP port `10002` on the render node is reachable from the client side. 3. Check whether the configured public IP or intranet IP is correct for the current deployment scenario. 4. If the render node does not have a public IP, consider using proxy mode instead of direct connection mode. ## Notes - Direct connection mode depends on correct network reachability between the client and the render node. - If port `10002` cannot be reached reliably from the client network, proxy mode is usually the safer configuration. - Keep the configured render-node IP consistent with the actual network path used by the deployment.
admin
2026年5月11日 10:17
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
Word文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码
有效期