LarkXR4.0 NAT(Win)

# NAT 服务部署指南（Windows）

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

## 一、选场景，照着做

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

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

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

双击 `start.bat`，两次都选 **n** 即可：

```Plain Text
Modify above config? (y/n)：n
Modify external-ip? (y/n) [n]：n
```

提示启动完成后窗口约 2 秒关闭，服务在后台运行。

停止：双击 `stop.bat`。

---

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

### 目录结构

下载程序包：

https://pxy\-home\.oss\-cn\-beijing\.aliyuncs\.com/LarkNatServer\.zip

解压到某盘符根目录

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

```Plain Text
LarkNatServer/
├── start.bat / stop.bat          ← 日常只操作这两个
├── bin\                          ← 内部脚本（隐藏，勿删）
├── jdk\                          ← JDK / JRE 17（含 java.exe）
├── redis\                        ← redis-server.exe + redis.conf
├── mysql\                        ← MySQL 8 Windows ZIP
├── turn\
│   ├── turnserver.conf           ← 重要
│   └── turnserver.exe            ← 可选；无则用 WSL coturn
└── nat-server\
    ├── application.yaml          ← 重要
    ├── pxydev-nat-server.jar
    ├── logs\
    └── ssl\
        └── natServer.jks         ← 仅 HTTPS 需要
```

### 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`

```Plain Text
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
```

放到：`LarkNatServer\nat-server\ssl\natServer.jks`

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

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

---

## 三、启动

```Plain Text
cd /d D:\LarkNatServer
start.bat
```

或资源管理器中双击 `start.bat`。

### 首次启动会问什么

交互提示为英文（避免编码问题）：

### 启动成功标志

- 窗口提示启动完成，约 2 秒后自动关闭

- 任务管理器可见：`mysqld.exe`、`redis-server.exe`、`javaw`/`java`、`turnserver`

- 日志 `nat-server\logs\nat-server.log` 出现：`proxy server start on port 20001`

- NAT 客户端上线后出现：`Auth Success for clientKey`

---

## 四、LarkXR 配置

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

```Properties
pxy.proxy.enable=true
pxy.nat-proxy.enable=true
pxy.nat-proxy.client-mode.server-host=您的服务器公网ip
pxy.nat-proxy.client-mode.server-port=20001
pxy.nat-proxy.client-mode.client-key=05e1e9a4edce4b7ba56700868bc1e423
pxy.licence.suffix=1
```

将 `server-host` 换成 NAT 服务器**公网 IP**

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

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

## 五、访问地址

---

## 六、验证

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

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

REM 看 NAT 日志
type nat-server\logs\nat-server.log
```

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

---

## 七、常用操作

内部脚本在隐藏目录 `bin\`：资源管理器「查看」→ 勾选「隐藏的项目」。日常勿删。

---

## 八、默认账号

> MySQL 客户端请用 **`127.0.0.1`**，不要填 `localhost`（避免命名管道 / 旧客户端兼容问题）。
> 
>

---

## 九、常见问题

### 缺少 `MSVCP140.dll`

安装 [VC\+\+ 2015–2022 x64](https://aka.ms/vs/17/release/vc_redist.x64.exe) 后重试 `start.bat`。

### lan\-address 填什么？

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

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

### 外网超时，日志无 `active ->`

1. 安全组 / 防火墙是否放行 **入方向** 20006、20001

2. NAT 客户端是否已 `Auth Success`

3. DNS / 公网 IP 是否正确

### 看不到 `bin` 目录

正常，已设隐藏属性。资源管理器勾选「隐藏的项目」即可。

---

## 附：配置占位符（首次由 start\.bat 填写）

```YAML
# application.yaml
lan-address: __LAN_ADDRESS__
```

```TOML
# turnserver.conf
external-ip=__EXTERNAL_IP__
```

不必事先手改；双击 `start.bat` 按提示填写即可。

---