LarkXR4.0 NAT

### 安全组放行（必须）
![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/20/49749ee7e5084ebb88e65040313e49a2.png)

## 选场景，照着做
### 一、场景一：HTTP \+ 静态 TURN（测试环境，最常用）
![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/20/4b1fa4b6ab204e84ab57559eb153ac97.png)

### 场景二：HTTPS \+ 域名
![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/20/29eb00a88dc74d9b8e72b7c01d305207.png)

### 场景三：再次启动（配置已有）

```Bash
cd /opt/natServer
shstart.sh
```

两次都输入 **n** 即可，全程无需再填：

```Plain Text
是否修改以上配置？(y/n)：n
是否修改 external-ip？(y/n)：n
? 启动所有服务...
```

---

## 二、前期准备（首次部署必做）

### 下载解压

```Bash
cd /opt
wget https://immershare-app.oss-cn-beijing.aliyuncs.com/natServer.zip
unzip natServer.zip
```

目录应为：

```Plain Text
/opt/natServer/
├── start.sh
├── docker-compose.yml
├── nat-server/
│   ├── application.yaml      ← 重要
│   └── ssl/
│       └── natServer.jks     ← 仅 HTTPS 模式需要
├── turn/
│   └── turnserver.conf       ← 重要
├── mysql/
├── redis/
└── redis/redis.conf          ← 按部署包提供
```

### LarkXR 前置（必须）

确保 LarkXR 已部署，**内网能打开**，记下地址，即后面的 `lan-address`

```Plain Text
http://192.168.0.184:8181 能访问
lan-address 就是  192.168.0.184:8181
```

### 证书（仅 HTTPS，HTTP 跳过）

密码统一：`Pxy-123456`，文件名：`natServer.jks`

以下是pem转jks命令：

```Bash
openssl pkcs12 -export -in fullchain.pem -inkey privkey.pem -out cert.p12 \
  -name myssl -password pass:Pxy-123456 && \
keytool -importkeystore -srckeystore cert.p12 -srcstoretype PKCS12 \
  -srcstorepass Pxy-123456 -destkeystore natServer.jks \
  -deststorepass Pxy-123456 -keypass Pxy-123456
```

放到：`/opt/natServer/nat-server/ssl/natServer.jks`

![Image](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=NjMzMjdjYzkxZGQ3ZjczNWUwNzVhOWRjZGQwNDUwNzBfMjQzZTI2NzY4MDczMDJmZDk0NGNmMzQ2Mjg4MDUzMWJfSUQ6NzY1NTU4NDE3NDU4MTIwNTk0NF8xNzg3MTk0ODc4OjE3ODcyODEyNzhfVjM)

![Image](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=N2JiYzNmZmM2NTIxOWEzZGQyMDIyMjJiMjM0OTYyYWVfNzljYmE2ZTE4NGFlMThkNjZkZTY2ZjdiYjE2Nzg3NjJfSUQ6NzY1NTU4NDIwMTI2MTUzNDE4OV8xNzg3MTk0ODc4OjE3ODcyODEyNzhfVjM)

### 域名解析（仅 HTTPS \+ 域名访问，HTTP 跳过）

将域名（如 `pxydl.pingxingyun.cn`）**A 记录**解析到 NAT 服务器公网 IP。

---

## 三、启动

```Bash
cd /opt/natServer
sh start.sh      
```

### 首次启动会问什么

```Plain Text
① lan-address（必填）     → LarkXR 内网地址，如 192.168.0.184:8181
② HTTPS (y/n) [n]         → n=HTTP  y=HTTPS（需 jks + realm）
③ external-ip             → 一般自动填公网 IP，探测失败才手填
```

### 启动成功标志

```Plain Text
✅ 启动成功！
docker compose ps          # 四个容器均为 Up
docker compose logs nat-server | grep "Auth Success"   # NAT 客户端上线后
```

---

## 四、LarkXR 配置

### 中心端 `larkxr-center/application.properties`

```Properties
pxy.proxy.enable=true
pxy.nat-proxy.enable=true
pxy.nat-proxy.client-mode.server-host=39.107.221.82    # NAT 服务器公网 IP
pxy.nat-proxy.client-mode.server-port=20001
pxy.nat-proxy.client-mode.client-key=05e1e9a4edce4b7ba56700868bc1e423
pxy.licence.suffix=1
```

重启 admin服务

### 渲染端 `larkxr-render/application.properties`

```Properties
# HTTP 模式填公网 IP；HTTPS 模式填域名
pxy.ice.server.uri=turn:pxydl.pingxingyun.cn:13478
pxy.ice.server.username=pxy
pxy.ice.server.password=Pxy%12345
pxy.ice.transport=1
```

重启 render服务

## 五、访问地址

---

## 六、验证

```Bash
# 容器状态
docker compose ps

# NAT 日志
docker compose logs -f nat-server

# 公网连通（HTTP）
curl -v http://<公网IP>:20006/ --connect-timeout 5

# 公网连通（HTTPS）
curl -vk https://<域名>:20006/ --connect-timeout 5
```

NAT 日志出现 `active -> client_key: ...` 表示外网已打到 NAT。

---

## 七、常用命令

```Bash
docker compose logs -f              # 全部日志
docker compose restart nat-server   # 重启 NAT
docker compose restart turn-server  # 重启 TURN（改 turnserver.conf 后）
docker compose down                 # 停止全部
```

---

## 八、常见问题

### 1\. `sh start.sh` 报错 `Illegal option -o pipefail`

```Bash
bash start.sh    # 或 chmod +x start.sh && ./start.sh
```

### 麒麟系统 Docker 安装失败

```Bash
sudo apt-get install -y docker.io

# docker compose 插件（安装失败时再执行）
sudo rm -f /usr/local/lib/docker/cli-plugins/docker-compose
sudo curl -fSL "https://ghproxy.net/https://github.com/docker/compose/releases/download/v2.24.5/docker-compose-linux-x86_64" \
  -o /usr/local/lib/docker/cli-plugins/docker-compose
sudo chmod +x /usr/local/lib/docker/cli-plugins/docker-compose
docker compose version
```

### lan\-address 填什么？

填 **LarkXR 所在机器的内网地址**，不是云服务器 IP。

```Plain Text
LarkXR 在 192.168.0.184:8181  →  lan-address: 192.168.0.184:8181
```