Konfiguracja e-mail — [email protected]
Instrukcja operacyjna dotycząca skonfigurowania
[email protected](i podobnych adresów) na istniejącej domenie hostowanej przez Cloudflare. Możesz wykonać samodzielnie, ~10 minut, bezpłatne na etapie F&F.
Phase 53.9 · Ostatnia aktualizacja: 2026-05-08 · Dostawca: Cloudflare Email Routing (zalecany dla F&F)
Dlaczego ten przewodnik istnieje
Arc OS wysyła dziś pocztę wychodzącą (weryfikacja, reset hasła) przez Resend z From: [email protected] — zob. shared/email.ts. Ale domena nie ma żadnej poczty przychodzącej: dig MX arc-os.co zwraca puste wyniki, więc wszystko wysłane na [email protected] odbija się. To psuje:
- Link
Supportw stopce (mailto:[email protected]) - Oczekiwanie „odpowiedz z pytaniami" w przepływie rejestracji
- E-mailowy fallback zgłaszania błędów dla użytkowników, którzy nie otwierają widżetu FeedbackWidget w aplikacji
- Wszelkie przyszłe przepływy „odpowiedz użytkownikowi"
Ten przewodnik włącza pocztę przychodzącą bez kupowania skrzynki pocztowej.
Pre-flight
- Konto Cloudflare ze strefą
arc-os.co(już skonfigurowane — rekordy NSamir.ns.cloudflare.com/becky.ns.cloudflare.com) - Osobisty Gmail (lub dowolna działająca skrzynka) gotowy do odbierania przekierowań
- 10 minut
- NIE włączaj na etapie weryfikacji domeny Resend przed ukończeniem tego przewodnika — Cloudflare Email Routing publikuje własne rekordy MX/SPF i będziesz mieć konflikty
Faza A — Cloudflare Email Routing (BEZPŁATNE, zalecane)
Krok 1 — Włącz Email Routing w panelu Cloudflare
- Otwórz https://dash.cloudflare.com → wybierz strefę arc-os.co
- Lewy panel boczny → Email → Email Routing
- Kliknij Enable Email Routing
- Cloudflare oferuje automatyczne dodanie wymaganych rekordów DNS — zaakceptuj. Wpisze:
MX 10 amir.mx.cloudflare.net.MX 20 isaac.mx.cloudflare.net.MX 30 linda.mx.cloudflare.net.TXT v=spf1 include:_spf.mx.cloudflare.net ~all
- Upewnij się, że pojawia się zielony znacznik przy „DNS records configured correctly"
Krok 2 — Zweryfikuj cel (Gmail) jednorazowo
Cloudflare wysyła jednorazowy e-mail weryfikacyjny na adres, na który będziesz przekierowywać pocztę. Kliknij link.
Krok 3 — Dodaj reguły przekierowania
W Email Routing → Routes kliknij Create address. Dodaj trzy:
| Adres niestandardowy | Akcja | Cel |
|---|---|---|
[email protected] |
Przekieruj na | <twój-gmail>@gmail.com |
[email protected] |
Przekieruj na | <twój-gmail>@gmail.com |
[email protected] |
Przekieruj na | <twój-gmail>@gmail.com |
Opcjonalnie: dodaj regułę Catch-all → przekieruj na Gmail. Łapie literówki jak
[email protected].
Krok 4 — Wyślij test
echo "test from $(hostname) at $(date)" | mail -s "Email Routing test" [email protected]
Lub po prostu wyślij ze swojego telefonu. Powinno dotrzeć do Gmaila w ciągu ~10 sekund z zachowanym From: <nadawca> i To: [email protected].
Krok 5 — Odpowiadaj z Gmaila jako [email protected] (opcjonalne, ale wygodne)
Cloudflare Email Routing działa tylko przychodzące — nie możesz WYSYŁAĆ z [email protected]. Obejście przez Gmail:
- Gmail → Ustawienia → Konta → Wyślij pocztę jako → Dodaj inny adres e-mail
- Adres:
[email protected], Nazwa:Arc OS Team - Wychodzące SMTP: własne SMTP Gmaila (Cloudflare nie proksuje ruchu wychodzącego)
- Zweryfikuj za pomocą kodu wysłanego przez Gmail — e-mail weryfikacyjny trafia z powrotem do Gmaila przez regułę przekierowania, więc jest natychmiastowy
Gmail pozwoli ci pisać z From: [email protected]. Odbiorcy to widzą. Reply-To wraca na [email protected] → łańcuch przekierowania → Gmail.
Krok 6 — Zaktualizuj nagłówek From: w rejestracji CRM
Już poprawny — shared/email.ts:32 domyślnie Citadel <[email protected]>. Potwierdź, że RESEND_API_KEY jest w vault i domena arc-os.co Resend jest zweryfikowana w ich pulpicie. Resend używa osobnego zestawu rekordów CNAME DKIM (*.resend._domainkey), które nie kolidują z MX/SPF Email Routing.
Jeśli chcesz też, żeby potwierdzenia rejestracji trafiały na adresy obsługiwane przez info@, żadnych zmian nie potrzebujesz — Resend po prostu wysyła; Cloudflare po prostu odbiera.
Faza B — DMARC (zalecane po zweryfikowaniu Fazy A)
DMARC chroni domenę przed spoofingiem. Gdy Cloudflare Email Routing (przychodzące) i Resend (wychodzące) działają, dodaj rekord TXT do monitorowania:
Name: _dmarc.arc-os.co
Type: TXT
Value: v=DMARC1; p=none; rua=mailto:[email protected]; pct=100
p=none zbiera raporty bez odrzucania czegokolwiek. Po 2 tygodniach czystych raportów przejdź na p=quarantine, a potem p=reject.
Faza C — Wyrośnij z przekierowań → prawdziwa skrzynka (później)
Gdy przekierowania nie wystarczają (oddzielne skrzynki dla ról, zaproszenia kalendarza, aplikacje mobilne, niezawodne wysyłanie z domeny):
| Dostawca | Koszt | Czas konfiguracji | Zalety |
|---|---|---|---|
| Zoho Mail Lite | $1/użytkownik/mies. (lub bezpłatnie dla ≤5 użytkowników z brandingiem Zoho) | 30 min | Pełna skrzynka, aplikacja mobilna, wysyłanie z info@ natywnie |
| Google Workspace | $6/użytkownik/mies. | 30 min | Gmail + Calendar + Drive + konsola admina najwyższej klasy |
| Fastmail | $5/użytkownik/mies. | 30 min | Nastawiony na prywatność, bez reklam, szybki UI |
Ścieżka migracji z Cloudflare → skrzynka: usuń regułę przekierowania dla adresu, który przenosisz (np. info@), zaktualizuj rekordy MX do nowego dostawcy, pozostaw Cloudflare Email Routing dla adresów, które nadal chcesz przekierowywać (np. bugs@ może być przekierowywany na zawsze).
Nie migruj przedwcześnie. Wolumen poczty F&F rzadko uzasadnia kognitywny narzut osobnej skrzynki.
Lista weryfikacyjna
Po ukończeniu Fazy A:
-
dig MX arc-os.cozwraca 3 rekordy Cloudflare -
dig TXT arc-os.cozawierav=spf1 include:_spf.mx.cloudflare.net - Testowy e-mail na
[email protected]trafia do Gmaila w <30s - Link
Supportw AppFooter CRM działa (teraz wskazuje nainfo@) - Stan sukcesu FeedbackWidget wspomina
[email protected] - Link kontaktowy w README działa
- Domena
arc-os.cow Resend nadal wyświetla zielony kolor w pulpicie (brak konfliktu DNS)
Po ukończeniu Fazy B:
-
dig TXT _dmarc.arc-os.cozwraca politykę - Pierwszy raport DMARC otrzymany na
[email protected]w ciągu 24h
Elementy do wykonania przez CEO (nie da się zautomatyzować)
- Teraz: otwórz Cloudflare → Email → włącz Email Routing → zaakceptuj DNS → zweryfikuj cel Gmail → dodaj 3 reguły przekierowania. ~7 minut.
- Opcjonalnie: konfiguracja „Wyślij pocztę jako" w Gmailu. ~3 minuty.
- Opcjonalnie: dodaj rekord TXT DMARC. ~1 minuta.
Po wykonaniu kroku 1 daj znać, a zamkniemy issue #39.
Odniesienia
- Dokumentacja Cloudflare Email Routing: https://developers.cloudflare.com/email-routing/
- Weryfikacja domeny Resend: https://resend.com/docs/dashboard/domains/introduction
- Istniejący helper e-mail CRM:
shared/email.ts - Istniejący link w stopce:
frontend/src/crm/components/AppFooter.jsx:17