Khắc phục lỗi 'GitHub Copilot Could Not Connect to Server' trong VS Code

Vấn đềSự cố này thường xảy ra ngay khi bạn đang tập trung làm việc. Bạn đang viết dở một hàm phức tạp, nhưng đoạn văn bản gợi ý (ghost text) ngừng xuất hiện. Bạn liếc nhìn thanh trạng thái và thấy biểu tượng GitHub Copilot đã chuyển sang màu đỏ. Một thông báo xác nhận sự khó chịu này: GitHub Copilot could not connect to server.

Lỗi này không phải là lỗi của chính AI. Thay vào đó, nó là sự cố đứt gãy trong 'hệ thống đường ống' giữa máy cục bộ của bạn và API của GitHub. Nếu bạn đang làm việc trong mạng doanh nghiệp sử dụng VPN, tường lửa hoặc công cụ kiểm tra SSL như Zscaler, kết nối của bạn có khả năng đang bị chặn hoặc can thiệp.

Cách gỡ lỗi kết nốiĐừng vội lãng phí thời gian cài đặt lại tiện ích mở rộng. Trước tiên, chúng ta cần xem chính xác lý do tại sao quá trình bắt tay (handshake) không thành công. Hầu hết các lần mất kết nối đều để lại dấu vết cụ thể trong nhật ký (logs).

1. Kiểm tra nhật ký đầu ra (Output Logs)Nhấn Ctrl+Shift+U (hoặc Cmd+Shift+U trên Mac) để mở bảng Output. Chọn GitHub Copilot từ menu thả xuống. Bạn hãy tìm các mã chẩn đoán cụ thể sau:

• ECONNRESET: Tường lửa hoặc proxy đã buộc đóng kết nối.- ETIMEDOUT: Yêu cầu đã quá thời gian chờ, thường có nghĩa là một cổng (gateway) đang âm thầm loại bỏ các gói tin.- self signed certificate in certificate chain: Công ty của bạn đang sử dụng kiểm tra SSL và Copilot không tin tưởng chứng chỉ cục bộ của họ.- 407 Proxy Authentication Required: Proxy của bạn đang dừng yêu cầu vì nó cần thông tin đăng nhập của bạn.### 2. Xác minh khả năng truy cập mạngKiểm tra xem máy của bạn có thể giao tiếp với gateway của Copilot hay không. Mở terminal và chạy lệnh sau:

curl -I https://copilot-proxy.githubusercontent.com/_ping

Một kết nối ổn định sẽ trả về HTTP/2 200. Nếu bạn nhận được lỗi 403 hoặc thông báo 'Could not resolve host', việc chặn đang xảy ra ở cấp độ mạng chứ không phải bên trong VS Code.

Các giải pháp hiệu quả### Giải pháp 1: Cấu hình Proxy thủ côngVS Code cố gắng kế thừa cài đặt proxy từ hệ điều hành, nhưng nó thường không truyền được các cài đặt này cho tiện ích mở rộng Copilot. Bạn có thể ép buộc kết nối bằng cách xác định rõ ràng proxy của mình trong settings.json.

{
  "http.proxy": "http://ten_dang_nhap:mat_khau@proxy.congtycua-ban.com:8080",
  "http.proxyStrictSSL": true,
  "http.proxySupport": "on"
}

Nếu văn phòng của bạn sử dụng proxy trong suốt (transparent proxy) không yêu cầu đăng nhập, hãy thử đặt "http.proxySupport": "fallback" thay thế.

Giải pháp 2: Khắc phục lỗi chứng chỉ SSLNhiều mạng doanh nghiệp sử dụng proxy 'Man-in-the-Middle' (MITM) để quét lưu lượng truy cập được mã hóa. Vì Copilot chạy trên Node.js, theo mặc định, nó bỏ qua kho chứng chỉ hệ thống của Windows hoặc macOS.

Cách nhanh chóng (ít an toàn hơn): Đặt "http.proxyStrictSSL": false trong cài đặt VS Code của bạn. Điều này ngăn Copilot xác minh chuỗi SSL. Cách chuyên nghiệp: Trỏ Node.js đến chứng chỉ Root CA của công ty bạn. Xuất chứng chỉ doanh nghiệp của bạn dưới dạng tệp .pem và thiết lập biến môi trường:

# Windows (PowerShell)
$env:NODE_EXTRA_CA_CERTS="C:\Users\Admin\Certs\CompanyCA.pem"

# macOS/Linux
export NODE_EXTRA_CA_CERTS="/Users/ten/certs/CompanyCA.pem"

Giải pháp 3: Làm mới Token của bạnĐôi khi kết nối vẫn ổn, nhưng phiên làm việc của bạn đã hết hạn. Điều này thường xảy ra nếu bạn không sử dụng IDE trong vài ngày.

• Nhấp vào biểu tượng Accounts ở góc dưới bên trái.- Đăng xuất khỏi tài khoản GitHub của bạn.- Khởi động lại VS Code hoàn toàn.- Nhấp vào biểu tượng Copilot và đăng nhập lại.### Giải pháp 4: Quy tắc tường lửa cho quản trị viên ITNếu bạn có quyền truy cập vào tường lửa mạng hoặc cần gửi yêu cầu cho bộ phận IT, hãy đảm bảo bốn điểm cuối (endpoints) sau được đưa vào danh sách trắng (whitelist) trên Cổng 443:
• github.com- api.github.com- copilot-proxy.githubusercontent.com- origin-tracker.githubusercontent.com## Xác nhận khắc phục thành côngSau khi áp dụng các thay đổi này, hãy xác minh trạng thái bằng ba bước kiểm tra sau:
• Biểu tượng trạng thái: Biểu tượng Copilot phải ở trạng thái đặc (màu trắng, xanh lam hoặc xám) mà không có dấu 'X' màu đỏ.- Đoạn văn bản gợi ý: Mở một tệp .js hoặc .py mới và nhập // tính số ngày giữa hai ngày. Các gợi ý sẽ xuất hiện trong vòng 1,5 giây.- Kiểm tra Ping: Nhật ký Output bây giờ sẽ hiển thị: [fetcher] Successfully reached https://copilot-proxy.githubusercontent.com/_ping.## Tổng kếtLỗi kết nối hiếm khi liên quan đến mã nguồn của AI. Chúng hầu như luôn liên quan đến cách môi trường Node.js cục bộ của bạn xử lý bảo mật mạng. Bằng cách cấu hình đúng NODE_EXTRA_CA_CERTS hoặc xác định rõ ràng http.proxy, bạn có thể giải quyết gần 95% các sự cố kết nối này. Hãy luôn cập nhật tiện ích mở rộng lên phiên bản mới nhất, vì GitHub thường xuyên phát hành các bản vá để xử lý proxy tốt hơn.