Cara Pasang Agent Zero pada VPS dengan Selamat

Apakah itu Agent Zero, dan di mana letaknya bahaya

Agent Zero ialah rangka kerja ejen sumber terbuka yang mengutamakan Docker. Ejen utama boleh menjana ejen bawahan untuk memecahkan tugasan kepada bahagian yang lebih khusus, dan ejen-ejen ini boleh melaksanakan kod, mengendalikan pelayar web, serta menjalankan arahan shell, semuanya di dalam bekas Docker Agent Zero. Anda mengawal keseluruhan sistem ini melalui UI Web. Ia berkeupayaan tinggi dan sangat menyeronokkan untuk digunakan, malah ia boleh berjalan pada perkakasan sekecil VPS berharga enam dolar. Jika anda lebih mengutamakan bentuk berbilang ejen berbanding rangka kerja tersebut, dua sesi Claude Code pada mesin yang sama boleh menghantar mesej antara satu sama lain secara terus, yang merupakan cara yang jauh lebih ringan untuk dijalankan dan diselamatkan.

Bahayanya terletak pada UI Web tersebut. Ia merupakan panel kawalan bagi sistem yang menjalankan arahan dan menulis fail, jadi UI Web yang terdedah tanpa pengesahan merupakan titik akses jauh terus ke dalam sistem tersebut. Inilah perangkap yang sering dilalui oleh kebanyakan panduan penyediaan: contoh docker run menerbitkan antara muka tersebut tanpa menyatakan alamat. Setakat 2026-10-12, arahan terus dalam README memetakan port hos 80 (-p 80:80), pelancar A0 Install menggunakan port 5080, dan panduan penggunaan VPS mengesyorkan 50080, manakala panduan yang ditulis untuk keluaran sehingga barisan v0.9.x menggunakan port 50001. Walau apa pun port yang anda pilih, pemetaan tanpa alamat akan mendengar pada setiap antara muka rangkaian, yang pada VPS awam bermakna ia boleh dicapai dari seluruh internet sebaik sahaja bekas tersebut bermula. Memperbaiki perkara ini adalah langkah pertama yang perlu anda lakukan, bukan yang terakhir.

Keperluan anda

Anda memerlukan VPS dengan Docker yang telah dipasang, kunci API untuk model bahasa atau model tempatan untuk dihubungkan, serta beberapa gigabait RAM untuk bermula. Agent Zero boleh dijalankan di mana-mana sahaja Docker beroperasi, daripada VPS kecil sehingga pelayan GPU. Jika anda baru menggunakan Docker, panduan asas Docker merangkumi perkara yang diandaikan oleh arahan di bawah.

Pemasangan dengan Docker, terikat pada loopback

Panduan permulaan pantas yang didokumentasikan adalah satu docker run. Perubahan penting daripada versi salin-tampal yang anda temui di tempat lain ialah alamat yang anda gunakan untuk menerbitkan servis. Jangan terbitkan pada setiap antara muka, seperti yang dilakukan oleh -p 80:80. Terbitkan pada loopback:

docker run -d --name agent-zero \
  -p 127.0.0.1:5080:80 \
  -v a0_usr:/a0/usr \
  agent0ai/agent-zero

-p 127.0.0.1:5080:80 mengikat Web UI hanya pada alamat loopback pelayan, jadi ia tidak boleh dicapai dari internet. Capai ia dari mesin anda sendiri melalui SSH tunnel:

ssh -L 5080:127.0.0.1:5080 you@your-vps

Kemudian buka http://127.0.0.1:5080 secara setempat, konfigurasikan pembekal model anda dalam UI, dan tetapkan log masuk serta kata laluan UI di bawah Settings, Authentication, yang menurut dokumentasi rasmi perlu dilakukan sebelum anda membuka instans tersebut kepada orang lain. Untuk persediaan berbilang pengguna yang kekal, letakkannya di sebalik VPN atau reverse proxy yang mempunyai pengesahan, tetapi jangan sekali-kali menerbitkan UI mentah ke internet terbuka. Tabiat ini wajar diamalkan pada setiap alat lain dalam pelayan yang antara mukanya mengawal sesuatu yang sensitif, yang juga merupakan cara pengimbas open-kritt yang dihoskan sendiri harus dicapai, melalui tunnel ke UI-nya dan bukannya port yang diterbitkan.

Di mana panduan lain berhenti, dan sebab anda tidak patut berbuat demikian

Cari cara untuk memasang Agent Zero dan anda akan menemui banyak panduan, termasuk daripada syarikat pengehosan, yang membawa anda kepada Web UI yang berjalan pada port yang diterbitkan (50001 dalam versi lama, 80, 5080 atau 50080 dalam versi baharu) dan berakhir di situ. Di situlah risiko bermula, bukan berakhir. Dua perkara melengkapkan tugas ini. Pertama, pastikan UI kekal peribadi, seperti di atas. Kedua, letakkan firewall default-deny di hadapan pelayan supaya servis yang anda terlupa tidak boleh menjawab permintaan daripada internet:

sudo ufw default deny incoming
sudo ufw allow 22/tcp
sudo ufw enable

Walau bagaimanapun, ketahui hadnya: Docker menghalakan trafik untuk port kontena yang diterbitkan sebelum peraturan UFW digunakan, jadi firewall tidak melindungi port kontena yang diterbitkan ke setiap antara muka. Itulah sebabnya pengikatan loopback di atas adalah penting, dan bagaimana port Docker memintas UFW menjelaskan perinciannya. Ikuti asas firewall untuk gambaran penuh, dan perhatikan jurang IPv6, kerana servis pada :: boleh dicapai melalui IPv6 walaupun peraturan IPv4 anda kelihatan ketat.

Pengasingan kontena melindungi ejen, bukan pelayan anda

Reka bentuk Agent Zero memberikan pengasingan yang baik dalam satu aspek: rangka kerja dan setiap ejen yang dijana berjalan di dalam kontena Docker dan bukannya terus pada hos anda. Oleh itu, kod yang ditulis dan dijalankan oleh ejen tersebut berada di dalam kontena, bukan dalam direktori home anda. Ini adalah ciri yang berbaloi. Ejen bawahan berkongsi kontena yang sama dengan ejen utama, jadi tembok pemisah wujud antara ejen dengan hos anda, bukannya antara ejen itu sendiri. Mudah untuk menganggap perkara ini sebagai "ia berada dalam sandbox, jadi saya selamat" dan berhenti di situ sahaja. Pengasingan kontena memastikan kerja ejen tidak menjejaskan hos. Ia tidak melakukan apa-apa untuk melindungi pelayan anda daripada internet, atau menghalang UI Web yang terdedah daripada memberikan kawalan kepada pihak luar. Tugas tersebut adalah tanggungjawab anda pada peringkat hos. Tentukan lebih awal sejauh mana ejen boleh bertindak semasa tiada siapa yang memantaunya, sama seperti pertimbangan di sebalik mod kebenaran Claude Code, di mana pelayan yang tidak dipantau memerlukan tetapan yang lebih ketat berbanding komputer riba yang berada di hadapan anda.

Rahsia, pengguna, dan hos

Simpan kunci API model dan sebarang kelayakan lain dalam konfigurasi Agent Zero atau fail persekitaran yang hanya boleh dibaca oleh akaun yang betul, jauh daripada sejarah shell anda dan jauh daripada mana-mana repositori. Pemikiran yang sama terpakai kepada apa-apa sahaja pada mesin yang melindungi rahsia, memandangkan langkah pengukuhan pada Vaultwarden bergantung kepada token admin dan fail sandarannya dan bukannya penyulitan yang sudah dilakukan dengan baik oleh aplikasi tersebut. Tadbir mesin sebagai pengguna tanpa keistimewaan dan bukannya root, mengikut prinsip pengguna keistimewaan minimum, dan tukar SSH kepada pengesahan kunci sahaja, seperti dalam pengukuhan SSH. Kemudian, ikuti senarai semak di bawah supaya tiada apa yang terlepas.

Jika anda membandingkan ejen, ini adalah postur keselamatan yang sama yang diambil oleh panduan pengukuhan OpenClaw dan panduan OpenHands: pastikan permukaan kawalan bersifat peribadi, jalankan sebagai pengguna tanpa keistimewaan, gunakan firewall secara lalai, dan anggap hos sebagai mesin yang menjalankan kod yang tidak ditulis olehnya sendiri. Untuk melihat perbandingan kelima-lima ejen secara bersebelahan, lihat ejen AI self-hosted terbaik pada tahun 2026.

Konsep asas bagi mana-mana ejen ini terdapat dalam membina ejen AI anda sendiri pada VPS, dan Dify merupakan satu lagi platform self-hostable yang wajar dibandingkan.

FAQ

Adakah selamat untuk melakukan self-host pada Agent Zero?

Selamat, jika anda memastikan Web UI-nya kekal peribadi dan mengeraskan (harden) hos tersebut. Agent Zero menjalankan kod, pelayar, dan shell, serta dikawal daripada Web UI pada mana-mana port hos yang anda terbitkan. Oleh itu, bahayanya terletak pada antara muka yang terdedah, bukan pada rangka kerja itu sendiri. Ikat (bind) UI tersebut kepada loopback dan aksesnya melalui SSH atau VPN, tetapkan log masuk dan kata laluan UI, letakkan firewall dengan polisi default-deny di hadapan, dan jalankannya sebagai pengguna tanpa keistimewaan (unprivileged user).

Adakah Agent Zero mendedahkan Web UI ke internet secara lalai?

Arahan docker run yang didokumentasikan menerbitkan antara muka tanpa alamat (README menggunakan -p 80:80), dan pemetaan seperti itu mendengar pada setiap antara muka rangkaian. Pada VPS awam, ini bermakna ia boleh dicapai dari internet sebaik sahaja kontena bermula. UFW tidak menghalangnya kerana Docker menghalakan port yang diterbitkan melangkaui firewall tersebut. Tambahkan 127.0.0.1 pada alamat yang diterbitkan supaya UI hanya mendengar pada loopback, kemudian aksesnya melalui terowong SSH atau VPN.

Bolehkah Agent Zero dijalankan pada VPS kecil?

Boleh. Agent Zero berjalan di mana-mana sahaja Docker berjalan, termasuk VPS yang kecil dan murah, walaupun tugas yang lebih berat dan model tempatan yang lebih besar memerlukan lebih banyak memori. Jika anda menghalakannya kepada model yang di-host sendiri dan bukannya API yang di-host, sesuaikan saiz pelayan untuk model tersebut, bukan sekadar untuk Agent Zero.

Bagaimanakah perbezaan Agent Zero dengan OpenClaw atau Hermes?

Fungsinya bertindih tetapi mempunyai matlamat yang berbeza. Agent Zero ialah rangka kerja yang mengutamakan Docker, dibina di sekitar ejen utama yang melahirkan ejen bawahan di dalam kontena, dan dipacu daripada Web UI. OpenClaw dan Hermes ialah pembantu peribadi yang anda akses melalui aplikasi sembang. Postur keselamatan adalah sama bagi kesemuanya: pastikan permukaan kawalan kekal peribadi dan keraskan hos anda.