วิธีติดตั้ง KiroCrew บน VPS ให้รันต่อเนื่องตลอด 24 ชั่วโมง
เรียนรู้วิธีติดตั้ง KiroCrew บน VPS ด้วย Docker และ systemd เพื่อให้เอเจนต์ทำงานได้ตลอดเวลา พร้อมวิธีจัดการหน่วยความจำ การสำรองข้อมูล และการย้อนกลับเวอร์ชันเมื่อเกิดข้อผิดพลาด
เหตุผลที่ควรโฮสต์ KiroCrew บน VPS แทนแล็ปท็อป
การโฮสต์ KiroCrew ด้วยตนเองจะคุ้มค่าก็ต่อเมื่อรันบนเครื่องที่เปิดตลอดเวลา ดังนั้น VPS จึงเป็นสภาพแวดล้อมที่เหมาะสมมากกว่าแล็ปท็อป KiroCrew จะจัดเก็บประวัติเซสชัน, หน่วยความจำเชิงความหมาย (semantic memory), งานที่ตั้งเวลาไว้ และคิวการอนุมัติลงบนดิสก์ และจะโหลดข้อมูลเหล่านี้ใหม่ทุกครั้งที่กระบวนการทำงานเริ่มต้นขึ้น ข้อมูลเหล่านี้จะไม่มีประโยชน์หากกระบวนการไม่ได้ทำงานในช่วงเวลา 03:00 น. ซึ่งเป็นเวลาที่งานที่ตั้งเวลาไว้ต้องทำงาน และแล็ปท็อปที่ปิดฝาอยู่จะไม่สามารถรันกระบวนการดังกล่าวได้
KiroCrew เป็นพื้นที่ทำงานสำหรับเอเจนต์แบบโอเพนซอร์สจากทีม Kiro ภายใต้สัญญาอนุญาต Apache 2.0 โดยมี 0.1.0 เผยแพร่เมื่อวันที่ 22 กรกฎาคม 2026 กระบวนการเดียวที่เรียกว่า gateway จะเป็นผู้ดูแลสถานะและให้บริการเว็บแดชบอร์ดผ่านพอร์ต 5476 คุณสามารถเข้าถึง gateway นี้ได้จากแดชบอร์ด, จาก CLI ของ kirocrew หรือจากช่องทางแชท เช่น Slack สิ่งที่คุณต้องโฮสต์ด้วยตนเองมีเพียงแค่ gateway เท่านั้น ดังนั้นคู่มือนี้จึงเน้นไปที่การทำให้บริการทำงานได้อย่างต่อเนื่อง, การป้องกันไม่ให้เข้าถึงได้จากอินเทอร์เน็ตสาธารณะ และการกู้คืนระบบหลังจากอัปเกรดแล้วเกิดปัญหา
มีสองสิ่งที่ควรทราบก่อนเริ่มต้น ตั้งแต่ 0.11.0 เป็นต้นมา การติดตั้ง KiroCrew ใหม่ที่ไม่ได้เลือก harness ไว้ล่วงหน้าจะใช้ KAS เป็นค่าเริ่มต้นโดยไม่จำเป็นต้องใช้ kiro-cli ส่วนการตั้งค่าที่เลือกไว้ใน Kiro CLI เดิมจะยังคงอยู่ การประมวลผล inference บนแบ็กเอนด์ของ Kiro จะใช้แผนบริการ Kiro ของคุณ ดังนั้น ณ วันที่ 1 พฤศจิกายน 2026 การตั้งค่าเริ่มต้นนี้จึงไม่ใช่การทำงานแบบออฟไลน์ นอกจากนี้ โปรเจกต์นี้ยังอยู่ในช่วงเริ่มต้นและมีการพัฒนาอย่างรวดเร็ว โดยเวอร์ชันเสถียรมีการเปลี่ยนแปลงจาก 0.1.3 เมื่อวันที่ 5 สิงหาคม 2026 มาเป็น 0.10.0 เมื่อวันที่ 25 ตุลาคม 2026 โดยมี 0.8.0 ในวันที่ 9 ตุลาคม และ 0.9.0 ในวันที่ 16 ตุลาคม คั่นกลาง และยังมี 0.11.0 release candidate ที่ออกมาเป็นเวอร์ชันทดสอบเมื่อวันที่ 25 ตุลาคม ให้สันนิษฐานไว้เสมอว่าคุณอาจต้องย้อนกลับเวอร์ชันในบางช่วงเวลา ดังนั้นควรติดตั้งในรูปแบบที่เอื้อต่อการดำเนินการดังกล่าว หากคุณไม่เคยรันเอเจนต์บนเซิร์ฟเวอร์มาก่อน การรันเอเจนต์เขียนโค้ดบน VPS จะครอบคลุมกฎพื้นฐานที่คู่มือนี้ใช้เป็นฐาน หากคุณยังใหม่กับฝั่งเอเจนต์มากกว่าฝั่งเซิร์ฟเวอร์ การศึกษา การเรียนรู้ว่าเอเจนต์ลูป, เครื่องมือ และหน่วยความจำของเอเจนต์คืออะไร ก่อน จะช่วยให้คุณเข้าใจตัวเลือกต่างๆ ด้านล่างนี้ในฐานะการตัดสินใจเชิงเทคนิค ไม่ใช่เพียงแค่การทำตามคำสั่งโดยไม่เข้าใจที่มา
สิ่งที่ KiroCrew ต้องการและตำแหน่งที่จัดเก็บสถานะ
การติดตั้งแบบ native จำเป็นต้องใช้ Python 3.12 หรือใหม่กว่า และ Node.js 22.12.0 หรือใหม่กว่า หากคุณต้องการ build dashboard จาก source (ทางโครงการแนะนำ Node 24 LTS) ส่วน backend ของ Kiro CLI จำเป็นต้องใช้ kiro-cli โดยต้องยืนยันตัวตนด้วย kiro-cli login หรือใช้ API key สำหรับการใช้งานแบบอัตโนมัติ นับตั้งแต่ 0.10.0 เป็นต้นมา เอนจิน KAS ที่มาพร้อมกับตัวโปรแกรมสามารถทำงานได้โดยไม่ต้องติดตั้ง kiro-cli และ 0.11.0 ได้กำหนดให้เป็นค่าเริ่มต้นสำหรับการติดตั้งใหม่ที่ไม่มีการเลือก harness ไว้ก่อนหน้า การติดตั้งแบบ container ไม่จำเป็นต้องมีสิ่งเหล่านี้บน host แต่จำเป็นต้องมี Docker ซึ่งเป็นเหตุผลหลักที่ควรเลือกใช้วิธีนี้
สถานะของโปรแกรมจะถูกจัดเก็บไว้ใน ~/.kiro/crew และตัวแปรสภาพแวดล้อม KIROCREW_HOME สามารถใช้เพื่อย้ายตำแหน่งจัดเก็บไปยังที่อื่นได้ โดยภายในประกอบด้วย:
config.json: การตั้งค่า gateway และข้อมูลรับรองสำหรับช่องทางแชท.env: ข้อมูลลับ (secrets)workspace/memory/: การตั้งค่าส่วนตัว, บันทึกโครงการ และประวัติการแชทmemory.dbและmemory_index.db: ดัชนีแบบ semantic และแบบ full-textmodels/: โมเดล embedding ซึ่งจะถูกดาวน์โหลดในการรันครั้งแรกsecurity_events.jsonl: บันทึกเหตุการณ์ด้านความปลอดภัย
ไดเรกทอรีดังกล่าวคือตัวการติดตั้งทั้งหมด หากคุณคัดลอกไปยัง VPS เครื่องใหม่ คุณก็จะเป็นการย้าย agent ของคุณไปที่นั่น ซึ่งเป็นเหตุผลว่าทำไมส่วนการสำรองข้อมูลด้านล่างจึงมีความสำคัญมากกว่าส่วนการติดตั้ง
ควรวางแผนโดยเน้นที่พื้นที่ดิสก์มากกว่า RAM ตัว gateway เป็นกระบวนการ Python ส่วนสิ่งที่ทำให้เครื่องทำงานหนักจริงๆ คือสิ่งที่ agent รัน ไม่ว่าจะเป็นการ build หรือชุดทดสอบ ไดเรกทอรีสถานะจะขยายขนาดขึ้นตามประวัติการแชท และโมเดล embedding จะถูกดาวน์โหลดในการเริ่มทำงานครั้งแรก ดังนั้นควรวัดขนาดบนเครื่องของคุณเองด้วย du -sh ~/.kiro/crew หลังจากผ่านไปสองสามสัปดาห์ แทนที่จะเชื่อตัวเลขที่เผยแพร่ในช่วงเดือนแรกๆ ของโครงการ ซึ่งแตกต่างจาก runtime ที่จัดสรร container และเบราว์เซอร์แยกให้ worker แต่ละตัว ซึ่งในกรณีนั้น การ self-host เพื่อนร่วมงาน AI ของ OpenBot จะทำให้การคำนวณขนาดเป็นเรื่องของ RAM ก่อนที่จะเป็นเรื่องของดิสก์
คุณควรเลือกใช้เส้นทางการติดตั้งแบบใดจากทั้ง 4 รูปแบบ
โครงการนี้เผยแพร่ซอฟต์แวร์ 4 รูปแบบ ได้แก่ แอปพลิเคชันบนเดสก์ท็อป, one-line wheel, ซอร์สโค้ด และ Docker ตัวติดตั้งแบบ one-line จะดึงไฟล์ wheel มาและสร้างตัวเรียกใช้งาน kirocrew หากไดเรกทอรีดังกล่าวไม่ได้อยู่ใน PATH ของคุณ ระบบจะแสดงคำแนะนำในการเพิ่มเข้าไป:
curl -fsSL https://download.crew.kiro.dev/cli.sh | shตัวติดตั้งนี้รองรับการระบุ flag ของช่องทาง (channel) และ flag ของเวอร์ชัน:
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อิมเมจคอนเทนเนอร์ถูกเผยแพร่ไว้ที่ ghcr.io/kirodotdev/kirocrew สำหรับ linux/amd64 และ linux/arm64 ในทุกแท็ก ส่วนการ build จากซอร์สโค้ดนั้นใช้ git clone ร่วมกับ make build ซึ่งเหมาะสำหรับผู้ที่ต้องการแก้ไขโค้ด ไม่ใช่สำหรับผู้ที่ต้องการใช้งานทั่วไป
แนะนำให้ใช้คอนเทนเนอร์ การติดตั้งจากซอร์สโค้ดแบบ native จะนำแพ็กเกจ Python และ Node ไปติดตั้งบนโฮสต์เดียวกับที่รันบริการอื่นของคุณ รวมถึง kiro-cli เมื่อใช้ Kiro CLI backend ดังนั้นหากการอัปเกรดเกิดข้อผิดพลาด คุณจะต้องแก้ไขปัญหาด้วยตนเอง แต่คอนเทนเนอร์จะเก็บรันไทม์ไว้ในอิมเมจเดียวและเก็บสถานะไว้ใน volume เดียว ซึ่งทำให้การย้อนกลับ (rollback) ทำได้เพียงแค่เปลี่ยนแท็กและรีสตาร์ทเท่านั้น
ตรึงอิมเมจไว้ที่ release tag แทนที่จะใช้ stable
ตัวอย่างของโปรเจกต์เองใช้ tag stable:
docker run -d --name kirocrew \
-p 127.0.0.1:5476:5476 \
-v kirocrew-home:/home/kirocrew \
ghcr.io/kirodotdev/kirocrew:stablestable เป็น tag ที่เปลี่ยนแปลงได้ตลอดเวลา เช่นเดียวกับ latest ซึ่งชี้ไปยัง release เดียวกัน มันจะชี้ไปยัง release ล่าสุดที่มีความเสถียรเสมอ ดังนั้นการดึงอิมเมจครั้งถัดไปอาจเปลี่ยนเวอร์ชันที่คุณใช้งานอยู่โดยที่คุณไม่ได้เลือก และ tag ดังกล่าวไม่ได้บันทึกข้อมูลว่าเวอร์ชันที่ใช้อยู่คืออะไร เวอร์ชัน tag นั้นไม่สามารถเปลี่ยนแปลงได้ (immutable) ดังนั้นควรตรึงไว้ที่เวอร์ชันใดเวอร์ชันหนึ่ง release ล่าสุดที่มีความเสถียร ณ วันที่ 1 พฤศจิกายน 2026 คือ 0.11.1 ซึ่งเผยแพร่เมื่อวันที่ 31 ตุลาคม 2026 เป็น hot patch สำหรับแก้ไขปัญหา memory integrity และ KAS ใน 0.11.0 ตัวอย่าง 0.8.0 ด้านล่างใช้ Kiro CLI นอกจากนี้ยังมี tag insider และ nightly โดยที่ nightly จะติดตาม build จาก main
เขียน /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:เริ่มการทำงาน จากนั้นตรวจสอบ health endpoint ที่อิมเมจใช้สำหรับ HEALTHCHECK ของตัวเอง:
cd /opt/kirocrew
docker compose up -d
docker compose ps
curl -s http://127.0.0.1:5476/api/healthdocker compose ps ควรรายงานสถานะคอนเทนเนอร์ว่า healthy ภายในเวลาประมาณหนึ่งนาที และ /api/health จะตอบกลับโดยไม่ต้องใช้ token (เช่นเดียวกับ /api/live และ /api/ready ซึ่งทำให้สามารถใช้เป็น probe ได้) หากสถานะยังคงเป็น starting ให้อ่าน docker logs kirocrew ก่อนที่จะทำการเปลี่ยนแปลงใดๆ การรันครั้งแรกจะดาวน์โหลด embedding model ในเบื้องหลัง โดยการค้นหาด้วยหน่วยความจำจะใช้การจับคู่คำสำคัญ (keyword matching) จนกว่าโมเดลจะดาวน์โหลดเสร็จสิ้น
การรักษาให้ระบบทำงานต่อเนื่องด้วย systemd
restart: unless-stopped จะนำคอนเทนเนอร์กลับมาทำงานใหม่หลังจากเกิดการขัดข้องหรือหลังจากรีบูตเครื่อง ตราบใดที่ Docker เริ่มทำงานตอนบูตเครื่อง ไฟล์ unit จะทำให้ dependency เหล่านี้ชัดเจนและช่วยให้คุณใช้คำสั่งเดียวเพื่อหยุด stack ทั้งหมดก่อนทำการสำรองข้อมูล การเริ่ม Docker Compose stack ตอนบูตเครื่อง ได้ครอบคลุมรูปแบบทั่วไปไว้แล้ว นี่คือรูปแบบของ KiroCrew ใน /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.targetsudo systemctl daemon-reload
sudo systemctl enable --now kirocrew
systemctl status kirocrewsystemctl status kirocrew ควรมีค่าเป็น active (exited) ซึ่งเป็นผลลัพธ์ที่ถูกต้องสำหรับ unit นี้ การใช้ Type=oneshot ร่วมกับ RemainAfterExit=yes นั้นถูกต้องแล้ว เนื่องจาก docker compose up -d จะคืนค่าทันทีที่คอนเทนเนอร์เริ่มทำงาน systemd จึงติดตามสถานะว่า stack ทำงานอยู่ ไม่ใช่ติดตาม process ที่ทำงานเบื้องหน้า หากคุณเขียน Type=simple แทน systemd จะเห็นว่าคำสั่งจบการทำงานทันที และทำเครื่องหมายว่า service นั้นตายแล้ว จากนั้นจะยอมแพ้หรือวนลูปการรีสตาร์ทขึ้นอยู่กับการตั้งค่า Restart= ของคุณ สำหรับการติดตั้งแบบ native ตัวโปรเจกต์จะมีไฟล์เทียบเท่ามาให้คือ kirocrew service install ซึ่งจะเขียน /etc/systemd/system/kirocrew.service และรัน gateway ในฐานะผู้ใช้ของคุณ ห้ามรันทั้งสอง unit พร้อมกัน หัวข้อนี้ในเวอร์ชันที่กว้างขึ้นอยู่ใน systemd services และ timers บน VPS unit ที่ไม่สามารถกลับมาทำงานได้จะเงียบสนิทเว้นแต่คุณจะตั้งค่าให้มันแจ้งเตือน ดังนั้นให้เพิ่มตัวจัดการ OnFailure= ที่ ส่งการแจ้งเตือนไปยังเซิร์ฟเวอร์ ntfy ของคุณเอง แล้วคุณจะทราบว่า gateway ล่มผ่านทางโทรศัพท์ของคุณ แทนที่จะทราบจากงานที่ตั้งเวลาไว้ซึ่งไม่เคยทำงานเลย
การใช้งานครั้งแรก: ลงชื่อเข้าใช้และรับ dashboard token
คอนเทนเนอร์จะเริ่มการทำงานของ gateway แต่ Kiro CLI runtime เริ่มต้นในอิมเมจ 0.8.0 ที่ถูกตรึงเวอร์ชันไว้ยังคงต้องการการยืนยันตัวตน ให้ลงชื่อเข้าใช้ภายในคอนเทนเนอร์ หรือส่งค่าผ่าน KIRO_API_KEY ในสภาพแวดล้อมของคอนเทนเนอร์เพื่อใช้งานแบบอัตโนมัติ:
docker exec -it kirocrew kiro-cli loginคำสั่งดังกล่าวจะแสดง device code และ URL ให้คุณเปิดผ่านเบราว์เซอร์ของคุณ จากนั้นให้สร้าง dashboard token:
docker exec kirocrew kirocrew token --ttl 2hURL ของ dashboard คือ http://localhost:5476/?token=<the token> โดย token จะมีวันหมดอายุ: ลิงก์ที่แสดงต้องถูกเปิดภายใน 5 นาทีหลังจากสร้าง และคำสั่งนี้จะขอ access cookie ที่มีอายุ 2 ชั่วโมง โดยมีระยะเวลาสูงสุดตามเอกสารระบุไว้ที่ 20 ชั่วโมง นอกจากนี้เบราว์เซอร์จะได้รับ refresh cookie ที่มีระยะเวลา idle window แบบเลื่อนได้ 30 วัน ดังนั้นเซสชันที่ยังมีการใช้งานอยู่จะได้รับการต่ออายุโดยไม่ต้องใช้ลิงก์ใหม่ หาก dashboard โหลดขึ้นมาเป็นหน้าว่างหรือเด้งกลับออกมาทันที มักเกิดจาก token หมดอายุ ให้สร้าง token ใหม่และเปิดใช้งานทันที ห้ามคัดลอก token ไปวางใน ticket หรือข้อความแชทเด็ดขาด เพราะใครก็ตามที่ถือ token นี้ไว้ จะสามารถเข้าถึง agent ของคุณได้ทันที
เข้าถึงแดชบอร์ดผ่าน SSH และห้ามเปิดพอร์ต 5476 สู่สาธารณะ
พิจารณา bind address ในตัวอย่างของโปรเจกต์อีกครั้งที่ -p 127.0.0.1:5476:5476 ภายในคอนเทนเนอร์ เกตเวย์จะฟังที่ 0.0.0.0 เนื่องจากต้องเข้าถึงได้ผ่านการทำ port mapping แต่การ mapping นั้นเปิดให้เข้าถึงได้เฉพาะ loopback บนโฮสต์เท่านั้น หากลบ prefix 127.0.0.1: ออก เกตเวย์จะถูกเปิดสู่สาธารณะทันทีสำหรับทุกคนที่สแกนพอร์ตนั้น กฎของ ufw ไม่สามารถช่วยคุณได้ เนื่องจาก Docker เปิดพอร์ตโดยการเขียนกฎ DNAT ซึ่งจะจัดการทราฟฟิกก่อนที่กฎของ ufw จะทำงาน ดังนั้น ufw deny 5476 จึงไม่มีผลใดๆ ต่อพอร์ตที่ถูกเปิดไว้ สำหรับ iptables backend เริ่มต้นของ Docker วิธีแก้คือการใส่กฎการกรองใน chain DOCKER-USER ของ Docker เอง ซึ่งวิธีนี้ใช้ได้ผล แต่กฎเหล่านั้นจะมองเห็นที่อยู่และพอร์ตภายในของคอนเทนเนอร์ เว้นแต่คุณจะจับคู่ด้วย conntrack extension ดังนั้นการ bind ไว้ที่ loopback จึงเป็นวิธีที่ง่ายกว่าและลดโอกาสเกิดข้อผิดพลาดได้มากกว่า ส่วน nftables backend ของ Docker จะใช้ตารางและ base chain แยกต่างหากสำหรับกฎการกรองแบบกำหนดเอง การที่พอร์ตของ Docker ข้ามการทำงานของ ufw ได้อธิบายกลไกดังกล่าวไว้โดยละเอียด
ให้ทำการ forward พอร์ตผ่าน SSH จากแล็ปท็อปของคุณแทน:
ssh -N -L 5476:127.0.0.1:5476 you@your-server.example.comปล่อยให้คำสั่งนั้นทำงานอยู่แล้วเปิด http://localhost:5476/?token=<the token> ในเครื่องของคุณ หากต้องการให้การ forward ทำงานอัตโนมัติทุกครั้งที่เชื่อมต่อ ให้ใส่ไว้ใน ~/.ssh/config:
Host your-server.example.com
LocalForward 5476 127.0.0.1:5476หากพอร์ต 5476 ถูกใช้งานอยู่บนแล็ปท็อปของคุณ ให้เปลี่ยนเฉพาะตัวเลขฝั่งซ้ายเป็น ssh -N -L 45476:127.0.0.1:5476 you@your-server.example.com แล้วเข้าใช้งานที่ http://localhost:45476/?token=... โดยไม่จำเป็นต้องตั้งค่า loopback-port เพิ่มเติมหรือสร้างคอนเทนเนอร์ใหม่ เนื่องจาก Origin ของ loopback ตรงกับ Host ของคำขอ ทำให้การตรวจสอบ CSRF ยอมรับการเชื่อมต่อนี้ คุณจะต้องทำ stack การ forward แบบนี้เมื่อมี agent ตัวที่สองมาใช้งานบนเครื่องเดียวกัน เพราะ การ self-host open-kritt เพื่อสแกนความปลอดภัย จะเพิ่มแดชบอร์ดที่เข้าถึงได้เฉพาะ loopback อีกตัวบนเซิร์ฟเวอร์เดียวกันที่พอร์ต 5173
พฤติกรรมที่ระบุไว้สองประการจะเป็นตัวกำหนดว่าคุณสามารถเปลี่ยนการตั้งค่าใดได้บ้างจากแดชบอร์ด ประการแรก เกตเวย์จะถือว่าคำขอใดก็ตามที่มี forwarding headers (Forwarded, X-Forwarded-* หรือ X-Real-IP) เป็นคำขอจากระยะไกล และ endpoint สำหรับเขียน config และเปิดเผย secret จะปฏิเสธคำขอเหล่านั้น ซึ่ง reverse proxy จะเพิ่ม header เหล่านี้เข้าไป ในขณะที่การ forward ด้วย ssh -L แบบปกติจะไม่เพิ่ม header ใดๆ ทำให้ระบบมองว่าเป็นคำขอภายในและไม่ถูกปฏิเสธด้วยเหตุผลนี้ ประการที่สอง ในอิมเมจของคอนเทนเนอร์ หน้าจัดการ channel-credential และหน้าแสดง secret จะเป็นแบบอ่านอย่างเดียวสำหรับเบราว์เซอร์ที่ไม่ได้เชื่อมต่อแบบ direct-local และในอิมเมจไม่มี text editor ติดตั้งมาให้ หาก channel credential ไม่สามารถบันทึกได้จากแดชบอร์ด นั่นเป็นเรื่องปกติไม่ใช่บั๊ก ให้แก้ไข config บนโฮสต์แทน:
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สำหรับการเข้าถึงผ่านโทรศัพท์ โปรเจกต์แนะนำให้ใช้ tailscale serve ของ Tailscale ซึ่งจะเก็บแดชบอร์ดไว้ภายใน tailnet ของคุณแทนที่จะใช้ public hostname ควรเลือกใช้วิธีนี้แทนการใช้ public reverse proxy เนื่องจาก token จะถูกส่งไปใน URL และ URL จะถูกบันทึกลงใน access log ทุกจุดที่ผ่าน กฎนี้เกี่ยวข้องกับสิ่งที่อยู่หลังพอร์ตมากกว่าตัวพอร์ตเอง ตัวอย่างเช่น Halcyon ซึ่งสร้างคลัง Jellyfin ใหม่ให้เป็นร้านวิดีโอยุค 90 ที่เปิดดูได้ เป็นสิ่งที่เหมาะสมสำหรับการเปิดผ่าน reverse proxy ในขณะที่เกตเวย์ที่สามารถรันคำสั่งบนเซิร์ฟเวอร์ของคุณได้นั้นไม่ควรทำเช่นนั้น
จำกัดขอบเขตความเสียหายของ agent ให้เหลือน้อยที่สุด
Container จะตรวจสอบการรองรับ sandbox ในการเริ่มทำงานครั้งแรก และผลลัพธ์จะเป็นตัวตัดสินว่า agent สามารถประมวลผลคำสั่งใดๆ ได้หรือไม่ หากมีการแยก namespace (namespace isolation) กระบวนการย่อยของ agent จะทำงานในสภาพแวดล้อมที่ถูกแยกส่วน แต่หากไม่มีการรองรับและไม่ได้ตั้งค่า KIROCREW_ALLOW_UNSANDBOXED=1 ระบบจะปฏิเสธการประมวลผลแทนที่จะปล่อยให้ทำงานโดยไม่มีการควบคุม ดังนั้นหาก gateway ดูเหมือนทำงานปกติแต่ทุก task กลับค้าง นั่นมักเป็นสาเหตุนี้ การตัดสินใจดังกล่าวจะถูกบันทึกไว้ใน docker logs kirocrew จากการรันครั้งแรกนั้น นอกจากนี้โครงการยังได้เผยแพร่โปรไฟล์ seccomp (secure computing mode) ที่คุณสามารถนำไปปรับใช้ได้:
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บนโฮสต์ที่เปิดใช้งาน AppArmor คู่มือ Docker ของโครงการระบุว่าการใช้โปรไฟล์ seccomp เป็นเพียงครึ่งหนึ่งของการเปลี่ยนแปลงเท่านั้น เนื่องจาก Docker จะแนบโปรไฟล์ AppArmor docker-default มาด้วย และจับคู่โปรไฟล์นั้นเข้ากับ apparmor=unconfined ตัวเลือกดังกล่าวจะยกเลิกเฉพาะกฎราย container ของ AppArmor เท่านั้น แต่โปรไฟล์ seccomp, การจำกัด capabilities และการใช้งานโดยผู้ใช้ที่ไม่ใช่ root ยังคงมีผลบังคับใช้อยู่
หากคุณตั้งค่า KIROCREW_ALLOW_UNSANDBOXED=1 ต้องเข้าใจให้ชัดเจนว่ามีอะไรเปลี่ยนแปลงบ้าง: ตอนนี้ container กลายเป็นขอบเขตเดียวที่กั้นระหว่าง agent กับเซิร์ฟเวอร์ของคุณ คำเตือนของโครงการควรได้รับการย้ำเตือนอย่างครบถ้วน ห้าม mount path ของโฮสต์ที่คุณจะไม่ส่งมอบให้ agent โดยตรง ในทางปฏิบัติ นั่นหมายถึงการห้าม mount Docker socket, การ bind mount / ใดๆ และไดเรกทอรีใดก็ตามที่เก็บข้อมูลของบริการอื่น
ส่วนที่เหลือคือกรอบการทำงานที่ใช้กับทุก agent ที่ได้รับอนุญาตให้รันคำสั่ง ให้จำกัดสิทธิ์ของ credentials ไว้เฉพาะ repository หรือ bucket ที่จำเป็นเท่านั้น ห้ามใช้ personal token ที่มีสิทธิ์ครอบคลุมทั้งบัญชี ให้รัน agent ในฐานะผู้ใช้เฉพาะ (dedicated user) ที่มีโฮมไดเรกทอรีว่างเปล่า ซึ่งเป็นสิ่งที่ ผู้ใช้ที่มีสิทธิ์น้อยที่สุดบน VPS มีไว้เพื่อการนี้ เมื่อ agent เขียนโค้ดแล้วรันโค้ดนั้น ให้ใช้เครื่องที่ยอมรับได้หากมันจะพัง: VM แบบใช้แล้วทิ้งสำหรับ coding agent เป็นขอบเขตที่แข็งแกร่งกว่า flag ใดๆ ในไฟล์ compose นี้ เพราะคุณสามารถลบมันทิ้งแทนที่จะต้องมาทำความสะอาดภายหลัง เหตุผลเดียวกันนี้ยังใช้กับการ รัน OpenClaw อย่างปลอดภัยบน VPS และ การ self-host Hermes agent บน VPS เครื่องมือต่างๆ ก็นับเป็นขอบเขตความเสียหายเช่นกัน การให้ agent ค้นหาเว็บจะทำให้ทุกหน้าเว็บที่มันดึงมากลายเป็นข้อมูลที่ไม่น่าเชื่อถือ ดังนั้น การชี้ไปยัง SearXNG instance ของคุณเอง จึงเป็นการตัดสินใจด้าน prompt injection พอๆ กับการจัดการระบบ งานที่ตั้งเวลาไว้ (scheduled work) อาจทำให้เสียค่าใช้จ่ายในขณะที่คุณหลับ เนื่องจากการประมวลผลบน Kiro backend จะใช้โควตาจากแผน Kiro ของคุณ ดังนั้นควรตั้งค่าขีดจำกัดตามที่อธิบายไว้ใน การควบคุมค่าใช้จ่ายของ AI agent บน VPS ก่อนที่คุณจะเพิ่มงานที่ต้องรันในตอนกลางคืน
สำรองข้อมูล volume ของสถานะก่อนการอัปเกรดทุกครั้ง
ค้นหาชื่อ volume ที่แท้จริงก่อน โดย Compose จะตั้งชื่อ prefix ของ volume ตามชื่อโปรเจกต์ ซึ่งค่าเริ่มต้นคือชื่อไดเรกทอรี ดังนั้น volume ที่ประกาศไว้เป็น kirocrew-home ใน /opt/kirocrew/compose.yaml จะถูกสร้างขึ้นในชื่อ kirocrew_kirocrew-home:
docker volume lsหยุดการทำงานของ gateway ก่อนที่จะคัดลอกข้อมูลใดๆ memory.db และ memory_index.db เป็นฐานข้อมูล SQLite การคัดลอกฐานข้อมูลในขณะที่มีการเขียนข้อมูลอยู่อาจทำให้ได้ธุรกรรมที่เขียนไม่สมบูรณ์ ซึ่งเมื่อนำไปกู้คืนจะกลายเป็นไฟล์ที่เสียหาย คำแนะนำในการย้ายข้อมูลของโปรเจกต์เองก็ได้ระบุไว้เช่นกันว่า ให้ย้ายข้อมูลในหน่วยความจำเฉพาะในขณะที่ gateway หยุดทำงานเท่านั้น กฎการหยุดทำงานก่อนนี้ไม่ได้จำกัดอยู่แค่ KiroCrew และหากมีเซิร์ฟเวอร์รูปภาพใช้งานอยู่บนเครื่องเดียวกัน การเปรียบเทียบระหว่าง PhotoPrism และ Immich จะระบุคำสั่งสำรองข้อมูลที่จำเป็นสำหรับทั้งสองบริการไว้อย่างชัดเจน
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คัดลอกไฟล์เก็บถาวรออกจากเครื่อง การกู้คืนข้อมูลใช้คำสั่งเดียวกันโดยต้องหยุด container และใช้ tar xzf แทนที่ 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การย้ายไปยังโฮสต์ใหม่เป็นงานที่แตกต่างจากการกู้คืนในที่เดิม และทางโปรเจกต์ได้ระบุรายละเอียดไว้ชัดเจน ประวัติการแชทและบันทึกของโปรเจกต์ภายใต้ workspace/memory/ จะถูกย้ายไปด้วย รวมถึงไฟล์ฐานข้อมูลทั้งสองไฟล์และ config.json ส่วนไฟล์ PID, บันทึกเหตุการณ์ความปลอดภัย และ .env นั้นผูกติดอยู่กับโฮสต์เดิม จึงควรทิ้งไว้ที่เดิมและป้อนข้อมูลลับใหม่อีกครั้งบนเครื่องใหม่
วิธีการย้อนกลับการอัปเกรดที่ผิดพลาด
การอัปเกรดนั้นทำได้รวดเร็วและปลอดภัยก็ต่อเมื่อคุณได้ล็อกเวอร์ชันไว้แล้ว ให้สำรองข้อมูลก่อนเสมอ จากนั้นจึงเปลี่ยน 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/healthdocker compose up -d จะดึง image มาหากยังไม่มีอยู่ในเครื่อง ดังนั้นการแก้ไข tag จึงถือเป็นการอัปเกรดทั้งหมด การย้อนกลับทำได้ด้วยลำดับขั้นตอนเดียวกันโดยใช้เลขเวอร์ชันเดิม ซึ่งจะทำให้คุณได้ image เดิมที่เคยใช้งานเป๊ะๆ เนื่องจาก version tag นั้นไม่สามารถเปลี่ยนแปลงได้
ตัว binary สามารถย้อนกลับได้อย่างหมดจด แต่ส่วนของ state อาจไม่เป็นเช่นนั้น gateway เวอร์ชันใหม่กว่าอาจเขียนทับ config.json หรือย้ายข้อมูลใน memory database ไปอยู่ในรูปแบบที่ gateway เวอร์ชันเก่าอ่านไม่ได้ และ ณ วันที่ 12 October 2026 ยังไม่มีการระบุเส้นทางการย้อนกลับ (downgrade path) สำหรับ state ไว้ในเอกสาร คู่มือการติดตั้งได้ระบุไว้อย่างชัดเจนในกรณีหนึ่งว่า ข้อมูลที่ถูกย้ายออกจาก ~/.kirocrew แบบเดิมจะไม่สามารถย้อนกลับได้ และ release ที่เก่ากว่า ~/.kiro/crew จะเริ่มต้นด้วยค่าว่าง ดังนั้นหาก image เวอร์ชันเก่าเริ่มทำงานแล้วมีพฤติกรรมผิดปกติ ไม่ต้องพยายาม debug ให้หยุดการทำงานนั้น แล้วกู้คืนข้อมูลสำรองที่คุณทำไว้ก่อนการอัปเกรด จากนั้นจึงเริ่มใหม่ นี่คือเหตุผลทั้งหมดว่าทำไมต้องสำรองข้อมูลก่อน และเป็นสาเหตุที่นิสัยการอัปเกรดก่อนแล้วค่อยสำรองข้อมูลทีหลังนั้นใช้ไม่ได้ผลกับโปรเจกต์ที่ยังใหม่อยู่เช่นนี้
สิ่งที่ยังไม่ได้ผ่านการพิสูจน์ในที่นี้
โปรดพิจารณาอายุของซอฟต์แวร์นี้ตามความเป็นจริง เวอร์ชัน 0.1.3 ได้รับการปล่อยออกมาเมื่อวันที่ 5 สิงหาคม 2026 และภายในวันที่ 12 ตุลาคม 2026 สายการผลิตเวอร์ชันเสถียรได้ไปถึง 0.8.0 แล้ว บันทึกการเปลี่ยนแปลงส่วนใหญ่ยังคงเป็น changelog ที่สร้างขึ้นโดยอัตโนมัติ ส่วนบันทึกของ 0.8.0 นั้นเขียนขึ้นด้วยมือแต่ไม่มีส่วนที่อธิบายเรื่องการย้ายข้อมูล (migration) และประวัติการเผยแพร่ต่อสาธารณะมีระยะเวลาเพียงประมาณ 3 เดือนเท่านั้น ไม่มีสิ่งใดในคู่มือนี้ที่เป็นผลลัพธ์จากการใช้งานระยะยาว ดังนั้นให้ถือว่าการเพิ่มขึ้นของหน่วยความจำ ขนาดของฐานข้อมูล และความน่าเชื่อถือของตัวจัดตารางเวลา (scheduler) เป็นสิ่งที่ต้องวัดผลด้วยตนเองบนเครื่องของคุณ แทนที่จะคาดเดาเอาเอง
มีพฤติกรรมสองประการที่ควรทดสอบด้วยตนเองก่อนที่คุณจะพึ่งพาการทำงานของมัน ประการแรก คือการตรวจสอบว่าการลดเวอร์ชัน (downgrade) จะสามารถอ่านสถานะที่เขียนโดยเวอร์ชันที่ใหม่กว่าได้หรือไม่ โดยให้ทดสอบกับสำเนาของ volume ในช่วงเวลาที่ไม่ส่งผลกระทบต่อการใช้งานจริง ไม่ใช่ระหว่างที่ระบบล่ม ประการที่สอง คือการตรวจสอบว่า gateway จะทำงานอย่างไรเมื่อการลงชื่อเข้าใช้ Kiro หมดอายุในขณะที่งานตามตารางเวลา (scheduled job) ถึงกำหนดทำงาน ทั้งสองกรณีนี้เป็นจุดบกพร่องเล็กน้อยที่โครงการใหม่ๆ มักจะค่อยๆ แก้ไขไปในระหว่างการปล่อยเวอร์ชันใหม่ และทั้งสองอย่างนี้เป็นสิ่งที่ตรวจสอบได้ง่ายในขณะนี้
FAQ
ทำไมแดชบอร์ด KiroCrew ถึงเปิดบน Public IP ของเซิร์ฟเวอร์ไม่ได้
เพราะตัวอย่างที่เผยแพร่ได้กำหนดให้พอร์ตผูกกับ loopback เท่านั้น -p 127.0.0.1:5476:5476 จะแมปพอร์ตของคอนเทนเนอร์เข้ากับที่อยู่ loopback ของโฮสต์โดยเจตนา คุณสามารถเข้าถึงได้โดยการทำ port forwarding ผ่าน SSH ด้วยคำสั่ง ssh -N -L 5476:127.0.0.1:5476 you@your-server จากนั้นเปิด http://localhost:5476/?token=<token> บนแล็ปท็อปของคุณ การลบ prefix 127.0.0.1: ออกเพื่อให้เข้าถึงได้จากภายนอกจะทำให้เกตเวย์เปิดรับการเชื่อมต่อจากอินเทอร์เน็ตสาธารณะ และ ufw จะไม่สามารถควบคุมได้ เนื่องจากกฎ DNAT ของพอร์ตที่เผยแพร่โดย Docker จะส่งผ่านทราฟฟิกก่อนที่กฎของ ufw จะทำงาน ให้ใช้ chain DOCKER-USER ของ Docker ร่วมกับ iptables backend หรือใช้ base chain ของ nftables แยกต่างหากร่วมกับ nftables backend เพื่อกรองพอร์ตที่เผยแพร่ การคงการผูกพอร์ตไว้ที่ loopback จึงเป็นวิธีที่ง่ายกว่า
KiroCrew เก็บข้อมูลไว้ที่ไหน และควรสำรองข้อมูลอะไรบ้าง
ข้อมูลทั้งหมดจะอยู่ที่ ~/.kiro/crew ซึ่งภายในอิมเมจคอนเทนเนอร์คือ /home/kirocrew/.kiro/crew และสามารถย้ายตำแหน่งได้ด้วย KIROCREW_HOME ให้สำรองข้อมูลทั้งไดเรกทอรีหรือทั้ง Docker volume ในขณะที่หยุดการทำงานของเกตเวย์ไว้ memory.db และ memory_index.db เป็นฐานข้อมูล SQLite ดังนั้นการคัดลอกไฟล์ในขณะที่เกตเวย์กำลังเขียนข้อมูลอาจทำให้ข้อมูลไม่สอดคล้องกัน เมื่อย้ายไปยังโฮสต์ใหม่ ให้คัดลอก workspace/memory/, ไฟล์ฐานข้อมูลทั้งสองไฟล์ และ config.json ไปด้วย ส่วนไฟล์ PID, บันทึกเหตุการณ์ความปลอดภัย และ .env เป็นข้อมูลที่ผูกกับโฮสต์เดิม
ควรใช้แท็ก stable หรือแท็กเวอร์ชัน
ควรใช้แท็กเวอร์ชัน เพราะ stable จะเปลี่ยนไปทุกครั้งที่มีการปล่อยซอฟต์แวร์รุ่นใหม่ ทำให้เวอร์ชันที่คุณใช้งานอยู่เปลี่ยนไปโดยไม่รู้ตัวเมื่อมีการ pull ครั้งถัดไป และตัวแท็กเองก็ไม่ได้ระบุข้อมูลใดๆ เกี่ยวกับเวอร์ชันที่กำลังทำงานอยู่ แท็กเวอร์ชันเช่น 0.8.0 นั้นไม่สามารถเปลี่ยนแปลงได้ ซึ่งเป็นหัวใจสำคัญที่ทำให้การย้อนกลับ (rollback) ทำงานได้จริง: คุณเพียงแค่ระบุหมายเลขเวอร์ชันเดิมกลับไปและจะได้อิมเมจที่เหมือนเดิมทุกประการ ณ วันที่ 1 พฤศจิกายน 2026 รุ่นเสถียรล่าสุดคือ 0.11.1
ทำไมเอเจนต์ของฉันถึงปฏิเสธที่จะรันคำสั่งใดๆ
คอนเทนเนอร์จะตรวจสอบการรองรับ sandbox ในการเริ่มทำงานครั้งแรก หากไม่สามารถแยกส่วน (isolate) กระบวนการย่อยของเอเจนต์ได้และไม่ได้ตั้งค่า KIROCREW_ALLOW_UNSANDBOXED=1 ไว้ มันจะปฏิเสธการรันคำสั่งแทนที่จะรันโดยไม่มีการจำกัดสิทธิ์ ทำให้สถานะของเกตเวย์ดูปกติแต่ทุกงานกลับหยุดชะงัก docker logs kirocrew จะแสดงผลการตัดสินใจเรื่อง sandbox จากการรันครั้งแรกนั้น การตั้งค่าตัวแปรดังกล่าวจะทำให้คอนเทนเนอร์เป็นขอบเขตเดียวระหว่างเอเจนต์กับโฮสต์ ดังนั้นหากคุณตั้งค่านี้ ห้าม mount สิ่งใดที่คุณไม่ต้องการให้เอเจนต์เข้าถึงโดยตรง
ฉันจำเป็นต้องมีบัญชี Kiro เพื่อ self-host KiroCrew หรือไม่
สำหรับแบ็กเอนด์ของ Kiro จำเป็นต้องมี ณ วันที่ 1 พฤศจิกายน 2026 KiroCrew เป็นซอฟต์แวร์เสรีภายใต้สัญญาอนุญาต Apache 2.0 แต่การประมวลผล (inference) บนแบ็กเอนด์เหล่านั้นจะใช้ตามแผนบริการ Kiro ของคุณ คอนเทนเนอร์ 0.8.0 ที่ถูกกำหนดไว้จะใช้ Kiro CLI: ให้รัน docker exec -it kirocrew kiro-cli login และยืนยันรหัสอุปกรณ์ในเบราว์เซอร์ของคุณ หรือส่งผ่าน KIRO_API_KEY ผ่าน environment ของคอนเทนเนอร์เพื่อการใช้งานแบบอัตโนมัติ จนกว่าจะมีการตั้งค่าการยืนยันตัวตน เกตเวย์จะเริ่มทำงานและแดชบอร์ดจะโหลดขึ้นมา แต่ harness เริ่มต้นจะไม่มีโมเดลให้ใช้งาน นับตั้งแต่ 0.10.0 เป็นต้นมา มีการเพิ่มเอนจิน KAS ในตัวที่ไม่จำเป็นต้องติดตั้ง kiro-cli โดย 0.11.0 ได้กำหนดให้ KAS เป็นค่าเริ่มต้นสำหรับการติดตั้งใหม่ที่ไม่มีการเลือก harness ไว้ล่วงหน้า ในขณะที่ยังคงรักษาการเลือก Kiro CLI ที่ระบุไว้ชัดเจน KAS จะใช้การลงชื่อเข้าใช้ของ Crew เองแทนที่ kiro-cli login คู่มือแบ็กเอนด์แบบกำหนดเองของโครงการช่วยให้ harness แบบ claude สามารถส่งการสนทนาหลักไปยัง endpoint ที่รองรับ Anthropic ตามที่คุณเลือกได้ แต่การลงชื่อเข้าใช้ kiro-cli ยังคงจำเป็นสำหรับฟีเจอร์เฉพาะของ Kiro