● Community Submission — This content is pending review by the Adom team. v1.0.0
adom.cloud — DNS Proxy
Skill

adom.cloud — DNS Proxy

Provision short, memorable *.adom.cloud URLs that reverse-proxy to long Adom container URLs. Powered by Cloudflare Workers + KV on the edge.

⚡ Install this skill

Paste this into Claude Code (VS Code panel, Adom editor, or terminal) to install:

Search the Adom Wiki for the skill "adom.cloud — DNS Proxy" (slug: adom-cloud) at https://wiki-ufypy5dpx93o.adom.cloud/wiki/skills/adom-cloud and install it into my local ~/.claude/skills/adom-cloud/ directory. Fetch the skill_source content from the wiki page and save it as SKILL.md. Then confirm it's installed by showing the first 5 lines.
?
What is a skill? Skills are instructions that teach AI assistants like Claude Code how to perform specific tasks. The description below is loaded into the AI as context when you invoke this skill. Well-written skills make the AI significantly more effective. Like Wikipedia, anyone can improve a skill by clicking Edit AI Skill — or have your AI submit an edit on your behalf.

Screenshots

Screenshot 1

adom.cloud showcase widget — hero, stats, architecture flow

Description

Edit AI Skill

adom.cloud — DNS Proxy Service

Turn long, secret container URLs into short, memorable *.adom.cloud addresses. The secret container hash is completely hidden from end users.

What It Does

Every Adom container has a URL like:

https://coder.john-project-a1b2c3d4e5f6g7h8.containers.adom.inc/proxy/8797/

The long hash in the URL acts as authentication — anyone with it can access your service. But it's ugly and hard to share. adom.cloud lets you create clean URLs like:

https://myapp.adom.cloud

That reverse-proxy to your container service, hiding the secret hash entirely.

How It Works

Browser → myapp.adom.cloud → Cloudflare DNS (proxied) → CF Worker → KV Lookup → Container URL
  1. DNS — A proxied A record points myapp.adom.cloud to a dummy IP (192.0.2.1)
  2. Cloudflare Worker — Intercepts the request before it reaches the dummy IP
  3. KV Lookup — Worker reads the subdomain from the Host header, looks up the target URL in Cloudflare Workers KV
  4. Reverse Proxy — Worker fetches from the real container URL and returns the response to the user

Both HTTP and WebSocket connections are proxied transparently — important for VS Code, Adom Viewer, and other real-time apps.

Features

  • Edge Performance — Cloudflare Workers run at 300+ edge locations worldwide, sub-50ms latency
  • Automatic SSL — HTTPS is free and automatic via Cloudflare
  • WebSocket Support — Full bidirectional WebSocket passthrough for real-time apps
  • Hidden Secrets — The container hash never appears in the user's browser
  • Instant Provisioning — Create a subdomain in seconds via Claude

Usage

Just ask Claude:

  • "Create a subdomain called myapp for my viewer on port 8797"
  • "Set up editor.adom.cloud to point to my VS Code on this container"
  • "List all my adom.cloud subdomains"
  • "Delete the test subdomain"

Claude handles all the Cloudflare API calls — DNS record creation, KV mapping, and verification.

Subdomain Rules

  • Lowercase letters, numbers, and hyphens only
  • 1–63 characters
  • Cannot start or end with a hyphen
  • Reserved names blocked: www, api, mail, admin, dashboard, etc.

Architecture

ComponentDetails
Domainadom.cloud (registered on Cloudflare)
Workeradom-dns-proxy — routes *.adom.cloud/*
KV StoreDNS_MAP namespace — subdomain → target URL mappings
DNS RecordsProxied A records → 192.0.2.1 (RFC 5737 dummy IP)
Sourcegallia/dns/ (Worker in worker/, provisioning service in root)

Security

  • The adom.cloud URL becomes public — anyone with it can access the service
  • The secret container hash is never exposed to end users
  • SSL termination at Cloudflare edge
  • Credentials stored securely in ~/.claude/skills/adom-cloud/.env (never committed to git)

Skill Source

Edit AI Skill 
---
name: adom-cloud
description: Provision and manage *.adom.cloud subdomains that proxy to Adom container URLs. Use when the user asks to "create a subdomain", "set up adom.cloud", "make a short URL for my app", "create a DNS entry", "list my subdomains", "delete a subdomain", or wants a clean public URL for any container service. Also trigger when the user mentions "adom.cloud" in the context of creating or managing URLs.
---

# adom.cloud — DNS Proxy Service

Provision short, memorable `*.adom.cloud` URLs that reverse-proxy to long Adom container URLs. Powered by Cloudflare Workers + KV on the edge.

**Example:** `https://dart-selfdriving-thruway.adom.cloud` → proxies to the user's container service, hiding the secret container hash.

## How It Works

```
Browser → myapp.adom.cloud → Cloudflare (proxied DNS) → CF Worker → KV lookup → Container URL
```

The Worker reads the subdomain from the Host header, looks up the target in KV, and reverse-proxies the request (HTTP + WebSocket). The secret container hash never appears in the user's browser.

## Provisioning a Subdomain

To create a new subdomain, you need to do TWO things via the Cloudflare API:

### 1. Create a proxied DNS A record

The IP `192.0.2.1` is a dummy (RFC 5737 documentation address). The Worker intercepts before it reaches origin. **Must be `proxied: true`** (orange cloud).

### 2. Write the KV mapping

The `target` must be a full URL with trailing slash.

### 3. Verify it works

Should return HTTP 200 (or whatever the target returns).

## Subdomain Validation Rules

- Lowercase alphanumeric + hyphens only
- 1–63 characters
- Cannot start or end with a hyphen
- Reserved names blocked

## Architecture Details

- **Domain:** adom.cloud (registered on Cloudflare)
- **Worker:** `adom-dns-proxy` — deployed to Cloudflare edge, routes `*.adom.cloud/*`
- **KV Namespace:** `DNS_MAP` — stores subdomain → target URL mappings
- **DNS records:** Proxied A records pointing to 192.0.2.1 (dummy IP, Worker intercepts)
- **Source code:** `gallia/dns/` (Worker in `worker/`, service in root)

Sub-Skills
?
What are Sub-Skills?

Sub-skills are community-contributed AI skill extensions for this component. They teach AI assistants about specific tools, configurators, or workflows.

Examples:

  • A manufacturer’s configuration tool for a motor controller
  • A community-written design guide for an amplifier circuit
  • An automated test/validation script for a sensor module

How to add one: Click Add Sub-Skill, provide the URL to your skill and a brief description. Submissions are reviewed by the Adom team before going live.

No sub-skills yet. Be the first to contribute one!

0 revisions · Updated 2026-03-09 13:54:05