Cloudflare Tunnel + Google Auth

Documentation Index

Fetch the complete documentation index at: https://docs.americ.io.vn/llms.txt

Use this file to discover all available pages before exploring further.

​

Prerequisites

• Ubuntu/Debian VPS with a web app running (e.g. on localhost:8080)
• A domain already on Cloudflare (nameservers pointing to Cloudflare)
• A Cloudflare account with Zero Trust enabled (free tier is sufficient)
• A Google Cloud account (for OAuth credentials)

​

Phase 1 — Install cloudflared on the VPS

​

1.1 Download and install

curl -L --output cloudflared.deb \
  https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb

sudo dpkg -i cloudflared.deb

# Fix any dependency issues if they arise
sudo apt-get install -f

# Verify
cloudflared --version

​

1.2 Authenticate with Cloudflare

cloudflared tunnel login

​

1.3 Create the tunnel

cloudflared tunnel create my-tunnel

Created tunnel my-tunnel with id 3f2a1b8c-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Save the UUID — you will need it in the next phase.

​

Phase 2 — Configure and run the tunnel

​

2.1 Write config.yml

tunnel: <YOUR_TUNNEL_UUID>
credentials-file: /root/.cloudflared/<YOUR_TUNNEL_UUID>.json

ingress:
  - hostname: app.yourdomain.com
    service: http://localhost:8080
  - service: http_status:404

​

2.2 Create the DNS record

cloudflared tunnel route dns my-tunnel app.yourdomain.com

​

2.3 Run as a systemd service

sudo cloudflared service install
sudo systemctl start cloudflared
sudo systemctl enable cloudflared

# Confirm it's running
sudo systemctl status cloudflared

​

Phase 3 — Create an Access Application

1. Go to Access → Applications → Add an application
2. Select Self-hosted
3. Set Application domain to app.yourdomain.com
4. Under Policies, click Add a policy:
   • Policy name: e.g. Allowed users
   • Action: Allow
   • Rule selector: Emails
   • Value: add each allowed address, e.g. alice@gmail.com, bob@gmail.com
5. Save the application

Anyone not in the email list will be blocked at the Cloudflare edge — your VPS never receives their request.

​

Phase 4 — Add Google as Identity Provider

​

4.1 Create OAuth credentials in Google Cloud

1. Go to Google Cloud Console → APIs & Services → Credentials
2. Click Create Credentials → OAuth 2.0 Client ID
3. Application type: Web application
4. Under Authorized redirect URIs, add:
   https://<your-team-name>.cloudflareaccess.com/cdn-cgi/access/callback
   
   Replace <your-team-name> with your Cloudflare Zero Trust team name (found in Zero Trust → Settings → General).
5. Save — copy the Client ID and Client Secret

​

4.2 Add Google IdP in Cloudflare Zero Trust

1. Go to Settings → Authentication → Login methods
2. Click Add → Google
3. Paste your Client ID and Client Secret
4. Click Save
5. Optionally click Test to confirm the connection works

​

How it works end-to-end

User visits app.yourdomain.com
        ↓
Cloudflare Access intercepts the request
        ↓
User is redirected to Google login
        ↓
Google authenticates → returns email to Cloudflare
        ↓
Cloudflare checks email against your policy
        ↓
Allowed → request forwarded through tunnel to VPS :8080
Blocked → 403, access denied

​

Customizing the Access login page

• Logo — upload a custom image
• App name — shown as the page title
• Background color — a single hex value

​

Troubleshooting

​

Useful commands

# Check tunnel status
cloudflared tunnel info my-tunnel

# List all tunnels
cloudflared tunnel list

# View live tunnel logs
sudo journalctl -u cloudflared -f

# Restart the tunnel service
sudo systemctl restart cloudflared