SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Cara Self-host Planka dengan Docker Compose

Panduan lengkap memasang Planka di VPS menggunakan Docker Compose, Postgres dan Traefik. Ketahui cara menetapkan BASE_URL yang betul agar isu log masuk tidak berlaku.

Kelebihan self-hosting Planka

Self-hosting Planka memberikan pasukan anda papan Kanban dengan model kad, senarai dan label yang sudah biasa digunakan oleh pengguna Trello, yang berjalan pada VPS di bawah kawalan anda. Tiada had bilangan pengguna dan tiada bil bagi setiap pengguna, kerana satu-satunya kos ialah pelayan itu sendiri. Panduan ini menggunakan Docker Compose di belakang Traefik, dengan Postgres untuk data dan named volume bagi setiap fail yang dimuat naik oleh pengguna.

Planka 2 dikeluarkan di bawah Fair Use License projek tersebut, yang disifatkan oleh projek itu sebagai source-available dan bukannya open source. Menjalankannya untuk projek dalaman organisasi anda sendiri adalah dibenarkan. Menawarkannya kepada pihak ketiga sebagai perkhidmatan hos komersial memerlukan lesen Pro atau Enterprise.

Panduan ini ditujukan kepada pasukan yang terdiri daripada dua hingga lima orang yang ingin beralih daripada pelan percuma Trello. Jika anda masih membuat keputusan papan mana yang ingin digunakan, baca perbandingan alternatif Trello yang di-self-host terlebih dahulu. Panduan ini mengandaikan pilihan telah dibuat dan hanya merangkumi proses deployment.

Anda memerlukan VPS yang menjalankan Docker Engine dengan pemalam Compose, serta DNS A record yang menghala ke VPS tersebut. Anda juga memerlukan instance Traefik yang sudah melakukan TLS (transport layer security) termination pada pelayan tersebut. Jika Traefik belum tersedia, sediakan reverse proxy Traefik di hadapan beberapa aplikasi Compose terlebih dahulu, dan baca asas Docker Compose untuk VPS jika fail di bawah kelihatan asing bagi anda.

Berapakah saiz VPS yang diperlukan oleh Planka?

FAQ teknikal projek ini mengesyorkan sekurang-kurangnya 2 GB RAM dan 10 GB storan untuk pasukan kecil, jadi anggap angka tersebut sebagai titik permulaan dan bukannya ukuran mutlak.

Apa yang sebenarnya dijalankan adalah kecil: satu proses Node.js yang menyediakan API dan frontend yang telah dibina, serta pelayan Postgres yang menyimpan data, yang menjalankan proses penyeliaan berserta satu proses backend bagi setiap sambungan yang dibuka. Satu proses proksi kecil juga berjalan di dalam kontena Planka untuk menapis permintaan keluar. Pelan 2 GB sepadan dengan syor RAM projek untuk pasukan kecil. Papan (board) adalah jiran yang ringan, jadi jika VPS yang sama juga bertujuan untuk menyimpan dokumen pasukan anda, tentukan saiz untuk aplikasi tersebut terlebih dahulu: menjalankan AFFiNE sebagai ruang kerja gaya Notion memerlukan beberapa gigabait secara sendirian sebelum Planka meminta sebarang sumber.

Tentukan saiz cakera sebelum anda menentukan saiz memori, kerana lampiran adalah bahagian yang akan berkembang. Ukur instans anda sendiri dan jangan hanya mempercayai perenggan ini:

docker stats --no-stream
docker system df -v

Perintah pertama mencetak memori dan CPU secara langsung bagi setiap kontena. Perintah kedua menunjukkan berapa banyak ruang yang digunakan oleh setiap volum. Ambil kedua-dua bacaan selepas satu minggu bekerja yang biasa, bukan pada hari pemasangan, kerana papan yang melahu tidak memberikan maklumat tentang pasukan anda.

Cipta direktori dan ambil pemilikan ke atasnya, supaya anda tidak perlu menyunting fail ini melalui sudo.

sudo mkdir -p /opt/planka
sudo chown "$USER":"$USER" /opt/planka
cd /opt/planka

Jana rahsia ke dalam fail .env di sebelah fail Compose. Compose membaca fail tersebut secara automatik dan menggantikan nilai-nilainya.

umask 077
{
  printf 'SECRET_KEY=%s\n' "$(openssl rand -hex 64)"
  printf 'POSTGRES_PASSWORD=%s\n' "$(openssl rand -hex 24)"
  printf 'ADMIN_PASSWORD=%s\n' "$(openssl rand -hex 12)"
} > .env
chmod 600 .env

openssl rand -hex adalah disengajakan. Rentetan heksadesimal hanya mengandungi digit dan huruf a hingga f, jadi ia tidak boleh merosakkan rentetan sambungan DATABASE_URL yang ia ditampal ke dalamnya. Base64 standard boleh mengandungi garis miring, tanda tambah dan tanda sama dengan sebagai pelapik, tetapi tidak pernah mengandungi tanda at; aksara dengan maksud khas dalam URL sambungan memerlukan pengekodan peratus. Corak yang lebih luas diliputi dalam menjauhkan rahsia daripada fail Compose.

Sekarang docker-compose.yml. Gantikan kanban.example.com dengan nama hos anda sendiri di kedua-dua tempat ia muncul.

services:
  planka:
    image: ghcr.io/plankanban/planka:2.2.1
    restart: unless-stopped
    volumes:
      - planka-data:/app/data
    environment:
      - BASE_URL=https://kanban.example.com
      - DATABASE_URL=postgresql://planka:${POSTGRES_PASSWORD}@postgres/planka
      - SECRET_KEY=${SECRET_KEY}
      - TRUST_PROXY=true
      - DEFAULT_ADMIN_EMAIL=you@example.com
      - DEFAULT_ADMIN_PASSWORD=${ADMIN_PASSWORD}
      - DEFAULT_ADMIN_NAME=Your Name
      - DEFAULT_ADMIN_USERNAME=admin
    networks:
      - proxy
      - internal
    labels:
      - "traefik.enable=true"
      - "traefik.docker.network=proxy"
      - "traefik.http.routers.planka.rule=Host(`kanban.example.com`)"
      - "traefik.http.routers.planka.entrypoints=websecure"
      - "traefik.http.routers.planka.tls.certresolver=default"
      - "traefik.http.services.planka.loadbalancer.server.port=1337"
    depends_on:
      postgres:
        condition: service_healthy

  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    volumes:
      - db-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=planka
      - POSTGRES_USER=planka
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
    networks:
      - internal
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U planka -d planka"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  planka-data:
  db-data:

networks:
  proxy:
    external: true
  internal:

Empat keputusan dalam fail itu perlu dijelaskan, kerana ia adalah perkara yang sering diubah oleh pengguna dan kemudian dikesali.

  • Tiada blok ports: pada servis Planka. Traefik mencapai kontena merentasi rangkaian proxy, jadi port 1337 tidak pernah diterbitkan pada hos. Menerbitkannya akan memberi sesiapa sahaja jalan pintas untuk memintas proksi dan sijil anda.
  • loadbalancer.server.port=1337 menamakan port di dalam kontena. Planka mendengar pada 1337, dan contoh upstream hanya mencapainya pada 3000 kerana ia memetakan port tersebut ke hos. Tiada pemetaan hos di sini, jadi Traefik perlu diberitahu tentang port kontena tersebut.
  • condition: service_healthy berpasangan dengan pemeriksaan kesihatan Postgres. Tanpanya, Planka bermula sebelum pangkalan data menerima sambungan, gagal dalam pertanyaan pertamanya dan keluar, yang kelihatan seperti gelung ranap. Mekanismenya ada dalam pemeriksaan kesihatan dan urutan permulaan Compose.
  • Servis pangkalan data dinamakan postgres dengan sengaja. Planka 2 menghalakan permintaan keluar miliknya sendiri melalui penapis dalaman yang senarai sekat lalainya ialah localhost,postgres. Namakan semula servis tersebut dan anda secara senyap membuang pangkalan data anda daripada senarai itu.

Semak sama ada Compose boleh melihat rahsia anda sebelum anda memulakan apa-apa:

docker compose config | grep -E 'image:|BASE_URL|POSTGRES_USER'

Ini mencetak fail dengan nilai .env yang telah digantikan. Nilai kosong bermakna Compose tidak membaca fail .env, biasanya kerana anda menjalankan arahan daripada direktori yang berbeza.

Fungsi sebenar pemboleh ubah bootstrap pentadbir

Sejak Planka 1.13, tiada akaun pentadbir dicipta secara automatik untuk anda, jadi pangkalan data yang baharu tidak mempunyai sesiapa yang boleh log masuk. Kumpulan DEFAULT_ADMIN_* merupakan salah satu daripada dua cara untuk menyelesaikan masalah ini.

Semasa permulaan, Planka akan mencari pengguna yang sepadan dengan DEFAULT_ADMIN_EMAIL. Jika tiada, ia akan mencipta satu akaun menggunakan kata laluan, nama paparan dan nama pengguna yang ditetapkan bersamanya. Pada permulaan seterusnya, ia juga akan mengemas kini akaun yang sepadan berdasarkan pemboleh ubah ini, termasuk menetapkan semula kata laluannya apabila DEFAULT_ADMIN_PASSWORD masih ditetapkan.

DEFAULT_ADMIN_EMAIL melakukan tugas kedua yang sering memerangkap pengguna. Selagi pemboleh ubah tersebut ditetapkan, akaun yang dinamakan tidak boleh diubah nama, peranan atau alamat e-melnya, malah tidak boleh dipadamkan melalui antara muka. Ini adalah langkah kawalan kunci, dan itulah sebabnya anda tidak boleh menamakan semula akaun tersebut atau menukar alamat e-melnya dalam UI. Buang pemboleh ubah tersebut dan mulakan semula, maka akaun itu akan menjadi pentadbir biasa yang boleh anda sunting seperti akaun lain.

Baris kata laluan adalah bahagian yang perlu diberi perhatian. Segala maklumat di bawah environment: boleh dibaca oleh sesiapa sahaja yang boleh menjalankan docker inspect pada kontena, jadi DEFAULT_ADMIN_PASSWORD tidak sepatutnya dibiarkan di situ secara kekal. Log masuk, padam baris tersebut, jalankan docker compose up -d sekali lagi, kemudian tukar kata laluan anda dalam antara muka.

Cara yang lebih bersih adalah dengan melangkau pemboleh ubah tersebut sepenuhnya. Komen keseluruhan kumpulan DEFAULT_ADMIN_*, kemudian cipta akaun secara interaktif:

docker compose run --rm planka npm run db:create-admin-user

Ia akan meminta e-mel, kata laluan, nama paparan dan nama pengguna pilihan, kemudian menulis data pengguna terus ke dalam pangkalan data. Kata laluan tidak akan menyentuh fail Compose atau persekitaran yang dikonfigurasikan pada kontena. Gunakan cara ini jika lebih daripada seorang mempunyai akses shell ke VPS. Perintah ini memulakan Postgres terlebih dahulu disebabkan oleh depends_on, jadi ia berfungsi pada stack yang belum pernah dijalankan.

Kedua-dua cara ini menyebabkan anda perlu mengurus kata laluan Planka secara manual. Sehingga versi 2.1.1, edisi Community boleh menyerahkan log masuk kepada penyedia OIDC seperti Authentik yang berjalan sebagai pelayan daftar masuk tunggal (SSO) anda sendiri, tetapi versi 2.2.0, yang dikeluarkan pada Ogos 2026, telah memindahkan OIDC dan SSO ke dalam PLANKA Pro. Apa yang diperoleh oleh edisi Community dalam keluaran yang sama ialah pengesahan dua faktor (TOTP) untuk akaun tempatan, jadi aktifkan ciri ini sekurang-kurangnya untuk akaun pentadbir.

Mengapa BASE_URL menyebabkan kegagalan log masuk apabila ia tidak sepadan dengan hostname

BASE_URL ialah alamat tepat yang ditaip oleh pengguna ke dalam pelayar, berserta skema dan tanpa garis miring (trailing slash) di hujung. Bagi stack ini, ia adalah https://kanban.example.com. Planka membina pautannya sendiri dan senarai asal WebSocket yang dibenarkan daripada nilai tersebut. Ini bermakna BASE_URL yang salah tidak akan memberikan ralat yang jelas. Sebaliknya, anda akan mendapat halaman yang dimuatkan tetapi tidak pernah selesai dipaparkan.

Versi yang biasa berlaku: anda menyalin contoh upstream, membiarkan BASE_URL=http://localhost:3000 seperti asal, dan melayari tapak tersebut melalui HTTPS pada domain sebenar anda. Borang log masuk dihantar dan kelayakan anda diterima. Namun, papan (board) tidak pernah muncul. Buka konsol pembangun pelayar dan anda akan melihat permintaan ke /socket.io/ gagal, kerana soket bersambung ke asal (origin) halaman pelayar, tetapi sekatan asal pelayan membenarkan asal yang diperoleh daripada BASE_URL.

TRUST_PROXY=true ialah separuh lagi daripada masalah yang sama. Planka berada di belakang Traefik, jadi setiap permintaan sampai kepadanya daripada alamat proksi melalui HTTP biasa di dalam rangkaian Docker. Tanpa TRUST_PROXY, aplikasi mengabaikan pengepala X-Forwarded-Proto dan X-Forwarded-For yang ditetapkan oleh Traefik, jadi ia menganggap sambungan tersebut tidak selamat dan melayan setiap klien sebagai satu alamat IP yang dikongsi. Dengan menetapkannya, aplikasi membaca pengepala tersebut dan bersetuju dengan pelayar mengenai skema yang digunakan.

Traefik memproksi WebSocket tanpa konfigurasi tambahan, yang merupakan salah satu sebab untuk memilihnya di sini. Pada nginx, proksi perlu memajukan pengepala naik taraf (upgrade headers), proxy_set_header Upgrade $http_upgrade dan proxy_set_header Connection "upgrade", atau anda akan mendapat masalah spinner yang tersangkut daripada punca yang berbeza. Pengepala ini boleh diletakkan dalam blok location / umum; blok berasingan untuk /socket.io juga berfungsi tetapi tidak diperlukan.

Memindahkan papan ke hostname baharu kemudiannya bermakna menukar dua perkara serentak: nilai BASE_URL dan peraturan Host() Traefik. Jika anda menukar satu dan terlupa yang lain, anda akan kembali menghadapi masalah spinner. Menghoskan Planka daripada subpath seperti https://example.com/planka berfungsi bermula dari versi 2.1.0 ke atas, yang dikeluarkan pada Mac 2026. Bagi tag yang lebih lama, gunakan subdomain sendiri untuknya.

Lokasi Planka menyimpan lampiran dan avatar

Planka 2 menyimpan semua muat naik pengguna di bawah satu laluan di dalam kontena: /app/data. Lampiran, avatar pengguna dan imej latar belakang papan semuanya berada di bawah laluan tersebut. Versi 1 menggunakan tiga direktori berasingan, jadi fail Compose yang disalin daripada panduan lama akan melekapkan laluan yang tidak lagi wujud, dan lekap data yang sepatutnya tidak akan berlaku.

Lekapan tunggal itu adalah perbezaan antara papan yang kekal selepas naik taraf dengan masalah yang tidak dijangka. Imej Docker mengisytiharkan /app/data sebagai volum, jadi jika anda tidak menyertakan lekap tersebut dalam Compose, muat naik akan diletakkan dalam volum tanpa nama. Compose mengekalkannya semasa penciptaan semula up biasa, tetapi down yang diikuti dengan up kemudiannya tidak akan menyambungkannya semula secara automatik. Papan akan kelihatan seperti biasa, kad-kad masih ada, tetapi setiap pautan lampiran akan mati kerana baris pangkalan data masih merujuk kepada fail dalam volum lama.

Volum bernama dalam fail Compose di atas menghalang perkara ini. Lekapan ikat (bind mount) juga boleh digunakan dan memudahkan fail disandarkan dengan alatan biasa, tetapi ia memerlukan satu langkah tambahan. Proses Node di dalam kontena berjalan sebagai UID 1000, jadi direktori hos yang dimiliki oleh root akan menyebabkan ralat kebenaran pada muat naik pertama:

sudo chown -R 1000:1000 /opt/planka/data

Perbandingan antara kedua-duanya dibincangkan dalam lekapan ikat berbanding volum bernama.

Jika saiz lampiran melebihi ruang cakera dalam pelan anda, Planka boleh menulisnya ke storan yang serasi dengan S3 melalui S3_ENDPOINT, S3_BUCKET dan pemboleh ubah kunci yang sepadan. Ia boleh merujuk kepada bucket yang dihoskan atau storan objek MinIO yang dihoskan sendiri pada mesin lain. Tentukan perkara ini sebelum pasukan anda mengisi papan tersebut, kerana mendayakan S3 akan menukar bacaan dan penulisan fail ke backend tersebut tanpa memindahkan muat naik sedia ada.

Mulakan stack dan pastikan ia berfungsi

docker compose pull
docker compose up -d
docker compose ps

docker compose ps sepatutnya menunjukkan postgres sebagai healthy dan planka sebagai running. Jika Planka memulakan semula dalam gelung, sambungan pangkalan data adalah perkara pertama yang perlu diperiksa, bukan aplikasinya.

docker compose logs -f planka

But pertama yang sihat akan menjalankan migrasi pangkalan data, tetapi konfigurasi pengeluaran menetapkan noShip: true dan menyekat mesej permulaan yang melaporkan port 1337. Sahkan skema benar-benar telah dimuatkan dengan bertanya kepada Postgres secara terus dan bukannya mempercayai log:

docker compose exec postgres psql -U planka -d planka -c '\dt'

Senarai jadual yang merangkumi board dan card bermakna migrasi telah dijalankan. "Did not find any relations" bermakna Planka tidak pernah bersambung, jadi bandingkan DATABASE_URL dengan nilai POSTGRES_USER dan POSTGRES_PASSWORD dalam .env anda.

Kemudian periksa laluan daripada mesin anda sendiri, bukan daripada VPS:

curl -I https://kanban.example.com

HTTP/2 200 bermakna Traefik memegang sijil dan berjaya mencapai kontena. Ralat 404 yang diberikan oleh Traefik bermakna tiada penghala (router) yang sepadan dengan permintaan tersebut: peraturan Host() tidak sepadan dengan nama hos yang anda minta, atau Traefik tidak mengambil label tersebut. Ralat 502 bermakna penghala sepadan tetapi Traefik tidak dapat mencapai kontena, contohnya kerana ia tidak disambungkan ke rangkaian proxy. Sekarang buka laman web tersebut dan log masuk dengan akaun admin.

Lakukan pg_dump sebelum setiap peningkatan versi

Dua storan berasingan menyimpan papan anda, jadi sandaran perlu merangkumi kedua-duanya: pangkalan data Postgres dan volum planka-data. Lakukan dump pangkalan data semasa stack sedang berjalan.

docker compose exec -T postgres pg_dump -U planka -d planka > "planka-db-$(date +%F).sql"

-T melumpuhkan peruntukan pseudo-terminal lalai Compose, mengekalkan dump pada aliran output biasa.

Kemudian muat naik. Cari nama volum sebenar terlebih dahulu, kerana Compose meletakkan awalan nama direktori projek padanya.

docker volume ls | grep planka
docker run --rm -v planka_planka-data:/data -v "$PWD":/backup alpine \
  tar czf /backup/planka-files-$(date +%F).tgz -C /data .

Projek ini juga menyertakan docker-backup.sh dan docker-restore.sh dalam repositorinya, dan dokumentasi rasmi meletakkannya pada cron job harian. Mana-mana pendekatan adalah memadai. Apa yang tidak memadai ialah sandaran yang tidak pernah anda pulihkan, jadi pulihkan satu ke dalam VPS percubaan sekali dan sahkan anda boleh log masuk serta membuka lampiran. Pasangan storan yang sama muncul dalam setiap aplikasi Compose yang menerima muat naik, jadi jika anda kemudian meletakkan Chatwoot pada kotak yang sama dengan meja bantuan anda, rutin yang anda bina di sini boleh digunakan semula dengan hanya menukar nama volum.

Jalankan dump serta-merta sebelum setiap perubahan versi. Sandaran dari malam tadi tidak sama dengan sandaran dari sebelum migrasi yang bakal anda jalankan.

Tetapkan tag dan baca nota keluaran

Kedua-dua tag imej dalam fail tersebut ditetapkan secara sengaja.

ghcr.io/plankanban/planka:2.2.1 ialah keluaran khusus, terkini setakat Oktober 2026. Community 2.3.0 telah dikeluarkan pada 4 November 2026, dengan pembetulan keselamatan, dan pihak pembangun mengesyorkan untuk mengemas kini. Community 2.3.1 menyusul pada 5 November 2026, membetulkan ralat ranap semasa menyunting deskripsi kad pada papan yang mempunyai ahli tanpa nama pengguna. latest berubah apabila pihak pembangun menerbitkan versi baharu, jadi docker compose pull rutin boleh membawa migrasi skema pada masa yang tidak anda pilih. Baca nota keluaran sebelum anda menukar nombor tersebut, kerana di situlah perubahan besar dan pembetulan keselamatan diterangkan. Versi 2.0.3 diterbitkan sebagai keluaran keselamatan, yang merupakan jenis maklumat yang anda perlu baca dan bukannya diserap secara tidak sengaja. Begitu juga dengan 2.2.1, yang dikeluarkan pada Ogos 2026: ia membetulkan kelemahan traversal laluan yang membolehkan pengguna yang log masuk membaca fail sewenang-wenangnya pada instans yang menggunakan storan fail tempatan, iaitu persediaan dalam panduan ini, dan nasihat tersebut menyenaraikan 2.1.1 dan sebelumnya sebagai terjejas. Jika anda datang daripada 2.1.x, baca nota 2.2.0 dahulu, kerana keluaran tersebut menyahaktifkan pengguna yang hanya pernah log masuk melalui SSO sehingga admin memberikan mereka kata laluan dan mengaktifkan semula mereka. Penetapan tag adalah mudah di sini kerana pihak pembangun menerbitkan imej, dan di mana sesuatu projek tidak menyediakannya, anda perlu melakukan disiplin yang sama dengan langkah tambahan, seperti dengan openGym yang dibina pada kotak daripada tag git yang disemak.

postgres:16-alpine ditetapkan kepada versi utama atas sebab yang lebih kritikal. Postgres menulis direktori datanya dalam format yang terikat dengan versi utama, dan pelayan enggan membuka direktori yang ditulis oleh versi yang berbeza. Tulis postgres:latest, biarkan tag melepasi 16, dan kontena tidak akan bermula. Imej 17, sebagai contoh, berhenti dengan:

FATAL:  database files are incompatible with server
DETAIL:  The data directory was initialized by PostgreSQL version 16, which is not compatible with this version 17.

Tiada apa yang hilang, dan tiada apa yang dibetulkan dengan memulakan semula. Beralih ke versi utama Postgres yang baharu bermakna melakukan dump daripada versi lama dan restore ke dalam direktori data yang baharu pada versi yang baharu, menjalankan pg_upgrade, yang menukar data tanpa dump tetapi memerlukan binari pelayan lama dan baharu tersedia bersama, atau replikasi logikal ke pelayan yang menjalankan versi baharu diikuti dengan penukaran. Setiap laluan adalah migrasi yang dirancang, bukan kesan sampingan daripada tarikan imej; replikasi logikal membolehkan pelayan lama terus berjalan sementara pelayan baharu mengejar data.

Jika anda memindahkan pemasangan Planka 1.x sedia ada dan bukannya bermula dari awal, naik taraf tersebut mempunyai prosedur tersendiri yang didokumenkan dalam dokumentasi projek, dan tiada cara untuk kembali ke versi 1 tanpa sandaran yang diambil terlebih dahulu.

Mod kegagalan dan rentetan yang akan anda lihat

Planka dimulakan semula secara berulang dan log menamakan pangkalan data. Kredensial dalam DATABASE_URL tidak sepadan dengan persekitaran Postgres. Ambil perhatian bahawa POSTGRES_PASSWORD hanya digunakan apabila direktori data dimulakan buat kali pertama, jadi membetulkan pemboleh ubah selepas but pertama yang gagal tidak akan mengubah apa-apa. Tukar kata laluan peranan pangkalan data dengan ALTER ROLE supaya sepadan dengan kata laluan yang dikonfigurasikan; membuang volum db-data hanya menjadi pilihan untuk pemasangan sementara yang tidak mempunyai data untuk disimpan.

Log masuk berjaya tetapi papan tidak pernah dimuatkan. BASE_URL tidak sepadan dengan alamat dalam bar pelayar, jadi pelayan menolak asal soket tersebut. Konsol pelayar menunjukkan permintaan yang gagal ke /socket.io/.

Muat naik gagal sedangkan fungsi lain berjalan lancar. Bind mount dimiliki oleh root. Jalankan sudo chown -R 1000:1000 pada direktori hos dan mulakan semula kontena.

Lampiran hilang selepas naik taraf. /app/data tidak dilampirkan pada volum muat naik asal. Lampirkan semula volum tersebut atau pulihkan fail daripada sandaran, kemudian gunakan volum bernama sebelum anda menyentuh tag imej itu lagi.

Traefik mengembalikan 404. Tiada penghala yang sepadan dengan permintaan: peraturan Host() tidak sepadan dengan rekod DNS anda, atau label tidak sampai ke Traefik. docker compose config menunjukkan label selepas penggantian, di mana kesilapan taip akan kelihatan. Ralat 502 pula bermaksud laluan sepadan tetapi kontena tidak dapat dicapai, jadi pastikan ia berada pada rangkaian proxy.

Pemberitahuan atau webhook tidak pernah sampai. Planka 2 menghantar permintaan HTTP keluar melalui penapis dalaman, dan senarai blok lalai meliputi localhost dan postgres. Webhook yang ditujukan ke localhost disekat secara reka bentuk, dan sebaik sahaja anda menetapkan OUTGOING_ALLOWED_HOSTS, setiap hos yang tiada dalam senarai itu juga akan disekat. Halakan webhook ke nama servis kontena yang satu lagi, dan tambahkan nama tersebut ke OUTGOING_ALLOWED_HOSTS jika anda menggunakan senarai kebenaran, bukannya membuang penapis tersebut.

Apabila ia berjalan, beban operasi adalah kecil. Pantau nota keluaran, dan lakukan dump pangkalan data sebelum setiap naik taraf. But semula akan mengembalikan stack secara automatik kerana restart: unless-stopped, selagi servis Docker itu sendiri diaktifkan semasa but, dan Stack Compose yang kembali selepas but semula merangkumi kes di mana ia tidak berlaku.

FAQ

Mengapakah Planka terus memuat selepas saya log masuk?

Kredensial telah diterima tetapi sambungan langsung (live connection) tidak. Pelayar membuka soket ke asal halaman, manakala Planka memperoleh asal soket yang dibenarkan daripada BASE_URL. Oleh itu, membiarkan pemboleh ubah itu pada http://localhost:3000 semasa anda mencapai tapak pada https://kanban.example.com menyebabkan pelayan menolak sambungan tersebut. Konsol pembangun menunjukkan permintaan yang gagal ke /socket.io/. Tetapkan BASE_URL kepada alamat awam yang tepat tanpa garis miring di hujung, tambah TRUST_PROXY=true supaya aplikasi mematuhi pengepala X-Forwarded-Proto daripada reverse proxy anda, kemudian jalankan docker compose up -d.

Bagaimanakah cara saya mencipta pengguna pentadbir Planka yang pertama?

Sejak versi 1.13, tiada pentadbir dicipta secara automatik. Sama ada tetapkan DEFAULT_ADMIN_EMAIL dengan pemboleh ubah kata laluan, nama dan nama pengguna yang sepadan serta mulakan stack, atau jalankan docker compose run --rm planka npm run db:create-admin-user dan jawab gesaan yang diberikan. Perintah interaktif adalah lebih selamat pada pelayan kongsi, kerana kata laluan tidak pernah dimasukkan ke dalam persekitaran kontena yang dikonfigurasikan di mana docker inspect boleh membacanya. Mengekalkan DEFAULT_ADMIN_EMAIL ditetapkan selepas itu menghalang perubahan pada nama, peranan dan alamat e-mel akaun tersebut, serta menyekat pemadamannya daripada antara muka. Alihkan DEFAULT_ADMIN_PASSWORD selepas persediaan, kerana membiarkannya ditetapkan akan menetapkan semula kata laluan akaun yang sepadan semasa permulaan.

Di manakah Planka menyimpan lampiran dan avatar?

Semua fail yang dimuat naik berada di bawah /app/data di dalam kontena dalam Planka 2, termasuk lampiran, avatar pengguna dan latar belakang papan. Lekapkan laluan tersebut pada volum bernama. Tanpa lekap (mount) yang eksplisit, imej Docker menggunakan volum tanpa nama, yang mana docker compose up seterusnya tidak akan menyambung semula secara automatik selepas docker compose down. Bind mount juga berfungsi, tetapi proses Node berjalan sebagai UID 1000, jadi jalankan sudo chown -R 1000:1000 pada direktori hos atau muat naik akan gagal dengan ralat kebenaran.

Berapakah jumlah RAM yang diperlukan oleh Planka yang dihoskan sendiri?

FAQ teknikal projek mengesyorkan sekurang-kurangnya 2 GB RAM dan 10 GB storan untuk pasukan kecil. Penempatan Docker lalai menjalankan proses Node, pelayan Postgres dengan proses backend bagi setiap sambungan terbuka, dan proksi Squid dalaman untuk penapisan permintaan keluar. Jalankan docker stats --no-stream selepas seminggu penggunaan biasa dan tentukan saiz berdasarkan angka anda sendiri. Pantau cakera dengan lebih teliti berbanding memori, kerana lampiran adalah perkara yang akan terus berkembang.

Bagaimanakah cara saya menaik taraf Planka tanpa kehilangan data?

Buat dump pangkalan data dan arkibkan volum muat naik serta-merta sebelum naik taraf, bukan mengikut jadual malam tadi. Gunakan docker compose exec -T postgres pg_dump -U planka -d planka > planka-db.sql, dengan mengekalkan -T untuk melumpuhkan peruntukan pseudo-terminal bagi output yang dihalakan semula. Baca nota keluaran bagi setiap versi yang anda langkau, tukar tag imej kepada keluaran tertentu dan bukannya latest, kemudian jalankan docker compose pull dan docker compose up -d serta pantau log untuk migrasi tersebut. Kekalkan tag Postgres pada versi majornya, kerana pelayan enggan membuka direktori data yang ditulis oleh versi major yang berbeza.

Adakah artikel ini berguna?