Bác sĩ chẩn đoán kết nối Remote Desktop Windows
Chẩn đoán và sửa lỗi chậm, treo hoặc không kết nối được của Windows App (Remote Desktop/AVD/W365/PC trực tiếp) trên macOS bằng bằng chứng log và giao thức truyền tải.
Tiện íchTrung cấp★ 1,323⑂ 212Điểm AI 8/10Cập nhật lần cuối: 8 thg 8, 2026
Làm được gì
Kỹ năng dẫn dắt quy trình chẩn đoán từng bước cho các sự cố kết nối Windows App (Microsoft Remote Desktop cũ) trên macOS tới Azure Virtual Desktop, Windows 365 hoặc PC cá nhân.
- Xác định giao thức truyền tải: đang dùng UDP Shortpath hay đã rơi về WebSocket/TCP qua gateway
- Thu thập bằng chứng mạng:
ifconfig,netstat -rn,scutil --proxy,lsofđể phát hiện VPN/proxy TUN (utun, IP nguồn 198.18.0.x) - Phân tích log Windows App trong
~/Library/Containers/com.microsoft.rdc.macos/..., gom sự kiện theo GUID phiên và tìm dấu hiệu nhưFetchClientOptions timeout, lỗi xác thực chứng chỉ,OneAuthError_InteractionRequired - Phân loại nguyên nhân A–F: proxy/VPN chặn, ISP chặn UDP, health check thất bại, host pool chưa bật Shortpath, tài khoản Microsoft work/school hết hạn làm treo hộp thoại, PC khởi động lại do Windows Update
- Dùng
scripts/probe_rdp_server.pyđể kiểm tra RDP + TLS của máy đích mà không cần mật khẩu
Dành cho ai
- Người dùng Mac làm việc trên VDI công ty (AVD/W365) bị lag nặng
- Người làm việc từ xa kết nối về PC nhà và bị treo ở "Configuring remote PC..."
- Người thường bật Clash/ShadowRocket/Tailscale song song khi làm việc
- Nhân viên IT helpdesk cần chứng minh nguyên nhân bằng log thay vì đoán
Ví dụ sử dụng
- "Connection Info hiện WebSocket, RTT 165ms" → kỹ năng kiểm tra route utun và log STUN/TURN, đề xuất thêm luật
DOMAIN-SUFFIX,wvd.microsoft.com,DIRECTcho proxy rồi xác nhận lại bằnglsof -i UDP. - "Kết nối tới PC nhà treo mãi ở Configuring remote PC" → chạy probe chứng minh cổng 3389 vẫn sống, rồi dựa vào
UserCancelled(8)và "no valid refresh tokens" để hướng dẫn xoá tài khoản Microsoft hết hạn trong Settings → Accounts và khởi động lại app. - "Phiên đang dùng thì đứt và không vào lại được" → đối chiếu
CMSTATE_DROPPEDvớiLastBootUpTimevà Event ID 1074 để kết luận Windows Update tự khởi động lại, kèm cách đặt active hours.
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục windows-remote-desktop-connection-doctor từ repo GitHub daymade/claude-code-skills vào ~/.claude/skills/windows-remote-desktop-connection-doctor/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/windows-remote-desktop-connection-doctor ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở Terminal trên máy Mac.
- Tải repo:
git clone https://github.com/daymade/claude-code-skills.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép kỹ năng:
cp -r claude-code-skills/windows-remote-desktop-connection-doctor ~/.claude/skills/ - Kiểm tra:
ls ~/.claude/skills/windows-remote-desktop-connection-doctorphải thấy SKILL.md, scripts, references. - Khởi động lại Claude Code và yêu cầu ví dụ: "Kết nối Windows App của tôi rất chậm, hãy chẩn đoán giúp".
- Đảm bảo máy có
python3(macOS thường có sẵn hoặc cài Xcode Command Line Tools) để chạypython3 scripts/probe_rdp_server.py <host> 3389.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT