SeaweedFS

קבצים מוכנים להפעלה

רמת תמיכה נתמך

תבנית Compose מהמקורות הרשמיים; עוד לא נבדקה בהרצה.

צור docker-compose

שדרוג וחזרה לאחור

איך עוברים לגרסה חדשה בבטחה, ואיך חוזרים אחורה אם משהו נכשל.

קודם גיבוי

עוצרים את ה-container ‏(docker compose stop seaweedfs) ומעתיקים את כל ה-volume של ‎/data: קובצי ‎.dat/.idx של ה-volumes, ה-metadata של ה-filer ב-LevelDB, מצב ה-master וקובצי המפתחות ‎.mini_*. הנתונים וה-metadata חייבים להיות מאותו רגע. [6][21][27]

שלבי השדרוג

1. קודם מגבים את ‎/data (ראו גיבוי). אחר כך מגדירים בקובץ ה-Compose את ה-tag המוצמד החדש ומריצים docker compose pull ו-docker compose up -d. נשארים על ה-tag הרגיל: גרסאות _large_disk משתמשות בפורמט אינדקס אחר ולא יכולות לעבוד על אותם נתונים. [20][35]
2. בודקים את docker compose logs seaweedfs ואת בדיקת ‎/healthz, ואז מציגים את התוכן של bucket מלקוח S3. ברירות המחדל של mini ‏(גודל volume, פורטים, שירותים מובנים) יכולות להשתנות בין גרסאות, ולכן משווים את הדגלים ב-mini.go החדש. [1][6][8]

חזרה לאחור

עוצרים את ה-stack, משחזרים את העותק של ‎/data שנלקח לפני השדרוג, מצמידים את ה-tag הקודם ומריצים docker compose up -d. [20][27]נגזרה-FAQ מבטיח שדרוגים תואמים לאחור אבל לא מתעד downgrade, ולכן לא מניחים שהרצת binary ישן על נתונים שגרסה חדשה כתבה היא בטוחה; שחזור העותק כן.

שינויים שוברים ידועים

• בגרסה 4.41: ‏mini ו-master שולחים כברירת מחדל סטטיסטיקות אנונימיות של ה-cluster ל-telemetry.seaweedfs.com (קודם: כבוי). מבטלים עם ‎-master.telemetry=false, כמו בתבנית. [6][33]נגזרה-release notes לא היו נגישים מסביבת המחקר; נלקח מברירת המחדל של הדגל ב-mini.go בגרסה 4.40 ‏(false) וב-4.41 ‏(true).
• בגרסה 4.23: פקודת ברירת המחדל של ה-image הפכה ל-mini -dir=/data (קודם: בלי פקודה, וה-container היה צריך פקודה כמו server). קובצי Compose שמעבירים פקודה משלהם לא מושפעים. [32]נגזרנלקח מ-docker/Dockerfile.go_build בגרסאות 4.22 ו-4.23; ה-release notes לא היו נגישים.
• בגרסה 4.00: ה-image הפסיק לרוץ כ-root: ‏4.00 הגדיר USER seaweed ‏(uid 1000), ולכן נתונים שגרסה 3.x כתבה כ-root לא נפתחו. מאז 4.01 ה-entrypoint מתחיל כ-root ומעביר קודם את ‎/data לבעלותו; משדרגים מ-3.x ישירות ל-4.01 ומעלה. [30][31]נגזרנלקח מ-docker/Dockerfile.go_build בגרסאות 3.99 ו-4.00 ומ-docker/entrypoint.sh בגרסה 4.01; ה-release notes לא היו נגישים.

מגבלות

• צומת אחד בלי replication: ‏weed mini מריץ master יחיד ושומר עותק אחד של כל אובייקט, ולכן דיסק שנכשל מאבד נתונים. מגינים על ‎/data עם RAID או גיבויים; ‏multi-master ו-replication דורשים את ההתקנה מרובת הרכיבים. [1][6]
• הלקוחות צריכים כתובות path-style ‏(https://host/bucket/key): התבנית לא מגדירה ‎-s3.domainName, ולכן כתובות bucket.host לא מנותבות. לרוב ה-SDKs ול-rclone יש הגדרת force-path-style. [8][13]
• ה-API של S3 מכסה buckets, אובייקטים, multipart, ‏versioning, ‏object lock ו-lifecycle, אבל לא bucket notifications, ‏bucket replication, ‏SelectObjectContent או Object Lambda; כדאי לבדוק את רשימת ה-API בויקי לפני שמסתמכים על יכולת. [23][24]
• בתבנית יש זהות admin אחת ממשתני סביבה, עם גישה מלאה לכל ה-buckets. משתמשים מוגבלים דורשים weed shell ‏(s3.configure) או קובץ ‎-s3.config, ומפתחות הסביבה משתנים רק בהפעלה מחדש. [1][15]
• מאחורי reverse proxy ההעלאות צריכות לעבור ב-streaming: ‏request buffering שובר חתימות SigV4 של chunked, ומגבלת גודל גוף מגבילה את גודל האובייקט. ‏Caddy עובד ב-streaming כברירת מחדל. [13]

אבטחה

• בלי AWS_ACCESS_KEY_ID ו-AWS_SECRET_ACCESS_KEY שער ה-S3 רץ במצב Allow-All ומקבל בקשות לא חתומות. התבנית הופכת את שניהם לחובה; אסור להסיר אותם מ-.env. [1][7][15]
• רק פורט 8333 מאומת ב-S3. פורטי ה-HTTP של ה-master ‏(9333), ה-volume ‏(9340) וה-filer ‏(8888) ופורטי ה-gRPC הם בלי התחברות ולא מפורסמים, אבל containers באותה רשת Docker יכולים להגיע אליהם; במצב caddy או proxy-network זה כולל את רשת ה-proxy. [6][25]
• כדי לסגור את פורטי ה-HTTP של ה-filer וה-volume, הויקי מתעד מפתחות JWT כמשתני סביבה (WEED_JWT_SIGNING_KEY, ‏WEED_JWT_FILER_SIGNING_KEY וגרסאות ה-_READ_ שלהם), ששער ה-S3 משתמש בהם. לא בתבנית; כדאי לבדוק לפני שמסתמכים על זה. [25][26]
• ה-Admin UI כבוי: בלי סיסמה, ה-UI ונתיבי ‎/api שלו פתוחים לכל מי שמגיע לפורט 23646. כדי להפעיל אותו מגדירים WEED_ADMIN_PASSWORD, מסירים את ‎-admin.ui=false וניגשים אליו רק דרך SSH tunnel. [11][28][29]
• ה-images חתומים ב-cosign מספטמבר 2026; מאמתים את chrislusf/seaweedfs:4.48 מול זהות ה-workflow של ה-release שב-docker/README.md ופורסים לפי ה-digest שנבדק. [18]

גיבוי

• הגיבוי העקבי הפשוט ביותר: לעצור את ה-container ולהעתיק את כל ה-volume של ‎/data, או לסנכרן כל bucket ליעד S3 אחר בלקוח S3 בזמן שהוא רץ. שומרים את הקבצים ‎.mini_sse_kek ו-‎.mini_kek_passphrase: אי אפשר לקרוא אובייקטי SSE-S3 בלעדיהם. [6][27]
• קובצי ה-volume וה-metadata של ה-filer חייבים להתאים: הויקי משלב weed backup של כל volume עם fs.meta.save של ה-metadata, בזמן שהכתיבה מושהית. עותק של ה-volumes לבד לא משחזר את שמות האובייקטים. [27]

גרסה אחרונה

הגרסה האחרונה של הפרויקט

SeaweedFS 4.48 [35]

הפרופיל נבדק מול

SeaweedFS 4.48

הפרופיל נבדק מול הגרסה האחרונה.

נבדק ב-

14 באוק׳ 2026

מצב

נבדק ב-90 הימים האחרונים

איפה הגרסאות מתפרסמות

תגיות ב-Docker Hub

הגרסאות האחרונות של כל האפליקציות

גרסה

סטטוס הפרופיל

פורסם

נבדק מול גרסה

SeaweedFS 4.48

גרסת הפרופיל

1.0.0

המספרים אומתו

14 באוק׳ 2026

גרסת הקטלוג

2026.10.10

מדיניות sizing

2026.10.0

קובץ Compose

לא אומת

הפרויקט וחלופות

האתר הרשמי

github.com/seaweedfs/seaweedfs

קוד מקור

github.com/seaweedfs/seaweedfs

מקורות

1. SeaweedFS wiki: Quick Start with weed mini (docker run with /data, AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY, S3_BUCKET; no keys = Allow All; -s3.externalUrl behind a proxy) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
2. SeaweedFS wiki: Docker Compose for S3 (weed server -s3 with an inline config.json, port 8333, no data volume) (Compose רשמי · נקרא 14 באוק׳ 2026)
3. docker/seaweedfs-compose.yml at 4.48: one container per component (master, volume, filer, s3, webdav), untagged image (Compose רשמי · נקרא 14 באוק׳ 2026)
4. docker/Dockerfile.go_build at 4.48: Alpine, curl installed, user seaweed (1000:1000), VOLUME /data, ENTRYPOINT /entrypoint.sh, CMD mini -dir=/data, no HEALTHCHECK (מאגר רשמי · נקרא 14 באוק׳ 2026)
5. docker/entrypoint.sh at 4.48: as root, chown -R /data to seaweed when ownership differs, then su-exec seaweed; mini adds -dir=/data unless given (מאגר רשמי · נקרא 14 באוק׳ 2026)
6. weed/command/mini.go at 4.48: ports 8333/9333/9340/8888/23646 (gRPC +10000), -webdav, -admin.ui, -s3.port.iceberg/lance, -master.telemetry (on), auto volume size (מאגר רשמי · נקרא 14 באוק׳ 2026)
7. weed/s3api/auth_credentials.go at 4.48: AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY add a static admin identity; auth is enforced once any identity exists (מאגר רשמי · נקרא 14 באוק׳ 2026)
8. weed/s3api/s3api_server.go at 4.48: /status, /healthz and /readyz probes; -domainName for virtual-host style; a host-less path-style route always registered (מאגר רשמי · נקרא 14 באוק׳ 2026)
9. weed/s3api/s3api_status_handlers.go at 4.48: StatusHandler answers 200 with an empty body (מאגר רשמי · נקרא 14 באוק׳ 2026)
10. weed/command/s3.go at 4.48: externalUrl falls back to the S3_EXTERNAL_URL env var and is tried first when verifying signatures behind a proxy (מאגר רשמי · נקרא 14 באוק׳ 2026)
11. weed/admin/handlers/admin_handlers.go at 4.48: /health and /metrics without auth; with the UI disabled no other route; without a password every UI and /api route is public (מאגר רשמי · נקרא 14 באוק׳ 2026)
12. Registry config of chrislusf/seaweedfs:4.48 (linux/amd64): no User, Entrypoint /entrypoint.sh, Cmd mini -dir=/data, Volumes /data, 8 ExposedPorts, no Healthcheck (מדידה · נקרא 14 באוק׳ 2026)
13. SeaweedFS wiki: S3 Nginx Proxy (SigV4 signs the Host header; X-Forwarded-Host or -s3.externalUrl; no request buffering; path or virtual-host style) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
14. SeaweedFS wiki: WebDAV (current implementation does not enforce authentication yet) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
15. SeaweedFS wiki: S3 Credentials (env vars give one global admin, restart to change them; Allow-All mode until any credential exists; config file, filer or weed shell for more users) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
16. SeaweedFS README at 4.48: blob store with O(1) disk reads, filer, S3 gateway; compares itself with MinIO, which it says ceased development on Apr 25, 2026 (מאגר רשמי · נקרא 14 באוק׳ 2026)
17. SeaweedFS LICENSE at 4.48: Apache License 2.0 (image label Apache-2.0) (מאגר רשמי · נקרא 14 באוק׳ 2026)
18. docker/README.md at 4.48: images on Docker Hub and ghcr.io signed with cosign (keyless) since September 2026 (מאגר רשמי · נקרא 14 באוק׳ 2026)
19. SeaweedFS wiki: Optimization (in-memory index about 20 bytes per file; memory for concurrent reads = file or chunk size × readers; leveldb index variants) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
20. SeaweedFS wiki: FAQ (16 bytes per index entry, 17 in large_disk builds, which cannot be mixed with standard ones; upgrades backward compatible unless noted) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
21. SeaweedFS wiki: Production Setup (leveldb index for many volumes; filer.toml leveldb2 store keeps metadata on local disk and supports one filer) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
22. SeaweedFS wiki: Volume Management (maintenance worker script every 17 min: volume.deleteEmpty, s3.clean.uploads -timeAgo=24h for unfinished multipart uploads) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
23. SeaweedFS wiki: Amazon S3 API (supported operations: buckets, objects, multipart, versioning, object lock and retention, lifecycle without transition rules) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
24. SeaweedFS wiki: Supported APIs vs MinIO (no bucket notifications, bucket replication, SelectObjectContent or Object Lambda) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
25. SeaweedFS wiki: Security Overview (master HTTP unsecured; filer HTTP and volume writes secured only with JWT keys; gRPC with mutual TLS) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
26. SeaweedFS wiki: Security Configuration (security.toml values as WEED_* env vars, e.g. WEED_JWT_SIGNING_KEY and WEED_JWT_FILER_SIGNING_KEY) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
27. SeaweedFS wiki: Data Backup (weed backup per volume, fs.meta.save for filer metadata; volumes and metadata must be copied while writes are paused) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
28. SeaweedFS wiki: Admin UI (adminPassword enables login; worker gRPC has no password auth; WEED_ADMIN_* env vars) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
29. weed/command/admin.go at 4.48: admin interface password, if empty auth is disabled; startAdminServer serves the routes on the given ip (מאגר רשמי · נקרא 14 באוק׳ 2026)
30. docker/Dockerfile.go_build at 4.00: USER seaweed (uid 1000) added, image no longer runs as root; 3.99 had no USER (מאגר רשמי · נקרא 14 באוק׳ 2026)
31. docker/entrypoint.sh at 4.01: starts as root, chowns /data to seaweed when needed, then su-exec (USER line removed from the Dockerfile) (מאגר רשמי · נקרא 14 באוק׳ 2026)
32. docker/Dockerfile.go_build at 4.23: first release with CMD mini -dir=/data (4.22 has no CMD, a command had to be given) (מאגר רשמי · נקרא 14 באוק׳ 2026)
33. weed/command/mini.go at 4.41: -master.telemetry defaults to true (anonymous cluster statistics; 4.40 defaulted to false) (מאגר רשמי · נקרא 14 באוק׳ 2026)
34. Docker Hub tag chrislusf/seaweedfs:4.48 (linux/amd64): 193,556,478 B compressed; 10 layers decompressed and counted: 529,553,408 B (מדידה · נקרא 14 באוק׳ 2026)
35. Docker Hub tags of chrislusf/seaweedfs (4.48 newest release on 2026-10-14, pushed 2026-09-28; dev is an unreleased build; _large_disk and _full are variants) (מאגר רשמי · נקרא 14 באוק׳ 2026)
36. Docker: containerd image store is the default on fresh Engine 29+ installs and keeps images compressed and uncompressed (תיעוד רשמי · נקרא 14 באוק׳ 2026)
37. Amazon Web Services: Amazon S3 pricing (hosted object storage) (תיעוד רשמי · נקרא 14 באוק׳ 2026)