Skip to content

README.md

Latest commit

 

History

History
78 lines (56 loc) · 2.24 KB

README.md

File metadata and controls

78 lines (56 loc) · 2.24 KB
title Cloudflare Container Workers with Go Fiber
keywords
cloudflare
container
worker
edge
description Run a Go Fiber v3 app in a Cloudflare Container Worker with a Worker proxy.

Cloudflare Container Workers with Go Fiber

Github StackBlitz

This example demonstrates how to use Go Fiber v3 with Cloudflare Container Workers.

Features

  • Go Fiber v3 framework
  • Distroless container for minimal attack surface (gcr.io/distroless/static-debian12)
  • JSON API response
  • Environment variables support
  • Logger and Recover middleware

Prerequisites

  • Bun
  • Go 1.25+
  • Wrangler CLI
  • Cloudflare account with Container Workers access

Getting Started

  1. Install dependencies:
bun install
  1. Run locally:
bun run dev
  1. Deploy to Cloudflare:
bun run deploy

Project Structure

.
├── src/index.ts           # Worker entry point
├── container_src/
│   ├── main.go           # Go Fiber application
│   ├── go.mod            # Go module file
│   └── go.sum            # Go dependencies
├── Dockerfile            # Container configuration
└── wrangler.jsonc        # Cloudflare Workers configuration

How it Works

  1. The Worker (TypeScript) receives HTTP requests.
  2. Requests are forwarded to the Go Fiber container.
  3. The container responds with JSON data, including environment variables.

Container Configuration

The container is configured with:

  • 2-minute sleep timeout for inactivity
  • Environment variable MESSAGE passed from the container class
  • Port 8080 (default)

Learn More