Skip to content

Commit fca0d04

Browse files
authored
fix(doc): add more trouble shoot cases for 0 peer (#50)
1 parent 0759dfa commit fca0d04

File tree

2 files changed

+13
-5
lines changed

2 files changed

+13
-5
lines changed

README.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -32,9 +32,8 @@ Please ensure you have the latest versions of Docker and Docker Compose installe
3232

3333
- **For Mac:**
3434
Download Docker from [Docker Desktop for Mac](https://docs.docker.com/docker-for-mac/install/).
35-
36-
*Note: Docker Compose is included in the Docker installation package for Mac.*
37-
35+
Docker Compose is included in the Docker installation package for Mac.
36+
- After installation, open Docker application, navigate to Settings \-> Resources \-> Network, and check the option \`Use kernel networking for UDP\`. Then restart Docker to apply.
3837

3938
- **For Linux:**
4039
Download and install both Docker and Docker Compose plugin from the official websites:

single_node/README.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -170,6 +170,15 @@ If the following error cases do not cover your issue, please refer to [Issue Wor
170170
If the logs show `Peer stats: all 0, active 0, passive 0`, it means tron node cannot use **P2P Node Discovering Protocol** to find neighbors.
171171
This protocol operates over UDP through port 18888. Therefore, the most likely cause of this issue is a network problem.
172172
Try debugging with the following steps:
173-
- Use the command `docker ps` to check if the ports mapping includes `-p 18888:18888`.
173+
- Use the command `docker ps` to check if the port mapping includes `-p 18888:18888`.
174174
- Verify your local network settings to ensure that port 18888 is not blocked.
175-
- Open the Docker application, navigate to Settings -> Resources -> Network, and check the option 'Use kernel networking for UDP'. Then restart Docker and your container.
175+
- If you are using a cloud server, check the security group settings to ensure that port 18888 is open.
176+
- If you are using macOS, open the Docker application, navigate to Settings \-> Resources \-> Network, and check the option \`Use kernel networking for UDP\`. Then restart Docker and your container.
177+
- If you are using Linux, you may need to enable IP forwarding:
178+
- Add \`net.ipv4.ip_forward=1\` to file \`/etc/sysctl.conf\`
179+
- Then restarted the network service and validated the setting:
180+
```
181+
[root@demo]# systemctl restart network
182+
[root@demo]# sysctl net.ipv4.ip_forward
183+
net. ipv4. ip_forward = 1 // expected output
184+
```

0 commit comments

Comments
 (0)