Skip to content

Commit 4ce53f4

Browse files
committed
move ICMP content
1 parent e2c8193 commit 4ce53f4

File tree

2 files changed

+43
-36
lines changed

2 files changed

+43
-36
lines changed

src/content/docs/cloudflare-one/connections/connect-networks/troubleshoot-tunnels/common-errors.mdx

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ sidebar:
55
order: 2
66
---
77

8+
import { Tabs, TabItem } from "~/components";
9+
810
This section covers the most common errors you might encounter when connecting resources with Cloudflare Tunnel. If you do not see your issue listed below, refer to the [troubleshooting FAQ](/cloudflare-one/faq/troubleshooting/), view your [Tunnel logs](/cloudflare-one/connections/connect-networks/monitor-tunnels/logs/), or [contact Cloudflare Support](/support/contacting-cloudflare-support/).
911

1012
## I see `cloudflared service is already installed`.
@@ -131,3 +133,43 @@ sudo sysctl -a | grep net.core.rmem_max
131133
```sh output
132134
net.core.rmem_max = 2500000
133135
```
136+
137+
## `ping` and `traceroute` commands do not work.
138+
139+
To ping an IP address behind Cloudflare Tunnel, your system must allow ICMP traffic through `cloudflared`:
140+
141+
<Tabs> <TabItem label="Linux" icon="linux">
142+
143+
1. Ensure that `ping_group_range` includes the Group ID (GID) of the user running `cloudflared`.
144+
145+
1. To get the Group ID of the user, run `id -g`.
146+
2. To verify the Group IDs that are allowed to use ICMP:
147+
148+
```sh
149+
sudo sysctl net.ipv4.ping_group_range
150+
```
151+
152+
```sh output
153+
net.ipv4.ping_group_range= 0 10000
154+
```
155+
156+
3. Either add the user to a group within that range, or update the range to encompass a group the user is already in. To update `ping_group_range`:
157+
158+
```sh
159+
echo 0 10001 | sudo tee /proc/sys/net/ipv4/ping_group_range
160+
```
161+
162+
2. If you are running multiple network interfaces (for example, `eth0` and `eth1`), configure `cloudflared` to use the external Internet-facing interface:
163+
164+
```sh
165+
cloudflared tunnel run --icmpv4-src <IP of primary interface>
166+
```
167+
168+
</TabItem> <TabItem label="Docker" icon="seti:docker">
169+
170+
In your environment, modify the `ping_group_range` parameter to include the Group ID (GID) of the user running `cloudflared`.
171+
172+
By default the [`cloudflared` Docker container](https://github.com/cloudflare/cloudflared/blob/master/Dockerfile#L29C6-L29C13) executes as a user called `nonroot` inside of the container. `nonroot` is a specific user that exists in the [base image](https://github.com/GoogleContainerTools/distroless/blob/859eeea1f9b3b7d59bdcd7e24a977f721e4a406c/base/base.bzl#L8) we use, and its Group ID is hardcoded to 65532.
173+
174+
</TabItem> </Tabs>
175+

src/content/partials/cloudflare-one/tunnel/enable-gateway-proxy.mdx

Lines changed: 1 addition & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -8,41 +8,6 @@ import { Tabs, TabItem } from "~/components";
88
2. In **Firewall**, turn on **Proxy**.
99
3. Select **TCP**.
1010
4. (Recommended) To proxy traffic to internal DNS resolvers, select **UDP**.
11-
5. (Recommended) To proxy traffic for diagnostic tools such as `ping` and `traceroute`, select **ICMP**. You may also need to update your system to allow ICMP traffic through `cloudflared`:
12-
13-
<Tabs> <TabItem label="Linux" icon="linux">
14-
15-
1. Ensure that `ping_group_range` includes the Group ID (GID) of the user running `cloudflared`.
16-
17-
1. To get the Group ID of the user, run `id -g`.
18-
2. To verify the Group IDs that are allowed to use ICMP:
19-
20-
```sh
21-
sudo sysctl net.ipv4.ping_group_range
22-
```
23-
24-
```sh output
25-
net.ipv4.ping_group_range= 0 10000
26-
```
27-
28-
3. Either add the user to a group within that range, or update the range to encompass a group the user is already in. To update `ping_group_range`:
29-
30-
```sh
31-
echo 0 10001 | sudo tee /proc/sys/net/ipv4/ping_group_range
32-
```
33-
34-
2. If you are running multiple network interfaces (for example, `eth0` and `eth1`), configure `cloudflared` to use the external Internet-facing interface:
35-
36-
```sh
37-
cloudflared tunnel run --icmpv4-src <IP of primary interface>
38-
```
39-
40-
</TabItem> <TabItem label="Docker" icon="seti:docker">
41-
42-
In your environment, modify the `ping_group_range` parameter to include the Group ID (GID) of the user running `cloudflared`.
43-
44-
By default the [`cloudflared` Docker container](https://github.com/cloudflare/cloudflared/blob/master/Dockerfile#L29C6-L29C13) executes as a user called `nonroot` inside of the container. `nonroot` is a specific user that exists in the [base image](https://github.com/GoogleContainerTools/distroless/blob/859eeea1f9b3b7d59bdcd7e24a977f721e4a406c/base/base.bzl#L8) we use, and its Group ID is hardcoded to 65532.
45-
46-
</TabItem> </Tabs>
11+
5. (Recommended) To proxy traffic for diagnostic tools such as `ping` and `traceroute`, select **ICMP**. You may also need to [update your system](/cloudflare-one/connections/connect-networks/troubleshoot-tunnels/common-errors/#ping-and-traceroute-commands-do-not-work) to allow ICMP traffic through `cloudflared`.
4712

4813
Cloudflare will now proxy traffic from enrolled devices, except for the traffic excluded in your [split tunnel settings](/cloudflare-one/connections/connect-networks/private-net/cloudflared/#3-route-private-network-ips-through-warp). For more information on how Gateway forwards traffic, refer to [Gateway proxy](/cloudflare-one/policies/gateway/proxy/).

0 commit comments

Comments
 (0)