Skip to content

Commit

Permalink
translate: update docs for ws/rpc changes
Browse files Browse the repository at this point in the history
  • Loading branch information
wuzhong-papermoon committed Nov 28, 2023
1 parent 2254adc commit 85ffb9c
Show file tree
Hide file tree
Showing 7 changed files with 27 additions and 38 deletions.
17 changes: 8 additions & 9 deletions builders/get-started/networks/moonbeam-dev.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,23 +43,23 @@ Moonbeam开发节点是您自己的个人开发环境,用于在Moonbeam上构
```bash
docker run --rm --name {{ networks.development.container_name }} --network host \
purestake/moonbeam:{{ networks.development.build_tag }} \
--dev
--dev --rpc-external
```

=== "MacOS"

```bash
docker run --rm --name {{ networks.development.container_name }} -p 9944:9944 \
purestake/moonbeam:{{ networks.development.build_tag }} \
--dev --ws-external --rpc-external
--dev --rpc-external
```

=== "Windows"

```bash
docker run --rm --name {{ networks.development.container_name }} -p 9944:9944 ^
purestake/moonbeam:{{ networks.development.build_tag }} ^
--dev --ws-external --rpc-external
--dev --rpc-external
```

!!! 注意事项
Expand Down Expand Up @@ -169,8 +169,7 @@ purestake/moonbeam \

- **`--dev`** - 指定开发链
- **`--tmp`** - 运行一个临时节点,该节点将在流程结束时删除所有配置
- **`--rpc-external`** - 监听所有RPC接口
- **`--ws-external`** - 监听所有Websocket接口
- **`--rpc-external`** - 监听所有RPC与Websocket接口

### 配置节点的常用选项 {: #node-options }

Expand All @@ -182,10 +181,10 @@ purestake/moonbeam \

- **`-l <log pattern>` or `--log <log pattern>`** - 设置自定义日志记录筛选器。日志模式的语法为`<target>=<level>`。例如,要打印所有JSON RPC日志,命令应如下所示:`-l json=trace`
- **`--sealing <interval>`** - 什么时候区块需要被封装在开发服务中。可接受的时间间隔参数为:`instant``manual`、或一个代表计时器间隔(以毫秒为单位)的数字(例如,`6000`是指节点每6秒产生一次区块)。默认设置是`instant`。请参阅下面的[配置区块生产](#configure-block-production)部分以获取更多信息
- **`--rpc-port <port>`** - *从[v0.30.0客户端版本](https://github.com/moonbeam-foundation/moonbeam/releases/tag/v0.30.0){target=_blank}开始弃用,使用`--ws-port`进行HTTP和WS的连接* - 设置HTTP RPC服务器的TCP端口。接受端口作为参数
- **`--ws-port <port>`** - 设置WebSockets RPC服务器的TCP端口。从[v0.30.0客户端版本](https://github.com/moonbeam-foundation/moonbeam/releases/tag/v0.30.0){target=_blank}开始,WS端口是用于HTTP和WS连接的统一端口。接受端口作为参数。默认值是{{ networks.parachain.ws }}
- **`--rpc-max-connections <connections>`** - *自[客户端v0.30.0](https://github.com/moonbeam-foundation/moonbeam/releases/tag/v0.30.0){target=_blank}起已弃用,此值已硬编码为100。请使用`--ws-max-connections`以调整HTTP和WS连接的总限制* - 指定HTTP RPC服务器连接的最大数量
- **`--ws-max-connections <connections>`** - 指定WS RPC服务器连接的最大数量。自[客户端v0.30.0](https://github.com/moonbeam-foundation/moonbeam/releases/tag/v0.30.0){target=_blank}起,此标志调整HTTP和WS连接的总限制。默认为100个连接。
- **`--rpc-port <port>`** - 用来配置HTTP与WS连接的统一端口。接收一个port作为参数,默认为{{ networks.parachain.rpc }}
- **`--ws-port <port>`** - *从[v0.33.0客户端版本](https://github.com/moonbeam-foundation/moonbeam/releases/tag/v0.33.0){target=_blank}开始已弃用,HTTP与WS连接改为统一使用`--rpc-port`来配置* 设置WebSockets RPC服务器的TCP端口。从[v0.30.0客户端版本](https://github.com/moonbeam-foundation/moonbeam/releases/tag/v0.30.0){target=_blank}开始使用,用来设置HTTP与WS连接的统一端口. 接收一个port作为参数
- **`--rpc-max-connections <connections>`** - 配置HTTP与WS连接的上限总和. 默认连接数为100
- **`--ws-max-connections <connections>`** - * *从[v0.33.0客户端版本](https://github.com/moonbeam-foundation/moonbeam/releases/tag/v0.33.0){target=_blank}开始已弃用, 改为使用`--rpc-max-connections`参数来限制 HTTP与WS连接数量上线* - 配置HTTP与WS连接的上限总和. 默认连接数为100
- **`--rpc-cors <origins>`** - 指定允许浏览器源头访问HTTP和WS RPC服务器。该源头可以是允许访问的以逗号分隔的来源列表,或者您也可以指定`null`。当运行一个开发节点时,预设为允许所有源头

如需命令行标志和选项的完整列表,请在命令末尾添加`--help`来启动Moonbeam开发节点。
Expand Down
7 changes: 2 additions & 5 deletions node-operators/networks/run-a-node/docker.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,10 +70,7 @@ description: 如何使用Docker为Moonbeam网络运行一个全平行链节点
- 在两处替换 `INSERT_YOUR_NODE_NAME`
- 用服务器实际RAM的50%替换 `<50% RAM in MB>`。例如服务器有32 GB RAM,这里则应配置为 `16000`. 内存配置最低值为 `2000`,但这将低于推荐配置

!!! 注意事项
对于v0.27.0之前的客户端版本,`--state-pruning`标志被命名为`--pruning`

对于v0.30.0之前的客户端版本,`--rpc-port`用于指定HTTP连接的端口,`--ws-port`用于指定WS连接的端口。从客户端版本v0.30.0开始,`--rpc-port`已被弃用,`--ws-port`命令行标志同时适用于HTTP连接和WS连接。类似地,`--rpc-max-connections`命令行标志已被弃用,现在被硬编码为100。您可以使用`--ws-max-connections`来调整HTTP和WS连接的总限制。
--8<-- 'text/node-operators/client-changes.md'

### 全节点 {: #full-node }

Expand Down Expand Up @@ -175,7 +172,7 @@ description: 如何使用Docker为Moonbeam网络运行一个全平行链节点
```

!!! 注意事项
如果您想要运行RPC终端、连接至Polkadot.js Apps或是运行您自己的应用,使用`--unsafe-rpc-external`和/或`--unsafe-ws-external`标志来运行能够从外部访问RPC端口的全节点。您能够通过执行`moonbeam --help`以获得更多细节。我们**不建议**收集人节点使用此配置。
如果您想要运行RPC终端、连接至Polkadot.js Apps或是运行您自己的应用,使用`--unsafe-rpc-external`标志来运行能够从外部访问RPC端口的全节点。您能够通过执行`moonbeam --help`以获得更多细节。我们**不建议**收集人节点使用此配置。

### 收集人 {: #collator }

Expand Down
8 changes: 4 additions & 4 deletions node-operators/networks/run-a-node/flags.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,10 +15,10 @@ description: 有助于在Moonbeam上运行一个完整平行链节点的标志

- **`--collator`** —— 为候选收集人启用验证人模式,当可用时允许节点活跃参与区块生产
- **`--port`** —— 指定端对端协议的TCP端口。平行链的默认端口为`{{ networks.parachain.p2p }}`,嵌入的中继链则为`{{ networks.relay_chain.p2p }}`
- **`--rpc-port`** —— *[v0.30.0客户端版本](https://github.com/moonbeam-foundation/moonbeam/releases/tag/v0.30.0){target=_blank}开始弃用,使用`--ws-port`进行HTTP和WS的连接* —— 指定HTTP RPC服务器的TCP端口。平行链的默认端口为`{{ networks.parachain.rpc }}`,嵌入的中继链的默认端口则为`{{ networks.relay_chain.rpc }}`
- **`--ws-port`** —— 指定WebSockets RPC服务器的TCP端口。[v0.30.0客户端版本](https://github.com/moonbeam-foundation/moonbeam/releases/tag/v0.30.0){target=_blank}开始,WS端口是用于HTTP和WS连接的统一端口。平行链的的默认端口为`{{ networks.parachain.ws }}`,嵌入的中继链的默认端口则为`{{ networks.relay_chain.ws }}`
- **`--rpc-max-connections`** - *[客户端v0.30.0](https://github.com/moonbeam-foundation/moonbeam/releases/tag/v0.30.0){target=_blank}起已弃用,此值已硬编码为100。请使用`--ws-max-connections`以调整HTTP和WS连接的总限制* - 指定HTTP RPC服务器连接的最大数量
- **`--ws-max-connections`** —— 指定WS RPC服务器连接的最大数量。自[v0.30.0客户端版本](https://github.com/moonbeam-foundation/moonbeam/releases/tag/v0.30.0){target=_blank}起,此命令行标志调节HTTP和WS连接的总限制。默认值为100
- **`--rpc-port`** - 用来配置HTTP与WS连接的统一端口。平行链的默认端口为`{{ networks.parachain.rpc }}`,嵌入的中继链的默认端口则为`{{ networks.relay_chain.rpc }}`
- **`--ws-port`** - - *[v0.33.0客户端版本](https://github.com/moonbeam-foundation/moonbeam/releases/tag/v0.33.0){target=_blank}开始已弃用,HTTP与WS连接改为统一使用`--rpc-port`来配置* 设置WebSockets RPC服务器的TCP端口。 平行链的的默认端口为`{{ networks.parachain.ws }}`,嵌入的中继链的默认端口则为`{{ networks.relay_chain.ws }}`
- **`--rpc-max-connections`** - 配置HTTP与WS连接的上限总和. 默认连接数为100
- **`--ws-max-connections`** - *[v0.33.0客户端版本](https://github.com/moonbeam-foundation/moonbeam/releases/tag/v0.33.0){target=_blank}开始已弃用, 改为使用`--rpc-max-connections`参数来限制 HTTP与WS连接数量上线* - 配置HTTP与WS连接的上限总和. 默认连接数为100
- **`--execution`** —— 指定所有执行内容该使用的执行策略。Substrate runtime被编译为本地可执行文件,该执行文件被包含在节点本地的一部分,以及存储在链上的WebAssembly二进制文件中。可用的选项如下:
- **`native`** —— 仅执行本地文件
- **`wasm`** —— 仅执行Wasm文件
Expand Down
3 changes: 1 addition & 2 deletions node-operators/networks/run-a-node/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,8 +59,7 @@ Moonbeam拥有多种不同的部署渠道,包含Moonbase Alpha测试网,Kusa

只有指定P2P端口才需要对流入流量开放。**收集人节点不可以开放任何WS或RPC端口。**

!!! 注意事项
[v0.30.0客户端版本](https://github.com/moonbeam-foundation/moonbeam/releases/tag/v0.30.0){target=_blank}开始,端口{{ networks.parachain.rpc }}的HTTP RPC端点已被弃用。端口{{ networks.parachain.ws }}的WS RPC端点应该同时用于HTTP和WS连接.
--8<-- 'text/node-operators/client-changes.md'

### 平行链全节点的默认端口 {: #default-ports-for-a-parachain-full-node }

Expand Down
7 changes: 2 additions & 5 deletions node-operators/networks/run-a-node/systemd.md
Original file line number Diff line number Diff line change
Expand Up @@ -205,10 +205,7 @@ description: 如何使用Systemd为Moonbeam网络运行一个平行链全节点
- 如果您使用不同目录,请再次检查基本路径
- 将文档命名为`/etc/systemd/system/moonbeam.service`

!!! 注意事项
对于v0.27.0之前的客户端版本,`--state-pruning`标志被命名为`--pruning`

对于v0.30.0之前的客户端版本,`--rpc-port`用于指定HTTP连接的端口,`--ws-port`用于指定WS连接的端口。从客户端版本v0.30.0开始,`--rpc-port`已被弃用,`--ws-port`命令行标志同时适用于HTTP连接和WS连接。类似地,`--rpc-max-connections`命令行标志已被弃用,现在被硬编码为100。您可以使用`--ws-max-connections`来调整HTTP和WS连接的总限制。
--8<-- 'text/node-operators/client-changes.md'

### 全节点 {: #full-node }

Expand Down Expand Up @@ -303,7 +300,7 @@ description: 如何使用Systemd为Moonbeam网络运行一个平行链全节点
```

!!! 注意事项
如果您想要运行RPC终端、连接至polkadot.js.org或是运行您自己的应用,使用`--unsafe-rpc-external`和/或`--unsafe-ws-external`标志来运行能够从外部访问RPC端口的全节点。您能够通过执行`moonbeam --help`以获得更多细节。我们**不建议**收集人节点使用此配置。有关上述标志的概述,请参阅开发者文档的[标志](/node-operators/networks/run-a-node/flags){target=_blank}页面。
如果您想要运行RPC终端、连接至polkadot.js.org或是运行您自己的应用,使用`--unsafe-rpc-external`标志来运行能够从外部访问RPC端口的全节点。您能够通过执行`moonbeam --help`以获得更多细节。我们**不建议**收集人节点使用此配置。有关上述标志的概述,请参阅开发者文档的[标志](/node-operators/networks/run-a-node/flags){target=_blank}页面。

### 收集人 {: #collator }

Expand Down
15 changes: 6 additions & 9 deletions node-operators/networks/tracing-node.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Geth的`debug`和`txpool` API以及OpenEthereum的`trace`模块提供一个非
- **`-ethapi-trace-cache-duration <uint>`** —— 设置持续时间(以秒为单位),在此之后给定块的`trace_filter`缓存被丢弃。区块存储在缓存中的默认时间为`300`

!!! 注意事项
如果您希望运行一个RPC端点以连接Polkadot.js Apps或是运行自有应用,请使用`--unsafe-rpc-external`和/或`--unsafe-ws-external`标志以运行一个能够外部访问RPC端口的完整节点。更多细节可以通过运行`moonbeam --help`命令获得。
如果您希望运行一个RPC端点以连接Polkadot.js Apps或是运行自有应用,请使用`--unsafe-rpc-external`标志以运行一个能够外部访问RPC端口的完整节点。更多细节可以通过运行`moonbeam --help`命令获得。

## 使用Docker运行一个追踪节点 {: #run-a-tracing-node-with-docker }

Expand Down Expand Up @@ -94,10 +94,7 @@ Geth的`debug`和`txpool` API以及OpenEthereum的`trace`模块提供一个非
- 在两处替换 `INSERT_YOUR_NODE_NAME`
- 用服务器实际RAM的50%替换 `<50% RAM in MB>`。例如服务器有32 GB RAM,这里则应配置为 `16000`. 内存配置最低值为 `2000`,但这将低于推荐配置

!!! 注意事项
对于v0.27.0之前的客户端版本,`--state-pruning`标志被命名为`--pruning`

对于v0.30.0之前的客户端版本,`--rpc-port`用于指定HTTP连接的端口,`--ws-port`用于指定WS连接的端口。从客户端版本v0.30.0开始,`--rpc-port`已被弃用,`--ws-port`命令行标志同时适用于HTTP连接和WS连接。类似地,`--rpc-max-connections`命令行标志已被弃用,现在被硬编码为100。您可以使用`--ws-max-connections`来调整HTTP和WS连接的总限制。
--8<-- 'text/node-operators/client-changes.md'

运行一个追踪节点的完整命令如下所示:

Expand Down Expand Up @@ -270,10 +267,7 @@ Geth的`debug`和`txpool` API以及OpenEthereum的`trace`模块提供一个非
- 如果您使用的是不同的目录,请再次确认基本路径
- 将文件命名为`/etc/systemd/system/moonbeam.service`

!!! 注意事项
对于v0.27.0之前的客户端版本,`--state-pruning`标志被命名为`--pruning`

对于v0.30.0之前的客户端版本,`--rpc-port`用于指定HTTP连接的端口,`--ws-port`用于指定WS连接的端口。从客户端版本v0.30.0开始,`--rpc-port`已被弃用,`--ws-port`命令行标志同时适用于HTTP连接和WS连接。类似地,`--rpc-max-connections`命令行标志已被弃用,现在被硬编码为100。您可以使用`--ws-max-connections`来调整HTTP和WS连接的总限制。
--8<-- 'text/node-operators/client-changes.md'

=== "Moonbeam"

Expand Down Expand Up @@ -374,6 +368,9 @@ Geth的`debug`和`txpool` API以及OpenEthereum的`trace`模块提供一个非
WantedBy=multi-user.target
```

!!! 注意事项
如果您希望运行一个RPC端点以连接Polkadot.js Apps或是运行自有应用,请使用`--unsafe-rpc-external`标志以运行一个能够外部访问RPC端口的完整节点。更多细节可以通过运行`moonbeam --help`命令获得。

### 运行服务器 {: #run-the-service }

--8<-- 'text/node-operators/networks/run-a-node/systemd/run-service.md'
Expand Down
8 changes: 4 additions & 4 deletions tutorials/integrations/local-subsquid.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ _作者:Erin Shaben_

- `--dev` - 指定使用开发链
- `--sealing 4000` - 每四秒(4000毫秒)密封一个区块
- `--ws-external` - 监听所有WebSocket接口
- `--rpc-external` - 监听所有HTTP与WebSocket接口

要创建一个开发节点,您可以运行以下指令为Moonbeam提供最新的Docker映像:

Expand All @@ -44,23 +44,23 @@ _作者:Erin Shaben_
```bash
docker run --rm --name {{ networks.development.container_name }} --network host \
purestake/moonbeam:{{ networks.development.build_tag }} \
--dev --sealing 4000 --ws-external --rpc-external
--dev --sealing 4000 --rpc-external
```

=== "MacOS"

```bash
docker run --rm --name {{ networks.development.container_name }} -p 9944:9944 \
purestake/moonbeam:{{ networks.development.build_tag }} \
--dev --sealing 4000 --ws-external --rpc-external
--dev --sealing 4000 --rpc-external
```

=== "Windows"

```bash
docker run --rm --name {{ networks.development.container_name }} -p 9944:9944 ^
purestake/moonbeam:{{ networks.development.build_tag }} ^
--dev --sealing 4000 --ws-external --rpc-external
--dev --sealing 4000 --rpc-external
```

这些指令将会启动我们的开发节点,您可以使用9944端口。
Expand Down

0 comments on commit 85ffb9c

Please sign in to comment.