Chuyển đến nội dung chính

Khắc phục sự cố Muddog

Trước tiên, trên màn hình Kết nối, xác định sự cố nằm ở Kết nối VPN của bạn hay Chia sẻ Internet của tôi. Nguyên nhân được hiển thị trong Chi tiết kết nối của từng mục hoặc Chi tiết lỗi trong thông báo lỗi.

Triệu chứngNội dung cần kiểm tra
Không thể kết nối với dịch vụTrạng thái và quyền truy cập dịch vụ
Danh sách quốc gia trống hoặc kết nối thất bạiQuốc gia và kết nối với đối tác
Đã kết nối nhưng IP không đổi hoặc không truy cập đượcPhạm vi VPN và lưu lượng
Không nhấn được nút khởi chạy hoặc VPN không áp dụng cho một số ứng dụngVPN theo ứng dụng
Lỗi cho biết dịch vụ không hỗ trợ tính năngPhiên bản ứng dụng và dịch vụ
Chỉ chia sẻ Internet của tôi bị lỗiChia sẻ và lưu nhật ký

Không thể kết nối với dịch vụ​

Ứng dụng đọc trạng thái của dịch vụ nền và hiển thị trên màn hình. Thông báo này có nghĩa là ứng dụng không thể kiểm tra trạng thái, không có nghĩa là VPN hoặc việc chia sẻ chắc chắn đã tắt.

Khi dịch vụ hoạt động bình thường trở lại, ứng dụng tự động kết nối lại. Hãy kiểm tra trạng thái và quyền phù hợp với hệ điều hành theo hướng dẫn dưới đây. Chia sẻ Internet cũng bắt đầu khi dịch vụ khởi chạy.

Linux​

  1. Nếu vừa cài đặt, hãy đăng xuất khỏi phiên desktop, đăng nhập lại rồi mở ứng dụng.

  2. Kiểm tra trạng thái dịch vụ trong terminal.

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

  3. Nếu dịch vụ đang dừng và bạn muốn sử dụng lại VPN và chia sẻ, hãy khởi chạy dịch vụ. Chia sẻ Internet cũng tiếp tục khi dịch vụ khởi chạy.

    sudo systemctl start muddog-engine.service

  4. Nếu dịch vụ đang chạy nhưng ứng dụng không truy cập được, chạy id -nG trong terminal của tài khoản sử dụng ứng dụng để kiểm tra có nhóm muddog hay không.

Nếu chưa có nhóm do quản trị viên cài đặt bằng tài khoản khác, hãy chạy lệnh sau trong terminal đăng nhập bằng tài khoản người dùng thông thường sẽ sử dụng ứng dụng. Sau đó phải đăng xuất khỏi phiên desktop rồi đăng nhập lại.

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

Không dùng cách chạy ứng dụng với quyền quản trị viên để thay thế bước này. Nếu bản thân dịch vụ không khởi chạy được, bạn có thể kiểm tra các lỗi gần đây bằng lệnh sau.

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

Windows​

Kiểm tra trạng thái dịch vụ trong PowerShell.

Get-Service -Name muddog-engine

Nếu dịch vụ đang dừng, khởi chạy trong PowerShell được mở bằng quyền quản trị viên.

Start-Service -Name muddog-engine

Nếu đã vô hiệu hóa dịch vụ, làm theo cách bật lại tự khởi chạy. Nếu dịch vụ không tồn tại hoặc thiếu tệp cần thiết, cài đặt hoặc sửa chữa bằng MSI mới nhất. Chạy ứng dụng bằng quyền người dùng thông thường.

macOS​

  1. Kiểm tra máy đang dùng macOS 13 trở lên và Muddog.app đã được sao chép vào /Applications.
  2. Kiểm tra tài khoản đang đăng nhập là tài khoản quản trị viên macOS.
  3. Chọn Service → Enable Background Service để yêu cầu đăng ký dịch vụ.
  4. Trong Service → Background Service Settings…, cho phép Muddog chạy nền. Sau khi cấp phép, chờ ứng dụng kết nối lại với dịch vụ.

Bạn cũng có thể kiểm tra trạng thái dịch vụ đã đăng ký trong terminal.

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

Không thể đăng ký dịch vụ nếu chạy ứng dụng từ DMG hoặc thư mục khác. Nếu có sự cố sau khi thay ứng dụng cũ, làm theo quy trình cập nhật macOS để gỡ dịch vụ rồi chạy lại ứng dụng.

Nếu vẫn thất bại sau các bước trên, hãy đưa nội dung lỗi dịch vụ vào báo cáo sự cố.

Danh sách quốc gia trống hoặc kết nối thất bại​

  1. Kiểm tra kết nối Internet thông thường có hoạt động hay không.
  2. Nhấn Quốc gia kết nối → Làm mới danh sách.
  3. Nếu quốc gia đã chọn không còn trong danh sách, kết nối bằng Tự động chọn hoặc chọn quốc gia khác.
  4. Nếu từng thay đổi máy chủ kết nối, hãy khôi phục giá trị mặc định trong cài đặt nâng cao rồi lưu.
  5. Nếu vẫn thất bại, kiểm tra Chi tiết kết nối.

Kết nối P2P chịu ảnh hưởng của người tham gia tại quốc gia đã chọn và tình trạng mạng của cả hai bên. Việc quốc gia xuất hiện trong danh sách không đảm bảo kết nối thành công. Nếu không có đối tác khả dụng, hãy thử lại sau hoặc chọn quốc gia khác. Để kiểm tra nguyên nhân có phải do hạn chế giao tiếp của tường lửa hay bộ định tuyến hay không, bạn có thể thử so sánh trên một đường truyền Internet khác sẵn có.

Tối đa 10 lần là giới hạn số lần thử kết nối. Quá trình có thể kết thúc sớm hơn nếu không tìm được đối tác; nếu VPN đã kết nối bị ngắt, bạn phải tự kết nối lại.

Đã kết nối nhưng IP không đổi hoặc không truy cập được​

  1. Kiểm tra Kết nối → Phạm vi kết nối hiện tại có đúng chế độ mong muốn hay không. Nếu chỉ lưu cài đặt mà chưa kết nối lại, phạm vi cũ vẫn được áp dụng.
  2. Với chế độ IP/dải địa chỉ, kiểm tra IP đích muốn truy cập có được bao gồm hoặc loại trừ trong danh sách hay không. Không thể nhập tên miền vào danh sách địa chỉ.
  3. Với chế độ theo ứng dụng, thoát hoàn toàn ứng dụng rồi khởi chạy lại từ Muddog.
  4. Kiểm tra kết nối đang thử có dùng IPv6 hay không. IPv6 không đi qua VPN; chế độ theo ứng dụng trên Windows chặn lưu lượng IPv6 của ứng dụng được chọn.
  5. Nếu đang dùng VPN hoặc công cụ quản lý mạng khác cùng lúc, hãy thử so sánh khi đã ngắt kết nối đó. Tuyến do công cụ khác thiết lập có thể được ưu tiên áp dụng.

Nếu trình duyệt hoặc trang kiểm tra IP không thuộc phạm vi VPN, việc thấy IP của đường truyền hiện có là bình thường. DNS cũng có thể sử dụng đường truyền hiện có tùy chế độ đang dùng và IP của máy chủ DNS.

Nếu một trang web vẫn hạn chế truy cập theo quốc gia, hãy thử quốc gia hoặc đối tác kết nối khác. Muddog không đảm bảo dịch vụ đó sẽ cho phép truy cập hay đảm bảo một mức tốc độ cụ thể.

Trên macOS, nếu đã đổi đường truyền đang dùng, chẳng hạn Wi-Fi, hãy ngắt VPN rồi kết nối lại. Nếu chế độ bao gồm IP báo lỗi xung đột với tuyến đến máy đích do chương trình khác thiết lập, hãy kiểm tra kết nối của chương trình đó và IP/dải địa chỉ đã chỉ định.

VPN theo ứng dụng không được áp dụng​

  • macOS không hỗ trợ VPN theo ứng dụng. Hãy dùng chế độ toàn bộ Internet hoặc IP/dải địa chỉ.
  • Nếu Chạy qua VPN bị vô hiệu hóa, kiểm tra đã lưu chế độ theo ứng dụng, đã kết nối VPN bằng chế độ đó và đã chọn ứng dụng cần chạy hay chưa.
  • Nếu danh sách ứng dụng trống, dùng Làm mới danh sách hoặc Tìm tệp thực thi.
  • Nếu trình duyệt chỉ mở lại cửa sổ hiện có, hãy dừng cả tiến trình nền rồi khởi chạy lại.
  • Không hỗ trợ ứng dụng chuyển việc khởi chạy cho dịch vụ riêng hoặc tái sử dụng một phiên bản ứng dụng đang chạy. Kiểm tra cách cài đặt và điều kiện sử dụng VPN theo ứng dụng.
  • Trên Linux, không hỗ trợ ứng dụng Snap/Flatpak. Nếu lỗi liên quan đến phiên người dùng systemd, cgroup v2 hoặc nftables, hãy kiểm tra môi trường tương ứng và đưa Chi tiết lỗi vào báo cáo sự cố.
  • Trên Windows, phải chọn tệp .exe cần chạy; sau khi kết nối lại VPN, phải thoát hoàn toàn chương trình rồi khởi chạy lại từ Muddog.
  • Nếu Windows báo lỗi thiếu hoặc không tải được thành phần WinDivert, hãy sửa chữa hoặc cài đặt lại bằng MSI. Nếu vẫn thất bại, hãy báo cáo Chi tiết lỗi.

Phiên bản ứng dụng và dịch vụ không khớp​

Kết nối với dịch vụ cũ không hỗ trợ tính năng mà ứng dụng yêu cầu sẽ gây lỗi. Hãy cập nhật cả ứng dụng và dịch vụ bằng gói mới. Việc không dùng được VPN theo ứng dụng trên macOS là do phạm vi hỗ trợ, không phải lỗi phiên bản.

Nếu đã cập nhật mà vẫn gặp lỗi, khởi động lại dịch vụ theo cách phù hợp với hệ điều hành. Khởi động lại sẽ ngắt các kết nối VPN cá nhân và chia sẻ đang hoạt động.

Trên Linux, đóng ứng dụng, chạy lệnh sau rồi mở lại ứng dụng.

sudo systemctl restart muddog-engine.service

Trên Windows, đóng ứng dụng, chạy lệnh sau trong PowerShell với quyền quản trị viên rồi mở lại ứng dụng.

Restart-Service -Name muddog-engine

Trên macOS, chọn Service → Remove Background Service and Quit, sau đó chạy lại Muddog trong /Applications và hoàn tất việc cấp phép dịch vụ nếu cần.

Sau khi khởi động lại dịch vụ, bạn phải kết nối lại VPN. Nếu lỗi tiếp diễn, hãy tổng hợp phiên bản ứng dụng và chi tiết lỗi để báo cáo thay vì liên tục khởi động lại.

Chỉ chia sẻ Internet bị lỗi hoặc không đọc được nhật ký​

Trước tiên, kiểm tra Chia sẻ Internet của tôi → Chi tiết kết nối. Chia sẻ sẽ dừng nếu thiếu dung lượng lưu nhật ký, vượt giới hạn lưu trữ hoặc xảy ra lỗi ghi tệp. Nhật ký được lưu theo cơ chế lưu giữ cục bộ.

Kiểm tra dung lượng đĩa và nhật ký dịch vụ. Nếu cần giữ các nhật ký đang lưu, đừng tùy tiện xóa chỉ để làm hết lỗi; hãy yêu cầu hỗ trợ kèm thông báo lỗi.

Nếu chỉ việc tra cứu nhật ký bị lỗi, kiểm tra quyền truy cập và phiên bản dịch vụ. Nếu nội dung thay đổi trong lúc tra cứu do nhật ký theo ngày được dọn dẹp, chọn lại ngày và điều kiện rồi nhấn Tra cứu. Nếu tra cứu thành công nhưng kết quả trống, hãy kiểm tra ngày UTC, bộ lọc và Nhật ký tiếp theo.