วิธีแก้ไขข้อผิดพลาด “Nginx Proxy Service Stopped” ของ Zimbra

เมื่อ Zimbra รายงานว่า “Nginx Proxy Service Stopped” หมายความว่ากระบวนการพร็อกซีหยุดทำงาน หรือการตรวจสอบสถานะไม่สามารถยืนยันได้ว่ากำลังทำงานอยู่ การรีสตาร์ทอาจช่วยให้เข้าถึงได้อีกครั้งหากการหยุดทำงานเป็นเพียงชั่วคราว แต่ข้อความเดียวกันนี้อาจปรากฏขึ้นอีกหาก NGINX ไม่สามารถโหลดการกำหนดค่าที่สร้างขึ้น ผูกพอร์ตที่จำเป็น อ่านใบรับรอง หรือเข้าถึงเซิร์ฟเวอร์อัปสตรีมที่ถูกต้องได้ ผลลัพธ์ที่เป็นประโยชน์ไม่ใช่แค่สถานะสีเขียว: พร็อกซีควรทำงานต่อไป เว็บเมลของ Zimbra ควรโหลดผ่าน URL สาธารณะที่ต้องการ และบันทึกของพร็อกซีไม่ควรแสดงความล้มเหลวในการเริ่มต้นอีกต่อไป

คู่มือนี้ใช้กับระบบ Zimbra ที่ใช้บริการ Zimbra Proxy ที่มาพร้อมกับแพ็กเกจ คำสั่งและรายละเอียดการกำหนดค่าอาจแตกต่างกันไปตามเวอร์ชันและโครงสร้างของ Zimbra ในการติดตั้งแบบหลายเซิร์ฟเวอร์ ให้ตรวจสอบโหนดพร็อกซี และอย่าเปิดใช้งานพร็อกซีบนโหนดเมลบ็อกซ์หรือ MTA เพียงเพราะเซิร์ฟเวอร์อื่นรายงานว่าหยุดทำงานคู่มือพร็อกซี ของ Zimbra และเอกสารอ้างอิง CLI ของพร็อกซีจะอธิบายบริการและไฟล์วินิจฉัย บางหน้าในศูนย์เทคนิคอาจมีการระบุว่าอยู่ในระหว่างการพัฒนา ดังนั้นโปรดใช้ควบคู่ไปกับเอกสารประกอบสำหรับเวอร์ชันที่คุณติดตั้ง

1. ตรวจสอบว่าพร็อกซีควรทำงานบนเซิร์ฟเวอร์นี้หรือไม่

เชื่อมต่อกับเซิร์ฟเวอร์ Zimbra ที่โฮสต์พร็อกซี แล้วเปลี่ยนไปใช้บัญชี Zimbra ตรวจสอบทั้งรายการบริการโดยรวมและสถานะเฉพาะของพร็อกซี:

su - zimbra
zmcontrol status
zmproxyctl status
zmprov gs `zmhostname` zimbraServiceEnabled

ตรวจสอบproxyบริการที่เปิดใช้งานและกระบวนการ NGINX ที่กำลังทำงานอยู่ในเอาต์พุตสถานะ เอกสารของ Zimbra จะแสดงการดำเนิน การต่างๆ zmproxyctlเช่นstart, stop, restart, reload, และstatusหากโฮสต์นี้เป็นโหนดสำหรับกล่องจดหมายเท่านั้นหรือโหนด MTA เท่านั้น อาจคาดได้ว่าพร็อกซีจะหยุดทำงาน ยืนยันบทบาทของเซิร์ฟเวอร์ในการใช้งานของคุณก่อนที่จะพยายามเปิดใช้งาน

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

2. อ่านบันทึกข้อผิดพลาดของ NGINX ก่อนรีสตาร์ท

คู่มือการแก้ไขปัญหาพร็อกซีของ Zimbra ระบุ/opt/zimbra/log/nginx.logและ/opt/zimbra/log/nginx.access.logกำหนดบันทึกพร็อกซีที่สำคัญ ตรวจสอบรายการข้อผิดพลาดล่าสุดและตรวจสอบว่าไฟล์การกำหนดค่าหลักมีอยู่หรือไม่:

tail -n 100 /opt/zimbra/log/nginx.log
tail -n 50 /opt/zimbra/log/nginx.access.log
ls -l /opt/zimbra/conf/nginx.conf

ข้อความแสดงข้อผิดพลาดมักจะชี้ไปยังการตรวจสอบถัดไป หากไม่มีข้อมูลnginx.confแสดงว่าการกำหนดค่าที่สร้างขึ้นนั้นจำเป็นต้องได้รับการตรวจสอบ “พอร์ตไม่ถูกต้อง” ในlistenคำสั่งบ่งชี้ถึงการตั้งค่าพอร์ตหรือการผูกพอร์ต ข้อผิดพลาดเกี่ยวกับคีย์ส่วนตัวหรือใบรับรองบ่งชี้ถึงข้อมูล SSL ความล้มเหลวในการผูกพอร์ตแสดงว่ากระบวนการอื่นอาจเป็นเจ้าของที่อยู่และพอร์ตนั้นอยู่แล้ว

อย่าลบไฟล์การกำหนดค่า NGINX หรือแก้ไขไฟล์ที่สร้างขึ้นเพื่อแก้ไขข้อผิดพลาด Zimbra สร้างการกำหนดค่า NGINX จากเทมเพลตและค่าที่จัดเก็บไว้ในไดเร็กทอรีการกำหนดค่าและ LDAP คู่มือการกำหนดค่าพร็อกซีและเทมเพลต ของผู้จำหน่าย จะอธิบายรูปแบบการสร้างนี้ การแก้ไขไฟล์ที่สร้างขึ้นด้วยตนเองอาจถูกแทนที่ในระหว่างการรีสตาร์ทหรือการอัปเดตการกำหนดค่าในภายหลัง

3. ลองรีสตาร์ทพร็อกซีที่รองรับ แล้วตรวจสอบผลลัพธ์

หากบันทึกไม่แสดงข้อผิดพลาดในการกำหนดค่าหรือใบรับรองที่เกิดขึ้นอย่างถาวร ให้รีสตาร์ทบริการผ่านตัวควบคุมของ Zimbra โดยใช้ผู้ใช้ Zimbra:

zmproxyctl restart
zmproxyctl status

จากนั้นตรวจสอบรายการบริการทั้งหมดอีกครั้ง:

zmcontrol status

ผลลัพธ์ที่ประสบความสำเร็จคือ พร็อกซีรายงานว่ากำลังทำงานและยังคงทำงานต่อไปหลังจากคำสั่งเสร็จสิ้น เอกสารประกอบพร็อกซีของ Zimbra อธิบายzmproxyctl restartว่าเป็นการดำเนินการบริการที่เรียกใช้การสร้างการกำหนดค่าด้วย หลีกเลี่ยงการใช้พร็อกซีระดับระบบsystemctl restart nginxเป็นตัวแทน: Zimbra จัดการการกำหนดค่าและบริการพร็อกซีของตนเอง หากการรีสตาร์ทล้มเหลว ให้กลับไปที่ข้อผิดพลาดล่าสุดในnginx.log; การรีสตาร์ทซ้ำโดยไม่ตรวจสอบข้อผิดพลาดมักจะไม่แก้ไขสาเหตุ

4. จับคู่ข้อผิดพลาดกับวิธีแก้ไขที่กำหนดเป้าหมาย

หากไฟล์การกำหนดค่าหายไปหรือการสร้างล้มเหลว

หมายเหตุการแก้ไขปัญหาของ Zimbra สำหรับกรณีที่ค่าที่หายไป/opt/zimbra/conf/nginx.confอธิบายถึงกรณีที่การสร้างการกำหนดค่าพร็อกซีล้มเหลวเนื่องจากแอตทริบิวต์อัปสตรีมมีเซิร์ฟเวอร์ที่ไม่มีอยู่จริงหรือเซิร์ฟเวอร์ที่ไม่ใช่เซิร์ฟเวอร์เมลบ็อกซ์ ตรวจสอบค่าระดับเซิร์ฟเวอร์และค่าทั่วโลกที่เกี่ยวข้องก่อน:

zmprov -l gs `zmhostname` zimbraReverseProxyAvailableLookupTargets
zmprov -l gs `zmhostname` zimbraReverseProxyUpstreamEwsServers
zmprov -l gs `zmhostname` zimbraReverseProxyUpstreamLoginServers
zmprov -l gcf zimbraReverseProxyAvailableLookupTargets
zmprov -l gcf zimbraReverseProxyUpstreamEwsServers
zmprov -l gcf zimbraReverseProxyUpstreamLoginServers

เปรียบเทียบชื่อโฮสต์แต่ละชื่อกับรายการเซิร์ฟเวอร์ที่ใช้งานจริงและการออกแบบเส้นทางที่คุณต้องการ แก้ไขรายการที่ล้าสมัยหรือไม่ถูกต้องหลังจากยืนยันแล้วว่าเซิร์ฟเวอร์ใดควรได้รับทราฟฟิกนั้น อย่าคัดลอกชื่อโฮสต์ตัวอย่างจากหน้าเว็บของผู้จำหน่ายไปใช้ในระบบใช้งานจริงเอกสารการแก้ไขปัญหาอย่างเป็นทางการเรื่อง “Nginx ไม่สามารถเริ่มต้นได้”แสดงคำสั่งสร้างการกำหนดค่าสำหรับรูปแบบข้อผิดพลาด missing-config / generator-error ที่เฉพาะเจาะจง:

/opt/zimbra/libexec/zmproxyconfgen -s `zmhostname`
zmproxyctl restart

ใช้คำสั่งนี้เฉพาะเมื่อพบข้อผิดพลาดที่ตรงกับรูปแบบดังกล่าว และหลังจากตรวจสอบค่าที่เกี่ยวข้องแล้ว หากตัวสร้างยังคงแสดงข้อผิดพลาดหรือไฟล์ยังคงหายไป ให้หยุดและตรวจสอบร่องรอยการทำงานทั้งหมดและคุณลักษณะของเซิร์ฟเวอร์แทนที่จะเรียกใช้ซ้ำหลายครั้ง

หากในบันทึกรายงานพอร์ตไม่ถูกต้องหรือการเชื่อมต่อล้มเหลว

ขั้นแรก ให้ระบุว่า Listener ตัวใดที่ตั้งค่าไว้แล้วเกิดข้อผิดพลาด ตรวจสอบค่าพอร์ตของบริการ Zimbra และพร็อกซีสำหรับโหนดนี้ จากนั้นตรวจสอบว่ามีกระบวนการอื่นกำลังรับฟังอยู่ที่ที่อยู่ดังกล่าวหรือไม่ ตัวอย่างเช่น หากข้อความระบุพอร์ต 443 ให้ตรวจสอบว่า Listener HTTPS สาธารณะนั้นเป็นของ Zimbra NGINX หรือของเว็บเซิร์ฟเวอร์หรือเอเจนต์โหลดบาลานเซอร์แยกต่างหาก อย่าหยุดกระบวนการที่ไม่รู้จักหรือกำหนดพอร์ตใหม่จนกว่าคุณจะเข้าใจว่าไคลเอ็นต์เข้าถึงบริการได้อย่างไร

ข้อผิดพลาดเช่นนี้invalid port ...:0ไม่ใช่เหตุผลที่จะต้องเดาหมายเลขพอร์ต อาจบ่งชี้ถึงการตั้งค่าพร็อกซีที่ไม่สอดคล้องกันหรือการกำหนดค่าที่สร้างขึ้น เปรียบเทียบค่ากับโครงสร้างเครือข่ายที่คาดหวัง ตรวจสอบการเปลี่ยนแปลงล่าสุด และแก้ไขการตั้งค่าต้นทางผ่านเครื่องมือที่ Zimbra รองรับ จากนั้นรีสตาร์ทzmproxyctlและยืนยันว่า Listener ที่สร้างขึ้นนั้นถูกต้อง

หากการเริ่มต้นระบบล้มเหลวในระหว่างการโหลดใบรับรองหรือคีย์ส่วนตัว

อ่านข้อความแสดงข้อผิดพลาด SSL ทั้งหมดและระบุเส้นทางของใบรับรองที่ระบุไว้ในนั้น ตรวจสอบให้แน่ใจว่าใบรับรองและคีย์ส่วนตัวเป็นของเดียวกัน สามารถอ่านได้โดยบัญชีบริการที่คาดหวัง และยังไม่หมดอายุ เอกสารการแก้ไขปัญหาพร็อกซีของ Zimbra มีกรณีที่พร็อกซีไม่สามารถโหลดข้อมูลคีย์ได้ ปฏิบัติตามขั้นตอนการติดตั้งใบรับรองสำหรับเวอร์ชัน Zimbra ของคุณแทนที่จะเปลี่ยนไฟล์แบบเฉพาะกิจ การรีสตาร์ทที่สำเร็จควรจะแก้ไขข้อผิดพลาดในการเริ่มต้น SSL และเบราว์เซอร์ควรแสดงใบรับรองที่คาดหวังสำหรับชื่อโฮสต์เว็บเมลสาธารณะ

หาก NGINX เริ่มทำงานแล้ว แต่ผู้ใช้พบข้อผิดพลาดเกี่ยวกับเกตเวย์

การที่พร็อกซีทำงานอยู่ไม่ได้หมายความว่าแบ็กเอนด์ของเมลบ็อกซ์นั้นทำงานได้ปกติ สำหรับข้อความ “ไม่มีเส้นทางไปยังโฮสต์” Zimbra แนะนำให้ตรวจสอบการแก้ไข DNS จากโหนดพร็อกซีและการเข้าถึงระดับพอร์ตไปยังแบ็กเอนด์ที่ต้องการ สำหรับการตอบสนอง 502 หรือ 503 ให้ตรวจสอบบริการเมลบ็อกซ์และโฮสต์และพอร์ตต้นทาง คู่มือพร็อกซีระบุว่ากระบวนการเมลบ็อกซ์ที่ไม่พร้อมใช้งานอาจทำให้เกิดข้อผิดพลาด 503 ได้ ใช้แบ็กเอนด์และพอร์ตที่ถูกต้องสำหรับเวอร์ชันและโทโพโลยีของคุณ และตรวจสอบบันทึกของเซิร์ฟเวอร์เมลบ็อกซ์ก่อนที่จะเปลี่ยนเวลาหมดอายุของพร็อกซีหรือเกณฑ์ความล้มเหลว

5. ตรวจสอบการกู้คืนจากทั้งเซิร์ฟเวอร์และเบราว์เซอร์

หลังจากทำการซ่อมแซมเฉพาะจุดแล้ว โปรดตรวจสอบสิ่งต่อไปนี้ทั้งหมด:

• zmproxyctl statusรายงานว่าพร็อกซีกำลังทำงานอยู่
• zmcontrol statusแสดงบริการที่คาดหวังสำหรับโหนดนี้
• บรรทัดล่าสุด/opt/zimbra/log/nginx.logไม่แสดงข้อผิดพลาดในการเริ่มต้นระบบแบบเดิมอีกต่อไป
• ผู้รับฟังที่คาดหวังนั้นมีอยู่และเป็นของบริการที่ต้องการ บน Linux ผู้ดูแลระบบสามารถตรวจสอบผู้รับฟังได้ด้วยคำสั่งss -ltnp; รายละเอียดสิทธิ์และผลลัพธ์จะแตกต่างกันไปตามแต่ละระบบปฏิบัติการ
• เบราว์เซอร์สามารถเข้าถึงชื่อโฮสต์เว็บเมล Zimbra ปกติผ่าน HTTPS เข้าสู่ระบบ และโหลดกล่องจดหมายได้ หากไคลเอนต์ IMAP หรือ POP ใช้พร็อกซีนี้ด้วย ให้ทดสอบโปรโตคอลเหล่านั้นแยกต่างหาก

การตรวจสอบเหล่านี้กำหนดการกู้คืนที่มีประโยชน์: บริการทำงานอยู่ ตัวรับฟังมีอยู่ เส้นทางเบราว์เซอร์ใช้งานได้ และความล้มเหลวไม่ได้กลับมาทันที หากสถานะบริการเป็นสีเขียว แต่เว็บเมลยังคงใช้งานไม่ได้ ให้เปลี่ยนไปตรวจสอบ DNS, TLS, กฎไฟร์วอลล์, การกำหนดเส้นทางของโหลดบาลานเซอร์ หรือสถานะของระบบแบ็กเอนด์ของกล่องจดหมาย หากหยุดทำงานอีกครั้ง ให้เก็บรักษาบรรทัดบันทึกใหม่และเอาต์พุตของตัวสร้างการกำหนดค่าไว้ เพราะสิ่งเหล่านั้นมีประโยชน์มากกว่าการรีสตาร์ทแบบสุ่มสี่สุ่มห้าอีกครั้ง

ควรใช้การบันทึกข้อมูลการแก้ไขข้อผิดพลาดเฉพาะสำหรับการตรวจสอบระยะสั้นและควบคุมได้เท่านั้น

หากบันทึกปกติไม่สามารถอธิบายความล้มเหลวที่เกิดขึ้นอย่างต่อเนื่องได้ Zimbra แนะนำให้เพิ่มระดับการบันทึกของพร็อกซี NGINX ชั่วคราว การบันทึกข้อมูลการแก้ไขข้อผิดพลาดอาจเปิดเผยข้อมูลที่ละเอียดอ่อน รวมถึงโทเค็นการตรวจสอบสิทธิ์ ดังนั้นควรหลีกเลี่ยงการเปิดใช้งานในระบบที่ใช้งานจริงเว้นแต่จำเป็น หากฝ่ายสนับสนุนแนะนำให้คุณใช้งาน ให้จำกัดการเข้าถึงบันทึก รวบรวมเฉพาะสิ่งที่จำเป็น จากนั้นคืนค่าการตั้งค่ากลับไปเป็นค่าก่อนหน้า และจัดการบันทึกการแก้ไขข้อผิดพลาดตามนโยบายความปลอดภัยของคุณ โปรดดูคำแนะนำการบันทึกข้อมูลการแก้ไขข้อผิดพลาดของ NGINX จาก Zimbra สำหรับคำสั่งที่เหมาะสมกับเวอร์ชัน

หากการสร้างการกำหนดค่าล้มเหลวอย่างต่อเนื่อง ไม่สามารถตรวจสอบความถูกต้องของใบรับรองพร็อกซี ข้อผิดพลาดเกี่ยวข้องกับ Listener ที่ไม่รู้จัก หรือบทบาทของโหนดไม่ชัดเจน โปรดติดต่อผู้ดูแลระบบ Zimbra หรือฝ่ายสนับสนุนของผู้จำหน่าย ตัวควบคุมบริการสามารถรีสตาร์ทการกำหนดค่าที่ใช้งานได้ตามปกติ แต่ไม่สามารถกำหนดเส้นทางการส่งอีเมลที่ถูกต้อง ซ่อมแซมใบรับรองที่ไม่ถูกต้อง หรือแก้ไขเส้นทางเครือข่ายที่เสียหายได้ด้วยตนเอง

เอกสารอ้างอิงอย่างเป็นทางการ

• คู่มือการใช้งาน Zimbra Proxy: บันทึกข้อมูลและการแก้ไขปัญหาเบื้องหลัง
• คู่มือการใช้งาน Zimbra Proxy: คำสั่ง CLI ของพร็อกซี
• ศูนย์เทคโนโลยีซิมบรา: NGINX ไม่สามารถเริ่มต้นทำงานได้
• ศูนย์เทคโนโลยี Zimbra: ขั้นตอนสำหรับบริการพร็อกซีที่ไม่สามารถเริ่มต้นได้
• คู่มือการใช้งาน Zimbra Proxy: การตั้งค่าและการสร้างเทมเพลต

แหล่งข้อมูลที่ตรวจสอบเมื่อวันที่ 6 ตุลาคม 2026 หน้าเว็บ Zimbra Tech Center ที่อ้างอิงในที่นี้มีตัวอย่างเก่า และบางส่วนระบุว่าเป็นงานที่กำลังดำเนินการอยู่ โปรดยืนยันคำสั่งกับเวอร์ชัน Zimbra ที่ติดตั้งบนเซิร์ฟเวอร์ของคุณก่อนที่จะเปลี่ยนแปลงการกำหนดค่าการใช้งานจริง