Pemecahan masalah Muddog

Periksa dahulu apakah masalah pada Koneksi VPN pribadi atau Berbagi internet saya di layar Koneksi. Penyebab ditampilkan pada Rincian koneksi masing-masing atau Rincian kesalahan dalam pemberitahuan.

Gejala	Yang diperiksa
Tidak dapat terhubung ke layanan	Status dan izin layanan
Daftar negara kosong atau koneksi gagal	Negara dan peserta tujuan
Terhubung tetapi IP sama atau akses gagal	Cakupan VPN dan lalu lintas
Tombol peluncuran tidak aktif atau aplikasi tertentu tidak memakai VPN	VPN per aplikasi
Layanan tidak mendukung fitur	Versi aplikasi dan layanan
Hanya berbagi internet yang gagal	Berbagi dan penyimpanan log

Tidak dapat terhubung ke layanan

Aplikasi membaca status layanan latar belakang untuk ditampilkan. Pesan ini berarti aplikasi tidak dapat memeriksa status, bukan kepastian bahwa VPN atau berbagi telah mati.

Aplikasi menyambung ulang otomatis setelah layanan pulih. Periksa status dan izin sesuai platform di bawah. Memulai layanan juga memulai berbagi internet.

Linux

1. Jika baru memasang, keluar dari desktop lalu masuk kembali dan buka aplikasi.

2. Periksa status layanan di terminal.

   systemctl status muddog-engine.service --no-pager

3. Jika layanan berhenti dan Anda ingin memakai VPN serta berbagi kembali, mulai layanan. Berbagi juga dilanjutkan.

   sudo systemctl start muddog-engine.service

4. Jika layanan berjalan tetapi aplikasi tidak dapat mengaksesnya, jalankan id -nG dari terminal akun pengguna aplikasi dan pastikan grup muddog ada.

Jika administrator memasang dengan akun lain sehingga grup belum ditambahkan, jalankan berikut dari terminal yang masuk sebagai pengguna biasa yang akan memakai aplikasi. Setelahnya, keluar dari desktop lalu masuk kembali.

sudo usermod -aG muddog "$(id -un)"

Jangan menggantikannya dengan menjalankan aplikasi sebagai administrator. Jika layanan sendiri tidak dimulai, periksa kesalahan terbaru:

sudo journalctl -u muddog-engine.service -n 100 --no-pager

Windows

Periksa status di PowerShell:

Get-Service -Name muddog-engine

Jika berhenti, mulai dari PowerShell sebagai administrator:

Start-Service -Name muddog-engine

Jika layanan dinonaktifkan, ikuti Mengaktifkan kembali mulai otomatis. Jika layanan atau berkas yang diperlukan tidak ada, pasang atau perbaiki dengan MSI terbaru. Jalankan aplikasi sebagai pengguna biasa.

macOS

1. Pastikan macOS 13 atau lebih baru dan Muddog.app sudah disalin ke /Applications.
2. Pastikan akun saat ini administrator macOS.
3. Pilih Service → Enable Background Service untuk meminta pendaftaran layanan.
4. Izinkan layanan latar belakang melalui Service → Background Service Settings…, lalu tunggu aplikasi tersambung kembali.

Status layanan terdaftar juga dapat diperiksa melalui terminal:

sudo launchctl print system/net.3rocks.muddog.engine

Aplikasi tidak dapat mendaftarkan layanan jika dijalankan dari DMG atau folder lain. Jika masalah muncul setelah mengganti aplikasi, hapus layanan lalu jalankan aplikasi kembali sesuai Prosedur pembaruan macOS.

Jika masih gagal, sertakan kesalahan layanan dalam Laporan masalah.

Daftar negara kosong atau koneksi gagal

1. Pastikan internet biasa berfungsi.
2. Tekan Negara koneksi → Muat ulang daftar.
3. Jika negara terpilih hilang, gunakan Pilih otomatis atau negara lain.
4. Jika pernah mengubah server koneksi, pulihkan dan simpan Bawaan pengaturan lanjutan.
5. Jika tetap gagal, periksa Rincian koneksi.

Koneksi P2P bergantung pada peserta di negara terpilih dan jaringan kedua sisi. Negara yang tercantum tidak menjamin koneksi. Jika tidak ada peserta tersedia, coba lagi nanti atau pilih negara lain. Bandingkan dengan koneksi internet lain jika tersedia untuk mengetahui apakah firewall atau pembatasan router menjadi penyebab.

Maksimum 10 adalah batas percobaan koneksi. Proses dapat berhenti lebih awal jika peserta tidak ditemukan. VPN yang sudah terhubung lalu terputus harus disambungkan ulang secara manual.

Terhubung tetapi IP sama atau akses gagal

1. Pastikan Koneksi → Cakupan koneksi saat ini sesuai keinginan. Jika hanya menyimpan tanpa menyambung ulang, cakupan lama tetap berlaku.
2. Pada mode IP/rentang, periksa apakah IP tujuan termasuk atau dikecualikan. Nama domain tidak dapat dimasukkan ke daftar alamat.
3. Pada mode per aplikasi, tutup aplikasi sepenuhnya dan jalankan kembali dari Muddog.
4. Periksa apakah koneksi memakai IPv6. IPv6 tidak melalui VPN; mode per aplikasi Windows memblokir IPv6 aplikasi terpilih.
5. Jika memakai VPN atau alat pengelola jaringan lain, bandingkan setelah memutuskan koneksi alat tersebut. Rute yang dibuatnya dapat lebih diutamakan.

Jika browser atau halaman pemeriksa IP tidak termasuk cakupan VPN, tampilnya IP asli adalah normal. DNS juga dapat memakai koneksi asli sesuai mode dan IP server DNS.

Jika pembatasan negara situs tetap berlaku, coba negara atau peserta tujuan lain. Muddog tidak menjamin izin akses layanan atau kecepatan tertentu.

Pada macOS, jika mengganti koneksi seperti Wi-Fi, putuskan VPN lalu hubungkan kembali. Jika mode penyertaan IP melaporkan konflik dengan rute host program lain, periksa koneksi program itu serta IP/rentang yang ditentukan.

VPN per aplikasi tidak diterapkan

• macOS tidak mendukung VPN per aplikasi. Gunakan seluruh internet atau IP/rentang.
• Jika Jalankan melalui VPN tidak aktif, pastikan mode per aplikasi sudah disimpan, VPN tersambung dalam mode tersebut, dan aplikasi sasaran dipilih.
• Jika daftar aplikasi kosong, gunakan Muat ulang daftar atau Cari executable.
• Jika browser hanya membuka ulang jendela lama, hentikan juga proses latar belakang sebelum menjalankannya.
• Aplikasi yang menyerahkan peluncuran ke layanan terpisah atau memakai ulang instans lama tidak didukung. Periksa cara pemasangan dan Persyaratan VPN per aplikasi.
• Snap/Flatpak tidak didukung di Linux. Untuk kesalahan sesi pengguna systemd, cgroup v2, atau nftables, periksa lingkungan dan sertakan Rincian kesalahan dalam Laporan masalah.
• Pada Windows, pilih .exe. Setelah VPN tersambung ulang, tutup program sepenuhnya dan jalankan kembali dari Muddog.
• Jika komponen WinDivert hilang atau gagal dimuat pada Windows, perbaiki atau pasang ulang melalui MSI. Laporkan Rincian kesalahan jika tetap gagal.

Versi aplikasi dan layanan berbeda

Kesalahan terjadi jika aplikasi terhubung ke layanan lama yang tidak mendukung fitur yang diminta. Perbarui aplikasi dan layanan bersama melalui paket baru. Tidak tersedianya VPN per aplikasi pada macOS adalah perbedaan dukungan, bukan kesalahan versi.

Jika sudah diperbarui tetapi kesalahan tetap muncul, mulai ulang layanan sesuai platform. Ini memutuskan VPN pribadi dan koneksi berbagi yang sedang berjalan.

Pada Linux, tutup aplikasi, jalankan berikut, lalu buka kembali:

sudo systemctl restart muddog-engine.service

Pada Windows, tutup aplikasi, jalankan di PowerShell administrator, lalu buka kembali:

Restart-Service -Name muddog-engine

Pada macOS, pilih Service → Remove Background Service and Quit, jalankan kembali Muddog dari /Applications, dan selesaikan persetujuan layanan.

Setelah layanan dimulai ulang, hubungkan VPN lagi. Jika kesalahan berlanjut, laporkan versi aplikasi dan rinciannya daripada terus mengulang restart.

Hanya berbagi internet yang gagal atau log tidak dapat dibaca

Periksa Berbagi internet saya → Rincian koneksi dahulu. Kekurangan ruang, batas penyimpanan terlampaui, atau kesalahan penulisan log menghentikan berbagi. Log disimpan sesuai Ketentuan penyimpanan lokal.

Periksa ruang disk dan log layanan. Jika log masih diperlukan, jangan menghapusnya sembarangan untuk menghilangkan kesalahan; minta dukungan dengan pesan kesalahan.

Jika hanya pencarian log yang gagal, periksa izin dan versi layanan. Jika pembersihan log harian mengubah data selama pencarian, pilih ulang tanggal/filter lalu Cari. Jika pencarian berhasil tetapi kosong, periksa tanggal UTC, filter, dan Log berikutnya.