אחסון PocketBase על VPS משלכם

‏PocketBase הוא backend בקוד פתוח בתוכנה אחת: מסד נתונים SQLite עם API ‏REST ובזמן אמת, הזדהות משתמשים, אחסון קבצים ולוח ניהול, מוכנים לאפליקציית ווב או מובייל. בוחרים אותו עם חבילה, משלמים, ואנחנו מקימים את ה-VPS (‏KVM, ‏NVMe, ‏Ubuntu 24.04 LTS) ומתקינים אותו תוך כמה דקות. מקבלים:

• ‏PocketBase 0.40.6 (‏MIT), שנבנה על השרת שלכם מהגרסה הרשמית עם checksum מאומת, כי הפרויקט לא מפרסם image רשמי לקונטיינר.
• כתובת HTTPS כמו yourname-x7k2.devoster.app, עם לוח הניהול ב-/_/ וה-API תחת /api/.
• חשבון superuser שכבר נוצר, עם התחברות במייל של חשבון Devoster שלכם וסיסמה שנוצרה אוטומטית ומוצגת בלוח הבקרה. קישור ההתקנה הראשונית של PocketBase אף פעם לא נגיש מהאינטרנט.
• הנתונים שלכם בתיקיות פשוטות תחת /opt/devoster/data/pocketbase: ‏pb_data, ‏pb_public, ‏pb_migrations ו-pb_hooks.
• שליטה מלוח הבקרה: פתיחת האפליקציה, איפוס סיסמת ה-superuser, ריסטארט, עצירה והפעלה, צפייה בלוגים, עדכון וחיבור דומיין משלכם.

האפליקציה בחינם; משלמים רק על חבילת ה-VPS, עם 10% הנחה בתשלום שנתי. השרת מגיע עם root מלא, גיבוי לילי חינם שנשמר 3 ימים ועוד Snapshot אחד, כתובת IPv4 ייעודית, ‏1Gbps עם תעבורה ללא הגבלה והגנת DDoS. כבר יש לכם VPS ב-Devoster? אפשר להתקין עליו את PocketBase מ-VPS Control, אחרי בדיקה קצרה של מערכת ההפעלה, הפורטים 80 ו-443 והמקום בדיסק, או להתקין את השרת מחדש איתו; שתי האפשרויות בחינם. אפליקציות נוספות שמותקנות כך נמצאות בעמוד האפליקציות בלחיצה אחת.

ממדלים את הנתונים כאוספים (collections) בלוח הניהול, ו-PocketBase מגיש אותם מיד דרך ה-API שלו:

• מסד נתונים עם API. אוספים הם טבלאות SQLite עם API ‏REST לרשימה, סינון, יצירה ועדכון של רשומות.
• מינויים בזמן אמת. לקוחות יכולים להירשם לאוסף או לרשומה ולקבל שינויים ברגע שהם קורים, לצ'אטים, דשבורדים חיים ומסכים שיתופיים.
• הזדהות למשתמשי האפליקציה שלכם, עם מייל וסיסמה והתחברות OAuth2 דרך ספקים שאתם מגדירים.
• אחסון קבצים בשדות של רשומות, על הדיסק של ה-VPS.
• כללי API לכל אוסף, שקובעים מי יכול לראות רשימה, לצפות, ליצור, לעדכן או למחוק.

ל-PocketBase יש SDK רשמיים ל-JavaScript ול-Dart, וכל שפה יכולה לקרוא ל-API ה-REST. שני סוגי חשבונות: ‏superusers מנהלים את PocketBase בלוח הניהול; משתמשי האפליקציה שלכם נמצאים באוסף users. האוסף הזה מאפשר הרשמה פתוחה כברירת מחדל, כי זה מה שרוב האפליקציות צריכות. אם שלכם לא, שנו את כלל ה-create של האוסף.

ארבע התיקיות תחת /opt/devoster/data/pocketbase הן הדרך להרחיב את ההתקנה. מעתיקים אליהן קבצים ב-SSH או ב-SFTP:

• pb_hooks ל-hooks ב-JavaScript ‏(*.pb.js): נתיבים מותאמים, ולידציה, פעולות כשרשומה משתנה, משימות מתוזמנות.
• pb_migrations למיגרציות ב-JavaScript, כך שהסכמה של האוספים מנוהלת בגרסאות וניתנת לשחזור.
• pb_public לקבצים סטטיים שמוגשים בשורש הכתובת. שימו כאן את ה-build של ה-front end, והאפליקציה וה-API שלה חולקים דומיין אחד.
• pb_data מחזיקה את מסדי הנתונים והקבצים שהועלו. השאירו אותה ל-PocketBase.

אחרי שינוי ב-hooks או במיגרציות, הפעילו את האפליקציה מחדש מלוח הבקרה. ההתקנה מריצה את הגרסה הרשמית של PocketBase עם hooks ב-JavaScript; שימוש ב-PocketBase כ-framework של Go דורש לקמפל בינארי משלכם, וזה מחוץ לאפליקציה בלחיצה אחת.

‏PocketBase הוא תוכנת Go אחת עם מסד נתונים מוטמע, קל מספיק לחבילה הקטנה ביותר. צריכת הזיכרון שלו מוגבלת לחלק מה-RAM של החבילה. מה שגדל הוא הדיסק, עם קבצים שמועלים, וה-CPU, עם תעבורה כבדה בזמן אמת או hooks עמוסים.

‏SQLite רץ על שרת אחד, ולכן PocketBase גדל במעבר לחבילה גדולה יותר, שאפשר לעשות מהפאנל בלי התקנה מחדש. אם אתם צופים שתצטרכו כמה שרתי אפליקציה מאחורי load balancer, ‏backend שבנוי על מסד נתונים client-server יתאים יותר.

‏PocketBase שולח למשתמשי האפליקציה שלכם מיילים לאימות, קישורים לאיפוס סיסמה וקודים חד-פעמיים. פורטי הדואר היוצא חסומים כברירת מחדל בחבילות ה-VPS של Devoster ולא מוגדר שרת דואר, כך שהמיילים האלה לא יוצאים עד שמגדירים אחד:

• השתמשו ב-SMTP relay של ספק מייל חיצוני. הזינו את ההגדרות שלו בהגדרות הדואר בלוח הניהול של PocketBase ובקשו מאיתנו לפתוח את פורט ה-submission של הספק; הוא נפתח אחרי אישור קצר.
• או קראו ל-API ב-HTTPS של ספק מתוך hook להודעות משלכם; שירותי מייל מבוססי HTTPS עובדים בלי לפתוח פורט.

עד אז, הרשמה עם מייל וסיסמה עדיין עובדת; רק התהליכים שתלויים במייל לא. את סיסמת ה-superuser שלכם מאפסים מלוח הבקרה של Devoster, בלי מייל.

‏PocketBase עדיין לפני גרסה 1.0, והמפתח שלו אומר את זה בפירוש: גרסה מינורית יכולה לשנות את ה-API של hooks ומיגרציות ב-JavaScript. לכן אנחנו קוראים את ה-changelog של כל גרסה לפני שמפיצים אותה, ואז מחילים אותה בשעת תחזוקה שאתם בוחרים, או כשאתם לוחצים Update now. לפני כן נלקח Snapshot של ה-VPS, ואם PocketBase לא חוזר לפעול תקין השרת חוזר אחורה אוטומטית. אם האפליקציה שלכם נשענת הרבה על hooks, אפשר לכבות את העדכון האוטומטי ולעדכן אחרי שבדקתם את הקוד מול ה-changelog.

‏PocketBase מופץ ברישיון MIT. ל-Devoster אין קשר לפרויקט.

השרת לא מנוהל: יש לכם root מלא, והאבטחה שלו, כללי ה-API של האוספים והנתונים של המשתמשים שלכם באחריותכם. הגיבויים הליליים (3 ימים) מכסים את כל ה-VPS; הגיבויים של PocketBase עצמו בלוח הניהול שלו הם שכבה נוספת. אנחנו לא עוזרים בתכנון הסכמה או בכתיבת hooks; התיעוד של PocketBase מכסה את זה.