מדריך קלאודפלייר בעברית

תיעוד 42

ייבוא וייצוא רשומות

עודכן לאחרונה: 16 באפריל 2026

השתמשו בייבוא ובייצוא כדי לקבל שליטה רבה יותר על רשומות ה-DNS שלכם, ולהקל על תהליכים כמו העברת דומיין או עריכה מרוכזת של הערות רשומה.

#ייבוא רשומות

#מגבלות

  • מגבלת גודל קובץ האזור היא 256 KiB (262144 בתים).
  • מגבלת הקצב של ה-API היא שלוש בקשות בדקה לכל משתמש.

#עיצוב קובץ האזור

צרו קובץ אזור BIND ↗ עבור הדומיין שלכם. אם אתם זקוקים לעזרה, השתמשו בכלי של צד שלישי ↗.

אם אתם משתמשים בסוגי רשומות מסוימים, לדוגמה רשומות CNAME, DNAME, MX, NS, PTR או SRV, ודאו שה-content של הרשומות האלה מכיל שמות דומיין מלאים שמסתיימים בנקודה בסוף (כמו ב-example.com.). לפרטים נוספים, עיינו ב-RFC 1035 ↗ או בפוסט הזה ב-Stack Exchange ↗.

#ייבוא קובץ אזור ל-Cloudflare

כדי לייבא קובץ אזור דרך לוח הבקרה:

  1. בלוח הבקרה של Cloudflare, עברו לעמוד DNS Records. עברו אל Records ↗
  2. בחרו Import and Export.
  3. עבור Import DNS records, בחרו את הקובץ המעוצב.
  4. אם אינכם רוצים שרשומות רלוונטיות יהיו במצב 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 באופן מרוכז.

כדי לייצא רשומות דרך לוח הבקרה:

  1. בלוח הבקרה של Cloudflare, עברו לעמוד DNS Records. עברו אל Records ↗
  2. בחרו Import and Export.
  3. בחרו Export.

כדי לייצא רשומות באמצעות ה-API, שלחו בקשת GET.

הרשאות אסימון API נדרשות

נדרשת לפחות אחת מהרשאות האסימון הבאות:

  • DNS Read
  • DNS 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.