Cấu hình Proxy cho Git HTTPS nên bắt đầu bằng một phép kiểm tra nhỏ, thay vì đổi thiết lập cho toàn bộ máy. Cách này giúp bạn biết lỗi nằm ở kết nối, xác thực hay chứng chỉ trước khi tải mã nguồn về.
Nếu cần một tuyến kết nối riêng cho công việc được phép, bạn có thể tham khảo Proxy dân cư ProxySmart. Hãy kiểm tra giao thức và cơ chế xác thực của endpoint thực tế; không suy ra cấu hình Git từ việc trình duyệt đã dùng proxy thành công.
1. Xác định Git HTTPS hay SSH
Hướng dẫn này dành cho remote dạng https://git.example/team/repo.git. Remote dạng ssh://git.example/team/repo.git dùng SSH và cần hướng dẫn riêng. Không xem http.proxy là thiết lập chuyển mọi kết nối Git qua proxy.
Trong repository đang làm việc, bạn có thể xem URL bằng git remote get-url origin. Chỉ xem kết quả tại máy, vì URL cũ có thể chứa tên đăng nhập hoặc token. Nếu phát hiện bí mật trong URL, ngừng chia sẻ ảnh chụp và xử lý theo quy trình thu hồi của đơn vị.
Đừng đổi remote từ SSH sang HTTPS chỉ để làm theo ví dụ khi chưa xác nhận quyền truy cập. Việc chọn giao thức phải phù hợp với chính sách của tổ chức, cách đăng nhập và công cụ phát triển đang sử dụng.
2. Chuẩn bị endpoint và phạm vi thử
Chuẩn bị host, cổng, loại proxy, thời hạn gói và cách xác thực. Toàn bộ địa chỉ có đuôi .example dưới đây là chỗ giữ chỗ; phải thay bằng endpoint được cấp và repository bạn có quyền truy cập, không chạy nguyên mẫu.
http://proxy.example:8080 mô tả kết nối tới HTTP proxy, không phải giao thức của repository. Với repository HTTPS, HTTP proxy thường dùng đường hầm CONNECT. Đừng tự đổi tiền tố thành https:// nếu nhà cung cấp không cấp HTTPS proxy. Tài liệu libcurl về proxy URI phân biệt các loại này.
TLS của repository bảo vệ dữ liệu HTTPS bên trong đường hầm, nhưng không tự bọc thêm TLS cho kết nối tới HTTP proxy. Thông tin xác thực gửi tới proxy là lớp riêng, cần được bảo vệ theo phương thức thực tế; không truyền bí mật trên mạng không tin cậy chỉ vì URL repository có HTTPS.
Với SOCKS5, lựa chọn socks5h:// yêu cầu proxy phân giải tên đích. Khả năng sử dụng còn phụ thuộc Git/libcurl của client. Bài dùng Proxy với cURL và Python giúp đối chiếu giao thức, nhưng kết quả từ công cụ khác không thay cho kiểm tra Git.
3. Kiểm tra từng lệnh trước khi lưu
Tùy chọn -c áp dụng cấu hình cho lần gọi Git hiện tại, theo tài liệu dòng lệnh Git. Bắt đầu với repository thử nghiệm không chứa dữ liệu nhạy cảm, trong môi trường đã được phép dùng proxy.
git -c http.proxy=http://proxy.example:8080 ls-remote https://git.example/team/repo.git HEADgit ls-remote đọc tham chiếu từ remote, không clone mã nguồn hay cập nhật nhánh làm việc. Nó vẫn tạo kết nối mạng và có thể yêu cầu đăng nhập; không phải phép thử ngoại tuyến hoặc bằng chứng rằng mọi thao tác sau đó đều thành công.
Nếu proxy yêu cầu xác thực, mẫu không có thông tin đăng nhập có thể trả lỗi 407. Đó không phải lý do đưa mật khẩu vào câu lệnh. Dừng bằng Ctrl+C nếu thao tác treo, ghi nhận thời điểm và thông báo đã che dữ liệu rồi kiểm tra nguyên nhân.
4. Áp dụng cho clone và fetch
Sau khi phép kiểm tra nhỏ đạt, bạn mới cân nhắc lệnh tải dữ liệu. git clone tạo repository cục bộ. Chọn một thư mục đích mới, kiểm tra dung lượng và tránh dùng tên trùng với thư mục công việc đang có.
git -c http.proxy=http://proxy.example:8080 clone https://git.example/team/repo.git repo-testTrong repository đã tồn tại, git fetch tải dữ liệu và cập nhật thông tin tham chiếu cục bộ. Đây là thao tác ghi lên máy, khác với kiểm tra tham chiếu ở bước trước. Xem đúng thư mục, đúng origin và lưu công việc đang làm trước khi chạy.
git -c http.proxy=http://proxy.example:8080 fetch originKhông thêm push, reset hay thay đổi nhánh vào một lượt kiểm tra mạng. Submodule, Git LFS và trình quản lý gói có thể có endpoint hoặc client riêng; kiểm tra từng thành phần nếu dự án cần, thay vì kết luận chỉ từ một lần clone.
5. Tìm cấu hình đang có hiệu lực
Git có thiết lập theo nguồn và theo URL. Dùng truy vấn đọc sau để xem giá trị khớp remote; phiên bản Git cũ có thể cần cú pháp tương ứng trong trợ giúp cài sẵn.
git config get --show-origin --show-scope --url=https://git.example/team/repo.git http.proxyĐầu ra có thể chứa bí mật cũ, nên không gửi nguyên văn. Không có kết quả chưa chứng minh đang đi trực tiếp: còn phải xem biến môi trường và cấu hình riêng cho remote. Cấu hình theo URL cũng có thể khiến một mẫu http.proxy chung chưa đạt ý định.
Đối chiếu git-config: proxy, phạm vi URL và nguồn cấu hình trước khi lưu thiết lập. Đừng đặt --global mặc định cho mọi dự án, hoặc xóa hàng loạt cấu hình của công ty để thử. Chọn phạm vi nhỏ nhất cần thiết và ghi lại cách khôi phục giá trị cũ.
6. Tách riêng hai lớp xác thực
Tài khoản proxy và tài khoản máy chủ Git là hai lớp khác nhau. Đăng nhập được một lớp không có nghĩa lớp còn lại hợp lệ. Hãy dùng cơ chế xác thực được tổ chức và nhà cung cấp hỗ trợ, với quyền tối thiểu cho repository cần làm việc.
Tài liệu Git về credentials mô tả cơ chế hỏi thông tin và credential helper. Không mặc định rằng helper hiện có xử lý đúng mọi loại proxy. Người quản trị cần xác nhận công cụ, nơi lưu bí mật và yêu cầu bảo vệ trên máy đó.
Không nhúng mật khẩu hoặc token vào URL, script, lịch sử terminal hay file được commit. Nếu cần hỗ trợ chẩn đoán, chuẩn bị bản sao thông báo đã lọc. Trace HTTP có thể chứa dữ liệu nhạy cảm; chỉ bật khi hiểu rõ dữ liệu thu được và không đăng log thô công khai.
7. Phân loại lỗi trước khi sửa
Lỗi 407: kiểm tra phía proxy
Ưu tiên kiểm tra tài khoản proxy, IP được phép và phương thức xác thực đúng gói. Không thay token của repository một cách mò mẫm. Xem thêm cách xử lý Proxy Authentication Required 407 để tách từng bước kiểm tra.
Lỗi TLS: giữ xác minh chứng chỉ
Không tắt http.sslVerify để vượt cảnh báo. Kiểm tra đồng hồ, hostname và chuỗi chứng chỉ; nếu mạng doanh nghiệp kiểm tra TLS, chỉ dùng CA được quản trị viên xác nhận. Bài lỗi chứng chỉ TLS khi dùng Proxy trình bày hướng kiểm tra an toàn.
Timeout hoặc mất kết nối: khoanh vùng từng chặng
Ghi nhận host, cổng, mạng đang dùng và thời điểm lỗi. So sánh với endpoint thử được phép, mỗi lần chỉ đổi một yếu tố. Không tăng timeout vô hạn hay tắt firewall. Mạng công ty bắt buộc proxy thì không thử đường trực tiếp để né chính sách.
8. Checklist trước khi dùng lâu dài
- Remote đúng HTTPS, proxy đúng giao thức và cổng được cấp.
- Phép thử nhỏ đạt; clone hoặc fetch được kiểm tra riêng.
- Không có bí mật trong URL, script và log chia sẻ.
- Xác minh TLS vẫn bật; quyền repository chỉ đủ nhu cầu.
- Đã ghi rõ phạm vi cấu hình, người quản lý và cách hoàn tác.
Khi chọn gói Proxy dân cư cho ứng dụng phát triển, hãy nêu rõ nhu cầu Git HTTPS và cách xác thực mong muốn với hỗ trợ. Một endpoint phù hợp cần được kiểm tra bằng chính luồng công việc của bạn, không chỉ bằng việc thấy IP thay đổi trên trình duyệt.