การดู : 119

19/11/2026 00:00น.

ภาพประกอบสามมิติของโล่ตั้งขวางหน้าก้อนเมฆแทน repository โดยมีกุญแจทองลอยเข้าหา พร้อมตัวเลข 5.8 พันล้านครั้ง ซึ่งเป็นจำนวนครั้งที่สแกน ไม่ใช่จำนวน secret ที่ถูกบล็อก

git push ถูกบล็อกเพราะมี secret? GitHub push protection คืออะไรและแก้อย่างไร

#push protection

#secret scanning

#GitHub

#Git

#Octoverse 2026

ลองนึกภาพว่าคุณทำงานมาทั้งวัน พิมพ์ git push ด้วยความโล่งใจ แล้วเทอร์มินัลตอบกลับมาว่าการ push ถูกปฏิเสธ เหตุผลคือ GitHub ตรวจเจอสิ่งที่ดูเหมือน secret อยู่ในโค้ดที่คุณกำลังจะส่งขึ้นไปครับ

ฟีเจอร์ที่ทำแบบนี้ชื่อ push protection และรายงาน Octoverse 2026 ระบุว่ามันทำงานเป็นพันล้านครั้งในรอบปี วันนี้ Superdev Academy จะพาไปดูว่ามันคืออะไร ใครโดนบ้าง ถ้าโดนแล้วต้องทำอะไรตามลำดับ และทำไมการลบ secret ออกจาก commit ล่าสุดอย่างเดียวมักไม่พอครับ

Push protection คืออะไร

ตามเอกสาร About push protection ของ GitHub นี่คือฟีเจอร์ในกลุ่ม secret scanning ที่ออกแบบมาป้องกันการฝังข้อมูลลับ (hardcoded credentials) โดยจะบล็อกการ push ที่มี secret ก่อนที่มันจะไปถึง repository แทนที่จะรอแจ้งเตือนหลังหลุดไปแล้วครับ

เมื่อ push ถูกบล็อก GitHub จะแสดงข้อความอธิบายเหตุผลของการบล็อก เอกสารไม่ได้แสดงตัวอย่างข้อความจริง เราจึงไม่ยกมาให้ดู ขอให้ใช้ข้อความที่คุณเห็นบนเครื่องของคุณเองเป็นหลักครับ

ใครโดนบ้าง

เอกสารแยกเป็นสองระดับ ระดับแรกคือ user push protection ซึ่งเปิดอยู่เป็นค่าเริ่มต้นและใช้บน GitHub.com เท่านั้น มันกันไม่ให้คุณ push secret ขึ้น public repository และจะไม่สร้าง alert เมื่อมีการข้าม เว้นแต่ repository นั้นเปิดระดับที่สองด้วย

ระดับที่สองคือ repository push protection ซึ่งปิดอยู่เป็นค่าเริ่มต้น ต้องมี GitHub Secret Protection และเปิดโดยผู้ดูแลระดับ repository, organization หรือ enterprise ใช้บล็อกการ push secret เข้า repo ที่กำหนดครับ

เรื่องขนาดการใช้งาน Octoverse 2026 ระบุว่า push protection ทำงานสแกน 5.8 พันล้านครั้ง เกือบสี่เท่าของจังหวะปี 2025 ตัวเลขนี้คือจำนวนครั้งที่สแกน ไม่ใช่จำนวน secret ที่ถูกบล็อก จึงบอกได้แค่ว่าฟีเจอร์นี้ถูกใช้กว้างมาก และไม่ควรเอาไปอ่านเป็นอัตราการหลุดของ secret ครับ แหล่งที่มา: รายงาน Octoverse 2026

ถูกบล็อกแล้วทำอะไรตามลำดับ

เอกสารบอกวิธีแก้ไว้สั้นๆ ว่าให้ตรวจโค้ดที่ถูกชี้ ลบข้อมูลลับออก แล้วลอง push ใหม่ ในทางปฏิบัติมีจุดสะดุดอยู่ข้อหนึ่งที่มือใหม่เจอบ่อย จึงขอขยายเป็นขั้นตอนครับ

ขั้นที่ 1: หาว่า secret อยู่ใน commit ไหน

ใช้ git log -S ค้นประวัติด้วยข้อความที่เป็นส่วนของ secret ตัวอย่างนี้ใช้ค่าปลอมเพื่อการสอนครับ

git log -S"fake-demo-value" --oneline

ทีมเรารันคำสั่งนี้ใน repo ทดลองที่ใส่ค่าปลอมไว้ใน commit หนึ่งแล้วลบออกใน commit ถัดมา ผลคือคำสั่งแสดงทั้งสอง commit คือ commit ที่เพิ่มค่านั้นและ commit ที่ลบมัน นี่คือเหตุผลที่แก้แค่ commit ล่าสุดไม่พอ เพราะ commit เก่ายังมีข้อความนั้นอยู่ในประวัติที่คุณกำลังจะ push ครับ

ขั้นที่ 2: เขียนประวัติที่ยังไม่ได้ push ใหม่

ถ้า commit เหล่านั้นยังไม่เคย push ขึ้นไป คุณเขียนประวัติใหม่ได้ ตัวอย่างวิธีที่ง่ายคือถอย commit กลับด้วย git reset --soft แล้ว commit ใหม่โดยไม่มี secret

git reset --soft HEAD~2
git commit -m "add config (clean)"

ในการทดลองของเรา หลังทำแบบนี้ git log -S"fake-demo-value" --oneline ไม่พบ commit ใดเหลืออยู่ (ตัวเลข 2 ใน HEAD~2 คือจำนวน commit ที่ต้องถอย ปรับให้ตรงกับของคุณ) ถ้าต้องแก้เฉพาะ commit ล่าสุด ใช้ git commit --amend ได้ครับ

ขั้นที่ 3: เปลี่ยน secret ถ้ามันออกจากเครื่องไปแล้ว

ถ้า secret นั้นเคยถูกวางในแชต ส่งไป remote อื่น หรือขึ้น repo สาธารณะมาก่อน ให้ถือว่าหลุดแล้วและออกค่าใหม่ (rotate) เสมอ การลบจากประวัติไม่ทำให้ค่าเก่าหายไปจากที่ที่มันไปถึงแล้วครับ

ขั้นที่ 4: push ใหม่

git push

กด bypass ได้ไหม

ได้ในบางระดับ และต้องระวัง สำหรับ repository push protection เอกสารระบุว่าคนที่มีสิทธิ์เขียน (write access) ข้ามได้โดยเลือกเหตุผล มีสามแบบ คือ "It's used in tests" ปิด alert ว่าใช้ในเทสต์ "It's a false positive" ปิด alert ว่าตรวจผิด และ "I'll fix it later" ซึ่งปล่อยให้ alert เปิดค้างไว้ครับ

การข้ามทุกครั้งสร้าง alert ในแท็บ Security and quality บันทึกลง audit log และส่งอีเมลถึงเจ้าของหรือผู้ดูแลที่เกี่ยวข้อง นอกจากนี้ระดับ delegated bypass ยังให้ตั้งว่าใครอนุมัติคำขอข้ามของคนอื่นได้ ถ้าสิ่งที่ถูกบล็อกเป็น secret จริง ทางที่ถูกคือลบและ rotate ไม่ใช่ข้ามครับ

แต่ของฉันเป็นค่าทดสอบ ทำไมต้องโดนบล็อก

เป็นความรู้สึกที่เข้าใจได้ครับ และมีกรณีแบบนั้นจริง ตัวเลือก "It's used in tests" กับ "It's a false positive" ในเอกสารมีไว้ให้ก็เพราะเหตุนี้

แต่ระบบตรวจรูปแบบของข้อความ ไม่รู้ว่าค่านั้นเป็นของจริงหรือของทดสอบ ถ้าทีมของคุณมีค่าทดสอบที่หน้าตาเหมือน key จริงอยู่บ่อยๆ ให้เก็บไว้ในไฟล์ที่ไม่เข้า Git แล้วอ่านจาก environment variable จะสบายใจกว่าการมาข้ามทุกครั้งครับ

ป้องกันตั้งแต่ต้น

นิสัยที่ได้ผลที่สุดคือไม่ให้ secret เข้าไปอยู่ในโฟลเดอร์ที่ Git ติดตามตั้งแต่แรก สร้างไฟล์ .env เก็บค่าลับ ใส่ .env ลงใน .gitignore แล้วตรวจว่า Git เมินมันจริงด้วยคำสั่งนี้ครับ

git check-ignore -v .env

ถ้ามันแสดงบรรทัดที่ชี้ไปยัง .gitignore แปลว่าไฟล์ถูกเมินแล้ว ในโค้ดให้อ่านค่าจาก environment variable แทนการเขียนค่าลงไปตรงๆ ส่วนเรื่องการยืนยันตัวตนกับ GitHub โดยไม่ต้องฝัง token ในคำสั่ง เราเขียนไว้ใน SSH Key สำหรับ GitHub ครับ


สรุป: ลบให้หมดทั้งประวัติ แล้วเปลี่ยนค่าที่หลุด

Push protection ของ GitHub บล็อก push ที่มี secret ก่อนถึง repository user push protection เปิดเป็นค่าเริ่มต้นบน GitHub.com สำหรับ public repo ส่วนระดับ repository ต้องมีผู้ดูแลเปิด เมื่อถูกบล็อก ให้ค้นด้วย git log -S ว่า secret อยู่ใน commit ไหน เขียนประวัติที่ยังไม่ push ใหม่ให้ไม่มีมัน เปลี่ยนค่าถ้ามันเคยออกจากเครื่อง แล้วจึง push

ถ้าอยากเตรียมตัวก่อนโดนจริง ลองสร้าง repo ทดลอง ใส่ค่าปลอมสักตัว แล้วฝึกค้นกับเขียนประวัติใหม่ตามขั้นข้างบนให้คล่อง เมื่อวันที่จำเป็นมาถึง คุณจะแก้ได้ในไม่กี่นาทีครับ

ถ้าอยากฝึก Branch, Pull Request และ Code Review ให้คล่องขึ้น ลองดูคอร์ส Git & GitHub Essentials ของ Superdev Academy ยาว 2 ชั่วโมง 42 บทเรียน สอนเป็นภาษาไทย มีเอกสารประกอบและใบรับรอง สิทธิ์เรียน 12 เดือน คอร์สนี้เป็นพื้นฐานการทำงานกับ Git และ GitHub ไม่ใช่เนื้อหาเฉพาะเรื่อง push protection ดูคอร์สทั้งหมดได้ที่ learn.superdevacademy.com/courses

🎯 ติดตามความรู้สาย Dev ได้ที่ Superdev Academy:

FAQ: คำถามที่พบบ่อยเกี่ยวกับบทความนี้

รวมคำถามและคำตอบที่ช่วยให้คุณเข้าใจเนื้อหาในบทความนี้ได้ดียิ่งขึ้น