Back to Details

domain-mail-automation

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Akademie: Domain, DNS & Mail einrichten

Academy平台：域名、DNS与邮箱配置

Du richtest für den Nutzer Domain, DNS-Einträge, Postfächer und E-Mail-Versand ein. Alles läuft über eine Schnittstelle: die Akademie von gefundenwerden.online. Der Nutzer hat dafür einen persönlichen Schlüssel.
你将为用户配置域名、DNS记录、邮箱及邮件发送功能。所有操作均通过唯一接口完成：gefundenwerden.online的Academy平台。用户拥有对应的个人密钥。

Der Schlüssel

密钥

Der Nutzer findet ihn in der Akademie unter Einstellungen oder in der Info-Box seiner Lektion. Er beginnt mit 
mm_
.
Basis:     https://academy.gefundenwerden.online
Anmeldung: Kopfzeile  Authorization: Bearer mm_…
Frag danach, wenn er fehlt — rate ihn nie. Ein Schlüssel öffnet drei Bereiche: 
/api/dns
, 
/api/mail
und 
/api/bewertungen
. Für SEO- und Marktdaten über dieselbe Route gibt es den eigenen Skill akademie-seo-daten — bei solchen Aufgaben den nutzen. Er gilt nur für die Domains dieses Nutzers; fremde Domains antworten mit 403.
Der Schlüssel gehört nicht in eine Projektdatei. Er bleibt im Gespräch oder in einer Umgebungsvariablen.
用户可在Academy平台的设置页面或课程信息框中找到该密钥，密钥以
mm_
开头。
Basis:     https://academy.gefundenwerden.online
Anmeldung: Kopfzeile  Authorization: Bearer mm_…
若用户未提供密钥，请主动询问——切勿猜测。 密钥可访问三个接口区域：
/api/dns
、
/api/mail
和
/api/bewertungen
。如需获取SEO及市场数据，请使用专属技能akademie-seo-daten——此类任务请调用该技能。密钥仅对用户自身的域名生效，操作他人域名会返回403错误。
密钥不可存入项目文件，仅可保留在对话中或环境变量内。

Grundregeln

基本规则

  • Zeig geplante DNS-Änderungen, bevor du sie setzt. Ein falscher MX-Eintrag leitet die Firmenpost um — das merkt niemand sofort.
  • Bestehende Einträge nie blind überschreiben, erst lesen.
  • Läuft für die Domain schon Mail? Dann keine MX-Einträge ändern, ohne den Nutzer ausdrücklich zu warnen. Umstellen heißt umziehen.
  • Antworten enthalten bei Fehlern immer ein Feld 
    fehler
    mit Klartext.
  • 在设置DNS变更前，先向用户展示计划修改的内容。 错误的MX记录会导致企业邮件转发错误——这种问题不会立即被发现。
  • 切勿盲目覆盖现有记录，应先读取现有记录。
  • 该域名是否已在使用邮件服务？ 若已使用，修改MX记录前必须明确告知用户。修改MX记录意味着迁移邮件服务。
  • 错误响应需包含
    fehler
    字段，并提供清晰的文本说明。

Die Kette (Domain → Website → Mail)

操作流程（域名 → 网站 → 邮箱）

1. Domain frei?         GET  /api/domain-check?domain=…      (ohne Schlüssel)
2. Domain anschließen   POST /api/dns { domain }             → Nameserver + DNS-Token
   → Nutzer trägt die zwei Nameserver bei seinem Registrar ein
3. Website an Vercel    DNS-Einträge setzen (siehe unten)
4. Mail-Domain anlegen  POST /api/mail { aktion:"domain", domain }
5. Mail-DNS holen       POST /api/mail { aktion:"records", domain }
6. Diese Einträge setzen (DNS only!)
7. Freischalten         POST /api/mail { aktion:"aktivieren", domain }
8. Postfächer anlegen   POST /api/mail { aktion:"postfach", … }
Zu Schritt 5: rate die Mail-DNS-Werte nicht. 
records
liefert sie fertig, inklusive des pro Domain individuellen Eigentumsnachweises.
Details stehen in 
references/
:
  • references/dns-und-domain.md
    — Domain-Check, DNS-Zentrale, Vercel
  • references/mail.md
    — Postfächer, Passwörter, Aliase, Aktivierung
  • references/bewertungen.md
    — Google-, Trustpilot- und Tripadvisor-Bewertungen
Lies die passende Datei, bevor du eine Anfrage schickst.
1. 域名是否可用？         GET  /api/domain-check?domain=…      (无需密钥)
2. 绑定域名             POST /api/dns { domain }             → 域名服务器 + DNS令牌
   → 用户需在域名注册商处填写这两个域名服务器
3. 将网站指向Vercel    设置DNS记录（详见下文）
4. 创建邮件域名         POST /api/mail { aktion:"domain", domain }
5. 获取邮件DNS记录     POST /api/mail { aktion:"records", domain }
6. 设置这些记录（仅DNS操作！）
7. 激活邮件域名         POST /api/mail { aktion:"aktivieren", domain }
8. 创建邮箱             POST /api/mail { aktion:"postfach", … }
关于步骤5：切勿自行猜测邮件DNS值。
records
接口会返回完整的配置值，包括每个域名专属的所有权验证信息。
详细内容请查看
references/
目录：
  • references/dns-und-domain.md
    — 域名查询、DNS中心、Vercel配置
  • references/mail.md
    — 邮箱、密码、别名、激活
  • references/bewertungen.md
    — Google、Trustpilot及Tripadvisor评论
发送请求前，请先阅读对应的文档。

Umzug von einem anderen Mail-Anbieter

从其他邮件服务商迁移

Bestehende Postfächer ziehen per IMAP-Sync um — Ablauf und Befehle stehen in 
references/mail.md
unter „Umzug bestehender Postfächer". Die Reihenfolge ist entscheidend: anlegen → syncen → Nutzer prüft in der Webmail → dann erst DNS samt MX → Nachsync. Nur die MX-Einträge bewegen Post; Postfächer und IMAP funktionieren schon vor der Verifizierung.
通过IMAP同步迁移现有邮箱——流程及命令详见
references/mail.md
中的「迁移现有邮箱」章节。操作顺序至关重要：创建新邮箱 → 同步数据 → 用户在网页邮箱中验证 → 最后修改DNS及MX记录 → 再次同步。只有MX记录会影响邮件接收；邮箱及IMAP服务在验证前即可正常使用。

Häufige Fehler

常见错误

  • MX umgestellt, bevor gesynct wurde → neue Mails landen im leeren Postfach und der Bestand fehlt. Reihenfolge einhalten: anlegen → syncen → Nutzer prüft → MX → Nachsync.
  • Passwort ändern mit 
    aktion:"postfach"
     → schlägt fehl. Dafür gibt es 
    aktion:"passwort"
    .
  • Mail-Domain bleibt „inactive" → meist fehlt der Eigentumsnachweis aus 
    records
    . Setzen, dann 
    aktivieren
    .
  • Cloudflare-Proxy an → bricht Zertifikat und Mail. Alle Einträge, die zu Vercel oder Mail gehören, laufen ohne Proxy („DNS only").
  • Subdomain beim Registrar angelegt (All-Inkl, Strato …) → wirkungslos, sobald die Nameserver auf die Akademie-DNS zeigen. Der Eintrag muss über 
    /api/dns
    beziehungsweise das DNS-Token gesetzt werden.
  • 403 → die Domain gehört diesem Konto nicht. Nicht umgehen versuchen, sondern dem Nutzer sagen.
  • 未完成同步就修改MX记录 → 新邮件会进入空邮箱，原有邮件数据丢失。请严格遵循操作顺序：创建 → 同步 → 用户验证 → 修改MX → 再次同步。
  • 使用
    aktion:"postfach"
    修改密码     → 操作会失败。修改密码需使用
    aktion:"passwort"
    。
  • 邮件域名始终处于「inactive」状态 → 通常是缺少
    records
    接口返回的所有权验证记录。设置该记录后，再执行
    aktivieren
    操作。
  • Cloudflare代理已开启 → 会破坏证书及邮件服务。所有指向Vercel或邮件服务的记录需设置为无代理（仅DNS）。
  • 在域名注册商处创建了子域名（如All-Inkl、Strato等）→ 当域名服务器指向Academy DNS后，该设置将失效。子域名需通过
    /api/dns
    接口或DNS令牌进行设置。
  • 返回403错误 → 该域名不属于当前账户。请勿尝试绕过限制，直接告知用户即可。