📘 תיעוד 257

מסטודון

עודכן לאחרונה ב-3 באוגוסט 2026.

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

#הקמת מופע חדש

אפשר להקים מופע Mastodon באירוח עצמי בכמה דרכים. לפרטים נוספים, פנו אל התיעוד הרשמי. כשמגיעים, אחרי ההתקנה, לשלב Configuring your environment בתיעוד של Mastodon, המשיכו לפי ההליכים שלמטה.

#1. קביעת שם המארח לגישה לקבצים

בשונה משם המארח ברירת המחדל של מופע Mastodon, אחסון אובייקטים לקבצים דורש שם מארח ייחודי. לדוגמה, אם שם המארח של Mastodon הוגדר כ-mastodon.example.com, אפשר להשתמש ב-mastodon-files.example.com או ב-files.example.com לגישה לקבצים. המשמעות היא שכשמבקרים במופע בכתובת mastodon.example.com, בכל פעם שיש מדיה מצורפת לפוסט, כמו תמונה או סרטון, הקובץ יוגש תחת שם המארח שנקבע בשלב זה, למשל mastodon-files.example.com.

הערה

אם עוברים בהמשך מ-R2 לשירות תואם S3 אחר, אפשר להמשיך להשתמש באותו שם מארח שנקבע בשלב זה. אנחנו לא ממליצים לשנות את שם המארח אחרי שהמופע כבר רץ, כדי למנוע שבירה של הפניות היסטוריות לקבצים. בתרחיש כזה אפשר להשתמש ב-Bulk Redirects כדי להורות לבקשות שמגיעות לשם המארח הקודם לפנות לשם המארח החדש.

#2. יצירה והגדרה של דלי R2

1. בלוח הבקרה של Cloudflare, עברו אל הדף R2 object storage. מעבר אל Overview
2. בחרו Create bucket.
3. הזינו את שם הדלי ואז בחרו Create bucket. השם הזה פנימי בזמן הגדרת מופע Mastodon, והוא לא נגיש לציבור.
4. אחרי יצירת הדלי, עברו ללשונית Settings של הדלי והעתיקו את הערך של S3 API.
5. מתוך לשונית Settings, בחרו Connect Domain והזינו את שם המארח משלב 1.
6. חזרו לדף הסקירה של R2 ובחרו Manage R2 API Tokens.
7. בחרו Create API token.
8. תנו לטוקן את השם Mastodon על ידי בחירת סמל העיפרון ליד שם ה-API, והעניקו לו את ההרשאה Edit. בחרו Create API Token כדי לסיים את יצירת הטוקן.
9. העתיקו את הערכים של Access Key ID ושל Secret Access Key.

#3. הגדרת R2 עבור Mastodon

בזמן הגדרת מופע Mastodon לפי קובץ התצורה הרשמי, החליפו את המקטע File storage בפרטים הבאים.

S3_ENABLED=true
S3_ALIAS_HOST={{mastodon-files.example.com}}                  # Change to the hostname determined in step 1
S3_BUCKET={{your-bucket-name}}                                # Change to the bucket name set in step 2
S3_ENDPOINT=https://{{unique-id}}.r2.cloudflarestorage.com/   # Change the {{unique-id}} to the part of S3 API retrieved in step 2
AWS_ACCESS_KEY_ID={{your-access-key-id}}                      # Change to the Access Key ID retrieved in step 2
AWS_SECRET_ACCESS_KEY={{your-secret-access-key}}              # Change to the Secret Access Key retrieved in step 2
S3_PROTOCOL=https
S3_PERMISSION=

השאירו את S3_PERMISSION ריק. זה מונע מ-Mastodon לשלוח כותרות ACL, ש-R2 לא תומך בהן.

אחרי ההגדרה אפשר להריץ את המופע. אחרי שהמופע רץ, העלו קובץ מדיה מצורף וודאו שהקובץ המצורף נשלף משם המארח שהוגדר למעלה. כשחוזרים לדף הדלי ב-R2, אמור להופיע המבנה הבא.

#מעבר אל R2

אם כבר יש מופע שרץ, אפשר להעביר את קובצי המדיה אל R2 וליהנות מ-עלות egress אפס.

#1. הקמת דלי R2 והתחלת העברת קבצים

1. (אופציונלי) כדי לצמצם את מספר הקבצים שמועברים, אפשר להשתמש ב-Mastodon admin CLI כדי לנקות קבצים שלא בשימוש.
2. הקימו דלי R2 שמוכן להעברת קבצים לפי שלבים 1 ו-2 במקטע הקמת מופע חדש למעלה.
3. העבירו את כל קובצי המדיה אל R2. פנו אל הדוגמאות שסופקו כדי לחבר בין ספקים שונים. אם קובצי המדיה האלה מתארחים כרגע מקומית, אפשר להשתמש ב-rclone כדי להעלות את הקבצים המקומיים האלה אל R2.

#2. (אופציונלי) הגדרת הפניות לנתיבי קבצים

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

אם קובצי המדיה התארחו מקומית, סביר שתצטרכו להגדיר הפניות. כברירת מחדל, לקובצי מדיה שמתארחים מקומית יש נתיב דומה ל-https://mastodon.example.com/cache/..., וצריך להפנות אותו לנתיב דומה ל-https://mastodon-files.example.com/cache/... אחרי שדלי R2 פועל לצד מופע Mastodon. אם כבר משתמשים בשירות אחסון אובייקטים תואם S3 אחר ורוצים לשמור על אותו שם מארח, אין צורך להגדיר הפניות.

Bulk Redirects זמינים בכל התוכניות. למידע נוסף, פנו אל Create Bulk Redirects in the dashboard.

#3. אימות הדלי וההפניות

לפי תוכנית ההעברה, אפשר לאמת שהדלי נגיש לציבור ושההפניות עובדות כראוי. כדי לאמת, פתחו קובץ מדיה קיים שהועלה, עם נתיב כמו https://mastodon.example.com/cache/..., החליפו את שם המארח מ-mastodon.example.com ל-mastodon-files.example.com, ובקרו בנתיב החדש. אם הקובץ נפתח כראוי, המשיכו לשלב האחרון.

#4. סיום ההעברה

המופע עשוי להמשיך לרוץ בזמן ההעברה, ובמהלך ההעברה סביר שנוצרים קובצי מדיה חדשים, דרך העלאות ישירות או דרך שליפה ממופעים מאוחדים אחרים. כדי להעלות רק את הקבצים שנוצרו לאחרונה, אפשר להשתמש בתוכנה כמו rclone. שימו לב: כשמריצים שוב את תוכנית הסנכרון, כל הקבצים הקיימים נבדקים באמצעות לפחות פעולות Class B.

אחרי שכל הקבצים מסונכרנים, אפשר להפעיל מחדש את מופע Mastodon עם תצורת אחסון האובייקטים החדשה, כפי שמתואר ב-שלב 3 של הקמת מופע חדש.