Cara Self-host OpenAnalytics di VPS Sendiri

Tapak permulaan, sebelum langkah pertama

Untuk mengehos sendiri OpenAnalytics, anda memerlukan VPS Linux dengan kira-kira 4 GB RAM, 25 GB ruang cakera kosong, Docker dengan pemalam Compose, dan empat rekod DNS yang sudah menghala ke pelayan tersebut. Ini adalah kenyataan yang jujur, dan ia perlu diletakkan sebelum arahan pertama dan bukannya selepasnya.

Stak ini terdiri daripada enam servis aplikasi dan tiga stor data. Postgres menyimpan satah kawalan: akaun, tapak, kunci API dan pautan perkongsian. ClickHouse menyimpan data peristiwa mentah dan data terkumpul yang dibaca oleh papan pemuka. Valkey dijalankan dua kali, sekali sebagai baris gilir peristiwa yang tahan lama dan sekali lagi sebagai cache yang boleh hilang, kerana kedua-dua tugas ini memerlukan polisi pengusiran (eviction policies) yang bertentangan. Hanya satu proses, iaitu gerbang pertanyaan (query gateway), dibenarkan membaca ClickHouse, dan ia mengesahkan tandatangan Ed25519 pada setiap sampul pertanyaan sebelum ia menjalankan sebarang pertanyaan.

Jika apa yang anda mahukan ialah satu binari dan satu fail konfigurasi, ini bukan pilihannya. GoatCounter ialah pilihan binari tunggal dalam kategori ini: satu fail boleh laku Go, SQLite secara lalai, tanpa pangkalan data luaran sama sekali. Stak yang lebih berat memberikan anda fungsi corong (funnels), web vitals, atribusi hasil daripada akaun Stripe anda sendiri, dan pelayan MCP (model context protocol). Memilih antara alat analitik yang dihoskan sendiri ialah catatan yang menimbang perbandingan tersebut. Panduan ini mengandaikan anda telah membuat keputusan.

Halakan empat rekod DNS ke pelayan terlebih dahulu

Empat subdomain mesti diselesaikan (resolve) kepada alamat IP awam pelayan sebelum anda memulakan sebarang langkah, kerana Caddy akan meminta sijil Let’s Encrypt pada pelancaran pertama dan cabaran tersebut akan gagal jika nama domain belum diselesaikan.

• app.example.com melayani papan pemuka (dashboard).
• api.example.com melayani API dan callback OAuth.
• c.example.com melayani pengumpul (collector) dan skrip penjejak.
• rt.example.com melayani strim masa nyata.

Gunakan empat rekod A, atau satu rekod A dan tiga CNAME yang menghala kepadanya. Sahkan dengan dig +short app.example.com sebelum anda meneruskan. Nama yang anda tambah seminit lalu mungkin masih disimpan dalam cache sebagai NXDOMAIN oleh mana-mana resolver yang digunakan oleh Let’s Encrypt, jadi jika percubaan sijil pertama gagal, anda disarankan untuk menunggu dan menyemak log Caddy. Menjalankan semula pemasangan tidak akan mempercepatkan penyebaran (propagation) DNS.

Cara melakukan self-host OpenAnalytics dengan Docker Compose

Semak keluar (checkout) release yang bertanda. Cawangan lalai (default branch) adalah tempat pembangunan berlaku, dan tag release adalah perkara yang sebenarnya dipadankan oleh imej yang diterbitkan. Perintah di bawah mengandaikan Docker dan plugin Compose sudah dipasang, yang diliputi dalam menjalankan servis Docker Compose pada VPS.

git clone https://github.com/OpenLabs-so/openanalytics
cd openanalytics
git checkout "$(git tag -l 'v*' --sort=-v:refname | sed '/-/d' | head -1)"
cd infra/selfhost
./generate-secrets.sh --domain example.com --email you@example.com --with-geoip
docker compose pull && docker compose up -d

sed '/-/d' dalam baris checkout menggugurkan tag pra-keluaran, supaya anda mendarat pada versi stabil terkini dan bukannya calon keluaran (release candidate). --with-geoip mengambil pangkalan data bandar DB-IP semasa penjanaan. Langkau langkah ini dan setiap acara akan membawa negara null, jadi paparan geografi tidak menunjukkan apa-apa langsung. Anda boleh menambahnya kemudian dengan menjalankan infra/selfhost/geoip/fetch-dbip.sh, menetapkan GEOIP_DB_PATH=/geoip/dbip-city-lite.mmdb dalam env/collector.env, kemudian mencipta semula pengumpul (collector) dengan docker compose up -d --force-recreate collector. Pangkalan data itu disegarkan setiap bulan, jadi ulangi pengambilan tersebut setiap bulan atau data bandar anda akan menjadi tidak tepat.

Sandarkan rahsia yang dijana sebelum anda meneruskan

Penjana tersebut menulis tiga perkara. .env menyimpan nama domain dan rujukan imej. env/*.env menyimpan satu fail rahsia bagi setiap servis. docker-compose.override.yml menyimpan tiga pasangan kunci Ed25519 sebagai skalar blok YAML, kerana PEM berbilang baris tidak boleh diletakkan dalam fail env. Kesemuanya diabaikan oleh git, dan tiada satu pun daripadanya boleh dijana semula kepada nilai yang sama.

Salin fail-fail tersebut keluar dari mesin sekarang. Setiap kehilangan membawa kesan yang khusus:

• Kehilangan kata laluan storan menyebabkan anda terkunci daripada Postgres dan ClickHouse, yang hanya boleh ditetapkan semula dari dalam kontena.
• Kehilangan OA_CREDENTIAL_KEYRING menyebabkan setiap kelayakan pihak ketiga yang disimpan tidak dapat dipulihkan, jadi sesiapa yang telah menyambungkan akaun Stripe perlu menyambungkannya semula.
• Kehilangan ANONYMOUS_IDENTITY_SECRET menyebabkan identiti pelawat ditetapkan semula: pelawat semalam semuanya dikira sebagai pelawat baharu, dan gangguan tersebut akan kelihatan pada carta.
• Kehilangan AUTH_SECRET menyebabkan setiap sesi dibatalkan, jadi semua orang perlu log masuk semula.
• Kehilangan kunci persendirian penandatangan (signing private key) bermakna anda perlu menukar pasangan kunci tersebut. Tiada data yang hilang.

Dua rahsia mesti mempunyai bait yang sama merentasi dua fail setiap satu. ANONYMOUS_IDENTITY_SECRET muncul dalam collector.env dan worker.env, kerana pengumpul (collector) mengira hash pelawat dan pekerja (worker) menulisnya. OA_CREDENTIAL_KEYRING muncul dalam api.env dan worker.env. Segala perkara lain dihadkan kepada tepat satu servis secara sengaja, dan servis yang diberikan rahsia yang tidak sepatutnya dipegang akan keluar (exit) dan bukannya bermula.

Naikkan stack dan buat pemeriksaan

grep OA_IMAGE .env
docker compose pull
docker compose up -d
docker compose logs -f migrate
docker compose ps

migrate akan menggunakan skema Postgres dan ClickHouse kemudian berhenti, jadi kontena migrate yang berhenti adalah keadaan akhir yang betul. tracker-build akan menyusun oa.js ke dalam volum yang dihidangkan oleh Caddy dan kemudian turut berhenti. Servis lain sepatutnya memaparkan healthy dalam docker compose ps. Servis yang dimulakan semula secara berulang hampir selalu disebabkan oleh kegagalan pengesahan persekitaran, dan log akan mencetak setiap masalah dalam satu senarai dan bukannya satu demi satu bagi setiap permulaan semula. Dua punca biasa ialah pemboleh ubah yang dibiarkan kosong, yang ditolak dan bukannya dianggap sebagai tidak ditetapkan, serta rahsia (secret) yang diletakkan dalam fail servis yang salah.

Pada arm64, atau daripada cawangan (branch), tiada imej yang diterbitkan dan anda perlu membina secara setempat dengan docker compose up -d --build. Hos dengan 4 GB RAM akan kehabisan memori semasa proses binaan tersebut. Tambahkan swap terlebih dahulu, yang hanya diperlukan semasa proses membina:

fallocate -l 4G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab

Proses membina mengambil masa kira-kira sepuluh minit. Proses menarik (pulling) mengambil masa beberapa minit, itulah sebabnya imej keluaran (release images) disediakan.

Tuntut akaun pertama dengan segera

Buka https://app.example.com. Peluncuran yang belum pernah dilog masuk tidak akan memaparkan borang log masuk: sebaliknya, ia menawarkan untuk mencipta akaun pertama. Akaun tersebut kekal sebagai akaun berkeistimewaan dan merupakan satu-satunya akaun yang boleh melihat skrin tetapan peluncuran. Sebaik sahaja akaun itu wujud, laluan tersebut akan menjawab 409, supaya tiada sesiapa boleh masuk selepas anda. Lakukan perkara ini sebaik sahaja stack berada dalam keadaan sihat, bukan pada minggu berikutnya.

Memasang penjejak

Tambah tapak dalam papan pemuka dan ia akan memberikan anda tag tersebut. Bentuknya adalah tetap:

<script
  async
  src="https://c.example.com/oa.js"
  data-key="YOUR_TRACKING_KEY"
  data-collector="https://c.example.com"
></script>

Letakkannya di dalam head halaman. Kunci penjejakan adalah awam mengikut reka bentuk, jadi ia sepatutnya berada dalam HTML anda di mana sesiapa sahaja boleh membacanya. Skrip ini memasang window.oa, dan panggilan seperti oa("track", ...) akan diletakkan dalam baris gilir oleh stub dan dihantar sebaik sahaja fail dimuatkan, jadi acara tersuai yang dicetuskan lebih awal tidak akan digugurkan. Jika sesuatu yang lain pada halaman tersebut sudah memiliki window.oa, penjejak akan dipasang sebagai window.openanalytics sebaliknya. Jika tapak yang sama juga menjawab sebagai perkhidmatan onion, jangan sertakan tag tersebut dalam binaan itu, kerana skrip yang diambil daripada c.example.com akan menarik pelawat Tor Browser kembali ke clearnet dan memautkan kedua-dua alamat tersebut dalam pemuatan halaman yang sama.

Kemudian periksa keseluruhan laluan dari hujung ke hujung:

curl -s https://c.example.com/oa.js -o /dev/null -w '%{http_code} %{size_download}\n'
curl -s https://api.example.com/health | head -c 200
docker compose logs --tail=50 worker | grep -i batch

Yang pertama sepatutnya mencetak 200 dan beberapa kilobait. Muatkan halaman pada tapak anda, kemudian cari baris batch dalam log pekerja dalam masa beberapa saat. Pengumpul menjawab 202 sebaik sahaja ia menerima acara, dan 202 bermaksud diletakkan dalam baris gilir, bukan disimpan. Pekerja adalah komponen yang memindahkan acara ke dalam ClickHouse. Acara yang diterima tetapi tidak muncul dalam papan pemuka bermakna pekerja disekat, dan kedalaman baris gilir Valkey yang terus meningkat mengesahkan perkara ini. Punca biasa ialah kelayakan ClickHouse yang salah dalam worker.env, atau kebenaran yang hilang pada jadual yang baru sahaja ditambah oleh migrasi.

Pastikan pengumpul boleh diakses awam dan papan pemuka dilindungi pengesahan

Caddy disertakan di dalam fail compose dan memperoleh sijil untuk kesemua empat nama secara automatik, jadi laluan lalai tidak memerlukan sebarang kerja proksi daripada anda. Jika pelayan sudah menjalankan proksi terbalik nginx, gunakan infra/selfhost/nginx.conf.example yang dibekalkan untuk bahagian hadapan tindanan tersebut, dan pastikan pengendalian pengepala (header) dikekalkan:

proxy_set_header X-Real-IP $remote_addr;
proxy_set_header CF-Connecting-IP "";
proxy_set_header True-Client-IP "";
proxy_set_header Fly-Client-IP "";

Pengumpul memperoleh hash pelawat harian daripada IP klien, jadi ia mesti mengambil alamat tersebut daripada sambungan dan bukan daripada pengepala. Menghantar CF-Connecting-IP melalui hop yang tidak dipercayai membolehkan mana-mana pemanggil menuntut sebarang alamat, yang akan merosakkan geolokasi dan meningkatkan kiraan pelawat secara serentak.

Akses dibahagikan dengan jelas mengikut nama hos. c. dan rt. mesti boleh dicapai oleh setiap pelawat bagi setiap tapak yang anda ukur, jadi jangan sekali-kali meletakkan pengesahan asas (basic auth) atau senarai putih IP di hadapan kedua-duanya. app. dan api. hanya perlu boleh dicapai oleh pengguna yang log masuk. Pengesahan aplikasi itu sendiri yang melindungi papan pemuka: log masuk kata laluan diaktifkan secara lalai melalui AUTH_PASSWORD_SIGNIN=enabled dalam env/api.env, dan butang Google atau GitHub hanya muncul apabila kedua-dua ID klien dan rahsia klien wujud untuk pembekal tersebut. Pautan ajaib (magic links) memerlukan pengangkutan mel, dan tanpanya API hanya menulis penghantaran ke peti keluar, jadi tiada apa-apa yang dihantar dan tiada ralat berlaku. Jika aplikasi self-hosted anda yang lain sudah berada di belakang log masuk tunggal Authentik, tentukan lebih awal sama ada papan pemuka ini akan menyertainya atau mengekalkan akaunnya sendiri, kerana akaun pertama yang anda cipta di sini akan kekal sebagai akaun berkeistimewaan.

Satu tetapan menentukan sama ada papan pemuka berfungsi atau tidak. AUTH_TRUSTED_ORIGINS dalam env/api.env mesti sepadan dengan asal (origin) papan pemuka dengan tepat. Jika salah atau tiada, API tidak mengeluarkan pengepala CORS (cross-origin resource sharing), pelayar akan menolak setiap panggilan, dan anda akan mendapat papan pemuka yang memaparkan susun atur tetapi tidak menunjukkan data, sementara docker compose ps melaporkan semuanya dalam keadaan baik.

Semasa anda berada dalam konfigurasi proksi, uruskan trafik automatik. Perangkak (crawler) mencapai pengumpul seperti trafik lain, dan paparan halaman mereka akan masuk ke dalam ClickHouse serta angka anda. Menyekat perangkak AI di pelayan menghalang sebahagian daripada trafik tersebut daripada memasuki pangkalan data sebelum ia menjejaskan ketepatan dan penggunaan cakera anda.

Apakah maksud "tanpa kuki" di sini, dan apakah kesannya kepada anda

Tiada kuki digunakan. Identiti pelawat adalah hash yang disaltkan, salt tersebut bertukar setiap hari, dan alamat IP mentah tidak pernah disimpan. Geolokasi diselesaikan secara setempat menggunakan fail DB-IP pada cakera anda sendiri, jadi tiada carian tentang pelawat yang keluar daripada hos tersebut. Mengekalkan carian secara setempat hanya membuang vendor, bukan data, yang merupakan had sama yang muncul apabila anda menjalankan instans SearXNG sendiri dan IP pelayan anda menjadi perkara yang dilihat oleh enjin carian.

Apa yang anda perolehi ialah ketiadaan pengecam yang dikekalkan pada peranti pelawat, yang merupakan perkara khusus yang menarik penjejak ke dalam peraturan persetujuan ePrivacy EU. Persediaan yang hanya berasaskan agregat seperti ini biasanya dijalankan tanpa sepanduk persetujuan atas sebab tersebut. GDPR masih mengawal apa sahaja yang anda simpan dan untuk berapa lama, dan peguam anda sendiri yang memutuskan kes anda, bukan fail README.

Apa yang anda korbankan ialah identiti merentas hari. Pertukaran salt bermakna seseorang yang melawat pada hari Isnin dan sekali lagi pada hari Rabu dikira sebagai dua pelawat, mengikut reka bentuk dan tiada jalan penyelesaian. Kiraan unik harian adalah tepat. Kiraan unik mingguan dan bulanan dibina daripada kiraan harian dan akan melebihkan jangkauan, jadi sebarang angka "pelawat kembali" dalam tempoh masa yang panjang tidak mengukur apa yang dilabelkan. Sesi dan perjalanan adalah boleh dipercayai dalam satu hari sahaja. Pertukaran ANONYMOUS_IDENTITY_SECRET mempunyai kesan yang sama seperti sempadan hari, jadi anggap pertukaran itu sebagai perubahan data dan bukannya sebagai rutin kebersihan biasa.

Pengumpul menghormati Do Not Track dan Global Privacy Control, isyarat pelayar yang memberitahu tapak supaya tidak menjual atau berkongsi data peribadi. Tag skrip membawa suisnya sendiri untuk tujuan yang sama: data-respect-gpc, data-respect-dnt, dan data-require-consent, yang menahan semua pengumpulan sehingga persetujuan diberikan dan mengingati jawapan dalam localStorage di bawah kunci oa.consent. Menetapkan data-storage="none" mematikan storan pelayar sepenuhnya.

Mengapa cakera penuh selepas enam bulan

Ini adalah punca utama kegagalan pelayan analitik yang dihoskan sendiri, dan acara (events) biasanya bukan penyebabnya.

Mulakan dengan imej. Satu keluaran menerbitkan sepuluh imej, dan saiznya mencecah kira-kira 13 GB pada cakera. Proses naik taraf akan menarik generasi baharu sebelum membuang yang lama, jadi untuk seketika anda menyimpan dua generasi. Ini merupakan sebahagian besar daripada keperluan 25 GB, sebelum satu pun paparan halaman diterima.

Kemudian, snapshot. snapshot.sh menghentikan stack, mengarkibkan kedua-dua volum data bersama setiap rahsia, dan memulakan semula. Salinan sejuk (cold copies) adalah satu-satunya jenis yang selamat di sini, kerana ClickHouse menggabungkan bahagian di latar belakang dan salinan yang diambil semasa penggabungan tidak konsisten. upgrade.sh mengambil satu salinan secara automatik sebelum setiap naik taraf, jadi arkib akan terkumpul pada cakera yang sama sehingga anda mengehadkannya.

./snapshot.sh create --label before-something-risky
./snapshot.sh list
./snapshot.sh --keep 3

Pada hos yang hampir mencapai had, tuntut semula generasi sebelumnya sebelum melakukan naik taraf. Ini selamat dilakukan semasa stack sedang berjalan, kerana imej yang menyokong kontena yang sedang berjalan masih dirujuk:

docker image prune -a -f

Seterusnya, acara itu sendiri. ClickHouse memampatkan data kolumnar dengan sangat padat, jadi volum acara mentah berkembang lebih perlahan daripada jangkaan kebanyakan orang, dan jadual rollup yang dibaca oleh papan pemuka adalah kecil berbanding jadual mentah. Ukur dan jangan meneka:

docker system df -v
docker compose exec clickhouse df -h /var/lib/clickhouse

Untuk angka bagi setiap jadual, jalankan arahan ini dengan kelayakan ClickHouse yang ditulis oleh penjana di bawah infra/selfhost/env/:

SELECT table, formatReadableSize(sum(bytes_on_disk)) AS size, sum(rows) AS row_count
FROM system.parts
WHERE active
GROUP BY table
ORDER BY sum(bytes_on_disk) DESC;

Ambil bacaan tersebut pada minggu pertama dan sekali lagi pada minggu keempat. Dua titik data memberikan anda kadar pertumbuhan, dan kadar pertumbuhan memberitahu anda bila volum perlu diubah saiznya. Panduan hos sendiri tidak mendokumentasikan sebarang tetapan pengekalan atau masa-untuk-hidup (time-to-live) bagi acara mentah setakat Ogos 2026, jadi tetapkan saiz cakera berdasarkan kadar yang anda ukur dan bukannya mengandaikan baris lama akan tamat tempoh dengan sendirinya.

Satu perangkap pemadaman perlu diketahui sebelum ia menjejaskan anda. Memadamkan tapak atau akaun akan meletakkan tugasan dalam baris gilir untuk pekerja (worker), dan pekerja tersebut memerlukan CLICKHOUSE_MAINTENANCE_USER dan CLICKHOUSE_MAINTENANCE_PASSWORD ditetapkan, dengan pengguna oa_maintenance yang sepadan wujud dalam ClickHouse. Tanpanya, pemadaman akan berada dalam baris gilir selama-lamanya. Tapak tersebut hilang daripada papan pemuka dan setiap baris kekal pada cakera, jadi anda mendapat gambaran pembersihan telah berlaku tetapi tiada ruang yang dikosongkan.

Naik taraf, dan tiga kos yang terlibat

git fetch --tags
git checkout "$(git tag -l 'v*' --sort=-v:refname | sed '/-/d' | head -1)"
cd infra/selfhost
./upgrade.sh

upgrade.sh akan memaparkan tiga kos sebelum ia bertindak. Downtime adalah nyata: peristiwa yang dicuba semasa pengumpul (collector) tidak berfungsi akan hilang, kerana penjejak (tracker) tidak melakukan percubaan semula. Rollback akan menyebabkan kehilangan data, kerana rollback.sh --to backups/<snapshot> menggantikan kedua-dua stor secara keseluruhan dan membuang setiap baris yang ditulis selepas snapshot tersebut diambil. Kos ketiga ialah cakera, iaitu timbunan snapshot yang diterangkan di atas.

Dua peraturan mulakan semula (restart) mudah disalah anggap. Hidupkan query gateway sebelum API, kerana API yang lebih baharu menghantar medan pertanyaan yang ditolak oleh gateway yang lebih lama. Dan ClickHouse memerlukan penciptaan semula (recreate) dan bukannya mulakan semula, kerana docker compose restart menggunakan semula persekitaran asal kontena dan mengabaikan suntingan anda secara senyap:

docker compose up -d --force-recreate clickhouse

Papan pemuka (dashboard) mempunyai bentuk perangkap yang sama. Tiga asal NEXT_PUBLIC_* dalam env/web.env dikompilasi ke dalam bundle pelayar dan digantikan apabila kontena bermula, jadi papan pemuka yang memanggil hostname yang salah diperbetulkan dengan docker compose up -d --force-recreate web dan bukannya restart. Log kontena web mencetak asal yang digunakan semasa ia bermula, yang merupakan cara terpantas untuk mengesahkan pembetulan telah berjaya.

Jika ClickHouse enggan bermula selepas suntingan konfigurasi, baca baris pertama lognya. Baris yang bermula dengan oa-entrypoint: bermaksud entrypoint menolak nilai yang anda tetapkan. Sebarang mesej lain biasanya bermaksud fail konfigurasi adalah XML yang tidak sah, dan punca paling biasa ialah tanda sempang berganda di dalam komen XML, yang tidak dibenarkan di situ.

AGPL-3.0, dan nama tersebut

Kod ini dilesenkan di bawah AGPL-3.0. Menjalankan kod ini tanpa pengubahsuaian untuk laman web anda sendiri tidak mewujudkan sebarang obligasi penerbitan. Obligasi bermula apabila anda mengubah suai kod tersebut dan menjalankan versi yang diubah suai itu sebagai servis rangkaian: lesen tersebut kemudiannya mewajibkan anda untuk menawarkan kod sumber yang telah diubah suai kepada pengguna servis tersebut. Ini merangkumi pemberian papan pemuka kepada klien pada instans anda, dan ia merangkumi penggabungan kod tersebut ke dalam sesuatu yang anda jual. Menyimpan perubahan anda dalam fork awam memenuhi syarat tersebut tanpa proses lanjut.

Jenama adalah berasingan daripada kod. Nama "OpenAnalytics" dan domain yang dihoskan oleh projek tersebut mengenal pasti instans yang dikendalikan oleh penulisnya, dan ia bukan sebahagian daripada pemberian lesen. Penempatan anda menjalankan perisian tersebut tanpa membawa jenama itu, jadi berikan nama sendiri kepada servis tersebut sebelum anda menawarkannya kepada pelanggan berbayar.

FAQ

Bolehkah saya menjalankan OpenAnalytics pada VPS 1 GB?

Tidak. Projek ini memerlukan kira-kira 4 GB RAM dan 25 GB ruang cakera kosong, kerana satu deployment menjalankan enam servis aplikasi di samping Postgres, ClickHouse dan dua instance Valkey. ClickHouse sahaja bukanlah proses yang ringan. Pada pelayan 1 GB, container akan bermula tetapi kernel out-of-memory killer akan menamatkan salah satu daripadanya, biasanya ClickHouse. Jika pelan 1 GB adalah kekangan mutlak, gunakan alat binari tunggal seperti GoatCounter, yang berjalan menggunakan SQLite tanpa pangkalan data luaran.

Adakah saya memerlukan sepanduk kuki dengan OpenAnalytics?

Itu adalah soalan untuk peguam anda, dan fakta teknikal menyebelahi anda. Tiada kuki digunakan, identiti pelawat adalah hash bersalt yang bertukar setiap hari, dan alamat IP mentah tidak pernah disimpan, jadi tiada data kekal ditulis untuk mengenal pasti pelawat. GDPR masih mengawal apa yang anda simpan dan berapa lama anda menyimpannya. Jika anda mahu pengumpulan data dilakukan secara eksplisit, tetapkan data-require-consent pada tag skrip: penjejak tidak akan mengumpul apa-apa sehingga kebenaran diberikan dan menyimpan jawapan tersebut dalam localStorage di bawah oa.consent.

Mengapa acara mengembalikan 202 tetapi tidak pernah muncul dalam papan pemuka?

202 bermaksud pengumpul telah menerima dan meletakkan acara dalam baris gilir, bukan bermaksud ia telah menyimpannya. Pekerja (worker) akan mengosongkan baris gilir tersebut ke dalam ClickHouse, jadi papan pemuka yang kosong dengan permintaan yang berjaya menunjukkan masalah pada pekerja. Baca docker compose logs --tail=50 worker dan pantau kedalaman baris gilir Valkey. Baris gilir yang terus berkembang bermakna pekerja disekat, dan punca biasa adalah kelayakan ClickHouse yang salah dalam worker.env atau kebenaran (grant) yang hilang pada jadual yang dicipta oleh migrasi terkini.

Mengapa papan pemuka kosong sedangkan setiap container sihat?

Semak AUTH_TRUSTED_ORIGINS dalam env/api.env terlebih dahulu. Ia mesti sepadan dengan origin papan pemuka dengan tepat, dan jika tidak, API tidak akan mengeluarkan header CORS, jadi pelayar akan menolak setiap panggilan dan anda akan melihat susun atur yang berfungsi tanpa data. Perkara kedua untuk disemak ialah tiga nilai NEXT_PUBLIC_* dalam env/web.env, yang digantikan apabila container web bermula. Membetulkannya memerlukan docker compose up -d --force-recreate web, kerana restart biasa akan mengekalkan nilai lama.

Adakah AGPL-3.0 menghalang saya daripada menawarkan ini kepada pelanggan?

Tidak, ia hanya mengenakan satu syarat. Jalankan kod tanpa diubah suai dan anda tidak berhutang apa-apa kepada sesiapa. Ubah suai kod tersebut dan jalankan versi yang diubah suai itu sebagai servis yang digunakan oleh orang lain, dan anda mesti menawarkan kod sumber yang diubah suai itu kepada pengguna tersebut, yang boleh dipenuhi melalui fork awam. Secara berasingan, nama "OpenAnalytics" tidak dilesenkan bersama kod tersebut, jadi apa sahaja yang anda jual perlu menggunakan nama sendiri.