SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor · Dikemas kini 2026-10-24

Cara Self-host Supabase di VPS Menggunakan Docker

Ketahui cara menjalankan stack rasmi Supabase di pelayan anda. Panduan ini merangkumi rahsia .env yang wajib ditukar, keperluan RAM, pengurusan servis, serta cara kemas kini.

Apa yang anda sedang bina

Self-hosting Supabase bermaksud menjalankan stack Docker Compose rasmi pada pelayan anda sendiri: Postgres, API REST di hadapannya, servis pengesahan, storan fail, websocket masa nyata, dan papan pemuka Studio. Anda mengklon satu repositori, menyunting satu fail .env, dan memulakan sebelas kontena yang secara kolektif berfungsi seperti projek Supabase di bawah kawalan anda.

Pemasangannya singkat. Bahagian yang sering bermasalah ialah fail .env. Ia dihantar bersama rahsia demo yang diterbitkan dalam repositori, dan stack yang dimulakan dengan tetapan lalai tersebut terbuka kepada sesiapa sahaja yang menemuinya. Panduan ini merangkumi rahsia yang perlu anda gantikan, tujuan setiap servis, jumlah memori yang sebenarnya diperlukan oleh stack tersebut, dan cara mengemas kininya tanpa memadamkan pangkalan data anda.

Jika Compose merupakan perkara baharu bagi anda, baca asas Docker Compose pada VPS terlebih dahulu. Segala maklumat di bawah mengandaikan docker compose version sudah memaparkan versi.

Kandungan sebenar stack tersebut

Supabase bukanlah satu program tunggal. Fail Compose memulakan set servis berasingan dalam satu rangkaian, dan memahami fungsi setiap satu akan membantu anda menyahpepijat senarai nama kontena yang panjang.

  • db ialah PostgreSQL dengan sambungan Supabase dimuatkan. Setiap servis lain berhubung dengannya. Jika kontena ini tidak sihat, semua servis lain turut gagal.
  • api-gw ialah API gateway. Sejak keluaran Ogos 2026, ia menjalankan Envoy; sebelum itu ia merupakan servis yang dipanggil kong, dan Kong masih tersedia sebagai pilihan ganti (opt-in override). Ia mendengar pada port 8000 dan menghalakan /rest/v1/, /auth/v1/ dan /storage/v1/ ke backend yang betul. Ia adalah satu-satunya kontena yang perlu anda dedahkan.
  • rest ialah PostgREST. Ia membaca skema Postgres anda dan menyediakannya sebagai REST API, jadi jadual baharu akan menjadi endpoint baharu tanpa perlu menulis kod.
  • auth ialah GoTrue. Ia mengeluarkan JSON web tokens (JWT) yang mengenal pasti pengguna anda.
  • storage dan imgproxy mengendalikan muat naik fail dan pengubahan saiz imej.
  • realtime menstrim perubahan pangkalan data melalui websocket.
  • studio dan meta ialah papan pemuka (dashboard) dan API pentadbir di sebaliknya.
  • functions ialah edge runtime berasaskan Deno, dan supavisor ialah Postgres connection pooler.

Log dan analitik (Logflare serta vector) telah dikeluarkan daripada fail Compose lalai pada Jun 2026. Ia kini merupakan fail ganti pilihan yang anda aktifkan dengan sh run.sh config add logs, menggunakan kaedah pelapisan fail Compose yang sama seperti yang diterangkan dalam menjalankan satu stack daripada beberapa fail Compose.

Senarai itulah sebabnya angka sumber di bawah ditetapkan sedemikian. Anda bukan sekadar menjalankan pangkalan data. Anda menjalankan pangkalan data berserta sepuluh servis sokongan.

Saiz: rancang untuk 8 GB RAM

Stack ini menggunakan kira-kira 2.5 hingga 3 GB memori residen pada pemasangan baharu setakat Julai 2026, sebelum data atau trafik anda sendiri diambil kira. Dalam ukuran tersebut, servis analitik dan proses Node.js Studio merupakan dua pengguna memori terbesar. Analitik bukan lagi sebahagian daripada stack lalai, jadi ia hanya menggunakan memori jika anda menghidupkan penggantian log (logs override). Pelayan 2 GB akan memulakan kontena tetapi kemudian kehilangan satu kontena akibat kernel out of memory killer, dan simptomnya ialah kontena tersekat dalam gelung but semula dengan exit code 137. Dokumentasi self-hosting Supabase sendiri, yang disemak pada Oktober 2026, menyenaraikan 4 GB RAM, 2 teras CPU dan 40 GB SSD sebagai minimum, manakala 8 GB, 4 teras dan 80 GB sebagai saranan.

Sediakan 8 GB RAM dan 4 vCPU untuk sebarang servis yang anda harapkan. 4 GB memadai untuk instans pembangunan solo jika anda menerima hakikat bahawa pertanyaan (query) yang berat dan sesi Studio yang dijalankan serentak akan menjadi perlahan. Storan juga penting kerana Postgres, volum storan, dan data log (jika anda mendayakannya) semuanya berada di bawah direktori projek. Mulakan dengan 40 GB dan pantau penggunaannya. Mengira jumlah servis sebelum memilih pelan adalah tabiat yang baik untuk sebarang perisian yang anda hos sendiri, memandangkan PhotoPrism dan Immich juga mempunyai keperluan RAM minimum yang nyata: halaman permulaan pantas Immich, yang disemak pada Oktober 2026, meminta sekurang-kurangnya 6 GB RAM dan 2 teras CPU. Jika ini melebihi keperluan pelayan projek anda buat masa ini, bandingkan dengan apa yang sebenarnya disertakan dalam pelan awan percuma Supabase, memandangkan aplikasi kecil yang kekal di bawah 500 MB dan tidak pernah terbiar selama seminggu boleh dijalankan di sana tanpa sebarang kos.

Pemasangan: klon repositori rasmi

Laluan yang disokong menyalin direktori docker daripada repositori utama ke dalam direktori projek anda sendiri. Pemisahan ini penting kerana ia bermaksud git pull yang akan datang tidak boleh menulis ganti .env anda.

git clone --depth 1 https://github.com/supabase/supabase
mkdir supabase-project
cp -rf supabase/docker/* supabase-project
cp supabase/docker/.env.example supabase-project/.env
cd supabase-project
docker compose pull

docker compose pull memuat turun beberapa gigabait imej. Proses ini sepatutnya berakhir dengan setiap servis ditandakan sebagai Pulled. Ralat manifest unknown di sini bermaksud tag imej yang dipinkan telah dialih keluar di bahagian hulu (upstream), dan penyelesaiannya adalah dengan menarik salinan repositori yang lebih baharu dan bukannya menyunting tag secara manual.

Rahsia yang wajib ditukar sebelum permulaan pertama

Lakukan perkara ini sebelum anda memulakan stack, bukan selepasnya. Beberapa nilai ini ditulis ke dalam data semasa but pertama, jadi menukarnya kemudian bermakna anda perlu menetapkan semula pangkalan data.

Repositori ini menyertakan penjana yang menghasilkan setiap nilai dengan betul, termasuk dua kunci API yang mesti ditandatangani dengan rahsia JWT baharu anda.

sh utils/generate-keys.sh --update-env

Skrip tersebut menulis nilai baharu untuk JWT_SECRET, ANON_KEY, SERVICE_ROLE_KEY, SECRET_KEY_BASE, REALTIME_DB_ENC_KEY, VAULT_ENC_KEY, PG_META_CRYPTO_KEY, token Logflare, kunci protokol S3 dan MINIO_ROOT_PASSWORD ke dalam .env. Setakat Oktober 2026, ia juga menulis nilai rawak untuk POSTGRES_PASSWORD dan DASHBOARD_PASSWORD. Ia memerlukan openssl, yang tersedia pada mana-mana imej Ubuntu biasa. Oleh kerana ia kini menulis semula kata laluan pangkalan data juga, jalankan skrip tersebut dengan --update-env hanya sebelum permulaan pertama, jangan sekali-kali jalankan terhadap stack yang sudah mengandungi data.

Dua nilai masih perlu diperiksa secara manual dalam .env:

  • POSTGRES_PASSWORD. Skrip mengisinya dengan hex rawak, yang selamat. Jika anda menggantikannya dengan nilai anda sendiri, gunakan huruf dan angka sahaja. Tanda baca di sini akan merosakkan rentetan sambungan (connection strings) yang dibina oleh beberapa servis dengan mencantumkan rentetan, dan kegagalan tersebut kelihatan seperti ralat pengesahan dan bukannya ralat penghuraian, yang menyebabkan pengguna mencari punca di tempat yang salah.
  • DASHBOARD_USERNAME dan DASHBOARD_PASSWORD. Ini adalah kelayakan pengesahan asas untuk Studio. Skrip menetapkan kata laluan rawak tetapi membiarkan nama pengguna pada nilai lalai supabase. Kata laluan lalai yang disertakan secara literal ialah this_password_is_insecure_and_should_be_updated, jadi jika anda melangkau skrip tersebut, tukarkannya sekarang.

Fahami mengapa ANON_KEY dan SERVICE_ROLE_KEY tidak boleh direka sendiri. Kedua-duanya adalah JWT yang ditandatangani dengan JWT_SECRET. Gateway hanya menerima kunci yang tepat dalam .env, dan servis di belakangnya mengesahkan tandatangan terhadap JWT_SECRET, jadi kunci yang tidak sepadan akan ditolak dengan HTTP 401. Gateway Envoy lalai menjawab 401 Unauthorized, begitu juga dengan penggantian Kong semasa, yang menjalankan Kong 3.9 dan mengembalikan {"message":"Unauthorized"}. Pemasangan sebelum Mac 2026 menjalankan Kong 2.8, yang menjawab {"message":"Invalid authentication credentials"}. Ini adalah kegagalan self-hosting yang paling biasa: pengendali menukar JWT_SECRET tetapi mengekalkan kunci demo. Jana ketiga-tiganya bersama-sama, sentiasa.

Anggap SERVICE_ROLE_KEY seperti kata laluan root. Ia memintas keselamatan peringkat baris (row level security) sepenuhnya. Ia hanya boleh diletakkan dalam kod bahagian pelayan dan tidak boleh diletakkan di tempat lain.

Tetapkan SITE_URL kepada alamat aplikasi anda, dan API_EXTERNAL_URL kepada alamat awam API dengan /auth/v1 di hujungnya, contohnya https://supabase.example.com/auth/v1. Tetapkan SUPABASE_PUBLIC_URL kepada alamat awam yang sama tanpa path tersebut. Auth membina pautan pengesahan e-mel dan pautan panggil balik OAuth daripada nilai-nilai tersebut, jadi membiarkannya pada nilai lalai localhost akan menghantar setiap pengguna anda ke mesin mereka sendiri.

Kemudian semak apa yang anda miliki:

sh run.sh secrets

Mulakan ia dan sahkan ia sihat

sh run.sh start
docker compose ps

run.sh start membungkus docker compose up -d --wait, jadi ia tidak akan kembali sehingga pemeriksaan kesihatan selesai. Setiap servis harus menunjukkan running (healthy) atau running. But pertama mengambil masa dua hingga empat minit kerana Postgres menjalankan skrip permulaannya sebelum perkara lain boleh disambungkan.

Jika kontena sedang dimulakan semula, baca lognya mengikut nama servis:

docker compose logs db
docker compose logs auth

Studio kemudiannya berada pada port 8000, dan ia akan meminta nama pengguna serta kata laluan papan pemuka yang telah anda tetapkan.

Jangan dedahkan port 8000 kepada internet awam

Gateway pada port 8000 menggunakan HTTP biasa. Setiap kunci API dan kata laluan pengguna dihantar melalui rangkaian dalam teks jelas, dan kelayakan Studio menggunakan pengesahan asas (basic authentication), yang merupakan pengekodan base64 dan bukannya penyulitan.

Letakkan reverse proxy di hadapannya, tamatkan TLS (transport layer security) di situ, dan ikat (bind) gateway tersebut kepada alamat loopback supaya tiada pihak lain boleh mencapainya. Dalam docker-compose.yml, baris port di bawah servis api-gw menjadi 127.0.0.1:${API_GW_HTTP_PORT:-${KONG_HTTP_PORT:-8000}}:8000/tcp, dan proksi akan menghalakan trafik ke situ. Bagi pemasangan sebelum perubahan kepada Envoy pada Ogos 2026, baris port yang sama terletak di bawah servis bernama kong. Traefik di hadapan beberapa aplikasi Compose merangkumi bahagian sijil. Proksi yang sama akhirnya akan mengendalikan segala-galanya pada pelayan tersebut, daripada stack ini sehinggalah kepada sesuatu yang santai seperti pustaka Jellyfin yang dibina semula sebagai kedai video 90-an, dan setiap satunya memerlukan nama hos dan bukannya port terbuka yang lain. Jika papan pemuka hanya untuk kegunaan anda, langkau proksi dan capai port loopback melalui SSH tunnel, pendekatan yang sama digunakan oleh open-kritt yang dihoskan sendiri untuk memastikan antara muka pengimbasannya tidak terdedah langsung kepada internet awam.

Tutup port lain pada firewall juga, kerana Docker menerbitkan port dengan menulis peraturan iptables sendiri yang tidak dikesan oleh konfigurasi ufw biasa. Perangkap tersebut dijelaskan dalam mengapa kontena Docker mengabaikan peraturan ufw anda.

Sandarkan pangkalan data, bukan direktori

Data Postgres berada dalam bind mount di ./volumes/db/data. Menyalin direktori tersebut semasa kontena sedang berjalan akan menghasilkan salinan yang tidak konsisten (torn copy), kerana Postgres menimbal (buffer) penulisan dan fail pada cakera hanya konsisten pada titik pusat pemeriksaan (checkpoint). Memulihkan data tersebut biasanya akan berjaya, namun kadangkala ia akan menghilangkan transaksi terakhir secara senyap, yang merupakan mod kegagalan paling buruk bagi sandaran.

Gunakan dump sebaliknya. pg_dumpall berjalan di dalam kontena dan menghasilkan syot kilat (snapshot) yang konsisten:

docker exec -t supabase-db pg_dumpall -U postgres > supabase-$(date +%F).sql

Pastikan fail tersebut tidak kosong sebelum anda mempercayainya. Kemudian, pindahkan fail dump tersebut keluar dari pelayan mengikut jadual, iaitu tujuan bagi sandaran luar tapak yang disulitkan menggunakan restic. Sandaran berjadual yang gagal secara senyap adalah sama seperti tiada sandaran langsung, jadi pastikan kerja cron atau systemd anda menghantar makluman ke telefon anda apabila ia keluar dengan kod bukan sifar. Sandarkan .env anda pada masa yang sama. Kehilangan JWT_SECRET bermakna setiap token yang dikeluarkan menjadi tidak sah dan setiap rahsia yang disimpan dalam bentuk sulit tidak boleh dibaca.

Fail yang dimuat naik berada dalam ./volumes/storage, dan fail tersebut adalah fail biasa, jadi penyalinan terus adalah memadai.

Kemas kini tanpa kehilangan data

Supabase menetapkan versi imej dalam docker-compose.yml, jadi tiada apa-apa yang berubah sehingga anda mengubahnya. Penetapan versi (pinning) wajar ditiru dalam mana-mana tindanan (stack) yang anda bina secara manual, itulah sebabnya relay RustDesk yang dihoskan sendiri menetapkan dua imej pelayannya dan tidak mengikut tag yang sentiasa berubah: naik taraf haruslah sesuatu yang anda pilih pada waktu pagi apabila anda mempunyai masa untuk melakukannya. Lakukan dump (sandaran) terlebih dahulu, setiap kali anda ingin melakukan naik taraf.

docker compose pull
sh run.sh recreate

recreate menghentikan tindanan tersebut dan memulakannya semula pada imej baharu. Data anda terselamat kerana ia berada dalam bind mount pada hos, bukan di dalam kontena. Baca CHANGELOG.md dalam repositori sebelum melakukan lonjakan versi utama, kerana naik taraf utama Postgres merupakan langkah berasingan yang tidak dilakukan oleh recreate. Postgres 17 telah menjadi lalai sejak Jun 2026, dan pemasangan sedia ada pada Postgres 15 akan beralih kepadanya dengan sudo bash utils/upgrade-pg17.sh, yang menggunakan pg_upgrade untuk memigrasikan data di tempatnya dan meminta pengesahan pada setiap langkah utama. Ia memerlukan setiap kontena berjalan dan ruang cakera kosong sekurang-kurangnya dua kali ganda saiz pangkalan data anda ditambah 5 GB, dan Supabase masih mengesyorkan sandaran bebas anda sendiri sebelum anda bermula.

Untuk mengambil perubahan pada fail Compose itu sendiri, jalankan sh update.sh dari direktori projek, atau sh update.sh --dry-run untuk melihat perkara yang akan berubah terlebih dahulu. Ia menggabungkan fail hulu (upstream) dengan suntingan anda sendiri, tidak akan menimpa nilai sedia ada dalam .env (ia hanya menambah kunci baharu), dan mengarkibkan konfigurasi anda di bawah backups/ sebelum menulis, walaupun bukan pangkalan data. Pemasangan tanpa fail .supabase-version memerlukan --from dan keluaran asal yang digunakan semasa memulakan pemasangan. Ini penting terutamanya untuk keluaran Ogos 2026, yang menggantikan servis kong dengan api-gw dan memerlukan kemas kini docker-compose.yml. Laluan manual juga masih berfungsi: klon semula repositori hulu dan salin direktori docker miliknya ke atas projek anda, dengan berhati-hati agar tidak menimpa .env.

Tetapan semula penuh, yang memusnahkan segala-galanya termasuk pangkalan data dan mengembalikan .env kepada lalai (yang lama disimpan sebagai .env.old), merupakan skrip berasingan dan ia meminta pengesahan:

sh reset.sh

FAQ

Mengapa panggilan API saya memulangkan "Invalid authentication credentials"?

Mesej tepat itu datang daripada Kong 2.8, iaitu gateway dalam stack bagi pemasangan sebelum Mac 2026. Gateway Envoy lalai dan penggantian Kong semasa, yang menjalankan Kong 3.9, melaporkan masalah yang sama sebagai 401 Unauthorized yang ringkas. Walau apa pun, kunci yang anda hantar tidak sepadan dengan ANON_KEY atau SERVICE_ROLE_KEY dalam .env, atau kunci tersebut tidak ditandatangani dengan JWT_SECRET yang kini berada dalam .env. Pada stack yang belum pernah menyimpan data, jana semula ketiga-tiganya bersama-sama dengan sh utils/generate-keys.sh --update-env. Pada stack yang sedang berjalan, jalankan skrip tanpa flag dan jawab tidak, supaya ia hanya mencetak nilai baharu, salin JWT_SECRET, ANON_KEY dan SERVICE_ROLE_KEY ke dalam .env secara manual, dan biarkan POSTGRES_PASSWORD tidak berubah. Kemudian jalankan sh run.sh recreate supaya servis membaca nilai baharu tersebut.

Bolehkah saya menjalankan Supabase yang dihoskan sendiri pada VPS 2 GB?

Tidak boleh dengan stabil. Dokumentasi hos sendiri Supabase menyenaraikan 4 GB RAM sebagai minimum setakat Oktober 2026, dan stack tersebut melahu hampir 3 GB setakat Julai 2026 dalam ukuran yang merangkumi servis log, yang kini bersifat pilihan. Kotak 2 GB akan kehilangan container akibat out of memory killer dan anda akan melihat exit code 137 dalam docker compose ps. Gunakan 8 GB untuk pengeluaran dan anggap 4 GB sebagai tahap minimum untuk pembangunan solo.

Adakah Supabase yang dihoskan sendiri menyertakan edge functions?

Ya. Fail Compose menyertakan runtime fungsi berasaskan Deno, dan ia melayani apa sahaja yang anda letakkan di bawah ./volumes/functions. Ia tidak menyertakan rangkaian penempatan global platform yang dihoskan, jadi fungsi anda berjalan pada satu pelayan anda, di satu lokasi.

Bagaimanakah cara saya menyambung ke pangkalan data Postgres secara terus?

Gunakan docker exec -it supabase-db psql -U postgres untuk shell interaktif pada pelayan itu sendiri. Untuk klien luaran, sambung melalui Supavisor pada port 5432 dengan pengguna postgres.<POOLER_TENANT_ID> dan POSTGRES_PASSWORD anda. Jangan buka port tersebut kepada internet. Capai ia melalui VPN atau tunnel SSH.

Mengapa pautan e-mel pengesahan auth saya menghala ke localhost?

SITE_URL dan API_EXTERNAL_URL dalam .env dibiarkan pada nilai lalai. Servis auth membina setiap pautan pengesahan dan tetapan semula kata laluan daripada dua nilai tersebut, jadi ia menghantar alamat yang diarahkan untuk dihantar. Tetapkan kedua-duanya kepada URL awam sebenar anda dan cipta semula stack tersebut.

Adakah artikel ini berguna?