Plausible Community Edition

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

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

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

צור docker-compose

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

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

קודם גיבוי

ה-migrations משנים את שני מסדי הנתונים: קחו קודם pg_dump של plausible_db, אחר כך עצרו את ה-stack וצרו ארכיון של ה-volume של event-data של ClickHouse, ושמרו את ה-.env. [2][29]נגזרה-wiki מראה pg_dump ל-PostgreSQL; ל-ClickHouse הוא לא נותן נוהל גיבוי, ולכן העתק קר של ה-volume שלו כשה-stack עצור הוא המקבילה הבטוחה.

שלבי השדרוג

1. קראו את ה-CHANGELOG ואת ה-release notes של כל גרסה בין הגרסה שלכם לחדשה: לכל release יש הוראות שדרוג משלו, ותיקוני אבטחה לא מועברים לגרסאות ישנות. [28][30]
2. שנו את ה-tag המוצמד של community-edition, ואז הריצו docker compose pull ו-docker compose up -d. פקודת ההפעלה יוצרת את מסדי הנתונים אם צריך ומריצה את ה-migrations של PostgreSQL ושל ClickHouse לפני שהאפליקציה מאזינה; עקבו אחרי docker compose logs -f plausible עד שהיא מוכנה. [2][8][28]
3. שנו את ה-tag של ClickHouse רק לזה שה-compose.yml של הגרסה החדשה מצמיד, כמו ב-v3.0.0 ‏(מ-24.3 ל-24.12). שדרוג גרסה ראשית של PostgreSQL דורש dump ושחזור, כפי שמדריך שדרוג PostgreSQL מראה. [26][27][29]נגזרמדריך השדרוג מכסה את ה-image של Plausible; הצעד של ClickHouse נגזר מכך ש-upstream שינה את ה-tag של ClickHouse ב-compose.yml שלו ב-v3.0.0.

חזרה לאחור

שחזרו את ה-dump של PostgreSQL ואת ה-volume של ClickHouse מלפני השדרוג והצמידו את ה-image חזרה ל-tag הקודם. צריך את שניהם: גרסה ישנה לא יכולה לקרוא טבלאות שמיגרציה חדשה יותר שינתה. [8][28]נגזרה-wiki ממליץ להצמיד גרסת patch כדי שאפשר יהיה לחזור ל-tag ידוע; ה-migrations רצים רק קדימה, ולכן הנתונים צריכים לחזור יחד איתו.

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

• בגרסה 3.0.0: ה-compose הרשמי העביר את ClickHouse מ-24.3.3.102 ל-24.12. ה-tracker שולח אירוע engagement עם עומק גלילה (sd) וזמן מעורבות (e), ש-proxies מותאמים לסקריפט חייבים להעביר; זמן בעמוד מחושב ממנו. ‏‎/api/health הוצא משימוש באופן רך לטובת ‎/api/system/health/live ו-‎/ready, ונתיבי הסטטיסטיקה הפנימיים הפסיקו לתמוך בפורמט הסינון הישן. [26][27][30]
• בגרסה 2.1.0: ‏ECTO_IPV6 ו-ECTO_CH_IPV6 הוצאו משימוש (חיבורים מנסים IPv6 ואז IPv4), ‏DATABASE_SOCKET_DIR הוצא משימוש באופן רך, ייבוא מ-Universal Analytics הוסר, ומסנני 'is' כבר לא מקבלים wildcards. [30]
• בגרסה 2.0.0: המשתנה IP_BLOCKLIST וה-plug של חומת האש שלו הוסרו, ושינוי הדומיין של אתר דורש migration של נתונים למזהים מספריים. [30]

מגבלות

• ‏CE היא גרסה לטווח ארוך שמתפרסמת בערך פעמיים בשנה, וחסרות בה כמה יכולות של ה-Cloud: משפכי שיווק, מסעות משתמש, יעדי הכנסות של ecommerce, ‏SSO וה-sites API. סינון הבוטים בסיסי (User-Agent ו-referrer spam בלבד), והתמיכה קהילתית בלבד. [32]
• ‏ClickHouse דורש מעבד עם SSE 4.2 ‏(או NEON ב-ARM), ו-upstream מכוונן אותו למכונות קטנות עם קובצי XML שהתבנית לא יכולה לטעון; כאן מיושמות רק הגדרות השרת שבהם, ולכן תכננו RAM לפי ה-presets ולא לפי 2 GB של ה-README. [5][24][25]
• התבנית לא כותבת הגדרות דואר. בלי SMTP_HOST_ADDR, ‏Plausible מנסה לשלוח בעצמו הזמנות, איפוס סיסמה ודוחות דרך פורט 25, שספקים רבים חוסמים או מסמנים כ-spam; הוסיפו SMTP relay ל-.env כדי שהדואר יעבוד. [13]

אבטחה

• הגישו את Plausible ב-HTTPS דרך reverse proxy, עם BASE_URL שמוגדר ל-https://<domain>; ה-cookies מסומנים secure רק כש-BASE_URL הוא https, וה-proxy חייב להעביר WebSocket upgrades בנתיב ‎/live/websocket. [13][14][30]
• בהפעלה הראשונה כל מי שמגיע ל-instance יכול לרשום את חשבון הבעלים, בלי קשר ל-DISABLE_REGISTRATION. צרו אותו מיד אחרי ההפעלה הראשונה; אחר כך רק מוזמנים יכולים להירשם (invite_only, ברירת המחדל ב-CE). [12][13]
• למשתמש ה-default של ClickHouse אין סיסמה, וה-compose מבטל את הנעילה של ה-image לגישה מ-localhost בלבד (CLICKHOUSE_SKIP_USER_SETUP=1) כדי ש-Plausible יוכל להתחבר. לעולם אל תפרסמו את הפורטים 8123, ‏9000, ‏9004 או 9005; התבנית משאירה אותם בתוך ה-stack. [2][16][19]
• בלי TOTP_VAULT_KEY, המפתח שמצפין את סודות ה-2FA של המשתמשים נגזר מ-SECRET_KEY_BASE. שמרו את SECRET_KEY_BASE בגיבוי ואל תחליפו אותו כלאחר יד, אחרת הגדרות 2FA קיימות יפסיקו לעבוד. [9][13]

גיבוי

• גבו שלושה דברים יחד: ‏pg_dump של plausible_db ‏(משתמשים, אתרים, יעדים), ה-volume של event-data של ClickHouse (כל הצפיות והאירועים, מועתק כשה-stack עצור), וה-.env ‏(SECRET_KEY_BASE וסיסמת מסד הנתונים). [2][13][29]
• לעותק נייד של הנתונים של אתר, השתמשו ב-Site Settings > Imports & Exports: ייצוא ה-CSV כולל מאפיינים מאז v3.1.0, ואפשר לייבא אותו ל-instance אחר של Plausible או ל-Cloud. [30][32]

גרסה אחרונה

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

Plausible Community Edition 3.2.1 [28][30][35]

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

Plausible Community Edition 3.2.1

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

נבדק ב-

14 באוק׳ 2026

מצב

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

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

GitHub Releases

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

גרסה

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

פורסם

נבדק מול גרסה

Plausible Community Edition 3.2.1

גרסת הפרופיל

1.0.0

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

14 באוק׳ 2026

גרסת הקטלוג

2026.10.10

מדיניות sizing

2026.10.0

קובץ Compose

לא אומת

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

האתר הרשמי

plausible.io/self-hosted-web-analytics

קוד מקור

github.com/plausible/analytics

חלופות

UmamiMatomoGoatCounter

מקורות

1. Docker Docs: Control startup order in Compose (pg_isready healthcheck, service_healthy) (תיעוד רשמי · נקרא 11 באוק׳ 2026)
2. community-edition repository: compose.yml at v3.2.1 (postgres:16-alpine; clickhouse-server:24.12-alpine, 4 XML mounts, nofile 262144; plausible: db createdb, db migrate, run; TMPDIR) (Compose רשמי · נקרא 14 באוק׳ 2026)
3. community-edition repository: clickhouse/logs.xml at v3.2.1 (logger warning, query_log TTL 30 days, removes metric, async metric, query_thread, text, trace, session, part logs) (Compose רשמי · נקרא 14 באוק׳ 2026)
4. community-edition repository: clickhouse/low-resources.xml at v3.2.1 (mark_cache_size 524288000) (Compose רשמי · נקרא 14 באוק׳ 2026)
5. community-edition repository: clickhouse/default-profile-low-resources-overrides.xml at v3.2.1 (max_threads 1, max_block_size 8192, max_download_threads 1, parallel parsing and formatting off) (Compose רשמי · נקרא 14 באוק׳ 2026)
6. community-edition repository: clickhouse/ipv4-only.xml at v3.2.1 (listen_host 0.0.0.0, against 'Listen [::]:9000 failed' warnings) (Compose רשמי · נקרא 14 באוק׳ 2026)
7. plausible/analytics repository: Dockerfile at v3.2.1 (alpine:3.22.2, user plausible uid 999 in nogroup, /var/lib/plausible world-writable VOLUME, LISTEN_IP 0.0.0.0, EXPOSE 8000, no HEALTHCHECK) (מאגר רשמי · נקרא 14 באוק׳ 2026)
8. plausible/analytics repository: rel/docker-entrypoint.sh at v3.2.1 ('run' starts the release, 'db <script>' runs createdb.sh or migrate.sh) (מאגר רשמי · נקרא 14 באוק׳ 2026)
9. plausible/analytics repository: config/runtime.exs at v3.2.1 (HTTP_PORT 8000; SECRET_KEY_BASE ≥ 32 bytes; TOTP key derived from it; DISABLE_REGISTRATION invite_only; no Repo pool_size) (מאגר רשמי · נקרא 14 באוק׳ 2026)
10. plausible/analytics repository: lib/plausible_web/router.ex at v3.2.1 (GET /api/system/health/live and /api/system/health/ready; /api/health kept for old checks) (מאגר רשמי · נקרא 14 באוק׳ 2026)
11. plausible/analytics repository: Api.SystemController at v3.2.1 (liveness returns ok; readiness runs SELECT 1 on PostgreSQL and ClickHouse and checks caches, 500 until all are ok) (מאגר רשמי · נקרא 14 באוק׳ 2026)
12. plausible/analytics repository: MaybeDisableRegistration plug at v3.2.1 (registration stays open on first launch, whatever DISABLE_REGISTRATION says) (מאגר רשמי · נקרא 14 באוק׳ 2026)
13. Plausible CE wiki: Configuration (BASE_URL, SECRET_KEY_BASE ≥ 64 bytes; TOTP_VAULT_KEY optional; DISABLE_REGISTRATION invite_only; HTTP_PORT 8000; database URLs; SMTP) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
14. Plausible CE wiki: Reverse Proxy (HTTP_PORT 8000 on loopback, proxy to it, /live/websocket needs the Upgrade headers, domain must match BASE_URL) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
15. ClickHouse repository: Dockerfile.alpine at v24.12.6.70-stable (alpine, busybox wget; clickhouse uid/gid 101; VOLUME /var/lib/clickhouse; EXPOSE 9000 8123 9009; no HEALTHCHECK) (מאגר רשמי · נקרא 14 באוק׳ 2026)
16. ClickHouse repository: docker entrypoint.sh at v24.12.6.70-stable (-- args go to clickhouse-server, as its own '-- --listen_host'; wget --spider /ping; chown, then uid 101; SKIP_USER_SETUP) (מאגר רשמי · נקרא 14 באוק׳ 2026)
17. ClickHouse repository: docker/server/docker_related_config.xml at v24.12.6.70-stable (listen_host :: and 0.0.0.0 with listen_try 1) (מאגר רשמי · נקרא 14 באוק׳ 2026)
18. ClickHouse repository: config.xml at v24.12.6.70-stable (logger trace, 10 × 1000M files; ports 8123, 9000, 9004, 9005, 9009; most system log tables without TTL) (מאגר רשמי · נקרא 14 באוק׳ 2026)
19. ClickHouse repository: programs/server/users.xml at v24.12.6.70-stable (user default with an empty password, default profile without overrides) (מאגר רשמי · נקרא 14 באוק׳ 2026)
20. ClickHouse repository: base/base/argsToConfig.cpp at v24.12.6.70-stable (each --key=value argument becomes a config layer; dotted keys address nested elements) (מאגר רשמי · נקרא 14 באוק׳ 2026)
21. ClickHouse repository: src/Interpreters/SystemLog.cpp at v24.12.6.70-stable (without an engine element, a system table is MergeTree with PARTITION BY, the '<table>.ttl' setting as TTL, and ORDER BY) (מאגר רשמי · נקרא 14 באוק׳ 2026)
22. ClickHouse repository: src/Loggers/Loggers.cpp at v24.12.6.70-stable (logger.level, default trace, sets the level of every logger and so of what reaches text_log) (מאגר רשמי · נקרא 14 באוק׳ 2026)
23. ClickHouse repository: programs/server/Server.cpp at v24.12.6.70-stable (loggers built from the full config at start; a config reload resets log levels from the config files only) (מאגר רשמי · נקרא 14 באוק׳ 2026)
24. ClickHouse Docs: Using less than 16GB of RAM (32 GB recommended; 2 GB needs tuning: 500 MB mark cache, 1 thread; disable asynchronous_metric_log, metric_log, text_log, trace_log) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
25. community-edition repository: README.md at v3.2.1 (CPU with SSE 4.2 or NEON; at least 2 GB RAM for ClickHouse and Plausible; SECRET_KEY_BASE ≥ 64 bytes; first user at BASE_URL) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
26. community-edition repository: compose.yml at v2.1.5 (clickhouse/clickhouse-server:24.3.3.102-alpine) (Compose רשמי · נקרא 14 באוק׳ 2026)
27. community-edition repository: compose.yml at v3.0.0 (clickhouse/clickhouse-server:24.12-alpine) (Compose רשמי · נקרא 14 באוק׳ 2026)
28. Plausible CE wiki: Upgrade (pin a patch version, recommended; security fixes are not backported; read each release's instructions; pull the new tag and docker compose up -d) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
29. Plausible CE wiki: Upgrade PostgreSQL (from 12 or later to 16 or later with pg_dump and psql; Plausible stopped meanwhile) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
30. plausible/analytics repository: CHANGELOG.md at v3.2.1 (v3.0.0 engagement events and /api/health soft-deprecation; v3.1.0 full site exports; v2.1.0 removals; v2.0.0 IP_BLOCKLIST removed) (Release notes · נקרא 14 באוק׳ 2026)
31. plausible/analytics repository: LICENSE.md at v3.2.1 (GNU AGPL v3) (מאגר רשמי · נקרא 14 באוק׳ 2026)
32. Plausible: Self-hosted web analytics (CE AGPLv3, twice a year; no funnels, journeys, revenue goals, SSO, sites API; basic bot filtering; Plausible Analytics Cloud is managed) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
33. GHCR manifest of ghcr.io/plausible/community-edition:v3.2.1 (linux/amd64): 64,805,743 B compressed in its layers; built 2026-05-15 from plausible/analytics e4f5a87, user 999 (מדידה · נקרא 14 באוק׳ 2026)
34. GHCR blob sha256:2d35ebdb… of community-edition:v3.2.1 (linux/amd64, Alpine 3.22.2 base layer): contains usr/bin/wget -> /bin/busybox (מדידה · נקרא 14 באוק׳ 2026)
35. GHCR tags of ghcr.io/plausible/community-edition (newest release v3.2.1; v3.2, v3 and latest move with it) (מאגר רשמי · נקרא 14 באוק׳ 2026)
36. Docker Hub: clickhouse/clickhouse-server tag 24.12.6.70-alpine (linux/amd64 154,945,233 B compressed; same digest as 24.12-alpine) (מאגר רשמי · נקרא 14 באוק׳ 2026)
37. Ecto Docs: Ecto.Repo (pool_size defaults to 10) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
38. docker-library/postgres: 18/trixie Dockerfile (postgres uid/gid 999, VOLUME /var/lib/postgresql) (מאגר רשמי · נקרא 14 באוק׳ 2026)
39. docker-library/postgres: 18/trixie docker-entrypoint.sh (chown PGDATA, then gosu postgres) (מאגר רשמי · נקרא 14 באוק׳ 2026)
40. PostgreSQL 18 documentation: 19.4 Resource Consumption (תיעוד רשמי · נקרא 10 באוק׳ 2026)
41. PostgreSQL 18 documentation: 19.3 Connections and Authentication (תיעוד רשמי · נקרא 10 באוק׳ 2026)
42. PostgreSQL 18 documentation: 19.10 Vacuuming (autovacuum settings) (תיעוד רשמי · נקרא 10 באוק׳ 2026)
43. PostgreSQL 18 documentation: 19.5 Write Ahead Log (max_wal_size) (תיעוד רשמי · נקרא 10 באוק׳ 2026)
44. PostgreSQL 18 documentation: 51.2 How Connections Are Established (תיעוד רשמי · נקרא 10 באוק׳ 2026)
45. Docker Official Image postgres: documentation (docker-library/docs) (תיעוד רשמי · נקרא 10 באוק׳ 2026)
46. Docker Hub: library/postgres tag 18.6 (compressed image sizes) (מאגר רשמי · נקרא 10 באוק׳ 2026)