วิธีตั้งค่า Proxy สำหรับ npm, pip, apt, Docker และ git: คู่มือทีละขั้นตอนสำหรับไฟล์คอนฟิกของแต่ละเครื่องมือ
บทความ
- บทนำ: ทำไมตัวจัดการแพ็กเกจแต่ละตัวถึงต้องมีตั้งค่า proxy ของตัวเอง
- การเตรียมความพร้อมล่วงหน้า
- แนวคิดพื้นฐาน: ทำไมตัวแปรสภาพแวดล้อมจึงไม่พอ
- ขั้นตอนที่ 1: ทดสอบ proxy และเตรียมสตริงมาตรฐาน
- ขั้นตอนที่ 2: ตั้งค่า npm ผ่านไฟล์ .npmrc
- ขั้นตอนที่ 3: ตั้งค่า pip ผ่าน pip.conf
- ขั้นตอนที่ 4: ตั้งค่า apt ผ่านไดเรกทอรี apt.conf.d
- ขั้นตอนที่ 5: ตั้งค่า docker สองระดับ
- ขั้นตอนที่ 6: ตั้งค่า git ผ่าน git config
- ตรวจสอบผลลัพธ์: เช็กลิสต์รวม
- ข้อผิดพลาดทั่วไปและวิธีแก้
- ความสามารถเพิ่มเติม
- Faq: คำถามที่พบบ่อยเกี่ยวกับการตั้งค่า
- บทสรุป
บทนำ: ทำไมตัวจัดการแพ็กเกจแต่ละตัวถึงต้องมีตั้งค่า proxy ของตัวเอง
คุณคงเคยเจอสถานการณ์แบบนี้มาแล้ว: ในเทอร์มินัลคุณ export ตัวแปร http_proxy และ https_proxy เรียบร้อย curl ดาวน์โหลดหน้าเว็บได้ปร๋อ แต่พอ npm install กลับค้างเป็นนาทีแล้วพังด้วยข้อผิดพลาด ETIMEDOUT หรือ apt update เงียบ ๆ พยายามต่อตรงไปที่ mirror ราวกับว่าไม่มี proxy อยู่ในระบบ หรือ Docker ตอน build image ดึง layer พื้นฐานไม่ได้ ทั้งที่สั่ง docker pull จากคอนโซลเดียวกันกลับใช้ได้ นี่ไม่ใช่บั๊กและไม่ใช่เรื่องเหนือธรรมชาติ เพียงแต่แต่ละเครื่องมือมีวิธีอ่านค่าตั้งค่าเครือข่ายที่แตกต่างกัน และตัวแปรสภาพแวดล้อมก็ครอบคลุมได้แค่บางส่วนเท่านั้น
คู่มือนี้จะโฟกัสที่ไฟล์คอนฟิกของห้าเครื่องมือที่นักพัฒนาทุกคนขาดไม่ได้: npm (ไฟล์ .npmrc), pip (pip.conf หรือ pip.ini), apt (ไดเรกทอรี apt.conf.d), Docker (daemon.json และ config.json) และ git (git config) เราจงใจไม่พูดซ้ำเรื่องตัวแปรสภาพแวดล้อมในเทอร์มินัลและ CI งานของเราตรงนี้คือแสดงวิธีเขียน proxy ให้มีผลเสมอ ไม่ว่าคำสั่งจะถูกเรียกจากใครหรือจากที่ไหน
ผลลัพธ์ที่คุณจะได้คือไฟล์คอนฟิกห้าไฟล์ที่ใช้งานได้จริง คัดลอกไปเครื่องไหนก็ใช้ได้ ความเข้าใจว่าแต่ละเครื่องมือหาค่าตั้งค่าจากที่ไหน พร้อมชุดคำสั่งสำหรับตรวจสอบ และยังรู้วิธี롤แบ็กกลับอย่างรวดเร็วอีกด้วย
คู่มือนี้เหมาะกับใคร
- นักพัฒนาที่ใช้แล็ปท็อปทำงานหรือเซิร์ฟเวอร์ที่อยู่หลัง proxy ของบริษัทหรือ proxy ที่บ้าน
- นักทดสอบและผู้เชี่ยวชาญด้าน automation ที่ต้องการให้บิลด์ทั้งหมดวิ่งผ่าน proxy ที่กำหนด
- ผู้ดูแลระบบที่กำลังตั้งค่า image มาตรฐานสำหรับเวิร์กสเตชัน
- ทุกคนที่ใช้ proxy แบบเช่า (รวมถึง proxy มือถือ) สำหรับการพัฒนา และอยากให้เฉพาะเครื่องมือที่ต้องการวิ่งผ่าน proxy ไม่ใช่ทั้งระบบ
สิ่งที่ควรรู้ก่อนเริ่ม
ทักษะพื้นฐานในการใช้เทอร์มินัลก็เพียงพอ: เปิดคอนโซล เปลี่ยนไดเรกทอรี แก้ไขไฟล์ข้อความ เราจะใช้ nano บน Linux และ Notepad บน Windows แต่จะใช้อะไรก็ได้ที่ถนัด ความเข้าใจว่า IP address และ port คืออะไรก็มีประโยชน์ แม้เราจะทบทวนพื้นฐานอีกครั้งในหัวข้อแนวคิด
ใช้เวลานานแค่ไหน
ถ้าตั้งค่าทั้งห้าเครื่องมือรวดเดียว เตรียมเวลาไว้ 60 ถึง 90 นาที แต่ละเครื่องมือใช้เวลา 10-15 นาทีรวมการตรวจสอบ ขั้นตอนที่ใช้เวลานานที่สุดคือ Docker เพราะมีสองระดับของการตั้งค่าและต้องรีสตาร์ตเซอร์วิส
การเตรียมความพร้อมล่วงหน้า
ก่อนแก้ไขคอนฟิก มารวบรวมทุกอย่างที่จำเป็นก่อน การข้ามขั้นตอนนี้คือสาเหตุหลักที่ทำให้เราต้องมานั่งเดาทีหลังว่าผิดตรงไหน
ข้อมูล proxy ที่จำเป็น
คุณต้องมี 4 พารามิเตอร์ จดลงไฟล์ข้อความไว้เลย จะได้ไม่ต้องไปหาจากแชต:
- ประเภท proxy: HTTP หรือ HTTPS (บางครั้ง SOCKS5 แต่ตัวจัดการแพ็กเกจส่วนใหญ่ต้องการ HTTP proxy)
- ที่อยู่: ชื่อโดเมนหรือ IP เช่น proxy.corp.local หรือ 10.20.30.40
- พอร์ต: มักเป็น 3128, 8080 หรือ 8888
- ชื่อผู้ใช้และรหัสผ่าน หาก proxy ต้องใช้การยืนยันตัวตน สังเกตอักขระพิเศษในรหัสผ่านด้วย เพราะจะต้องเข้ารหัส เรื่องนี้จะอธิบายด้านล่าง
ข้อกำหนดระบบและเวอร์ชัน
คู่มือนี้ทดสอบบนเวอร์ชันล่าสุดปี 2026 และใช้ได้กับ:
- Ubuntu 22.04 และ 24.04, Debian 12 และ 13 (สำหรับ apt)
- Node.js 20 และ 22 พร้อม npm 10 และ 11
- Python 3.10 ขึ้นไป พร้อม pip 24 ขึ้นไป
- Docker Engine 25 ขึ้นไป (คีย์ proxies ใน daemon.json ปรากฏในเวอร์ชัน 23 บนเวอร์ชันเก่ากว่าให้ใช้ systemd drop-in เราจะแสดงทั้งสองวิธี)
- Git 2.40 ขึ้นไป
ถ้าใช้ Windows คำสั่งทั้งหมดสำหรับ npm, pip และ git ใช้ใน PowerShell ได้โดยไม่ต้องแก้ไข ต่างกันแค่เส้นทางไฟล์ สำหรับ Docker Desktop การตั้งค่า proxy ทำผ่าน GUI ซึ่งเราจะอธิบายด้วย
สิทธิ์การเข้าถึง
สำหรับ npm, pip และ git สิทธิ์ผู้ใช้ทั่วไปก็เพียงพอ เพราะคอนฟิกอยู่ในโฮมไดเรกทอรี ส่วน apt และ Docker ต้องใช้ sudo เพราะไฟล์อยู่ใน /etc และเปลี่ยนพฤติกรรมของเซอร์วิสระบบ
สำรองข้อมูล
ก่อนเริ่ม ให้คัดลอกคอนฟิกที่มีอยู่เดิมไว้ หนึ่งคำสั่งต่อหนึ่งไฟล์ แล้วคุณจะกลับสู่สภาพเดิมได้เสมอ:
cp ~/.npmrc ~/.npmrc.bak 2>/dev/null; cp ~/.config/pip/pip.conf ~/pip.conf.bak 2>/dev/null; cp ~/.gitconfig ~/.gitconfig.bak 2>/dev/null; sudo cp /etc/docker/daemon.json /etc/docker/daemon.json.bak 2>/dev/null; sudo cp -r /etc/apt/apt.conf.d /etc/apt/apt.conf.d.bak 2>/dev/nullส่วนท้าย 2>/dev/null จำเป็นเพื่อไม่ให้คำสั่งฟ้อง error ถ้าไฟล์ยังไม่มี ซึ่งเป็นเรื่องปกติ เพราะผู้ใช้หลายคนไม่มี .npmrc และ pip.conf ตั้งแต่แรก
เคล็ดลับ: สร้างโฟลเดอร์ proxy-configs ในโฮมไดเรกทอรี และเก็บเวอร์ชันต้นฉบับของคอนฟิกทั้งห้าไว้ในนั้น การย้ายไปเครื่องใหม่จะกลายเป็นแค่การคัดลอกห้าไฟล์
แนวคิดพื้นฐาน: ทำไมตัวแปรสภาพแวดล้อมจึงไม่พอ
มาทำความเข้าใจว่าเกิดอะไรขึ้นเบื้องหลัง ไม่งั้นขั้นตอนต่อไปจะดูเหมือนคาถาเวทมนตร์
proxy ในบริบทของตัวจัดการแพ็กเกจคืออะไร
พร็อกซีเซิร์ฟเวอร์ คือตัวกลาง แทนที่จะเชื่อมต่อกับ registry.npmjs.org โดยตรง npm ของคุณจะเชื่อมต่อกับ proxy แล้วขอให้ proxy ไปที่ registry.npmjs.org ให้ สำหรับทรัพยากร HTTPS จะใช้วิธี CONNECT คือ proxy จะสร้าง tunnel แล้วทราฟฟิกที่เข้ารหัสจะผ่านไปโดยไม่ถูกถอดรหัส สิ่งที่ตัวจัดการแพ็กเกจต้องรู้คือที่อยู่ proxy พอร์ต และข้อมูลยืนยันตัวตนหากจำเป็น
เครื่องมือรู้จัก proxy ได้อย่างไร
มีสามชั้นของการตั้งค่า และรวมกันเป็นลำดับความสำคัญ:
- แฟล็กบรรทัดคำสั่ง: เช่น pip install --proxy มีผลแค่การรันครั้งเดียว
- คอนฟิกของเครื่องมือเอง: .npmrc, pip.conf และอื่น ๆ มีผลเสมอสำหรับเครื่องมือนั้น
- ตัวแปรสภาพแวดล้อม: http_proxy, https_proxy, no_proxy มีผลกับทุกโปรแกรมในเซสชันปัจจุบันที่อ่านมัน
คำสำคัญคือ ที่อ่านมัน และนี่แหละที่ปัญหาเริ่มต้น
สี่เหตุผลที่ตัวแปรสภาพแวดล้อมไม่เพียงพอ
เหตุผลที่หนึ่ง: การเปลี่ยนผู้ใช้ เมื่อคุณสั่ง sudo apt update คำสั่งจะทำงานในนาม root และ sudo โดยค่าเริ่มต้นจะล้างสภาพแวดล้อม (ออปชัน env_reset) ตัวแปร http_proxy ของคุณจะอยู่กับผู้ใช้ทั่วไปเท่านั้น ยิ่งไปกว่านั้น apt เองดาวน์โหลดไฟล์ในนามผู้ใช้บริการ _apt ซึ่งไม่มีเซสชันของคุณเลย
เหตุผลที่สอง: เดมอนและเซอร์วิส Docker Engine เป็นเซอร์วิสเบื้องหลังที่ systemd เริ่มตอนบูตระบบ มันไม่เคยเห็นเทอร์มินัลของคุณ คำสั่ง docker pull แค่ส่งคำขอไปยังเดมอน แต่ตัวที่ดาวน์โหลด image คือเดมอน ดังนั้นตัวแปรในคอนโซลของคุณจึงไม่มีผลกับ docker pull เลย
เหตุผลที่สาม: การตีความที่ต่างกัน บางโปรแกรมอ่านเฉพาะ http_proxy ตัวพิมพ์เล็ก บางตัวอ่านเฉพาะ HTTP_PROXY บางตัวอ่านทั้งสอง เวอร์ชันเก่าของ npm ไม่สนใจ no_proxy บางเครื่องมือไม่เข้าใจข้อมูลยืนยันตัวตนในตัวแปร การมีคอนฟิกของตัวเองช่วยให้ไม่ต้องเดา
เหตุผลที่สี่: ความละเอียด ตัวแปรสภาพแวดล้อมมีหรือไม่มีเท่านั้น แต่คุณอาจต้องการให้เฉพาะ github.com วิ่งผ่าน proxy แต่ไม่ให้ GitLab ภายในวิ่ง หรือให้ PyPI สาธารณะวิ่งผ่าน proxy แต่ index ภายในต่อตรง กฎแบบนี้มีแค่คอนฟิกที่ทำได้: git รองรับการตั้ง proxy ตาม URL เฉพาะ, apt ตามโฮสต์เฉพาะ, Docker มีรายการยกเว้นในระดับเดมอน
การเข้ารหัสอักขระพิเศษในรหัสผ่าน
ชื่อผู้ใช้และรหัสผ่านในคอนฟิกจะถูกส่งภายใน URL รูปแบบ http://user:password@host:port อักขระ @, :, /, #, ?, % และช่องว่างภายในรหัสผ่านจะทำให้การแยกวิเคราะห์ที่อยู่พัง ต้องแทนด้วยรหัสเปอร์เซ็นต์: @ กลายเป็น %40, : กลายเป็น %3A, # กลายเป็น %23, / กลายเป็น %2F, % กลายเป็น %25, ช่องว่างเป็น %20 ตัวอย่างเช่น รหัสผ่าน p@ss:1 จะเขียนในคอนฟิกเป็น p%40ss%3A1 จำกฎนี้ไว้ จะช่วยคุณได้ในทั้งห้าเครื่องมือ
ขั้นตอนที่ 1: ทดสอบ proxy และเตรียมสตริงมาตรฐาน
เป้าหมายของขั้นนี้: ตรวจสอบว่า proxy ทำงานได้จริง และได้สตริงการเชื่อมต่อที่ผ่านการทดสอบแล้วหนึ่งชุด ซึ่งเราจะใช้แทรกในทุกคอนฟิก
- เปิดเทอร์มินัล บน Linux กด Ctrl+Alt+T บน Windows เปิด PowerShell จากเมนู Start
- ประกอบสตริงการเชื่อมต่อตามเทมเพลต http://ชื่อผู้ใช้:รหัสผ่าน@ที่อยู่:พอร์ต ถ้าไม่ต้องยืนยันตัวตนก็แค่ http://ที่อยู่:พอร์ต ตัวอย่าง: http://dev:s3cret@10.20.30.40:3128
- รันคำขอทดสอบผ่าน curl โดยระบุ proxy ด้วยแฟล็ก -x อย่างชัดเจน เพื่อไม่ให้ขึ้นกับตัวแปร:
curl -x http://dev:s3cret@10.20.30.40:3128 -I https://registry.npmjs.org/ - รอผลลัพธ์ ควรเริ่มต้นด้วย HTTP/2 200 หรือ HTTP/1.1 200 OK ถ้าเห็น 407 Proxy Authentication Required แปลว่าชื่อผู้ใช้หรือรหัสผ่านผิด ถ้าเห็น Could not resolve proxy แปลว่าที่อยู่พิมพ์ผิด ถ้า connection refused แปลว่าพอร์ตผิดหรือ proxy ปิดอยู่
- ทดสอบซ้ำกับเป้าหมายอื่น ๆ: https://pypi.org/simple/, https://deb.debian.org/, https://registry-1.docker.io/v2/, https://github.com/ สำหรับ Docker การได้ 401 ถือว่าปกติ แสดงว่าไปถึง registry แล้วและมันขอ token
- จดสตริงสุดท้ายลงไฟล์ข้อความของคุณ นี่คือ สตริง proxy มาตรฐาน ของคุณ
ข้อควรระวัง: ถ้ารหัสผ่านมีอักขระพิเศษ ให้เข้ารหัสตั้งแต่ขั้นนี้และทดสอบเวอร์ชันที่เข้ารหัสแล้วผ่าน curl เมื่อนั้นในคอนฟิกถัดไปคุณจะแทรกสตริงที่ใช้งานได้แน่นอน
เคล็ดลับ: ถ้าผู้ให้บริการให้ไม่ใช่ proxy เดียว แต่เป็นพูลที่อยู่หรือ proxy มือถือที่หมุน IP อัตโนมัติ ปกติจะมีจุดเข้าเดียว: โฮสต์และพอร์ตเดียวที่ IP เปลี่ยนอัตโนมัติด้านหลัง ให้เขียนจุดเข้านี้ในคอนฟิก ไม่ใช่ IP เจาะจงจากพูล ไม่งั้นการตั้งค่าจะใช้ไม่ได้ทันทีที่มีการหมุนครั้งแรก
การตรวจสอบ: curl ด้วยแฟล็ก -x คืนค่า 200 (หรือ 401 สำหรับ Docker Hub) จากทั้งห้าที่อยู่ ถ้ามีอย่างน้อยหนึ่งไม่ตอบ อย่าเพิ่งไปต่อ เพราะคอนฟิกไม่สามารถซ่อม proxy ที่ไม่ทำงานได้
ขั้นตอนที่ 2: ตั้งค่า npm ผ่านไฟล์ .npmrc
เป้าหมายของขั้นนี้: npm install, npm view และ npm publish ทำงานผ่าน proxy จากทุกโปรเจกต์และทุกคอนโซล รวมถึง IDE ที่เรียก npm เองด้วย
คอนฟิก npm อยู่ที่ไหน
npm อ่านค่าตั้งค่าจากหลายไฟล์ตามลำดับความสำคัญจากน้อยไปมาก: ค่าในตัว, ไฟล์ global ในไดเรกทอรีติดตั้ง npm, ไฟล์ผู้ใช้ ~/.npmrc (บน Windows คือ C:\Users\ชื่อ\.npmrc) และไฟล์ .npmrc ของโปรเจกต์ที่วางข้าง package.json สำหรับ proxy เกือบทุกกรณีใช้ไฟล์ผู้ใช้ เพราะมีผลกับทุกโปรเจกต์แต่ไม่ถูก commit เข้า repository
การตั้งค่าทีละขั้นตอน
- ตั้ง proxy สำหรับทราฟฟิก HTTP ปกติ:
npm config set proxy http://dev:s3cret@10.20.30.40:3128 - ตั้ง proxy สำหรับทราฟฟิก HTTPS (registry ของ npm ทำงานบน HTTPS ดังนั้นค่านี้คือค่าหลัก):
สังเกตว่าค่าเริ่มด้วย http:// ไม่ใช่ https:// เพราะนี่คือที่อยู่ของ proxy เอง ซึ่งมักรับการเชื่อมต่อผ่าน HTTP ธรรมดาแม้จะ tunnel HTTPS อยู่ก็ตามnpm config set https-proxy http://dev:s3cret@10.20.30.40:3128 - ถ้าคุณมี registry ภายในหรือ mirror ที่ต้องต่อตรง ให้เพิ่มข้อยกเว้นคั่นด้วยจุลภาค:
จุดหน้าโดเมนหมายถึงทุกซับโดเมนnpm config set noproxy localhost,127.0.0.1,.corp.local - เปิดไฟล์ตรวจสอบว่าเขียนลงไปแล้ว:
บน Windows: type $env:USERPROFILE\.npmrc คุณจะเห็นสามบรรทัดในรูปแบบ key=valuecat ~/.npmrc - ถ้า proxy ของบริษัทเปลี่ยนใบรับรอง ให้เพิ่ม root certificate ของบริษัท:
อย่าปิดการตรวจสอบใบรับรองผ่าน strict-ssl=false ถ้าไม่จำเป็นจริง ๆ เพราะเป็นการเปิดทางให้มีการสลับแพ็กเกจnpm config set cafile /etc/ssl/certs/corp-root.pem
อีกวิธีคือสร้างไฟล์ด้วยตัวเอง เนื้อหาของ ~/.npmrc จะเป็น:
proxy=http://dev:s3cret@10.20.30.40:3128 https-proxy=http://dev:s3cret@10.20.30.40:3128 noproxy=localhost,127.0.0.1,.corp.localแต่ละคู่ต้องอยู่คนละบรรทัด ไม่มีเครื่องหมายคำพูดและไม่มีช่องว่างรอบเครื่องหมายเท่ากับ
แล้ว yarn กับ pnpm ล่ะ
Yarn Classic (1.x) อ่าน ~/.npmrc เดียวกันและยังมี ~/.yarnrc ของตัวเองที่มีคีย์ proxy และ https-proxy ส่วน Yarn Berry (2+) เก็บค่าใน .yarnrc.yml ด้วยคีย์ httpProxy และ httpsProxy pnpm เข้ากันได้กับ .npmrc อย่างสมบูรณ์ ไม่ต้องทำอะไรเพิ่ม และควรจำไว้ว่า npm ci กับ IDE ของบริษัทก็รัน npm ด้วยผู้ใช้เดียวกัน ดังนั้น .npmrc ของผู้ใช้ก็ครอบคลุมหมด
เคล็ดลับ: คำสั่ง npm config list --json จะแสดงคอนฟิกรวมจากทุกไฟล์ ถ้าเห็น proxy=null แสดงว่าไฟล์ไม่ถูกอ่าน ตรวจสอบว่าไฟล์อยู่ในโฮมไดเรกทอรีของผู้ใช้ที่คุณใช้รัน npm จริง ๆ
การตรวจสอบ: รัน npm view lodash version ภายใน 1-3 วินาทีควรได้บรรทัดที่มีเลขเวอร์ชัน เพื่อความชัดเจน ลองยกเลิกตัวแปรสภาพแวดล้อมชั่วคราว (unset http_proxy https_proxy) แล้วรันซ้ำ npm ก็ควรยังทำงานได้เพราะอ่านจาก .npmrc
ปัญหาที่อาจเจอ
- ETIMEDOUT หรือ ECONNRESET: ที่อยู่หรือพอร์ต proxy ผิด หรือ proxy บล็อก CONNECT ไปพอร์ต 443 ตรวจสอบสตริงมาตรฐานด้วย curl
- 407 Proxy Authentication Required: ชื่อผู้ใช้หรือรหัสผ่านผิด ส่วนใหญ่เป็นเพราะอักขระพิเศษยังไม่ได้เข้ารหัส
- UNABLE_TO_GET_ISSUER_CERT_LOCALLY: proxy สลับใบรับรอง ต้องใช้ cafile ที่มี root certificate ของบริษัท
ขั้นตอนที่ 3: ตั้งค่า pip ผ่าน pip.conf
เป้าหมายของขั้นนี้: pip install และ pip download ทำงานผ่าน proxy รวมถึงภายใน virtual environment และเมื่อเรียกจากสคริปต์ Python
หา pip.conf ที่ไหน
pip ใช้ไฟล์สามระดับ: ระดับ global (ทั้งระบบ), ระดับผู้ใช้ และระดับ virtual environment เส้นทางขึ้นอยู่กับระบบ:
- Linux, ระดับผู้ใช้: ~/.config/pip/pip.conf (เส้นทางเก่า ~/.pip/pip.conf ก็ยังถูกอ่าน)
- Linux, ระดับ global: /etc/pip.conf
- macOS, ระดับผู้ใช้: ~/Library/Application Support/pip/pip.conf หรือถ้าโฟลเดอร์นี้ไม่มีก็ ~/.config/pip/pip.conf
- Windows, ระดับผู้ใช้: %APPDATA%\pip\pip.ini นั่นคือ C:\Users\ชื่อ\AppData\Roaming\pip\pip.ini
- ภายใน virtual environment: ไฟล์ pip.conf (หรือ pip.ini) ที่รากของไดเรกทอรี venv
ถ้าไม่อยากเดา ถาม pip ตรง ๆ ได้: คำสั่ง pip config debug จะแสดงเส้นทางทั้งหมดที่มันตรวจสอบ และทำเครื่องหมายไฟล์ที่มีอยู่
การตั้งค่าทีละขั้นตอน
- ตรวจสอบว่า pip เป็นเวอร์ชันล่าสุด: pip --version ควรเป็น 24 ขึ้นไป
- ตั้ง proxy ด้วยคำสั่งเดียว pip จะสร้างไฟล์ในตำแหน่งที่ถูกต้องให้เอง:
คำว่า global หมายถึงเซกชัน [global] ในไฟล์ ไม่ใช่ระดับระบบ ไฟล์ที่สร้างจะเป็นระดับผู้ใช้pip config set global.proxy http://dev:s3cret@10.20.30.40:3128 - ถ้า proxy สลับใบรับรอง ให้ระบุ root certificate:
pip config set global.cert /etc/ssl/certs/corp-root.pem - ดูผลลัพธ์:
ผลลัพธ์ที่คาดหวัง: global.proxy='http://dev:s3cret@10.20.30.40:3128'pip config list - เปิดไฟล์ตรวจสอบรูปแบบ ควรมีหน้าตาแบบนี้:
แต่ละบรรทัดแยกกัน เซกชันในวงเล็บเหลี่ยมอยู่ด้านบน[global] proxy = http://dev:s3cret@10.20.30.40:3128 cert = /etc/ssl/certs/corp-root.pem
ข้อแตกต่างสำคัญของ pip กับ npm: pip ไม่มีค่าตั้งแยกสำหรับ HTTPS proxy ใช้คีย์ proxy เดียวสำหรับทุกการเชื่อมต่อ และ pip ไม่มีคีย์เทียบเท่า noproxy ในคอนฟิก: ข้อยกเว้นจะดึงจากตัวแปรสภาพแวดล้อม no_proxy เท่านั้น ถ้าคุณต้องต่อตรงกับ index ภายใน วิธีที่ง่ายกว่าคือระบุ index-url แยกสำหรับ index นั้นแล้วรัน pip ด้วยแฟล็ก --proxy ค่าว่างเฉพาะกรณีนั้น หรือใช้ pip.conf ของโปรเจกต์ใน venv ที่ไม่มีบรรทัด proxy
เคล็ดลับ: ถ้ามีหลายโปรเจกต์และอันหนึ่งต้องการ proxy แต่อีกอันไม่ ให้วาง pip.conf ไว้ที่รากของ virtual environment ที่เกี่ยวข้อง ค่าตั้งของ venv มีความสำคัญเหนือระดับผู้ใช้ คุณจะได้พฤติกรรมต่างกันโดยไม่ต้องสลับไฟล์ global
ข้อควรระวัง: อย่าเพิ่ม trusted-host = pypi.org เพื่อกลบข้อผิดพลาดใบรับรอง เพราะเป็นการปิดการตรวจสอบความถูกต้องและเปิดทางให้ตัวกลางใด ๆ ยัดแพ็กเกจปลอมให้คุณ ทางแก้ที่ถูกต้องคือคีย์ cert ที่มี certificate ของบริษัท
การตรวจสอบ: รัน pip download requests --no-deps -d /tmp/piptest ภายในไม่กี่วินาทีจะปรากฏไฟล์ requests-*.whl ในไดเรกทอรี จากนั้นลบไดเรกทอรีทดสอบทิ้ง ถ้าอยากมั่นใจว่าใช้คอนฟิกจริง ๆ ก็ยกเลิกตัวแปรสภาพแวดล้อมแล้วรันซ้ำ
ปัญหาที่อาจเจอ
- ProxyError หรือ Cannot connect to proxy: ที่อยู่พิมพ์ผิดหรือพอร์ตไม่ถูก เทียบกับสตริงมาตรฐาน
- Tunnel connection failed: 407: ยืนยันตัวตนไม่ผ่าน ตรวจสอบการเข้ารหัสรหัสผ่าน
- SSLError CERTIFICATE_VERIFY_FAILED: ต้องใช้คีย์ cert ที่มี root certificate ของ proxy
- ไฟล์เขียนแล้วแต่ pip หาไม่เจอ: คุณรัน pip ของอินเทอร์พรีเตอร์อีกตัว (เช่น python3 -m pip ของ Python คนละตัว) รัน pip config debug ด้วยคำสั่งเดียวกับที่คุณใช้ติดตั้งแพ็กเกจ
ขั้นตอนที่ 4: ตั้งค่า apt ผ่านไดเรกทอรี apt.conf.d
เป้าหมายของขั้นนี้: sudo apt update และ sudo apt install ดาวน์โหลดแพ็กเกจผ่าน proxy ส่วนการเรียกไปยัง mirror ภายในให้ต่อตรง
ทำไมต้อง apt.conf.d
apt อ่านค่าตั้งจาก /etc/apt/apt.conf และไฟล์ทั้งหมดในไดเรกทอรี /etc/apt/apt.conf.d/ ตามลำดับตัวอักษร มารยาทที่ดีคืออย่าไปยุ่งกับไฟล์ของคนอื่น ให้สร้างไฟล์ใหม่ที่มีคำนำหน้าเป็นตัวเลข ตัวเลขกำหนดลำดับการอ่าน: ไฟล์ 80proxy จะถูกใช้หลัง 01autoremove และไฟล์ระบบอื่น ๆ และนี่คือที่ที่การตั้งค่าจะรอดจากการอัปเดตแพ็กเกจ apt ทุกครั้ง
การตั้งค่าทีละขั้นตอน
- สร้างไฟล์ตั้งค่าใหม่:
จะเปิดตัวแก้ไขเปล่า ๆ ขึ้นมาsudo nano /etc/apt/apt.conf.d/80proxy - เขียนสองบรรทัดสำหรับ repository แบบ HTTP และ HTTPS สังเกตเครื่องหมายคำพูดและอัฒภาค เพราะไวยากรณ์ของ apt บังคับ:
Acquire::http::Proxy "http://dev:s3cret@10.20.30.40:3128"; Acquire::https::Proxy "http://dev:s3cret@10.20.30.40:3128"; - ถ้ามี mirror ภายในที่ไม่ต้องใช้ proxy ให้เพิ่มบรรทัดยกเว้น คำ DIRECT ตัวพิมพ์ใหญ่หมายถึงการต่อตรง:
Acquire::http::Proxy::mirror.corp.local "DIRECT"; - บันทึกไฟล์: ใน nano กด Ctrl+O แล้ว Enter แล้ว Ctrl+X เพื่อออก
- จำกัดสิทธิ์ไฟล์ เพราะมีรหัสผ่านอยู่ข้างใน:
เฉพาะ root เท่านั้นที่อ่านเนื้อหาได้sudo chmod 600 /etc/apt/apt.conf.d/80proxy - ตรวจสอบว่า apt อ่านไฟล์ได้ไม่มีข้อผิดพลาดไวยากรณ์:
คุณควรเห็นบรรทัด Acquire::http::Proxy และ Acquire::https::Proxy พร้อมค่าของคุณapt-config dump | grep -i proxy
นี่คือตัวอย่างไฟล์เต็มเพื่อความชัดเจน:
Acquire::http::Proxy "http://dev:s3cret@10.20.30.40:3128"; Acquire::https::Proxy "http://dev:s3cret@10.20.30.40:3128"; Acquire::http::Proxy::mirror.corp.local "DIRECT"; Acquire::https::Proxy::mirror.corp.local "DIRECT";ทางเลือกสำหรับรันครั้งเดียวโดยไม่ต้องมีไฟล์: sudo apt -o Acquire::http::Proxy="http://10.20.30.40:3128" update แฟล็ก -o สะดวกสำหรับทดสอบค่าก่อนเขียนลงคอนฟิก
เคล็ดลับ: proxy ที่แคชแพ็กเกจ deb เองมักมีพอร์ตแยกสำหรับ apt สอบถามผู้ดูแลระบบดู ถ้ามี apt update จะเร็วขึ้นหลายเท่าจากแคชในเครื่อง
การตรวจสอบ: รัน sudo apt update ในเอาต์พุตจะมีบรรทัด Hit หรือ Get พร้อมที่อยู่ repository และไม่มีบรรทัด Err สังเกตว่าเราไม่ได้ตั้งตัวแปรสภาพแวดล้อมเลย และต่อให้ตั้ง sudo ก็ล้างมันทิ้งอยู่ดี แต่ apt ก็ยังออกเครือข่ายได้ นี่แหละคือผลของคอนฟิกของตัวเอง
ปัญหาที่อาจเจอ
- Err: 407 Proxy Authentication Required: ยืนยันตัวตนไม่ผ่าน ตรวจสอบการเข้ารหัสอักขระพิเศษ
- Could not connect หรือ Connection timed out: apt ต่อตรง สาเหตุน่าจะพิมพ์ผิดในไฟล์ และ apt-config dump ไม่แสดงให้เห็น ตรวจสอบตัวพิมพ์ใหญ่เล็กใน Acquire และเครื่องหมายโคลอนคู่
- E: Syntax error: ลืมอัฒภาคหรือเครื่องหมายคำพูดท้ายบรรทัด
- ไฟล์อยู่แต่การยกเว้น DIRECT ไม่ทำงาน: ตรวจสอบว่าโฮสต์เนมในบรรทัดยกเว้นตรงกับใน sources.list ทุกตัวอักษร ไม่มี http:// และไม่มีพอร์ต
ขั้นตอนที่ 5: ตั้งค่า Docker สองระดับ
เป้าหมายของขั้นนี้: docker pull, docker build และ docker compose pull ดาวน์โหลด image ผ่าน proxy และคอนเทนเนอร์ได้รับค่าตั้ง proxy โดยอัตโนมัติเมื่อจำเป็น
สองระดับที่มักสับสน
Docker มีสองที่แยกกันซึ่งต้องการ proxy ต่างกัน:
- ระดับเดมอน (เซอร์วิส dockerd) ตัวนี้แหละที่ดาวน์โหลด image จาก registry ตั้งค่าใน /etc/docker/daemon.json หรือผ่าน systemd ต้องรีสตาร์ตเซอร์วิส
- ระดับไคลเอนต์ (ไฟล์ ~/.docker/config.json) ไม่มีผลต่อการดาวน์โหลด image แต่จะส่งตัวแปร proxy เข้าไปในคอนเทนเนอร์ที่รันและในขั้นตอน build โดยอัตโนมัติ เพื่อให้ apt หรือ pip ภายในคอนเทนเนอร์เห็น proxy ด้วย
ตั้งแค่ไคลเอนต์ - docker pull ไม่ทำงาน ตั้งแค่เดมอน - image ดาวน์โหลดได้ แต่ RUN apt-get update ใน Dockerfile จะพัง ต้องตั้งทั้งสอง
ส่วน A: เดมอนผ่าน daemon.json
- ตรวจสอบเวอร์ชัน: docker version ถ้าเวอร์ชันของเซิร์ฟเวอร์เป็น 23.0 ขึ้นไป ใช้ daemon.json ถ้าเก่ากว่าให้ข้ามไปส่วน B
- เปิดไฟล์ตั้งค่าเดมอน:
ถ้ามีไฟล์อยู่แล้วและมีคีย์อื่น ให้เพิ่มบล็อก proxies เข้าไปในวงเล็บปีกกาเดียวกันโดยคั่นด้วยจุลภาค ถ้าไม่มีไฟล์ให้สร้างใหม่sudo nano /etc/docker/daemon.json - เขียนบล็อกตั้งค่า:
สังเกตว่าคีย์เขียนด้วยเครื่องหมายยัติภังค์คั่นและเป็นตัวพิมพ์เล็กแบบนี้เป๊ะ นี่คือรูปแบบของเดมอน ส่วนไคลเอนต์คีย์จะต่างออกไป{ "proxies": { "http-proxy": "http://dev:s3cret@10.20.30.40:3128", "https-proxy": "http://dev:s3cret@10.20.30.40:3128", "no-proxy": "localhost,127.0.0.0/8,registry.corp.local" } } - บันทึกไฟล์ (Ctrl+O, Enter, Ctrl+X)
- ตรวจสอบว่า JSON ถูกต้อง ไม่งั้นเดมอนจะไม่สตาร์ต:
ถ้าคำสั่งแสดงเนื้อหาไฟล์พร้อมการเยื้องแสดงว่าไวยากรณ์ถูก ถ้าฟ้อง Expecting value หรือ Extra data แสดงว่ามีจุลภาคเกินหรือขาดpython3 -m json.tool /etc/docker/daemon.json - รีสตาร์ตเซอร์วิส:
ใช้เวลา 5-15 วินาที คอนเทนเนอร์ที่รันอยู่ทั้งหมดจะหยุด所以要ทำในจังหวะที่สะดวกsudo systemctl restart docker - ตรวจสอบว่าเดมอนขึ้นมาแล้ว: sudo systemctl status docker ควรเห็นคำว่า active (running) สีเขียว
ข้อควรระวัง: จุลภาคเกินตัวเดียวใน daemon.json ทำให้ Docker ไม่สตาร์ตเลย และคอนเทนเนอร์ทั้งหมดบนเครื่องจะล่มไปด้วย ตรวจสอบไฟล์ผ่าน json.tool ก่อนรีสตาร์ตทุกครั้งและเก็บไฟล์สำรองไว้ข้าง ๆ
ส่วน B: เดมอนผ่าน systemd (สำหรับเวอร์ชันเก่าและใช้เป็นทางเลือก)
- สร้างไดเรกทอรีสำหรับการตั้งค่าเพิ่มเติมของเซอร์วิส: sudo mkdir -p /etc/systemd/system/docker.service.d
- สร้างไฟล์: sudo nano /etc/systemd/system/docker.service.d/http-proxy.conf
- เขียน:
[Service] Environment="HTTP_PROXY=http://dev:s3cret@10.20.30.40:3128" Environment="HTTPS_PROXY=http://dev:s3cret@10.20.30.40:3128" Environment="NO_PROXY=localhost,127.0.0.0/8,registry.corp.local" - บันทึกและใช้งาน: sudo systemctl daemon-reload แล้ว sudo systemctl restart docker
ใช่ครับ นี่ใช้ตัวแปรสภาพแวดล้อม แต่ไม่ได้ตั้งในคอนโซลของคุณ แต่ตั้งในนิยามของเซอร์วิส: เดมอนได้รับมันตอนสตาร์ตจาก systemd นี่เป็นวิธีเดียวสำหรับ Docker ที่เก่ากว่าเวอร์ชัน 23 ถ้าคุณตั้งทั้ง daemon.json และไฟล์ systemd พร้อมกัน daemon.json จะมีความสำคัญกว่า
ส่วน C: ไคลเอนต์ผ่าน ~/.docker/config.json
- เปิดหรือสร้างไฟล์ nano ~/.docker/config.json ถ้าไฟล์มีบล็อก auths ที่มีข้อมูลล็อกอินของ registry อยู่แล้ว อย่าลบ ให้เพิ่มบล็อกใหม่ข้าง ๆ คั่นด้วยจุลภาค
- เขียน:
ตรงนี้คีย์เป็นแบบ camelCase: httpProxy, httpsProxy, noProxy นี่คือความต่างจาก daemon.json และสลับกันไม่ได้{ "proxies": { "default": { "httpProxy": "http://dev:s3cret@10.20.30.40:3128", "httpsProxy": "http://dev:s3cret@10.20.30.40:3128", "noProxy": "localhost,127.0.0.0/8,.corp.local" } } } - บันทึกไฟล์ ไม่ต้องรีสตาร์ตอะไร ไคลเอนต์อ่านไฟล์ทุกครั้งที่สั่งคำสั่ง
ตอนนี้เมื่อ docker run และ docker build ตัวแปร HTTP_PROXY, HTTPS_PROXY และ NO_PROXY (ทั้งสองรูปแบบตัวพิมพ์) จะเข้าไปในคอนเทนเนอร์โดยอัตโนมัติ ดังนั้น apt-get และ pip ภายใน Dockerfile ก็จะวิ่งผ่าน proxy โดยไม่ต้องตั้ง ARG และ ENV เอง
Docker Desktop บน Windows และ macOS
เปิดการตั้งค่าจากไอคอนใน tray เลือก Resources แล้วหัวข้อย่อย Proxies สลับเป็น Manual proxy configuration กรอกที่อยู่ในช่อง Web Server (HTTP) และ Secure Web Server (HTTPS) ส่วนรายการยกเว้นใส่ใน Bypass proxy settings for these hosts and domains กด Apply and restart ไฟล์ config.json ฝั่งไคลเอนต์บน Windows อยู่ที่ C:\Users\ชื่อ\.docker\config.json และตั้งค่าแบบเดียวกับที่อธิบายข้างบน
เคล็ดลับ: คำสั่ง docker info แสดงเซกชันที่มี HTTP Proxy, HTTPS Proxy และ No Proxy นี่คือวิธีที่เร็วที่สุดในการรู้ว่าเดมอนเห็นค่าของคุณหรือยัง โดยไม่ต้องเริ่มดาวน์โหลด
การตรวจสอบ: รัน docker pull hello-world image นี้หนักแค่ไม่กี่กิโลไบต์และดาวน์โหลดในไม่กี่วินาที ตอนท้ายจะขึ้น Status: Downloaded newer image จากนั้นตรวจสอบฝั่งไคลเอนต์: docker run --rm alpine env | grep -i proxy ในเอาต์พุตควรมีบรรทัด HTTP_PROXY และ HTTPS_PROXY พร้อมที่อยู่ของคุณ
ปัญหาที่อาจเจอ
- Docker ไม่สตาร์ตหลังแก้ daemon.json: ข้อผิดพลาดไวยากรณ์ ดู sudo journalctl -u docker -n 30 จะมีบรรทัดที่ผิดระบุไว้ กู้คืนจากไฟล์สำรอง
- docker pull ค้างและหมดเวลา ทั้งที่ docker info แสดง proxy: เดมอนยังไม่ถูกรีสตาร์ตหลังแก้ หรือ proxy ไม่ยอมให้ CONNECT ไปยัง registry-1.docker.io ตรวจสอบสตริงมาตรฐานด้วย curl
- apt-get update ในการ build พัง แต่ docker pull ทำงาน: ยังไม่ได้ตั้ง config.json ฝั่งไคลเอนต์ หรือ build ผ่าน builder ระยะไกลที่อ่านไฟล์คนละไฟล์
- คอนเทนเนอร์ได้ proxy แต่ต่อกับคอนเทนเนอร์ข้าง ๆ ไม่ได้: เพิ่มชื่อเซอร์วิสภายในและ subnet ของ Docker ลงใน noProxy
ขั้นตอนที่ 6: ตั้งค่า git ผ่าน git config
เป้าหมายของขั้นนี้: git clone, fetch, pull และ push ผ่าน HTTPS วิ่งผ่าน proxy ขณะที่เซิร์ฟเวอร์ภายในยังต่อตรงได้ และสามารถตั้ง proxy เฉพาะสำหรับโฮสต์ใดโฮสต์หนึ่งได้
git เก็บค่าตั้งไว้ที่ไหน
สามระดับ: ระดับระบบ (/etc/gitconfig), ระดับผู้ใช้ (~/.gitconfig บน Windows คือ C:\Users\ชื่อ\.gitconfig) และระดับ local ใน repository (.git/config) โดยทั่วไปตั้ง proxy ในระดับ global และข้อยกเว้นเฉพาะจุดก็ตั้งในระดับ global แต่ผูกกับ URL
การตั้งค่าทีละขั้นตอน
- ตั้ง proxy สำหรับการเชื่อมต่อ HTTPS และ HTTP ทั้งหมดด้วยคำสั่งเดียว:
ต่างจาก npm ตรงที่ git ไม่มี https.proxy แยกสำหรับโปรโตคอล HTTPS: คีย์ http.proxy ใช้กับทั้งสอง การตั้ง https.proxy มีในคู่มือเก่า ๆ แต่ไม่ใช่คีย์มาตรฐานของ git และจะถูกเพิกเฉยgit config --global http.proxy http://dev:s3cret@10.20.30.40:3128 - ถ้าเซิร์ฟเวอร์ภายในไม่ต้องใช้ proxy ให้ตั้งค่าเป็นสตริงว่างเฉพาะ URL นั้น:
สตริงว่างหมายถึงการต่อตรง ส่วนที่อยู่ระหว่าง http. และ .proxy คือคำนำหน้า URL ที่กฎนี้ใช้git config --global http.https://git.corp.local.proxy "" - ถ้าโฮสต์ใดต้องการ proxy อีกตัว (เช่น proxy มือถือเฉพาะ) ให้ระบุแบบผูกกับ URL เช่นเดียวกัน:
git config --global http.https://github.com.proxy http://dev:s3cret@10.20.30.41:3128 - ถ้า proxy สลับใบรับรอง ให้เพิ่ม root certificate:
git config --global http.sslCAInfo /etc/ssl/certs/corp-root.pem - ตรวจสอบไฟล์สุดท้าย:
คุณจะเห็นบรรทัด http.proxy=... และ http.https://git.corp.local.proxy= ที่มีค่าว่างgit config --global --list | grep -i proxy
ไฟล์ ~/.gitconfig หลังคำสั่งเหล่านี้จะมีหน้าตาแบบนี้:
[http] proxy = http://dev:s3cret@10.20.30.40:3128 sslCAInfo = /etc/ssl/certs/corp-root.pem [http "https://git.corp.local"] proxy = [http "https://github.com"] proxy = http://dev:s3cret@10.20.30.41:3128ความละเอียดแบบนี้ทำผ่านตัวแปรสภาพแวดล้อมไม่ได้: no_proxy ยกเว้นโฮสต์ได้แต่กำหนด proxy ต่างกันให้เซิร์ฟเวอร์ต่างกันไม่ได้
แล้วที่อยู่แบบ SSH ล่ะ
การตั้ง http.proxy ไม่มีผลกับที่อยู่แบบ git@github.com:user/repo.git เพราะนั่นคือโปรโตคอล SSH ไม่ใช่ HTTP ถ้า proxy ของคุณอนุญาตการ tunnel ไปพอร์ต 22 ผ่าน CONNECT ก็ตั้ง SSH client ในไฟล์ ~/.ssh/config ด้วยไดเรกทีฟ ProxyCommand และยูทิลิตี้ nc หรือ corkscrew ได้ แต่ proxy ของบริษัทหลายแห่งห้ามการเชื่อมต่อแบบนี้ วิธีที่ง่ายและคาดเดาได้ที่สุดคือเปลี่ยน remote เป็น HTTPS: git remote set-url origin https://github.com/user/repo.git แล้วใช้ access token แทนรหัสผ่าน
เคล็ดลับ: เพื่อไม่ให้เก็บรหัสผ่าน proxy ใน ~/.gitconfig แบบข้อความธรรมดา สามารถแยกไปไฟล์ที่มีสิทธิ์ 600 และเชื่อมด้วยไดเรกทีฟ include สร้าง ~/.gitconfig-proxy ที่มีเซกชัน [http] แล้วในไฟล์หลักเพิ่ม [include] path = ~/.gitconfig-proxy จากนั้นคอนฟิกหลักก็โชว์เพื่อนร่วมงานได้อย่างสบายใจ
การตรวจสอบ: รัน git ls-remote https://github.com/git/git.git HEAD ภายในไม่กี่วินาทีจะได้บรรทัดที่มี hash ของ commit พร้อมคำว่า HEAD คำสั่งนี้ไม่สร้างไฟล์และไม่โคลนอะไร เหมาะเป็นเทสต์ของส่วนเครือข่ายมาก จากนั้นทดสอบข้อยกเว้น: git ls-remote ไปยังเซิร์ฟเวอร์ภายในควรทำงานได้แม้ proxy ล่ม
ปัญหาที่อาจเจอ
- Failed to connect to proxy หรือ Could not resolve proxy: ที่อยู่พิมพ์ผิด
- Received HTTP code 407 from proxy after CONNECT: ยืนยันตัวตนผิด ตรวจสอบการเข้ารหัสรหัสผ่าน
- SSL certificate problem: unable to get local issuer certificate: ต้องใช้ http.sslCAInfo อย่าใช้ http.sslVerify false แบบถาวร
- กฎสำหรับ URL ไม่ถูกใช้: คำนำหน้าต้องตรงกับต้นของที่อยู่ใน remote ถ้า remote เขียนเป็น https://www.github.com กฎสำหรับ https://github.com จะไม่ทำงาน
ตรวจสอบผลลัพธ์: เช็กลิสต์รวม
หลังตั้งค่าทั้งห้าเครื่องมือแล้ว ให้รันการตรวจสอบสุดท้าย มันถูกออกแบบมาให้ตัดอิทธิพลของตัวแปรสภาพแวดล้อมออก เพื่อให้มั่นใจว่าเป็นคอนฟิกที่ทำงานจริง
- เปิดเทอร์มินัลใหม่และยกเลิกตัวแปรถ้ามีตั้งไว้: unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY no_proxy NO_PROXY ใน PowerShell: Remove-Item Env:HTTP_PROXY และอื่น ๆ ในทำนองเดียวกัน
- ตรวจสอบ npm: npm view express version คาดว่าจะได้เลขเวอร์ชัน
- ตรวจสอบ pip: pip download six --no-deps -d /tmp/t คาดว่าจะได้ไฟล์ whl ที่ดาวน์โหลดมา
- ตรวจสอบ apt: sudo apt update คาดว่าจะมีบรรทัด Hit หรือ Get โดยไม่มี Err
- ตรวจสอบ Docker: docker pull hello-world และ docker run --rm alpine env | grep -i proxy คาดว่าจะได้ image ที่ดาวน์โหลดและเห็นตัวแปรในคอนเทนเนอร์
- ตรวจสอบ git: git ls-remote https://github.com/git/git.git HEAD คาดว่าจะได้ hash ของ commit
ตัวชี้วัดความสำเร็จ
- ทั้งหกคำสั่งทำงานได้โดยไม่มีตัวแปรสภาพแวดล้อมในคอนโซล
- ในไฟล์ .npmrc, pip.conf, 80proxy, daemon.json, config.json และ .gitconfig มีสตริง proxy มาตรฐานเดียวกันเขียนอยู่
- ไฟล์ที่มีรหัสผ่าน (80proxy, daemon.json, .npmrc, pip.conf, .gitconfig) มีสิทธิ์ 600 หรือเข้าถึงได้เฉพาะ root
- ข้อยกเว้นสำหรับโฮสต์ภายในทำงาน: การเรียกไปยังโฮสต์เหล่านั้นผ่านได้แม้ปิด proxy
- ไฟล์สำรองของต้นฉบับวางอยู่ข้าง ๆ และคุณรู้วิธีrollback
การตรวจสอบ: ถ้ามีข้อใดไม่ผ่านอย่างน้อยหนึ่งข้อ ให้กลับไปที่หัวข้อของเครื่องมือนั้นและเทียบไฟล์ของคุณกับตัวอย่างในคู่มือทีละตัวอักษร ในเก้าในสิบกรณีสาเหตุคือพิมพ์ผิดหรืออักขระในรหัสผ่านยังไม่ได้เข้ารหัส
ข้อผิดพลาดทั่วไปและวิธีแก้
ข้อผิดพลาดที่ 1: รหัส 407 Proxy Authentication Required ทุกที่
สาเหตุ: รหัสผ่านมีอักขระพิเศษ (@, :, #, %) ที่ยังไม่ได้เข้ารหัส และเครื่องมือแยกวิเคราะห์ที่อยู่ผิด
วิธีแก้: เข้ารหัสอักขระด้วยรหัสเปอร์เซ็นต์ (@ เป็น %40, : เป็น %3A, # เป็น %23, % เป็น %25) แล้วทดสอบสตริงใหม่ผ่าน curl -x ก่อนเขียนลงคอนฟิก
ข้อผิดพลาดที่ 2: ทำงานจากเทอร์มินัลได้ แต่ผ่าน sudo ไม่ได้
สาเหตุ: sudo ล้างสภาพแวดล้อม และคุณยังไม่ได้สร้างคอนฟิก คลาสสิกสำหรับ apt
วิธีแก้: สร้าง /etc/apt/apt.conf.d/80proxy ตามขั้นตอนที่ 4 สำหรับเครื่องมืออื่นที่รันใต้ root จำไว้ว่า root อ่านโฮมไดเรกทอรีของตัวเองคือ /root ไม่ใช่ของคุณ ถ้าต้องใช้ npm หรือ pip ในนาม root คอนฟิกต้องอยู่ที่ /root/.npmrc หรือ /root/.config/pip/pip.conf
ข้อผิดพลาดที่ 3: Docker ไม่สตาร์ตหลังแก้ daemon.json
สาเหตุ: JSON ไม่ถูกต้อง: จุลภาคเกินหลังสมาชิกตัวสุดท้าย วงเล็บหาย หรือใช้เครื่องหมายคำพูดเดี่ยวแทนคู่
วิธีแก้: รัน sudo journalctl -u docker -n 30 หาบรรทัดที่ผิด แก้ไฟล์และตรวจสอบผ่าน python3 -m json.tool ก่อนรีสตาร์ตครั้งถัดไป ในกรณีเลวร้ายให้กู้คืนจาก daemon.json.bak
ข้อผิดพลาดที่ 4: docker pull ทำงาน แต่ apt-get ใน Dockerfile พัง
สาเหตุ: ตั้งเดมอนแล้วแต่ยังไม่ได้ตั้งไคลเอนต์ โปรเซสภายในคอนเทนเนอร์ไม่สืบทอดค่าตั้งของเดมอน
วิธีแก้: สร้าง ~/.docker/config.json ที่มีบล็อก proxies.default ตามส่วน C ของขั้นตอนที่ 5 หลังจากนั้น docker build จะส่งตัวแปรเข้าไปในขั้นตอน RUN โดยอัตโนมัติ
ข้อผิดพลาดที่ 5: ข้อผิดพลาดใบรับรอง SSL ในทุกเครื่องมือ
สาเหตุ: proxy ตรวจสอบทราฟฟิกและใส่ใบรับรองของตัวเองที่ระบบไม่ไว้ใจ
วิธีแก้: ขอ root certificate ของ proxy ในรูปแบบ PEM จากผู้ดูแลระบบแล้วระบุ: npm cafile, pip cert, git http.sslCAInfo สำหรับ apt และ Docker แค่เพิ่มใบรับรองเข้า trust store ของระบบ: คัดลอกไปที่ /usr/local/share/ca-certificates/ แล้วรัน sudo update-ca-certificates จากนั้นรีสตาร์ต Docker อย่าปิดการตรวจสอบใบรับรองด้วยแฟล็ก strict-ssl, trusted-host และ sslVerify
ข้อผิดพลาดที่ 6: pip ไม่สนใจ pip.conf
สาเหตุ: เครื่องมี Python หลายเวอร์ชัน และคุณแก้คอนฟิกของตัวหนึ่งแต่รันอีกตัว หรือไฟล์อยู่ในที่เก่าที่เวอร์ชันนี้ไม่อ่าน
วิธีแก้: รัน python3 -m pip config debug ด้วยคำสั่งเดียวกับที่คุณใช้ติดตั้งแพ็กเกจ เอาต์พุตจะแสดงไฟล์ที่ถูกพบ ย้ายการตั้งค่าไปยังเส้นทางผู้ใช้ที่พบ
ข้อผิดพลาดที่ 7: git วิ่งผ่าน proxy แม้ไปยังเซิร์ฟเวอร์ภายใน
สาเหตุ: กฎยกเว้นตั้งสำหรับ URL ที่ไม่ตรงกับที่อยู่ใน remote หรือตั้งใน .git/config ของ repository อื่น
วิธีแก้: ดูที่อยู่ที่แน่นอนผ่าน git remote -v คัดลอกส่วนต้นจนถึงชื่อโฮสต์แล้วตั้งกฎ http.URL_ที่แน่นอน.proxy ด้วยค่าว่างผ่าน --global
ข้อผิดพลาดที่ 8: ทุกอย่างทำงานได้ พอเปลี่ยนรหัสผ่าน proxy ก็พัง
สาเหตุ: รหัสผ่านฝังอยู่ในห้าที่ต่างกัน แต่ไม่ได้อัปเดตครบ
วิธีแก้: ใช้คำสั่ง grep -rl 'รหัสผ่านเก่า' ~/.npmrc ~/.config/pip ~/.gitconfig ~/.docker และ sudo grep -rl สำหรับ /etc/apt/apt.conf.d และ /etc/docker เพื่อหาทุกตำแหน่งแล้วอัปเดตแต่ละที่ จากนั้นรันเช็กลิสต์รวม
ความสามารถเพิ่มเติม
proxy ภายในเครื่องเป็นจุดเข้าเดียว
ถ้าข้อมูลยืนยันตัวตนของ proxy เปลี่ยนบ่อยหรือพูลที่อยู่หมุน IP การตั้ง proxy เบา ๆ ในเครื่องตัวเอง (เช่นที่ 127.0.0.1:3128) ที่รู้เองว่าจะไปไหนด้วยข้อมูลอะไร จะสะดวกมาก จากนั้นในห้าคอนฟิกก็เขียนที่อยู่เดียวโดยไม่ต้องมีรหัสผ่าน และเปลี่ยนข้อมูลจริงในที่เดียว วิธีนี้ยังช่วยเครื่องมือที่จัดการการยืนยันตัวตนใน URL ได้ไม่ดีด้วย
Mirror และ caching proxy สำหรับแพ็กเกจ
proxy ไม่จำเป็นต้องเป็นแบบอเนกประสงค์ สำหรับ apt มี caching proxy ที่เก็บไฟล์ deb ไว้ในเครื่องและแจกให้ทั้งออฟฟิศ สำหรับ npm และ pip บริษัทต่าง ๆ ตั้ง private registry ที่ proxy สาธารณะและ cache ไปด้วย ในกรณีนั้นแทนคีย์ proxy จะใช้ registry ใน .npmrc และ index-url ใน pip.conf ส่วน proxy สำหรับโลกภายนอกก็ตั้งบน registry นั้น สำหรับ Docker คีย์ registry-mirrors ใน daemon.json มีบทบาทคล้ายกัน
ตั้งแยกสำหรับแต่ละโปรเจกต์
.npmrc ของโปรเจกต์ข้าง package.json, pip.conf ใน venv และ .git/config ระดับ local ทำให้โปรเจกต์หนึ่งวิ่งผ่าน proxy แต่อีกโปรเจกต์ต่อตรงได้ เพียงอย่า commit ไฟล์ที่มีรหัสผ่านเข้า repository: เพิ่มใน .gitignore หรือใช้ตัวแปรแทนรูปแบบ ${PROXY_URL} ที่ npm ขยายจากสภาพแวดล้อมได้เมื่ออ่าน .npmrc
Automation สำหรับการกระจาย
คอนฟิกทั้งห้าเป็นไฟล์ข้อความธรรมดา สะดวกต่อการกระจายด้วยสคริปต์หรือระบบจัดการคอนฟิก: สคริปต์รับสตริงมาตรฐานมาเป็นพารามิเตอร์ตัวเดียวแล้วสร้างไฟล์ในรูปแบบที่ต้องการ สำหรับการตรวจสอบหลังกระจาย ใช้คำสั่งจากเช็กลิสต์รวม เพราะไม่ต้องมี interaction และเหมาะกับทดสอบอัตโนมัติ
ความปลอดภัยในการเก็บรหัสผ่าน
ขั้นต่ำคือสิทธิ์ 600 ในทุกไฟล์ที่มีรหัสผ่าน ที่ดีกว่าคือแยกความลับไปไฟล์ที่ include แยก (include ใน git, ไฟล์แยกใน apt.conf.d เฉพาะบรรทัดที่มียืนยันตัวตน) ที่ดีที่สุดคือ proxy ที่ไม่ต้องใช้รหัสผ่านแต่จำกัดตาม IP หรือใช้ proxy ภายในเครื่องแบบที่กล่าวข้างบน และอย่าส่งคอนฟิกที่มีรหัสผ่านเข้าแชตหรือ ticket ทั้งไฟล์เด็ดขาด
FAQ: คำถามที่พบบ่อยเกี่ยวกับการตั้งค่า
ต้องลบตัวแปร http_proxy จาก .bashrc ทิ้งไหม
ไม่จำเป็น คอนฟิกของเครื่องมือมีความสำคัญเหนือตัวแปร จะไม่ขัดกัน แต่ถ้าคุณอยากให้เฉพาะตัวจัดการแพ็กเกจวิ่งผ่าน proxy ส่วนเบราว์เซอร์และโปรแกรมอื่นต่อตรง จะลบตัวแปรออกดีกว่า เพราะมันมีผลกับทุกอย่าง
ทำไมใน https-proxy ของ npm ต้องเขียนที่อยู่ขึ้นต้นด้วย http:// ไม่ใช่ https://
เพราะนั่นคือที่อยู่ของ proxy เอง ไม่ใช่โปรโตคอลของทรัพยากรปลายทาง proxy ส่วนใหญ่รับการเชื่อมต่อผ่าน HTTP ธรรมดาและ tunnel HTTPS อยู่ข้างใน ถ้า proxy ของคุณรับการเชื่อมต่อ TLS จริง ๆ ก็เขียน https:// ได้ แต่หายาก
ใช้ SOCKS5 proxy ได้ไหม
npm - ไม่ได้ รองรับเฉพาะ HTTP proxy pip - ได้ ถ้าติดตั้งแพ็กเกจ pysocks และที่อยู่รูปแบบ socks5://host:port git - ได้ รูปแบบ socks5h://host:port ตัวอักษร h หมายถึงการ resolve ชื่อฝั่ง proxy apt - เฉพาะผ่าน transport เพิ่มเติม มาตรฐานไม่รองรับ Docker - ไม่ได้ ในทางปฏิบัติขอพอร์ต HTTP จากผู้ให้บริการจะง่ายกว่า
จะปิด proxy ในทุกเครื่องมืออย่างรวดเร็วได้อย่างไร
npm: npm config delete proxy และ npm config delete https-proxy pip: pip config unset global.proxy git: git config --global --unset http.proxy apt: ลบหรือเปลี่ยนชื่อ /etc/apt/apt.conf.d/80proxy Docker: ลบบล็อก proxies จาก daemon.json และ config.json แล้วรีสตาร์ตเซอร์วิส หรือแค่คืนไฟล์ .bak จากที่สำรองไว้
เก็บคอนฟิกใน Windows ที่ไหน
npm: C:\Users\ชื่อ\.npmrc pip: C:\Users\ชื่อ\AppData\Roaming\pip\pip.ini git: C:\Users\ชื่อ\.gitconfig Docker: C:\Users\ชื่อ\.docker\config.json สำหรับไคลเอนต์ และตั้งค่าผ่าน Docker Desktop สำหรับเดมอน apt ไม่ได้ใช้บน Windows ยกเว้นใน WSL ที่ใช้เส้นทางแบบ Linux ภายใน subsystem
ใช้ได้ใน WSL ไหม
ได้ WSL เป็น Linux ธรรมดา คอนฟิกทั้งหมดอยู่ในเส้นทางแบบ Linux ภายในดิสทริบิวชัน สังเกตว่า Docker Desktop ที่ผสานกับ WSL ใช้เดมอนฝั่ง Windows จึงตั้งค่าเดมอนผ่าน Docker Desktop ส่วน config.json ฝั่งไคลเอนต์อยู่ใน WSL ที่โฮมไดเรกทอรี
จะรู้ได้อย่างไรว่าเครื่องมือตัวไหนอ่านไฟล์ตัวไหน
npm config list --json, pip config debug, apt-config dump, docker info, git config --show-origin --list แต่ละคำสั่งไม่เพียงแสดงค่า แต่ยังแสดงแหล่งที่มาด้วย นี่คือสิ่งแรกที่ควรลองรันเมื่อแก้บั๊ก
ทำไม Docker Compose ไม่เห็น proxy
Compose เป็นไคลเอนต์ ใช้เดมอนตัวเดียวกับ ~/.docker/config.json ถ้า docker pull ทำงานแต่ docker compose pull ไม่ ให้ตรวจสอบว่าคุณรัน compose ด้วยผู้ใช้เดียวกันและในไฟล์ compose ไม่ได้เขียนทับตัวแปรสภาพแวดล้อมของคอนเทนเนอร์ที่ครอบ proxy อยู่
ตั้ง proxy ต่างกันสำหรับ npm กับ pip ได้ไหม
ได้ นี่แหละคือข้อดีของคอนฟิกเฉพาะเครื่องมือ แต่ละไฟล์เป็นอิสระจากกัน ตัวอย่างเช่น npm อาจวิ่งผ่าน proxy ตัวหนึ่ง ส่วน pip ผ่านอีกตัวที่มี IP และตำแหน่งทางภูมิศาสตร์ต่างกัน ถ้างานต้องการแบบนั้น
บทสรุป
มาสรุปกันครับ คุณได้ทดสอบ proxy ผ่าน curl และได้สตริงการเชื่อมต่อมาตรฐานพร้อมรหัสผ่านที่เข้ารหัสถูกต้อง จากนั้นเขียนมันลงห้าที่: ~/.npmrc สำหรับ npm, pip.conf สำหรับ pip, /etc/apt/apt.conf.d/80proxy สำหรับ apt, daemon.json และ ~/.docker/config.json สำหรับ Docker และ ~/.gitconfig สำหรับ git สำหรับแต่ละเครื่องมือคุณตั้งข้อยกเว้นสำหรับโฮสต์ภายในในจุดที่รองรับ และมั่นใจว่าทุกอย่างทำงานได้แม้สภาพแวดล้อมถูกล้างจนหมด นี่แหละคือสิ่งที่ทำให้คอนฟิกเฉพาะเครื่องมือต่างจากตัวแปรสภาพแวดล้อม: มันไม่ขึ้นกับว่าใคร จากที่ไหน และผ่านเซอร์วิสอะไรเรียกคำสั่งนั้น
ก้าวต่อไป ทำอะไรต่อดี เก็บไฟล์มาตรฐานทั้งห้าไว้ในโฟลเดอร์ส่วนตัวและเขียนสคริปต์สั้น ๆ ที่กระจายไปเครื่องใหม่ ตรวจสอบสิทธิ์ไฟล์ที่มีรหัสผ่าน ถ้ามีเพื่อนร่วมงานที่เจอปัญหาเดียวกัน แบ่งปันเช็กลิสต์รวมให้เขา เพราะมันประหยัดเวลาการแก้บั๊กได้หลายชั่วโมง
จะพัฒนาต่อไปไหน ระดับถัดไปคือ caching proxy และ private registry สำหรับแพ็กเกจ proxy ภายในเครื่องเป็นจุดเข้าเดียว และการตรวจสอบค่าตั้งเครือข่ายอัตโนมัติในไปป์ไลน์ และถ้าคุณต้องการตั้ง proxy ไม่ใช่สำหรับเครื่องมือ แต่สำหรับเซสชันเทอร์มินัลหรืองานใน CI โดยเฉพาะ ก็มีคู่มือแยกเรื่องตัวแปรสภาพแวดล้อมอยู่ ตอนนี้คุณรู้แล้วว่าขีดจำกัดของมันสิ้นสุดตรงไหน และความสามารถของคอนฟิกเริ่มต้นตรงไหน