Operasi dan troubleshooting

Tujuan

Menyediakan perintah operasi umum setelah deployment, metode health check, dan jalur pemeriksaan masalah tipikal.

Perintah umum

cd $INSTALL_PATH
docker compose ps
docker compose logs --tail 200 --follow
docker compose down
docker compose up -d

Melihat log aplikasi:

tail -n 200 $INSTALL_PATH/logs/app/app.log

Memperbarui data lokasi geografis:

bash update_geolite2.sh

Health check

Objek	Perintah atau pintu masuk	Hasil normal
Status container	docker compose ps	Layanan kunci running/up
Kesehatan aplikasi	https://<APP_DOMAIN>/status/health	Mengembalikan status sehat
Konsol admin	/admin/login	Halaman login dapat dibuka
Portal pengguna	/app/login	Halaman login dapat dibuka
HTTPS	Address bar browser	Sertifikat valid atau sesuai strategi self-signed intranet
Resource replay	/__replay__/...	Resource enterprise dapat dimuat

Masalah tipikal

Gejala	Kemungkinan penyebab	Saran penanganan
Halaman tidak bisa dibuka	Domain belum resolve, port belum terbuka, Caddy belum berjalan	Periksa DNS, 80/443, firewall, dan log container
Admin tidak bisa login	Kata sandi salah, inisialisasi belum selesai, cache browser	Gunakan kata sandi system saat instalasi, periksa log aplikasi
Pengguna tidak melihat situs	Grup belum diotorisasi, situs dinonaktifkan, kategori kosong	Periksa otorisasi situs SaaS pada grup dan status situs
Pengguna tidak melihat workspace	Grup belum diberi workspace	Tambahkan otorisasi di manajemen workspace grup
Login situs abnormal	Kategori akun, skrip, atau strategi situs target berubah	Periksa konfigurasi situs, konfigurasi kategori akun, dan URL pencocokan skrip
Sertifikat otomatis gagal	Domain tidak mengarah ke IP publik atau port tidak terbuka	Pastikan resolusi domain dan rule masuk 80/443
Replay tidak tersedia	Deployment bukan full atau resource object storage tidak dapat dijangkau	Periksa lisensi, tipe deployment, dan resource /__replay__/

Saran perubahan

• Sebelum mengubah skrip situs, plugin, proxy, atau workspace, catat konfigurasi lama.
• Sebelum upgrade besar, backup $INSTALL_PATH/volumes, $INSTALL_PATH/logs, dan data database.
• Sebelum membagikan tautan kolaborasi eksternal, buka lengkap satu kali dengan pengguna uji tanpa privilege.
• Setelah skrip diaktifkan pada situs produksi, minta tim bisnis melakukan validasi login dan halaman penting.