## Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/redirectcenter#sponsor)]
================================================
FILE: db/guardian.json
================================================
{"denyFqdn":[]}
================================================
FILE: deno.json
================================================
{
"tasks": {
"dev": "deno run --watch --allow-net --allow-read --allow-env src/main.ts",
"start": "deno run --allow-net --allow-read --allow-env src/main.ts",
"test": "deno test --allow-net --allow-read --allow-env"
},
"imports": {
"hono": "jsr:@hono/hono@^4",
"hono/cookie": "jsr:@hono/hono@^4/cookie",
"hono/compress": "jsr:@hono/hono@^4/compress",
"hono/deno": "jsr:@hono/hono@^4/deno",
"hono/": "jsr:@hono/hono@^4/",
"ventojs": "https://deno.land/x/vento@v1.12.12/mod.ts",
"psl": "npm:psl@^1.9.0",
"parse-domain": "npm:parse-domain@^5.0.0"
},
"compilerOptions": {
"strict": true
}
}
================================================
FILE: redirect-center.service
================================================
[Unit]
Description=Redirect Center - DNS CNAME redirect service
After=network.target
[Service]
Type=simple
User=www-data
WorkingDirectory=/opt/redirect.center
ExecStart=/usr/bin/deno run --allow-net --allow-read --allow-env --v8-flags=--max-old-space-size=128,--optimize-for-size src/main.ts
Restart=always
RestartSec=3
Environment=FQDN=redirect.center
Environment=ENTRY_IP=54.84.55.102
Environment=LISTEN_PORT=80
Environment=LOGGER_LEVEL=info
# Logging
StandardOutput=journal
StandardError=journal
SyslogIdentifier=redirect-center
# Security hardening
NoNewPrivileges=true
[Install]
WantedBy=multi-user.target
================================================
FILE: src/config.ts
================================================
export interface AppConfig {
fqdn: string;
entryIp: string;
listenPort: number;
listenIp: string;
environment: string;
projectName: string;
loggerLevel: string;
}
export function loadConfig(): AppConfig {
return {
fqdn: Deno.env.get("FQDN") || "localhost",
entryIp: Deno.env.get("ENTRY_IP") || "127.0.0.1",
listenPort: Number(Deno.env.get("LISTEN_PORT")) || 3000,
listenIp: Deno.env.get("LISTEN_IP") || "0.0.0.0",
environment: Deno.env.get("ENVIRONMENT") || "dev1",
projectName: Deno.env.get("PROJECT_NAME") || "redirect.center",
loggerLevel: Deno.env.get("LOGGER_LEVEL") || "debug",
};
}
export const config = loadConfig();
================================================
FILE: src/helpers/base32.ts
================================================
const ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
export function encode(data: Uint8Array): string {
let result = "";
let bits = 0;
let value = 0;
for (const byte of data) {
value = (value << 8) | byte;
bits += 8;
while (bits >= 5) {
result += ALPHABET[(value >>> (bits - 5)) & 0x1f];
bits -= 5;
}
}
if (bits > 0) {
result += ALPHABET[(value << (5 - bits)) & 0x1f];
}
return result;
}
export function decode(encoded: string): Uint8Array {
const input = encoded.toUpperCase().replace(/=+$/, "");
const output: number[] = [];
let bits = 0;
let value = 0;
for (const char of input) {
const idx = ALPHABET.indexOf(char);
if (idx === -1) continue;
value = (value << 5) | idx;
bits += 5;
if (bits >= 8) {
output.push((value >>> (bits - 8)) & 0xff);
bits -= 8;
}
}
return new Uint8Array(output);
}
================================================
FILE: src/helpers/base32_test.ts
================================================
import { assertEquals } from "https://deno.land/std@0.224.0/assert/mod.ts";
import { decode, encode } from "./base32.ts";
Deno.test("base32 encode", () => {
const input = new TextEncoder().encode("AnY");
const result = encode(input);
assertEquals(result, "IFXFS");
});
Deno.test("base32 decode", () => {
const result = decode("IFXFS");
const text = new TextDecoder().decode(result);
assertEquals(text, "AnY");
});
Deno.test("base32 encode/decode roundtrip", () => {
const original = "AaBbCc";
const encoded = encode(new TextEncoder().encode(original));
const decoded = new TextDecoder().decode(decode(encoded));
assertEquals(decoded, original);
});
Deno.test("base32 decode with padding", () => {
const result = decode("IFXFS===");
const text = new TextDecoder().decode(result);
assertEquals(text, "AnY");
});
Deno.test("base32 encode /test", () => {
const input = new TextEncoder().encode("/test");
const result = encode(input);
assertEquals(result.toLowerCase(), "f52gk43u".toLowerCase());
});
Deno.test("base32 encode abc=def", () => {
const input = new TextEncoder().encode("abc=def");
const result = encode(input);
assertEquals(result.toLowerCase(), "mfrggplemvta".toLowerCase());
});
================================================
FILE: src/helpers/dns-doh-resolver.ts
================================================
/**
* DNS over HTTPS (DoH) resolver — drop-in replacement for Deno.resolveDns().
*
* Returns the same format as Deno.resolveDns(host, "CNAME"):
* - Success: string[] with trailing dot (e.g., ["target.example.com."])
* - Error: throws Error with message matching Deno's pattern
*
* Uses Cloudflare and Google as DoH providers (same order as DNS_SERVERS).
* Uses fetch() instead of native UDP — avoids Deno native memory leak (#28307).
*/
const DOH_SERVERS = (Deno.env.get("DOH_SERVERS") ||
"https://cloudflare-dns.com/dns-query,https://dns.google/resolve")
.split(",")
.map((s) => s.trim())
.filter(Boolean);
interface DoHAnswer {
type: number;
data: string;
}
interface DoHResponse {
Status: number;
Answer?: DoHAnswer[];
}
/**
* Resolve CNAME records via DNS over HTTPS.
* Signature and return format match Deno.resolveDns(host, "CNAME").
*/
export async function resolveCnameDoH(host: string): PromiseRedirect any domain using only a DNS record. No server, no hosting, no code. Redirecione qualquer domínio usando apenas um registro DNS. Sem servidor, sem hospedagem, sem código.
Three steps. No account, no sign-up — completely free and open source. Três passos. Sem cadastro, sem conta — totalmente gratuito e open source.
Create an A record pointing to {{ app.entryIp }}
Crie um registro A apontando para {{ app.entryIp }}
Create a CNAME like dest.com.{{ app.fqdn }}
Crie um CNAME como dest.com.{{ app.fqdn }}
Visitors get a 301 redirect automatically. Visitantes recebem um redirect 301 automaticamente.
Click each example to see the DNS records you need. Clique em cada exemplo para ver os registros DNS necessários.
my-domain.com → www.my-domain.com
Redirect your bare/root domain to the www version: Redirecione seu domínio raiz para a versão www:
.opts-https to force HTTPS: www.my-domain.com.opts-https.{{ app.fqdn }}
Adicione .opts-https para forçar HTTPS: www.my-domain.com.opts-https.{{ app.fqdn }}
www.my-domain.com → www.other-domain.com
Redirect a subdomain to a completely different domain: Redirecione um subdomínio para um domínio completamente diferente:
/page → /page
Keep the original URL path and query string when redirecting: Mantenha o caminho e a query string originais ao redirecionar:
.opts-uri passes the full request path and query string to the destination.
.opts-uri repassa o caminho completo e a query string para o destino.
jobs.my-domain.com → my-domain.com/careers?ref=dns
Redirect a subdomain to a specific path with query parameters: Redirecione um subdomínio para um caminho específico com parâmetros de consulta:
.opts-slash.careers adds /careers. The query ref=dns is Base32-encoded. Use the CNAME Generator to build these automatically.
.opts-slash.careers adiciona /careers. A query ref=dns é codificada em Base32. Use o Gerador de CNAME para gerar automaticamente.
Modifiers you can add to your CNAME record to customize the redirect. Modificadores que você pode adicionar ao seu registro CNAME para personalizar o redirecionamento.
| Parameter Parâmetro | Description Descrição | Example Exemplo |
|---|---|---|
.opts-https |
Force redirect to HTTPS Forçar redirecionamento para HTTPS | example.com.opts-https.{{ app.fqdn }} |
.opts-uri |
Preserve original path and query string Preservar caminho e query string originais | example.com.opts-uri.{{ app.fqdn }} |
.opts-slash.{path} |
Append a path to the destination URL Adicionar um caminho à URL de destino | example.com.opts-slash.blog.{{ app.fqdn }} |
.opts-path-{base32} |
Base32-encoded path (for special characters) Caminho codificado em Base32 (para caracteres especiais) | example.com.opts-path-mfrgg.{{ app.fqdn }} |
.opts-query-{base32} |
Base32-encoded query string Query string codificada em Base32 | example.com.opts-query-nfxgg.{{ app.fqdn }} |
.opts-statuscode-{code} |
HTTP status code: 301, 302, 307 or 308 Código de status HTTP: 301, 302, 307 ou 308 | example.com.opts-statuscode-302.{{ app.fqdn }} |
.opts-port-{port} |
Redirect to a specific port Redirecionar para uma porta específica | example.com.opts-port-8080.{{ app.fqdn }} |