Proxy with DigitalOcean App Platform

App Platform can route a path prefix to its own component. Send /a to a small proxy service and read the visitor IP from App Platform's header.

Set it up

1. Already running a server component?

   If your app is Express, Flask, FastAPI, Laravel or another server, add that stack's recipe to it directly and skip the separate service. Take the visitor IP from do-connecting-ip (see the next step).

2. Create a proxy service

   For a static site, deploy the Express recipe as a service component, reading App Platform's visitor IP header:

   metricraven-proxy.js

   Copy

   1

   2

   3

   // The Express recipe, reading App Platform's visitor IP header.
   // Replace the first line of relay() with:
   const headers = { "x-visitor-ip": req.get("do-connecting-ip") || req.ip };

3. Route /a to the service

   In the app spec, or under Settings → Components in the control panel, give the service the /a route and keep the path prefix so it receives /a/script and /a/event:

   .do/app.yaml

   Copy

   1

   2

   3

   4

   5

   6

   7

   8

   9

   10

   11

   12

   13

   14

   15

   16

   17

   18

   19

   20

   # .do/app.yaml (excerpt) · route /a to a small proxy service
   services:
     - name: metricraven-proxy
       github:
         repo: your-org/metricraven-proxy
         branch: main
       run_command: node metricraven-proxy.js
       http_port: 8080
       envs:
         - key: PORT
           value: "8080"
   ingress:
     rules:
       - match:
           path:
             prefix: /a
         component:
           name: metricraven-proxy
           preserve_path_prefix: true
       # ...your existing rules for the rest of the site

4. Point your script tag at your own paths

   Replace your MetricRaven tag with this one. src loads the tracker from your domain and data-api sends its events there too.

   Your website's shared layout

   Copy

   1

   <script defer src="/a/script" data-api="/a/event" data-site-id="YOUR_SITE_ID"></script>

Notes

• DigitalOcean documents do-connecting-ip as the client IP on App Platform; x-forwarded-for there holds the ingress address, so don't use it.

How the proxy works and which headers it must send: Use your own domain.