SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Cara Self-host KiroCrew di VPS untuk Ejen Sentiasa Aktif

Jalankan KiroCrew sebagai bekas Docker yang sentiasa aktif pada VPS anda. Panduan ini merangkumi konfigurasi systemd, akses SSH, sandaran data dan langkah pemulihan sistem.

Mengapa hos sendiri KiroCrew pada VPS berbanding komputer riba

Hos sendiri KiroCrew hanya berbaloi pada mesin yang tidak pernah tidur, jadi VPS adalah tempat yang sesuai untuknya dan bukannya komputer riba. KiroCrew menyimpan sejarah sesi, memori semantik, tugasan berjadual dan baris gilir kelulusan pada cakera, dan ia memuatkan semula semua itu apabila proses dimulakan semula. Tiada gunanya jika proses tersebut tidak berjalan pada jam 03:00 apabila tugasan berjadual perlu dilaksanakan, dan komputer riba yang ditutup tidak akan menjalankannya.

KiroCrew ialah ruang kerja ejen sumber terbuka daripada pasukan Kiro, dilesenkan di bawah Apache 2.0, dengan 0.1.0 dikeluarkan pada 22 Julai 2026. Satu proses, yang dipanggil gateway, memiliki status tersebut dan menyediakan papan pemuka web pada port 5476. Anda mencapai gateway tersebut daripada papan pemuka, daripada CLI kirocrew, atau daripada saluran sembang seperti Slack. Gateway ialah satu-satunya perkara yang anda hos sendiri, jadi panduan ini adalah tentang cara memastikan ia terus berjalan, menjauhkannya daripada internet awam, dan keupayaan untuk memulihkannya selepas naik taraf yang gagal.

Dua perkara untuk diketahui sebelum anda bermula. Sejak 0.11.0, pemasangan baharu KiroCrew tanpa pilihan harness yang disimpan akan menggunakan KAS secara lalai tanpa memerlukan kiro-cli; pilihan CLI Kiro sedia ada yang dinyatakan secara eksplisit akan dikekalkan. Inferens pada backend Kiro menggunakan pelan Kiro anda, jadi setakat 1 November 2026 persediaan lalai ini tidak beroperasi di luar talian. Projek ini juga masih baharu dan berkembang pesat: keluaran stabilnya berubah daripada 0.1.3 pada 5 Ogos 2026 kepada 0.10.0 pada 25 Oktober 2026, dengan 0.8.0 pada 9 Oktober dan 0.9.0 pada 16 Oktober di antaranya, dan calon keluaran 0.11.0 sudah pun dikeluarkan sebagai pra-keluaran pada 25 Oktober. Andaikan anda perlu membuat rollback pada satu ketika nanti, dan pasanglah ia dengan cara yang membolehkan anda berbuat demikian. Jika anda belum pernah menjalankan ejen pada pelayan sebelum ini, menjalankan ejen pengekodan pada VPS merangkumi peraturan asas yang menjadi asas panduan ini. Jika bahagian ejen lebih baharu kepada anda berbanding bahagian pelayan, mempelajari perkara sebenar tentang gelung ejen, alatan dan memorinya terlebih dahulu akan menjadikan pilihan di bawah dibaca sebagai keputusan yang difahami dan bukannya arahan yang tidak jelas.

Keperluan KiroCrew dan lokasi penyimpanan datanya

Pemasangan natif memerlukan Python 3.12 atau lebih baharu, serta Node.js 22.12.0 atau lebih baharu jika anda membina papan pemuka daripada sumber (projek ini mengesyorkan Node 24 LTS). Bahagian belakang Kiro CLI memerlukan kiro-cli, yang disahkan dengan kiro-cli login atau kunci API untuk kegunaan automatik; sejak 0.10.0, enjin KAS terbina dalam berjalan tanpa kiro-cli dipasang, dan 0.11.0 menjadikannya tetapan lalai untuk pemasangan baharu yang tidak mempunyai pilihan harness yang disimpan. Pemasangan kontena tidak memerlukan semua itu pada hos. Ia hanya memerlukan Docker. Itulah sebab utama untuk memilih kaedah ini.

Data disimpan dalam ~/.kiro/crew, dan pemboleh ubah persekitaran KIROCREW_HOME boleh memindahkannya ke lokasi lain. Kandungan di dalamnya:

  • config.json: tetapan gateway dan kelayakan saluran sembang.
  • .env: rahsia (secrets).
  • workspace/memory/: keutamaan, nota projek dan sejarah sembang.
  • memory.db dan memory_index.db: indeks semantik dan indeks teks penuh.
  • models/: model embedding, yang dimuat turun pada pelaksanaan pertama.
  • security_events.jsonl: log peristiwa keselamatan.

Direktori tersebut adalah pemasangan itu sendiri. Salin direktori itu ke VPS baharu dan anda telah memindahkan ejen anda; itulah sebabnya bahagian sandaran di bawah lebih penting daripada bahagian pemasangan.

Rancang untuk ruang cakera dan bukannya RAM. Gateway ialah proses Python; perkara yang sebenarnya membebankan pelayan ialah apa sahaja yang dijalankan oleh ejen, seperti binaan atau suite ujian. Direktori data akan berkembang mengikut sejarah sembang, dan model embedding akan dimuat turun pada permulaan pertama, jadi ukur saiznya pada pelayan anda sendiri dengan du -sh ~/.kiro/crew selepas beberapa minggu dan bukannya mempercayai sebarang angka yang diterbitkan pada bulan-bulan awal projek. Bandingkan perkara ini dengan runtime yang memberikan setiap pekerja kontena dan pelayar sendiri, di mana self-hosting OpenBot's AI coworkers menjadikan penentuan saiz sebagai isu RAM sebelum ia menjadi isu cakera.

Laluan pemasangan mana yang patut anda gunakan

Projek ini menerbitkan empat laluan: aplikasi desktop, wheel satu baris, sumber dan Docker. Pemasang satu baris mengambil wheel dan mencipta pelancar kirocrew; jika direktorinya tiada dalam PATH anda, ia akan mencetak arahan untuk menambahnya:

curl -fsSL https://download.crew.kiro.dev/cli.sh | sh

Ia menerima flag saluran dan flag versi:

curl -fsSL https://download.crew.kiro.dev/cli.sh | sh -s -- --channel insider
curl -fsSL https://download.crew.kiro.dev/cli.sh | sh -s -- --version 0.8.0

Imej kontena diterbitkan di ghcr.io/kirodotdev/kirocrew, untuk linux/amd64 dan linux/arm64 di bawah setiap tag. Binaan sumber ialah git clone ditambah make build, dan ia ditujukan untuk mereka yang mengubah kod, bukan untuk mereka yang menjalankannya.

Gunakan kontena. Pemasangan sumber asli meletakkan pakej Python dan Node pada hos yang sama yang menjalankan servis anda yang lain, ditambah kiro-cli apabila menggunakan backend CLI Kiro, jadi naik taraf yang gagal akan menyebabkan anda terpaksa membaikinya secara manual. Kontena menyimpan runtime dalam satu imej dan keadaan dalam satu volum, yang menjadikan rollback hanya sebagai pertukaran tag dan but semula.

Pin imej kepada tag keluaran, bukan kepada stable

Contoh projek itu sendiri menggunakan tag stable:

docker run -d --name kirocrew \
  -p 127.0.0.1:5476:5476 \
  -v kirocrew-home:/home/kirocrew \
  ghcr.io/kirodotdev/kirocrew:stable

stable ialah tag yang berubah-ubah, begitu juga latest, yang menghala kepada keluaran yang sama. Ia menghala kepada apa sahaja keluaran stabil terkini, jadi tarikan (pull) seterusnya boleh menukar versi yang anda jalankan tanpa pilihan anda, dan tag tersebut tidak merekodkan versi yang digunakan. Tag versi adalah tidak boleh ubah (immutable), jadi tetapkan satu versi. Keluaran stabil terkini setakat 1 November 2026 ialah 0.11.1, yang diterbitkan pada 31 Oktober 2026, iaitu tampalan panas (hot patch) untuk integriti memori dan pembaikan KAS dalam 0.11.0. Contoh 0.8.0 di bawah menggunakan Kiro CLI. Terdapat juga tag insider dan nightly; nightly mengikuti binaan daripada main.

Tulis /opt/kirocrew/compose.yaml:

services:
  kirocrew:
    image: ghcr.io/kirodotdev/kirocrew:0.8.0
    container_name: kirocrew
    restart: unless-stopped
    ports:
      - "127.0.0.1:5476:5476"
    volumes:
      - kirocrew-home:/home/kirocrew

volumes:
  kirocrew-home:

Mulakan ia, kemudian semak titik akhir kesihatan (health endpoint) yang turut digunakan oleh imej tersebut untuk HEALTHCHECK miliknya:

cd /opt/kirocrew
docker compose up -d
docker compose ps
curl -s http://127.0.0.1:5476/api/health

docker compose ps sepatutnya melaporkan kontena sebagai sihat dalam masa seminit atau lebih, dan /api/health menjawab tanpa token (begitu juga /api/live dan /api/ready, yang menjadikannya boleh digunakan sebagai probe). Jika status kekal pada starting, baca docker logs kirocrew sebelum menukar apa-apa. Jalankan kali pertama akan memuat turun model embedding di latar belakang; carian memori menggunakan padanan kata kunci sehingga model tersebut tiba.

Memastikan ia terus berjalan dengan systemd

restart: unless-stopped akan menghidupkan semula container selepas berlaku kerosakan (crash) dan selepas but semula, selagi Docker sendiri bermula semasa but. Fail unit menjadikan dependency tersebut jelas dan memberikan anda satu arahan untuk menghentikan keseluruhan stack sebelum membuat sandaran. Memulakan stack Docker Compose semasa but merangkumi corak umum ini. Ini adalah bentuk KiroCrew untuknya, dalam /etc/systemd/system/kirocrew.service:

[Unit]
Description=KiroCrew gateway
Requires=docker.service
After=docker.service

[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/opt/kirocrew
ExecStart=/usr/bin/docker compose up -d
ExecStop=/usr/bin/docker compose down
TimeoutStartSec=0

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now kirocrew
systemctl status kirocrew

systemctl status kirocrew sepatutnya membaca active (exited), yang merupakan hasil sihat untuk unit ini. Type=oneshot dengan RemainAfterExit=yes adalah tepat di sini kerana docker compose up -d kembali sebaik sahaja container dimulakan: systemd menjejaki fakta bahawa stack tersebut sedang berjalan, bukan proses latar depan. Tulis Type=simple sebaliknya dan systemd melihat arahan tersebut tamat serta-merta, menandakan servis sebagai mati, dan kemudian sama ada berputus asa atau melakukan gelung mulakan semula (restart-loop) bergantung pada tetapan Restart= anda. Untuk pemasangan natif, projek ini membekalkan setaranya sendiri, kirocrew service install, yang menulis /etc/systemd/system/kirocrew.service dan menjalankan gateway sebagai pengguna anda. Jangan jalankan kedua-dua unit tersebut. Versi yang lebih luas mengenai topik ini terdapat dalam servis dan pemasa systemd pada VPS. Unit yang gagal untuk kembali berjalan akan senyap melainkan anda memintanya untuk memberi maklum balas, jadi tambahkan pengendali OnFailure= yang menghantar makluman ke pelayan ntfy anda sendiri dan anda akan mendapat tahu bahawa gateway tidak berfungsi melalui telefon anda dan bukannya daripada kerja berjadual yang tidak pernah dijalankan.

Jalankan kali pertama: daftar masuk dan dapatkan token papan pemuka

Kontena memulakan get laluan, namun runtime Kiro CLI lalai dalam imej 0.8.0 yang dipinkan masih memerlukan pengesahan. Daftar masuk di dalam kontena, atau hantar KIRO_API_KEY melalui persekitaran kontena untuk kegunaan automatik:

docker exec -it kirocrew kiro-cli login

Perintah tersebut akan mencetak kod peranti dan URL yang perlu anda buka dalam pelayar web anda sendiri. Kemudian, jana token papan pemuka:

docker exec kirocrew kirocrew token --ttl 2h

URL papan pemuka ialah http://localhost:5476/?token=<the token>. Token mempunyai tempoh tamat: pautan yang dicetak perlu dibuka dalam masa lima minit selepas dijana, dan perintah ini meminta kuki akses selama dua jam, dengan dua puluh jam sebagai tempoh maksimum yang didokumenkan. Pelayar juga menerima kuki penyegaran dengan tetingkap melahu bergerak selama 30 hari, jadi sesi yang aktif akan diperbaharui tanpa memerlukan pautan lain. Papan pemuka yang dimuatkan kosong atau terus mengeluarkan anda biasanya disebabkan oleh token yang telah tamat tempoh, jadi jana token baharu dan buka dengan segera. Jangan sekali-kali menampal token ke dalam tiket atau mesej sembang, kerana sesiapa yang memegangnya akan memegang ejen anda.

Capai papan pemuka melalui SSH, dan jangan sekali-kali menerbitkan port 5476

Lihat semula alamat bind dalam contoh projek: -p 127.0.0.1:5476:5476. Di dalam kontena, gateway mendengar pada 0.0.0.0, kerana ia perlu dicapai melalui pemetaan port, tetapi pemetaan itu sendiri hanya diterbitkan ke loopback pada hos. Padamkan awalan 127.0.0.1: dan gateway tersebut akan berada di internet awam untuk sesiapa sahaja yang mengimbas port itu. Peraturan ufw juga tidak akan menyelamatkan anda: Docker menerbitkan port dengan menulis peraturan DNAT yang menghalakan trafik sebelum peraturan ufw digunakan, jadi ufw deny 5476 tidak memberi kesan kepada port yang diterbitkan. Dengan backend iptables lalai Docker, jawapan Docker sendiri adalah dengan meletakkan peraturan penapisan dalam rantaian DOCKER-USER miliknya. Itu berfungsi, tetapi peraturan tersebut melihat alamat dan port dalaman kontena melainkan anda memadankannya dengan sambungan conntrack, jadi bind loopback kekal sebagai kawalan yang lebih mudah dan sukar untuk disalahgunakan. Backend nftables Docker sebaliknya menggunakan jadual nftables dan rantaian asas yang berasingan untuk penapisan tersuai. Port Docker memintas ufw membincangkan mekanisme tersebut.

Majukan port melalui SSH dari komputer riba anda sebaliknya:

ssh -N -L 5476:127.0.0.1:5476 you@your-server.example.com

Biarkan ia berjalan dan buka http://localhost:5476/?token=<the token> secara setempat. Untuk menjadikan pemajuan automatik pada setiap sambungan, letakkannya dalam ~/.ssh/config:

Host your-server.example.com
    LocalForward 5476 127.0.0.1:5476

Jika port 5476 sudah digunakan pada komputer riba anda, tukar nombor sebelah kiri sahaja: ssh -N -L 45476:127.0.0.1:5476 you@your-server.example.com, kemudian layari ke http://localhost:45476/?token=.... Tiada tetapan port loopback tambahan atau penciptaan semula kontena diperlukan: Origin loopback sepadan dengan Host permintaan itu sendiri, jadi semakan CSRF menerimanya. Anda akan menyusun pemajuan seperti ini sebaik sahaja ejen kedua berkongsi kotak yang sama, kerana self-hosting open-kritt untuk pengimbasan keselamatan meletakkan satu lagi papan pemuka loopback-sahaja pada pelayan yang sama, pada port 5173.

Dua tingkah laku yang didokumenkan menentukan tetapan yang boleh anda ubah daripada papan pemuka. Pertama, gateway menganggap sebarang permintaan yang membawa pengepala pemajuan (Forwarded, X-Forwarded-* atau X-Real-IP) sebagai jauh, dan titik akhir tulis-konfigurasi serta pendedahan-rahsia miliknya menolak permintaan tersebut. Reverse proxy menambah pengepala tersebut; pemajuan ssh -L biasa tidak menambah apa-apa, jadi ia kelihatan setempat dan tidak ditolak atas alasan itu. Kedua, dalam imej kontena, halaman kelayakan-saluran dan paparan pendedahan-rahsia adalah baca-sahaja untuk mana-mana pelayar yang bukan direct-local, dan imej tersebut tidak menyertakan penyunting teks. Kelayakan saluran yang tidak dapat disimpan daripada papan pemuka adalah disebabkan perkara ini, bukan pepijat. Edit konfigurasi pada hos sebaliknya:

docker cp kirocrew:/home/kirocrew/.kiro/crew/config.json .
# edit config.json here
docker cp config.json kirocrew:/home/kirocrew/.kiro/crew/config.json
docker exec -u 0 kirocrew chown kirocrew:kirocrew /home/kirocrew/.kiro/crew/config.json
docker restart kirocrew

Untuk akses telefon, projek ini merujuk kepada tailscale serve daripada Tailscale, yang mengekalkan papan pemuka di dalam tailnet anda sendiri dan bukannya pada nama hos awam. Utamakan kaedah itu berbanding reverse proxy awam. Token tersebut bergerak dalam URL, dan URL ditulis ke dalam setiap log akses pada laluannya. Peraturan itu adalah mengenai apa yang berada di sebalik port dan bukannya port itu sendiri: sesuatu seperti Halcyon, yang membina semula pustaka Jellyfin sebagai kedai video 90-an yang boleh dilayari wujud untuk orang lain buka dan merupakan calon yang sesuai untuk reverse proxy, manakala gateway yang boleh menjalankan arahan pada pelayan anda adalah sebaliknya.

Berikan ejen radius letupan terkecil yang mungkin

Kontena akan menyemak sokongan sandbox semasa permulaan pertama, dan hasilnya menentukan sama ada ejen boleh melaksanakan sebarang arahan. Jika pengasingan namespace tersedia, subproses ejen akan berjalan dalam keadaan terasing. Jika ia tidak tersedia dan KIROCREW_ALLOW_UNSANDBOXED=1 tidak ditetapkan, pelaksanaan akan ditolak daripada berjalan tanpa sekatan. Oleh itu, gateway yang kelihatan sihat tetapi semua tugas terhenti biasanya berpunca daripada perkara ini. Keputusan tersebut disimpan dalam docker logs kirocrew daripada larian pertama itu. Projek ini juga menerbitkan profil seccomp (secure computing mode) yang boleh anda gunakan:

curl -fsSL https://raw.githubusercontent.com/kirodotdev/KiroCrew/main/docker/seccomp/kirocrew-seccomp.json \
  -o /opt/kirocrew/kirocrew-seccomp.json
    security_opt:
      - seccomp:./kirocrew-seccomp.json

Pada hos yang mempunyai AppArmor diaktifkan, panduan Docker projek tersebut menyatakan bahawa profil seccomp hanyalah separuh daripada perubahan, kerana Docker juga melampirkan profil AppArmor docker-default miliknya, dan ia menggandingkan profil tersebut dengan apparmor=unconfined. Pilihan itu hanya melonggarkan peraturan AppArmor bagi setiap kontena; profil seccomp, keupayaan yang digugurkan (dropped capabilities) dan pengguna bukan root masih terpakai.

Jika anda menetapkan KIROCREW_ALLOW_UNSANDBOXED=1, fahami dengan jelas perkara yang berubah: kontena kini menjadi satu-satunya sempadan antara ejen dan pelayan anda. Amaran projek ini perlu diulangi sepenuhnya. Jangan lekapkan (mount) laluan hos yang anda tidak akan berikan terus kepada ejen. Secara praktikalnya, ini bermakna jangan gunakan Docker socket, sebarang bind mount bagi /, dan sebarang direktori yang menyimpan data servis lain.

Selebihnya ialah kerangka yang terpakai kepada setiap ejen yang dibenarkan menjalankan arahan. Hadkan kelayakan (credentials) ejen kepada satu repositori atau satu bucket yang diperlukan sahaja, jangan gunakan token peribadi dengan hak akses seluruh akaun. Jalankan ejen sebagai pengguna khusus yang direktori home-nya tidak menyimpan apa-apa perkara lain, iaitu tujuan bagi pengguna dengan keistimewaan minimum pada VPS. Apabila ejen menulis kod dan kemudian menjalankan kod tersebut, berikan ia mesin yang boleh ia rosakkan: VM pakai buang untuk ejen pengekodan merupakan sempadan yang lebih kukuh daripada mana-mana flag dalam fail compose ini, kerana anda memadamkan mesin tersebut dan bukannya membersihkannya. Penaakulan yang sama membentuk menjalankan OpenClaw dengan selamat pada VPS dan self-hosting ejen Hermes pada VPS. Alatan juga dikira sebagai radius letupan: memberikan ejen keupayaan carian web menjadikan setiap halaman yang diambilnya sebagai input yang tidak dipercayai, jadi menghalakannya ke instans SearXNG anda sendiri merupakan keputusan berkaitan suntikan prompt (prompt injection) sama seperti keputusan teknikal. Kerja berjadual juga akan menggunakan kos semasa anda tidur, memandangkan inferens pada backend Kiro menggunakan pelan Kiro anda, jadi tetapkan had yang diterangkan dalam mengawal kos ejen AI pada VPS sebelum anda menambah tugasan malam.

Sandarkan volum keadaan sebelum setiap naik taraf

Cari nama volum sebenar terlebih dahulu. Compose memberikan awalan kepada volum bernama dengan nama projek, yang secara lalai menggunakan nama direktori, jadi volum yang diisytiharkan sebagai kirocrew-home dalam /opt/kirocrew/compose.yaml dicipta sebagai kirocrew_kirocrew-home:

docker volume ls

Hentikan gateway sebelum menyalin apa-apa. memory.db dan memory_index.db merupakan pangkalan data SQLite, dan menyalin pangkalan data semasa ia sedang ditulis boleh menangkap transaksi yang separuh siap, yang akan dipulihkan sebagai fail rosak. Arahan migrasi projek itu sendiri menyatakan perkara yang sama: pindahkan memori hanya semasa gateway dihentikan. Peraturan berhenti-dahulu itu tidak khusus untuk KiroCrew, dan jika pelayan foto berkongsi kotak yang sama, perbandingan PhotoPrism dan Immich memberikan arahan sandaran tepat yang diperlukan oleh kedua-duanya.

sudo systemctl stop kirocrew
docker run --rm -v kirocrew_kirocrew-home:/data:ro -v "$PWD":/backup \
  alpine tar czf /backup/kirocrew-2026-08-06.tgz -C /data .
sudo systemctl start kirocrew

Salin arkib keluar dari kotak tersebut. Pemulihan menggunakan arahan yang sama dengan bekas dihentikan dan tar xzf menggantikan tar czf:

sudo systemctl stop kirocrew
docker run --rm -v kirocrew_kirocrew-home:/data -v "$PWD":/backup \
  alpine tar xzf /backup/kirocrew-2026-08-06.tgz -C /data
sudo systemctl start kirocrew

Berpindah ke hos baharu adalah tugas yang berbeza daripada pemulihan di tempat asal, dan projek tersebut memberikan perincian khusus mengenainya. Sejarah sembang dan nota projek di bawah workspace/memory/ akan dibawa bersama, begitu juga dengan dua fail pangkalan data dan config.json. Fail PID, log peristiwa keselamatan dan .env terikat dengan hos lama, jadi tinggalkan fail tersebut dan masukkan semula rahsia (secrets) pada kotak baharu.

Bagaimana untuk membatalkan naik taraf yang bermasalah

Proses naik taraf adalah singkat, dan ia hanya selamat kerana anda telah menetapkan versi (pin). Lakukan sandaran (backup) terlebih dahulu, kemudian tukar tag:

sudo systemctl stop kirocrew
# take the backup here, as above
sudo nano /opt/kirocrew/compose.yaml   # set the new image tag
sudo systemctl start kirocrew
docker compose -f /opt/kirocrew/compose.yaml ps
curl -s http://127.0.0.1:5476/api/health

docker compose up -d akan menarik imej tersebut jika ia belum ada pada pelayan, jadi penyuntingan tag adalah keseluruhan proses naik taraf. Pembatalan naik taraf (rollback) menggunakan urutan yang sama dengan nombor versi lama, dan ia memberikan anda imej yang tepat seperti yang anda miliki sebelum ini, kerana tag versi adalah tidak boleh diubah (immutable).

Binari tersebut akan kembali kepada versi asal dengan sempurna. Keadaan (state) adalah bahagian yang mungkin tidak. Gateway yang lebih baharu boleh menulis semula config.json atau memindahkan pangkalan data memori ke dalam bentuk yang tidak boleh dibaca oleh gateway yang lebih lama, dan tiada laluan turun taraf (downgrade) untuk keadaan (state) yang didokumentasikan setakat 12 Oktober 2026. Panduan pemasangan menyatakan dengan jelas tentang satu kes: data yang dialihkan keluar daripada direktori ~/.kirocrew lama tidak mempunyai laluan pembatalan, dan keluaran (release) yang lebih awal daripada ~/.kiro/crew akan bermula dalam keadaan kosong. Jadi, jika imej lama bermula dan kemudian berkelakuan ganjil, jangan nyahpepijat (debug) ia. Hentikan servis tersebut, pulihkan sandaran yang anda ambil sebelum naik taraf, dan mulakan semula. Itulah sebab utama mengapa sandaran perlu dilakukan terlebih dahulu, dan itulah sebabnya tabiat menaik taraf sekarang dan membuat sandaran kemudian akan gagal pada projek yang masih baharu ini.

Perkara yang belum terbukti di sini

Bersikap jujurlah mengenai usia perisian ini. Versi 0.1.3 dikeluarkan pada 5 Ogos 2026, dan menjelang 12 Oktober 2026 barisan stabil telah mencapai 0.8.0. Kebanyakan nota keluaran masih berupa log perubahan automatik; nota 0.8.0 ditulis secara manual tetapi tidak mengandungi bahagian migrasi, dan sejarah keluaran awam hanya menjangkau kira-kira tiga bulan. Tiada apa-apa dalam panduan ini merupakan hasil jangka panjang, jadi anggaplah pertumbuhan memori, saiz pangkalan data dan kebolehpercayaan penjadual sebagai perkara yang perlu diukur pada pelayan anda sendiri, bukannya sesuatu yang boleh diandaikan.

Dua kelakuan wajar diuji sendiri sebelum anda bergantung kepadanya. Pertama, sama ada proses turun taraf (downgrade) boleh membaca keadaan yang ditulis oleh versi yang lebih baharu: cubalah pada salinan volum semasa ia tidak mendatangkan masalah, bukan semasa gangguan perkhidmatan. Kedua, apakah tindakan gateway apabila log masuk Kiro tamat tempoh sementara tugasan berjadual perlu dijalankan. Kedua-duanya merupakan jenis kekasaran yang biasanya diperhalusi secara senyap oleh projek baharu antara keluaran, dan kedua-duanya mudah untuk diperiksa sekarang.

FAQ

Mengapa papan pemuka KiroCrew tidak terbuka pada IP awam pelayan saya?

Kerana contoh yang diterbitkan mengikat port tersebut kepada loopback. -p 127.0.0.1:5476:5476 memetakan port kontena kepada alamat loopback hos sahaja, dan ini dilakukan dengan sengaja. Capai papan pemuka tersebut dengan memajukan port melalui SSH menggunakan ssh -N -L 5476:127.0.0.1:5476 you@your-server, kemudian buka http://localhost:5476/?token=<token> pada komputer riba anda. Membuang awalan 127.0.0.1: untuk menjadikannya boleh dicapai akan meletakkan gateway pada internet awam, dan ufw tidak akan mengawalnya, kerana peraturan DNAT port yang diterbitkan oleh Docker menghalakan trafik sebelum peraturan ufw digunakan. Gunakan chain DOCKER-USER Docker dengan backend iptables-nya, atau asingkan base chain nftables dengan backend nftables-nya, untuk menapis port yang diterbitkan; mengekalkan ikatan loopback adalah lebih mudah.

Di manakah KiroCrew menyimpan datanya, dan apakah yang perlu saya sandarkan?

Segala-galanya terletak di bawah ~/.kiro/crew, iaitu /home/kirocrew/.kiro/crew di dalam imej kontena, dan KIROCREW_HOME memindahkannya ke lokasi lain. Sandarkan keseluruhan direktori, atau keseluruhan Docker volume, semasa gateway dihentikan. memory.db dan memory_index.db merupakan pangkalan data SQLite, jadi salinan yang diambil semasa gateway sedang menulis boleh menjadi tidak konsisten. Apabila berpindah ke hos baharu, workspace/memory/, kedua-dua fail pangkalan data dan config.json perlu dipindahkan, manakala fail PID, log peristiwa keselamatan dan .env adalah milik hos lama.

Patutkah saya menggunakan tag stable atau tag versi?

Gunakan tag versi. stable berubah setiap kali keluaran baharu dilancarkan, jadi versi yang anda jalankan boleh berubah tanpa pengetahuan anda pada pull seterusnya, dan tag itu sendiri tidak memberikan maklumat tentang apa yang sedang dijalankan. Tag versi seperti 0.8.0 adalah tidak boleh diubah, dan itulah yang membolehkan rollback berfungsi: anda meletakkan nombor lama kembali dan mendapatkan imej yang sama. Setakat 1 November 2026, keluaran stabil terkini ialah 0.11.1.

Mengapa ejen saya enggan menjalankan sebarang arahan?

Kontena tersebut memeriksa sokongan sandbox pada permulaan pertamanya. Jika ia tidak dapat mengasingkan subproses ejen dan KIROCREW_ALLOW_UNSANDBOXED=1 tidak ditetapkan, ia enggan melaksanakannya daripada menjalankannya tanpa sekatan, jadi gateway kelihatan sihat walaupun setiap tugasan terhenti. docker logs kirocrew menunjukkan keputusan sandbox daripada larian pertama itu. Menetapkan pemboleh ubah tersebut menjadikan kontena sebagai satu-satunya sempadan antara ejen dan hos, jadi jika anda menetapkannya, jangan lekapkan apa-apa yang anda tidak mahu berikan kepada ejen secara terus.

Adakah saya memerlukan akaun Kiro untuk melakukan self-host KiroCrew?

Untuk backend Kiro, ya, setakat 1 November 2026. KiroCrew ialah perisian percuma di bawah Apache 2.0, tetapi inferens pada backend tersebut menggunakan pelan Kiro anda. Kontena 0.8.0 yang dipinkan menggunakan Kiro CLI: jalankan docker exec -it kirocrew kiro-cli login dan luluskan kod peranti dalam pelayar anda, atau hantarkan KIRO_API_KEY melalui persekitaran kontena untuk kegunaan automatik. Sehingga pengesahan dikonfigurasikan, gateway itu bermula dan papan pemuka dimuatkan, tetapi harness lalainya tidak mempunyai model untuk dihubungi. Sejak 0.10.0, terdapat juga enjin KAS terbina dalam yang tidak memerlukan kiro-cli dipasang; 0.11.0 menjadikan KAS sebagai lalai untuk pemasangan baharu tanpa pilihan harness yang disimpan, sambil mengekalkan pilihan Kiro CLI yang eksplisit. KAS menggunakan log masuk Crew sendiri dan bukannya kiro-cli login. Panduan backend tersuai projek tersebut membolehkan harness claude menghantar pusingan model utama ke endpoint serasi Anthropic yang anda pilih, tetapi log masuk kiro-cli masih kekal untuk ciri khusus Kiro.

Adakah artikel ini berguna?