תיעוד 42
ייבוא וייצוא רשומות
עודכן לאחרונה: 16 באפריל 2026
השתמשו בייבוא ובייצוא כדי לקבל שליטה רבה יותר על רשומות ה-DNS שלכם, ולהקל על תהליכים כמו העברת דומיין או עריכה מרוכזת של הערות רשומה.
#ייבוא רשומות
#מגבלות
- מגבלת גודל קובץ האזור היא 256 KiB (262144 בתים).
- מגבלת הקצב של ה-API היא שלוש בקשות בדקה לכל משתמש.
#עיצוב קובץ האזור
צרו קובץ אזור BIND ↗ עבור הדומיין שלכם. אם אתם זקוקים לעזרה, השתמשו בכלי של צד שלישי ↗.
אם אתם משתמשים בסוגי רשומות מסוימים, לדוגמה רשומות CNAME, DNAME, MX, NS, PTR או SRV, ודאו שה-content של הרשומות האלה מכיל שמות דומיין מלאים שמסתיימים בנקודה בסוף (כמו ב-example.com.). לפרטים נוספים, עיינו ב-RFC 1035 ↗ או בפוסט הזה ב-Stack Exchange ↗.
#ייבוא קובץ אזור ל-Cloudflare
כדי לייבא קובץ אזור דרך לוח הבקרה:
- בלוח הבקרה של Cloudflare, עברו לעמוד DNS Records. עברו אל Records ↗
- בחרו Import and Export.
- עבור Import DNS records, בחרו את הקובץ המעוצב.
- אם אינכם רוצים שרשומות רלוונטיות יהיו במצב proxied, בטלו את הסימון של Proxy imported DNS records.
כדי לייבא רשומות באמצעות ה-API, שלחו בקשת POST עם קובץ מעוצב כראוי.
הרשאות אסימון API נדרשות
נדרשת לפחות אחת מהרשאות האסימון הבאות:
DNS Write
ייבוא רשומות DNS, bash
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_records/import" \
--request POST \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--form "file=@your_formatted_file.txt"#ייצוא רשומות
אפשר גם לייצא רשומות מ-Cloudflare באופן מרוכז.
כדי לייצא רשומות דרך לוח הבקרה:
- בלוח הבקרה של Cloudflare, עברו לעמוד DNS Records. עברו אל Records ↗
- בחרו Import and Export.
- בחרו Export.
כדי לייצא רשומות באמצעות ה-API, שלחו בקשת GET.
הרשאות אסימון API נדרשות
נדרשת לפחות אחת מהרשאות האסימון הבאות:
DNS ReadDNS Write
ייצוא רשומות DNS, bash
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_records/export" \
--request GET \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"#מאפייני רשומת DNS
בייצוא או בייבוא של קובץ אזור, Cloudflare מעצבת הערות ותגיות במבנה הבא, ומוסיפה את המאפיינים כהערה בתוך השורה באמצעות התו ; אחרי כל רשומה, בהתאם ל-RFC 1035 סעיף 5 ↗:
| שילוב | תיאור |
|---|---|
| רק תגיות | שמות תגיות מכילים קבוצה קטנה של תווים. בנוסף, ערכי תגיות חייבים להיות מוקפים במירכאות כפולות ( ") אם הם מכילים ", =, , או \. כשהם מוקפים במירכאות כפולות ("), ערכי התגיות מיוצגים כמחרוזות JSON, כך שמירכאות אחרות בתוך הערך יכולות להופיע עם תו הבריחה \".תגית עם ערך ריק יכולה להיות מיוצגת כ- my-tag-name:"", כ-my-tag-name: או כ-my-tag-name. |
| רק הערה | להערות יש פחות מגבלות על תווים, כלומר ההערה נכללת כלשונה. אם ההערה כוללת את המחרוזת cf_tags=, צריך לכלול cf_tags= נוסף בסוף השורה. |
| הערה ותגיות | הערת קובץ האזור תהיה בצורה ; <comment> cf_tags=<tags>, כמתואר למעלה. שימו לב לתו הרווח שנוסף לפני cf_tags=. |
| בלי אף מאפיין | ההערה בקובץ האזור יכולה להיות ריקה או להישמט לגמרי. גם הערות בקובץ האזור שאינן באות מיד אחרי רשומה מתעלמים מהן. |
קובץ אזור לדוגמה, txt
; Only tags
a.example.com. 60 IN A 1.1.1.1 ; cf_tags=awesome
b.example.com. 60 IN A 1.1.1.1 ; cf_tags=tag1,tag2:value2,tag3:"value,with,commas",tag4:"value with \"escaped\" quotation marks"
; Only a comment
c.example.com. 60 IN A 1.1.1.1 ; just a comment without tags
d.example.com. 60 IN A 1.1.1.1 ; this comment contains cf_tags= as text cf_tags=
; Comments and tags
e.example.com. 60 IN A 1.1.1.1 ; simple example cf_tags=important,ticket:THIS-12345
f.example.com. 60 IN A 1.1.1.1 ; this is the comment cf_tags=tag1:value1,tag2:value2,tag-without-value,another-tag-without-value,tag-with-quoted-value:"because of the comma, quotes are needed"
; Neither attribute
g.example.com. 60 IN A 1.1.1.1#תגיות cf- שמורות
בייצוא ובייבוא, תגיות מיוחדות שמתחילות ב-cf- מאפשרות לשלוט בהגדרות מסוימות של Cloudflare. בייצוא, התגיות האלה מתווספות אוטומטית כדי לשקף את ההגדרה הנוכחית של כל רשומה באזור.
דוגמה לרשומות עם תגיות cf-, txt
;; CNAME Records
a.cloudflaredocs.com. 1 IN CNAME example.com. ; cf_tags=test:1,cf-flatten-cname
b.cloudflaredocs.com. 1 IN CNAME example.com. ; cf_tags=cf-proxied:false
c.cloudflaredocs.com. 1 IN CNAME example.com. ; cf_tags=tag-without-value,cf-proxied:true#cf-proxied
בייצוא, רשומות DNS במצב proxied יציגו תגית cf-proxied:true, ורשומות DNS-only יקבלו את התגית cf-proxied:false.
בייבוא קובצי אזור, הערך בתגית cf-proxied יקבל עדיפות בקביעה אם רשומה צריכה להיות במצב proxied. המשמעות:
- אם התגית קיימת, הערך שלה ייחשב עבור הרשומה המתאימה, בין שהאפשרות Proxy imported DNS records נבחרה (דרך לוח הבקרה) ובין שהפרמטר
proxiedהוגדר באופן כללי ל-trueאו ל-false(דרך ה-API). - אם התגית חסרה, סטטוס ה-proxied יחזור לאפשרות הייבוא הכללית, כלומר Proxy imported DNS records נבחרה או לא (דרך לוח הבקרה), או שהפרמטר
proxiedהוגדר ל-trueאו ל-false(דרך ה-API).
#cf-flatten-cname
אם אתם באזור בתשלום ורוצים להשתמש ב-Per-record CNAME flattening, השתמשו בתגית cf-flatten-cname ליד כל רשומת CNAME שטוחה בקובץ האזור. בייצוא, התגית הזו מתווספת אוטומטית כדי לשקף את הגדרת הרשומה שיש לכם באזור.
#הנחיות קובץ אזור DNS
קובץ אזור DNS יכול להיבנות באמצעות הנחיות בנוסף לרשומות משאב (RRs). הנחיות מתחילות ב-$ והן תקניות: $ORIGIN ו-$INCLUDE מוגדרות ב-RFC 1035 ↗, ו-$TTL מוגדר ב-RFC 2308 ↗. בנוסף, BIND מספק את ההנחיה $GENERATE הלא תקנית ↗.
Cloudflare תומכת בהנחיות $ORIGIN, $TTL ו-$GENERATE.
$INCLUDE אינה נתמכת. כשקובץ אזור מכיל הנחיית $INCLUDE, Cloudflare מגיבה בשגיאת פענוח $INCLUDE directive not allowed.