הגדר אירוח תת-נתיב עם Cloudflare

ניתן לארח את מרכז העזרה Notiondesk שלך בתת-נתיב של הדומיין הראשי שלך באמצעות Cloudflare Workers .

לדוגמה, במקום להשתמש בתת-דומיין כמו help.yourdomain.com, ניתן להגיש את מרכז העזרה שלך מ:

הגדרה זו שימושית כאשר אתר האינטרנט הראשי שלך כבר משתמש ב- Cloudflare ואתה רוצה שהתיעוד או תוכן התמיכה שלך יישארו תחת אותו דומיין.

לפני שאתם מתחילים

לפני הגדרת אירוח תת-נתיב עם Cloudflare, ודא שיש לך:

yourdomain.com/help

yourdomain.com/docs

yourdomain.com/support

• מרכז עזרה קיים של Notiondesk

• גישה ללוח המחוונים של Cloudflare

• דומיין המנוהל דרך Cloudflare

• נתיב משנה שברצונך להשתמש בו עבור מרכז העזרה שלך, כגון:
  • __נשמר_13__

  • __נשמר_12__

  • __נשמר_11__

• אירוח תת-נתיב מופעל ב-Notiondesk

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

הפעל אירוח נתיב משנה ב-Notiondesk

ראשית, הפעל אירוח נתיב משנה מלוח המחוונים Notiondesk שלך.

1. פתח את לוח המחוונים Notiondesk שלך.

2. עבור אל הגדרות > כללי

3. גלול מטה אל הקטע דומיינים

4. הפעל את מתג נתיב המשנה

5. בחר את Cloudflare כספק ההתקנה שלך

6. העתק את קוד ה-Cloudflare Worker שנוצר על ידי Notiondesk

Notiondesk מייצר באופן אוטומטי את קוד ה-Cloudflare Worker עם הערכים הנכונים עבור מרכז העזרה שלך.

עליך להעתיק את הקוד ישירות מלוח המחוונים שלך, מכיוון שהוא מכיל ערכים ספציפיים להגדרה שלך, כגון:

• מארח המקור Notiondesk שלך

• הדומיין המותאם אישית שלך

• נתיב המשנה שבחרת

צור עובד Cloudflare

לאחר מכן, צור Cloudflare Worker שיעביר את נתיב המשנה של מרכז העזרה שלך ל-Notiondesk.

1. פתח את לוח המחוונים של Cloudflare

2. עבור אל עובדים ודפים

3. לחץ על צור יישום

4. בחר עובד

5. צור עובד חדש

6. פתח את עורך העובדים

7. החלף את קוד ברירת המחדל בקוד שנוצר על ידי Notiondesk

8. לחץ על שמור ופרוס

לאחר פריסת ה-Worker, Cloudflare יהפוך אותו לזמין, אך הוא עדיין לא יפעל בכתובת ה-URL של מרכז העזרה שלך. עליך להגדיר מסלול כך ש-Cloudflare ידע מתי להפעיל את ה-Worker.

הגדרת מסלול Cloudflare

לאחר פריסת ה-Worker, עליך להודיע ​​ל-Cloudflare מתי Worker זה אמור לפעול. ה-Worker אמור לפעול רק בנתיב המשנה של מרכז העזרה שבחרת.

לדוגמה, אם מרכז העזרה שלך אמור להיות זמין ב-yourdomain.com/help, הוסף נתיב Worker כמו זה yourdomain.com/help*

זה גורם ל-Cloudflare להריץ את ה-Worker עבור:

• yourdomain.com/help

• yourdomain.com/help/collections/getting-started

• yourdomain.com/help/articles/example-article

• yourdomain.com/help/contact

עליך גם לוודא שהנתיב הפנימי Notiondesk מטופל: yourdomain.com/_nd/*

הוסף את המסלול ב-Cloudflare

1. פתחו את ה-Worker שלכם בלוח המחוונים של Cloudflare

2. עבור אל הגדרות

3. דומיינים ונתיבים פתוחים

4. לחץ על הוסף מסלול

5. בחר את האזור שלך

6. הוסף את נתיב מרכז העזרה שלך, לדוגמה : yourdomain.com/help*

7. הוסף את הנתיב הפנימי Notiondesk, לדוגמה: yourdomain.com/_nd/*

8. שמור את השינויים שלך

השתמש בנתיב המשנה שבחרת ב-Notiondesk. אם בחרת ב-, המסלול שלך צריך להיות ./docsyourdomain.com/docs*

אם בחרת ב-/support, המסלול שלך צריך להיות yourdomain.com/support*.

התיעוד הרשמי של Cloudflare מסביר גם כיצד פועלים מסלולי Worker ודומיינים מותאמים אישית עבור Workers אם אתם זקוקים לפרטים נוספים.

דוגמה לעובד Cloudflare

const ORIGIN_HOST = "your-help-center.notiondesk.help";
const CUSTOM_HOST = "yourdomain.com";
const SUBPATH = "/help";

function isSubpathRequest(pathname) {
  return pathname === SUBPATH || pathname.startsWith(SUBPATH + "/");
}

export default {
  async fetch(request) {
    const url = new URL(request.url);
    const shouldProxy =
      isSubpathRequest(url.pathname) || url.pathname.startsWith("/_nd/");

    if (!shouldProxy) {
      return fetch(request);
    }

    url.hostname = ORIGIN_HOST;

    const proxyRequest = new Request(url, request);
    proxyRequest.headers.set("Host", CUSTOM_HOST);
    proxyRequest.headers.set("X-Forwarded-Host", CUSTOM_HOST);
    proxyRequest.headers.set("X-Forwarded-Proto", "https");

    if (isSubpathRequest(url.pathname)) {
      proxyRequest.headers.set("X-Site-Path-Prefix", SUBPATH);
    }

    return fetch(proxyRequest);
  },
};

זוהי רק דוגמה. השתמשו בקוד העובד שנוצר בלוח המחוונים Notiondesk שלכם עבור מרכז העזרה שלכם.

אימות ההגדרה שלך

לאחר פריסת ה-Worker ותצורת הנתיבים, פתח את מרכז העזרה שלך מנתיב המשנה שבחרת. ודא שדף מרכז העזרה הראשי נטען כהלכה.

מה לבדוק

ודא כי:

• מרכז העזרה נטען תחת הדומיין הראשי שלך

• דפי המאמר נפתחים כראוי

• תמונות, סקריפטים וסגנונות נטענים כראוי

• כתובת ה-URL של הדפדפן נשארת בדומיין המותאם אישית שלך

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