📘 תיעוד 158

פרמטרי הרצה

עמוד זה מפרט את דגלי התצורה של הפקודה cloudflared tunnel run. עבור מנהרה שמנוהלת מרחוק, הוסיפו את הדגלים האלה לשירות המנהרה. אם אתם משתמשים במנהרה שמנוהלת מקומית, הוסיפו את הדגלים האלה לקובץ התצורה כזוגות מפתח/ערך.

#הוספת פרמטרי הרצה לשירות המנהרה

מנהרות שמנוהלות מרחוק רצות כשירות במערכת ההפעלה. כדי להוסיף פרמטרי הרצה לקובץ שירות המנהרה:

ב-Linux, Cloudflare Tunnel מתקין את עצמו כשירות מערכת באמצעות systemctl. כברירת מחדל, שם השירות יהיה cloudflared.service. כדי להגדיר את המנהרה ב-Linux:

1. פתחו את cloudflared.service.

   העתק

   sudo systemctl edit --full cloudflared.service

2. שנו את הפקודה cloudflared tunnel run עם דגל התצורה הרצוי. לדוגמה,

   העתק

   [Unit]
   Description=Cloudflare Tunnel
   After=network.target
   
   [Service]
   TimeoutStartSec=0
   Type=notify
   ExecStart=/usr/local/bin/cloudflared tunnel --loglevel info --logfile /var/log/cloudflared/cloudflared.log run --token <TOKEN VALUE>
   Restart=on-failure
   RestartSec=5s
   
   [Install]
   WantedBy=multi-user.target

3. הפעילו מחדש את cloudflared.service:

   העתק

   sudo systemctl restart cloudflared

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

   העתק

   sudo systemctl status cloudflared

   העתק

   ● cloudflared.service - cloudflared
     Loaded: loaded (/etc/systemd/system/cloudflared.service; enabled; preset: enabled)
     Active: active (running) since Wed 2024-10-09 20:02:59 UTC; 2s ago
   Main PID: 2157 (cloudflared)
      Tasks: 8 (limit: 1136)
     Memory: 16.3M
        CPU: 136ms
     CGroup: /system.slice/cloudflared.service
             └─2157 /usr/bin/cloudflared tunnel --loglevel info --logfile /var/log/cloudflared/cloudflared.log run --token eyJhIjoi...

ב-macOS, Cloudflare Tunnel מתקין את עצמו כ-launch agent באמצעות launchctl. כברירת מחדל, הסוכן ייקרא com.cloudflare.cloudflared. כדי להגדיר את המנהרה ב-macOS:

1. עצרו את שירות cloudflared.

   העתק

   sudo launchctl stop com.cloudflare.cloudflared

2. פרקו את קובץ התצורה.

   העתק

   sudo launchctl unload /Library/LaunchDaemons/com.cloudflare.cloudflared.plist

3. פתחו את /Library/LaunchDaemons/com.cloudflare.cloudflared.plist בעורך טקסט.

4. שנו את המפתח ProgramArguments עם דגל התצורה הרצוי. לדוגמה,

   העתק

   <plist version="1.0">
       <dict>
           <key>Label</key>
           <string>com.cloudflare.cloudflared</string>
           <key>ProgramArguments</key>
           <array>
               <string>/opt/homebrew/bin/cloudflared</string>
               <string>tunnel</string>
               <string>--logfile</string>
               <string><PATH></string>
               <string>--loglevel</string>
               <string>debug</string>
               <string>run</string>
               <string>--token</string>
               <string><TOKEN VALUE> </string>
           </array>

5. טענו את קובץ התצורה המעודכן.

   העתק

   sudo launchctl load /Library/LaunchDaemons/com.cloudflare.cloudflared.plist

6. הפעילו את שירות cloudflared.

   העתק

   sudo launchctl start com.cloudflare.cloudflared

ב-Windows, Cloudflare Tunnel מתקין את עצמו כשירות מערכת באמצעות עורך הרישום (Registry Editor). כברירת מחדל, שם השירות יהיה cloudflared. כדי להגדיר את המנהרה ב-Windows:

1. פתחו את עורך הרישום (Registry Editor).

2. עברו אל HKEY_LOCAL_MACHINE > SYSTEM > CurrentControlSet > Services > cloudflared.

3. לחצו לחיצה כפולה על ImagePath.

4. שנו את Value data עם דגל התצורה הרצוי. לדוגמה,

   העתק

   C:\Program Files (x86)\cloudflared\.\cloudflared.exe tunnel --loglevel info --logfile <PATH> run --token <TOKEN VALUE>

#פרמטרים

#autoupdate-freq

מגדיר את תדירות העדכונים של cloudflared.

עדכונים אוטומטיים מובנים מופעלים כאשר cloudflared מותקן כקובץ בינארי עצמאי ורץ כשירות. הם אינם זמינים ב-Windows, בהתקנות באמצעות מנהל חבילות, או כאשר cloudflared רץ באופן אינטראקטיבי בטרמינל. כאשר עדכון זמין, cloudflared מופעל מחדש כדי להשתמש בגרסה החדשה. המעדכן אינו ממתין לכך שהתהליך המחליף יתחבר אל Cloudflare לפני כיבוי התהליך הישן. חיבורים פעילים עלולים להיקטע. כדי לשלוט במועד העדכונים, השתמשו ב-no-autoupdate.

#config

הערה

למנהרות שמנוהלות מקומית בלבד.

מציין את הנתיב לקובץ תצורה בפורמט YAML.

#disable-path-normalization

הערה

נדרשת גרסה 2026.10.0 של cloudflared או גרסה מאוחרת יותר.

כאשר הערך הוא false, מתבצע נרמול של כתובות URL לפני התאמה לכללי ingress עבור מנהרות שדורשות אימות של Cloudflare Access. נתיב ה-URL שנשלח אל המקור שלכם נשאר כפי שהוא. הגדירו --disable-path-normalization=false כדי להפעיל נרמול.

ברירת המחדל היא true בגרסה 2026.10.0. לשינוי המתוכנן של ברירת המחדל, עיינו ביומן השינויים של נרמול URL.

#dns-resolver-addrs

הערה

נדרשת גרסה 2025.7.0 של cloudflared או גרסה מאוחרת יותר.

מציין כתובות של פותרי DNS מותאמים אישית שבהן cloudflared ישתמש במקום פותרי ברירת המחדל של מחשב המארח. כל כתובת חייבת להיות בפורמט ip:port. מתן כתובת IP בלי פורט יגרום לכך ש-cloudflared לא יצליח להתחיל. אפשר לציין כמה פותרים על ידי חזרה על הדגל. לדוגמה,

cloudflared tunnel run --dns-resolver-addrs 1.1.1.1:53 --dns-resolver-addrs 1.0.0.1:53 <UUID or NAME>

כאשר מצוינים כמה פותרים, cloudflared בוחר אחד באקראי עבור כל בקשת DNS. מותרות לכל היותר 10 כתובות של פותרים.

#edge-bind-address

מציין את כתובת ה-IP היוצאת המשמשת ליצירת חיבור בין cloudflared לרשת הגלובלית של Cloudflare.

כברירת מחדל, cloudflared מאפשר למערכת ההפעלה להחליט באיזו כתובת IP להשתמש. אפשרות זו שימושית אם יש לכם כמה ממשקי רשת זמינים ואתם רוצים להעדיף ממשק מסוים.

גרסת ה-IP של edge-bind-address תעקוף את edge-ip-version (אם סופקה). לדוגמה, אם תזינו כתובת מקור מסוג IPv6, cloudflared תמיד יתחבר ליעד מסוג IPv6.

#edge-ip-version

מציין את גרסת כתובת ה-IP (IPv4 או IPv6) המשמשת ליצירת חיבור בין cloudflared לרשת הגלובלית של Cloudflare. הערכים הזמינים הם auto, 4 ו-6.

הערך auto מסתמך על מערכת ההפעלה המארחת כדי לקבוע איזו גרסת IP לבחור. גרסת ה-IP הראשונה שתוחזר מפענוח ה-DNS של חיפוש האזור תשמש כקבוצה הראשית. בהגדרות רשת כפולות של IPv6 ו-IPv4, cloudflared יפריד את גרסאות ה-IP לשתי קבוצות כתובות שישמשו כגיבוי בתרחישי כשל בקישוריות.

#grace-period

כאשר cloudflared מקבל SIGINT/SIGTERM הוא יפסיק לקבל בקשות חדשות, ימתין שבקשות שנמצאות בתהליך יסתיימו, ואז יכבה את עצמו. ההמתנה לבקשות שנמצאות בתהליך תסתיים לאחר תקופת החסד הזו, או כאשר מתקבל SIGTERM/SIGINT שני.

#log-directory

כותב יומנים לקובץ בשם cloudflared.log בספרייה שצוינה. כאשר הקובץ מגיע ל-1 MB, cloudflared מסובב אותו ושומר עד חמישה קובצי גיבוי. הסיבוב מבוסס על גודל הקובץ. אין שמירה לפי גיל.

השתמשו ב-log-directory לרישום יומן קבוע שגרתי. אם תציינו גם את logfile, ל-logfile יש קדימות.

#logfile

שומר את יומן היישום בקובץ זה. cloudflared אינו מסובב את הקובץ הזה. השתמשו ב-logfile להפעלות קצרות של איתור תקלות או כאשר כלי אחר מנהל את סיבוב היומנים. אם תציינו גם את log-directory, ל-logfile יש קדימות. לפרטים נוספים על המידע שנדרש בעת פנייה לתמיכה של Cloudflare, עיינו במדריך זה.

#loglevel

מציין את רמת הפירוט של הרישום ביומן עבור מופע cloudflared המקומי. הערכים הזמינים הם debug, info (ברירת מחדל), warn, error ו-fatal. ברמת debug, cloudflared ירשום ביומן ויציג את כתובת ה-URL של הבקשה, השיטה, הפרוטוקול, אורך התוכן, וגם את כל כותרות הבקשה והתגובה. עם זאת, שימו לב שזה עלול לחשוף מידע רגיש ביומנים.

#metrics

חושף נקודת קצה של Prometheus בכתובת ה-IP ובפורט שצוינו, ואז אפשר לשלוח אליה שאילתה עבור מדדי שימוש.

#no-autoupdate

הערה

פרמטר זה אינו חל כאשר cloudflared רץ ב-Windows, הותקן על ידי מנהל חבילות, או רץ באופן אינטראקטיבי בטרמינל. עדכונים אוטומטיים אינם זמינים בסביבות אלה.

אפשר לבדוק אם cloudflared הותקן על ידי מנהל חבילות על ידי הרצת ls -la /usr/local/etc/cloudflared/ וחיפוש .installedFromPackageManager בפלט.

משבית עדכונים אוטומטיים של cloudflared. כדי לשנות את מרווח העדכון האוטומטי, עיינו ב-autoupdate-freq. לשיטות עדכון ידניות ולאפשרויות לצמצום זמן השבתה, עיינו בעדכון cloudflared.

#output

הערה

נדרשת גרסה 2025.6.1 של cloudflared או גרסה מאוחרת יותר.

מציין את פורמט יומן המסוף. הערכים הזמינים הם default ו-json.

הערך json מעצב כל שורת יומן כאובייקט JSON. פורמט זה שימושי לפריסות Kubernetes ולמערכות איסוף יומנים שצורכות JSON.

#origincert

הערה

למנהרות שמנוהלות מקומית בלבד.

מציין את אישור החשבון עבור אחד האזורים שלכם, ומאשר ללקוח לשמש כמקור עבור האזור הזה. אפשר לקבל אישור באמצעות הפקודה cloudflared tunnel login או על ידי ביקור ב-https://dash.cloudflare.com/argotunnel.

#pidfile

כותב את מזהה התהליך (PID) של היישום לקובץ זה לאחר החיבור המוצלח הראשון. שימושי בעיקר לסקריפטים ולשילוב עם שירותים.

#post-quantum

כברירת מחדל, חיבורי Cloudflare Tunnel דרך quic מוצפנים באמצעות הצפנה פוסט-קוונטית (PQC) אבל יחזרו למצב שאינו PQ אם יש בעיות בחיבור. אם הדגל --post-quantum מסופק, חיבורי quic מורשים להשתמש רק בהסכמות מפתח PQ, בלי נפילה למצב שאינו PQ.

הסכמות מפתח פוסט-קוונטיות אינן נתמכות בעת שימוש בפרוטוקול http2.

#protocol

מציין את הפרוטוקול המשמש ליצירת חיבור בין cloudflared לרשת הגלובלית של Cloudflare. הערכים הזמינים הם auto, http2 ו-quic.

הערך auto יגדיר באופן אוטומטי את פרוטוקול quic. אם cloudflared אינו מצליח ליצור חיבורי UDP, הוא יעבור לשימוש בפרוטוקול http2.

#region

מאפשר לבחור את האזורים שאליהם נוצרים החיבורים. כרגע הערך הזמין היחיד הוא us, שמנתב את כל החיבורים דרך מרכזי נתונים בארצות הברית. השמיטו או השאירו ריק כדי להתחבר לאזור הגלובלי.

כאשר האזור מוגדר ל-us, cloudflared משתמש בשמות מארח ובכתובות IP ייעודיים לארצות הברית. עיינו במנהרה עם חומת אש לפרטים.

הערה

עבור סביבות FedRAMP High ↗︎, אסימון המנהרה קובע ניתוב למרכזי הנתונים של FedRAMP באופן אוטומטי. אין צורך בדגל --region. עיינו במנהרה עם חומת אש עבור נקודות הקצה הייעודיות ל-FedRAMP שחומת האש שלכם חייבת לאפשר.

#retries

מציין את המספר המרבי של ניסיונות חוזרים עבור שגיאות חיבור או פרוטוקול. הניסיונות החוזרים משתמשים בהשהיה מעריכית (ניסיון חוזר לאחר 1, 2, 4, 8, 16 שניות כברירת מחדל), ולכן לא מומלץ להגדיל את הערך הזה באופן משמעותי.

#tag

מציין תגיות מותאמות אישית המשמשות לזיהוי המנהרה הזו. אפשר לציין כמה תגיות על ידי הוספת דגלי --tag <KEY=VAL> נוספים לפקודה. אם מזינים כמה תגיות לקובץ תצורה, הפרידו בפסיקים: tag: {KEY1=VALUE1, KEY2=VALUE2}.

#token

הערה

למנהרות שמנוהלות מרחוק בלבד.

משייך את מופע cloudflared למנהרה מסוימת. אסימון המנהרה מוצג בלוח הבקרה כאשר יוצרים את המנהרה בפעם הראשונה. אפשר גם לאחזר את האסימון באמצעות ה-API.

#token-file

הערה

למנהרות שמנוהלות מרחוק בלבד. נדרשת גרסה 2025.4.0 או מאוחרת יותר.

משייך את מופע cloudflared למנהרה מסוימת באמצעות קובץ שמכיל את האסימון.