วิธีตั้งค่าเครือข่ายให้คอนเทนเนอร์สื่อสารผ่าน Gluetun
คอนเทนเนอร์ที่ใช้ network_mode: service:gluetun จะไม่มีอินเทอร์เฟซเครือข่ายเป็นของตัวเอง คุณต้องเผยแพร่พอร์ตผ่าน Gluetun และกำหนดค่า subnets ที่อนุญาตให้เข้าถึงได้เท่านั้น
เกิดอะไรขึ้นเมื่อคอนเทนเนอร์เข้าร่วมเครือข่ายของ gluetun
คอนเทนเนอร์ที่ตั้งค่า network_mode: service:gluetun จะไม่มีอินเทอร์เฟซเครือข่ายเป็นของตัวเอง คอนเทนเนอร์นั้นจะเข้าร่วม network namespace ของ gluetun ส่งผลให้การเปิดพอร์ต (port publishing) และกฎไฟร์วอลล์ไม่ได้เป็นคุณสมบัติของคอนเทนเนอร์นั้นอีกต่อไป แต่กลายเป็นคุณสมบัติของบริการ gluetun แทน คำตอบทุกข้อด้านล่างนี้เป็นผลสืบเนื่องมาจากข้อเท็จจริงดังกล่าว
Network namespace คือสำเนาส่วนตัวของ stack เครือข่ายในระดับเคอร์เนล ซึ่งประกอบด้วยอินเทอร์เฟซของตัวเอง ตารางการกำหนดเส้นทาง (routing table) ของตัวเอง กฎไฟร์วอลล์ของตัวเอง และซ็อกเก็ตที่รอรับการเชื่อมต่อ (listening sockets) ของตัวเอง โดยปกติ Docker จะสร้าง namespace ให้คอนเทนเนอร์ละหนึ่งชุด แต่เมื่อคุณระบุ network_mode: service:gluetun ตัว Docker จะข้ามขั้นตอนนั้นไปและนำคอนเทนเนอร์ใหม่เข้าไปอยู่ใน namespace ที่ gluetun ใช้งานอยู่แล้ว คอนเทนเนอร์จะยังคงมีระบบไฟล์เป็นของตัวเอง แต่จะไม่มี /etc/hosts หรือ /etc/resolv.conf เป็นของตัวเอง เนื่องจาก Docker จะส่งไฟล์ชุดเดียวกับที่ gluetun ใช้งานให้ ซึ่งประเด็นนี้มีความสำคัญในภายหลัง
คุณสามารถตรวจสอบเรื่องนี้ได้โดยตรง
docker inspect -f '{{.HostConfig.NetworkMode}}' qbittorrentคำสั่งดังกล่าวจะแสดงผล container: ตามด้วย ID ของคอนเทนเนอร์ gluetun ในขณะที่คอนเทนเนอร์ทั่วไปจะแสดงผลเป็น bridge คู่มือนี้จะอธิบายต่อจากหัวข้อ การกำหนดเส้นทางทราฟฟิก Docker ผ่าน VPN ด้วย gluetun ซึ่งในขณะนี้อุโมงค์เครือข่ายทำงานได้แล้ว แต่ยังไม่มีสิ่งใดสามารถสื่อสารกับคอนเทนเนอร์ได้
เผยแพร่พอร์ตบน gluetun ไม่ใช่บนแอปพลิเคชัน
หากทิ้งบล็อก ports: ไว้บนเซอร์วิสที่ตั้งค่า network_mode ไว้ Docker จะปฏิเสธการสร้างคอนเทนเนอร์:
Error response from daemon: conflicting options: port publishing and the container type network modeเหตุผลนั้นตรงไปตรงมา การเผยแพร่พอร์ตหมายถึงการเพิ่มกฎ NAT (network address translation) เพื่อส่งต่อพอร์ตของโฮสต์เข้าไปยัง network namespace ของคอนเทนเนอร์ ซึ่งคอนเทนเนอร์นี้ไม่มี namespace เป็นของตนเอง ให้ย้ายการแมปพอร์ตไปไว้ที่เซอร์วิส gluetun แทน หมายเลขพอร์ตไม่ต้องเปลี่ยนแปลง เนื่องจากแอปพลิเคชันยังคงฟังพอร์ตนั้นอยู่ภายใน namespace ที่ใช้ร่วมกัน
services:
gluetun:
ports:
- "8080:8080/tcp" # qBittorrent web UI
qbittorrent:
network_mode: "service:gluetun"
# no ports: block hereบล็อก expose: บนเซอร์วิสที่เป็น dependency จะล้มเหลวในลักษณะเดียวกันด้วย conflicting options: port exposing and the container type network mode และบล็อก networks: ในจุดนั้นก็ถือเป็นข้อผิดพลาดร้ายแรงเช่นกัน โดย Compose จะรายงานว่าเซอร์วิสมีการประกาศค่า network_mode และ networks ที่ขัดแย้งกันเอง และปฏิเสธที่จะโหลดไฟล์ดังกล่าวทั้งหมด
ผลกระทบประการหนึ่งจะปรากฏในภายหลัง คอนเทนเนอร์ทุกตัวใน namespace เดียวกันจะใช้พื้นที่พอร์ตชุดเดียวกัน ดังนั้นหากแอปพลิเคชันสองตัวมีค่าเริ่มต้นเป็น 8080 ทั้งคู่จะเกิดการชนกัน และตัวที่เริ่มทำงานทีหลังจะล้มเหลวด้วยข้อผิดพลาด address already in use ให้เปลี่ยนค่าของตัวใดตัวหนึ่งในการตั้งค่าของแอปนั้นเอง เช่น ตัวแปร WEBUI_PORT ในอิมเมจ qBittorrent ของ LinuxServer จากนั้นจึงเผยแพร่หมายเลขพอร์ตใหม่บน gluetun
คอนเทนเนอร์ที่อยู่หลัง gluetun สื่อสารกันเองได้อย่างไร
ภายในเนมสเปซเดียวกัน คอนเทนเนอร์จะใช้ loopback interface ร่วมกันอยู่แล้ว คอนเทนเนอร์ที่อยู่หลัง gluetun สามารถเข้าถึงคอนเทนเนอร์พี่น้องได้ที่ 127.0.0.1:<port> โดยไม่ต้องผ่าน Docker network ใดๆ
จากภายนอกเนมสเปซ คอนเทนเนอร์นี้จะไม่มีชื่อเรียก ระบบ DNS ฝังตัวของ Docker จะแปลงชื่อบริการให้เป็นที่อยู่บนเครือข่ายที่ผู้ใช้กำหนด แต่คอนเทนเนอร์นี้ไม่มีที่อยู่บนเครือข่ายใดเลย ดังนั้นคอนเทนเนอร์ทั่วไปอย่าง Sonarr จึงไม่สามารถเข้าถึงไคลเอนต์ torrent ได้ที่ http://qbittorrent:8080 แต่จะเข้าถึงได้ที่ http://gluetun:8080 เนื่องจากซ็อกเก็ตกำลังรอรับการเชื่อมต่ออยู่ในเนมสเปซของ gluetun และใช้ที่อยู่ของ gluetun สิ่งนี้มักทำให้ผู้ที่เข้าใจ วิธีการทำงานของ Docker Compose networks และ service names รู้สึกแปลกใจ เพราะคาดหวังว่าการเรียกชื่อแบบปกติจะใช้งานได้ นอกจากนี้ยังสามารถทำงานได้โดยไม่ต้องเปิดพอร์ตใดๆ ออกสู่โฮสต์ เนื่องจากคอนเทนเนอร์ทั้งสองอยู่ใน Compose network เดียวกัน
ให้ตรวจสอบ DNS ก่อนเริ่มแก้ไขปัญหาอื่นใด gluetun รันเซิร์ฟเวอร์ DNS ของตัวเองไว้ภายในเนมสเปซ และ Docker จะกำหนดไฟล์ /etc/resolv.conf ชุดเดียวกันให้กับทุกคอนเทนเนอร์ที่อยู่หลัง gluetun ดังนั้นการค้นหาข้อมูลของแอปพลิเคชันคุณจะผ่านตัวแก้ไขชื่อ (resolver) ของ gluetun แทนที่จะเป็นของโฮสต์ โดยค่าเริ่มต้นตัวแก้ไขชื่อนี้จะปฏิเสธคำตอบที่ชี้ไปยังที่อยู่ส่วนตัว (private addresses) ซึ่งเป็นสาเหตุว่าทำไมชื่อที่แปลงค่าได้บนโฮสต์ถึงอาจล้มเหลวเมื่ออยู่ภายในคอนเทนเนอร์ เอกสารของ gluetun ระบุว่าชื่อโฮสต์ดังกล่าวจะต้องถูกระบุไว้ใน DNS_REBINDING_PROTECTION_EXEMPT_HOSTNAMES
docker exec qbittorrent cat /etc/resolv.confฉันจะเข้าถึงบริการที่รันอยู่บน Docker host ได้อย่างไร
ให้ใช้ host.docker.internal โดยต้องตั้งค่าสองส่วนบน service ของ gluetun เนื่องจากมีปัญหาที่ต้องแก้ไขสองจุด
ส่วนแรกคือชื่อ host โดย container ที่อยู่หลัง gluetun จะอ่านค่า /etc/hosts ของ gluetun และ Docker จะปฏิเสธรายการ extra_hosts บน service ที่ตั้งค่า network_mode ด้วย conflicting options: custom host-to-IP mapping and the network mode ดังนั้นรายการนี้จึงต้องระบุไว้ที่ gluetun เพื่อให้ทุก container ใน namespace เดียวกันมองเห็น
gluetun:
extra_hosts:
- "host.docker.internal:host-gateway"host-gateway เป็นค่าพิเศษที่ Docker จะแทนที่ด้วยที่อยู่ภายในของตัว host เอง สำหรับการติดตั้ง Docker บน Linux ทั่วไป ค่านี้คือที่อยู่ของ bridge docker0 ซึ่งมักจะเป็น 172.17.0.1 ให้ตรวจสอบค่าของคุณด้วยคำสั่ง ip -4 addr show docker0 บน VPS สำหรับ Docker Desktop นั้นจะแก้ไขชื่อนี้ได้เองโดยอัตโนมัติ ซึ่งเป็นเหตุผลว่าทำไมคู่มือที่เขียนบนแล็ปท็อปจึงข้ามบรรทัด extra_hosts ไป และทำให้ไฟล์เดียวกันใช้งานไม่ได้เมื่อนำไปใช้บนเซิร์ฟเวอร์
ส่วนที่สองคือเส้นทาง (route) การเพิ่มชื่อ host เพียงอย่างเดียวทำได้แค่บอก container ว่าต้องใช้ที่อยู่ใด แต่แพ็กเก็ตข้อมูลยังคงถูกส่งออกผ่านเส้นทางเริ่มต้นของ gluetun ซึ่งก็คือ tunnel และ firewall ของ gluetun จะทำการดรอปแพ็กเก็ตนั้น อาการที่พบคือการเชื่อมต่อจะค้างแล้วหมดเวลา (timeout) แทนที่จะถูกปฏิเสธ (refused) การถูกปฏิเสธหมายความว่าแพ็กเก็ตส่งไปถึงและมีบางอย่างตอบกลับมาว่าไม่ได้ แต่การหมดเวลาหมายความว่าแพ็กเก็ตไปไม่ถึงปลายทาง
gluetun:
environment:
- FIREWALL_OUTBOUND_SUBNETS=172.17.0.1/32จากนั้นให้ตรวจสอบว่าบริการบน host กำลังรอรับการเชื่อมต่อ (listening) ที่ที่อยู่นั้นจริงหรือไม่ หาก PostgreSQL server ถูกผูกไว้ (bind) กับ 127.0.0.1 เพียงอย่างเดียว จะไม่สามารถเข้าถึงได้จาก container ใดๆ ที่มี network namespace ของตัวเอง ซึ่งรวมถึงทุก container ที่อยู่หลัง gluetun ไม่ว่าจะผ่าน tunnel หรือไม่ก็ตาม เพราะ 127.0.0.1 ภายใน namespace นั้นคือ loopback ของตัว namespace เอง มีเพียง container ที่ใช้ host networking เท่านั้นที่จะใช้ loopback ร่วมกับ host ได้ และ container ที่อยู่หลัง gluetun ได้ใช้ network_mode ไปกับ gluetun แล้ว ให้เปลี่ยนไปผูก PostgreSQL กับ 172.17.0.1 แทน ซึ่งจะยอมรับการเชื่อมต่อจาก container โดยยังคงไม่เปิดเผยบน public interface ให้ตรวจสอบความถูกต้องด้วยคำสั่ง ss -lntp | grep 5432 บน host
สิ่งที่ FIREWALL_OUTBOUND_SUBNETS เปลี่ยนแปลงจริง
เอกสารของ gluetun อธิบายว่าค่านี้คือรายการ subnet ที่คั่นด้วยเครื่องหมายจุลภาค ซึ่ง gluetun และคอนเทนเนอร์ที่ใช้ network stack ร่วมกันได้รับอนุญาตให้เข้าถึงได้ โดยระบุว่ามีการเปลี่ยนแปลงทั้งในส่วนของ firewall และ routing ทั้งสองส่วนนี้มีความสำคัญเท่ากัน gluetun จะเพิ่มเส้นทาง (route) สำหรับแต่ละ subnet ที่ระบุผ่าน Docker bridge gateway เพื่อให้แพ็กเก็ตสำหรับที่อยู่เหล่านั้นออกทาง eth0 แทนที่จะออกทาง VPN tunnel นอกจากนี้ยังเป็นการเปิด firewall สำหรับ subnet เหล่านั้นด้วย เนื่องจากโดยปกติแล้ว gluetun จะทิ้ง (drop) ทราฟฟิกขาออกที่ไม่มุ่งหน้าไปยัง VPN server
ให้ระบุค่าโดยไม่มีช่องว่างหลังเครื่องหมายจุลภาค
- FIREWALL_OUTBOUND_SUBNETS=172.17.0.1/32,192.168.1.0/24,100.64.7.9/32มีคุณสมบัติสองประการที่มักถูกมองข้าม ประการแรก การตั้งค่านี้เป็นระดับ namespace ดังนั้นจึงมีผลกับทุกคอนเทนเนอร์ที่อยู่เบื้องหลัง gluetun ไม่ใช่แค่คอนเทนเนอร์ที่คุณตั้งใจไว้เท่านั้น ประการที่สอง การตั้งค่านี้มีผลเฉพาะขาออก (outbound) เท่านั้น โดยจะควบคุมการเชื่อมต่อที่คอนเทนเนอร์เป็นผู้เริ่ม ส่วนการเชื่อมต่อที่เข้ามายังพอร์ตที่เปิดไว้ (published port) จะใช้เส้นทางอื่นและไม่จำเป็นต้องระบุในส่วนนี้
การเข้าถึงเว็บ UI จาก Tailscale peer
Tailscale กำหนดที่อยู่ให้ทุกเครื่องใน 100.64.0.0/10 ซึ่งเป็นช่วงที่สงวนไว้สำหรับ carrier grade NAT การใช้งานนี้ไม่มีค่าใช้จ่ายสำหรับ tailnet ส่วนบุคคล แม้ว่า ขีดจำกัดผู้ใช้ 6 คนของแผนฟรี จะเป็นตัวกำหนดว่าเงื่อนไขนี้ยังคงอยู่หรือไม่เมื่อผู้อื่นต้องการเข้าถึง UI เดียวกัน อุปกรณ์ของผู้ใช้ไม่มีการจำกัดจำนวนในทุกแผน ส่วนเซิร์ฟเวอร์และอุปกรณ์ที่ติดแท็ก (tagged devices) จะถูกนับแยกต่างหาก โดยหน้าการเรียกเก็บเงินของ Tailscale ระบุว่ารวมทรัพยากรที่ติดแท็กไว้ 50 รายการ และรายการถัดไปมีค่าใช้จ่าย 1 ดอลลาร์ต่อเดือน เนื่องจากโดยปกติการเรียกเก็บเงินจะนับที่จำนวนผู้ใช้มากกว่าจำนวนเครื่อง ค่าใช้จ่ายจริงของ tailnet แบบชำระเงิน จึงขึ้นอยู่กับจำนวนคนที่คุณเชิญ ไม่ใช่จำนวนคอนเทนเนอร์ที่คุณเปิดให้เข้าถึง ทั้งสองทิศทางต้องใช้วิธีการที่แตกต่างกัน
การเข้าถึงขาเข้า (Inbound) เป็นส่วนที่ง่าย การประกาศ 8080:8080 บน gluetun จะผูกพอร์ตนั้นเข้ากับทุกที่อยู่ของโฮสต์ และอินเทอร์เฟซ tailscale0 ของโฮสต์ก็เป็นหนึ่งในนั้น ดังนั้น peer จึงสามารถเปิด http://<machine-name>:8080 เพื่อเข้าถึงคอนเทนเนอร์ได้ Gluetun ไม่มีส่วนเกี่ยวข้องในเส้นทางนี้ เนื่องจากกฎ NAT ของ Docker อยู่ที่ระดับโฮสต์ ซึ่งอยู่นอก namespace
หากต้องการให้เข้าถึง UI ได้เฉพาะผ่าน tailnet เท่านั้น ให้ผูกพอร์ตที่ประกาศไว้เข้ากับที่อยู่ Tailscale ของโฮสต์แทนที่จะผูกกับทุกที่อยู่
ports:
- "100.101.102.103:8080:8080/tcp"ค้นหาที่อยู่นั้นด้วย tailscale ip -4 บนโฮสต์ การผูกพอร์ต (binding) เป็นการควบคุมที่เข้มงวดกว่ากฎไฟร์วอลล์ในกรณีนี้ เพราะพอร์ตจะไม่ถูกเปิดบนอินเทอร์เฟซสาธารณะเลย หากคุณต้องการเข้าถึง UI ผ่านชื่อ HTTPS แทนการใช้โฮสต์และพอร์ต tailscale serve สามารถทำหน้าที่เป็นหน้าด่านให้กับพอร์ตที่ประกาศไว้ได้ แม้ว่า serve และ funnel จะมีความแตกต่างกันในเรื่องผู้ที่สามารถเข้าถึงได้ และมีเพียงหนึ่งในสองวิธีนี้เท่านั้นที่คง UI ไว้บน tailnet นอกจากนี้ยังช่วยเลี่ยงปัญหาใน การที่ Docker ประกาศพอร์ตข้าม ufw โดยตรง รูปแบบ Tailscale sidecar สำหรับ Compose จะก้าวไปอีกขั้นด้วยการตัดพอร์ตโฮสต์ออกไปทั้งหมด แต่รูปแบบนี้ทำงานโดยการนำแอปไปไว้ใน network namespace ของ sidecar ซึ่งคอนเทนเนอร์ที่อยู่หลัง gluetun ได้ใช้ network_mode ไปกับ gluetun แล้ว
การเข้าถึงขาออก (Outbound) คือจุดที่ FIREWALL_OUTBOUND_SUBNETS กลับมามีบทบาท หากคอนเทนเนอร์จำเป็นต้องเรียกใช้ peer ให้เพิ่มที่อยู่ของ peer นั้น และควรเลือกใช้ /32 ต่อ peer แทนการใช้ /10 ทั้งหมด หากเครื่องที่คุณกำลังเรียกใช้งานอยู่ในเครือข่ายส่วนตัวที่เข้าถึงผ่าน VPS ที่ประกาศ subnet นั้นไปยัง tailnet ของคุณ ให้ระบุช่วงที่ประกาศแทนที่ที่อยู่ 100.x ของเราเตอร์เอง และตรวจสอบว่าโฮสต์ได้ยอมรับเส้นทางเหล่านั้นแล้ว โดยปกติชื่อ MagicDNS จะไม่สามารถ resolve ภายในคอนเทนเนอร์ได้ เนื่องจากคอนเทนเนอร์ใช้ DNS server ของ gluetun แทน resolver ของโฮสต์ ดังนั้นให้ใช้ที่อยู่ตัวเลข 100.x หรือกำหนดชื่อด้วยบรรทัด extra_hosts ในบริการ gluetun ตัวเลือก DNS_UPSTREAM_PLAIN_ADDRESSES ของ gluetun สามารถส่งต่อคำขอไปยัง resolver อื่นได้ แต่จะส่งทุกคำขอเป็นข้อความธรรมดา (plaintext) ซึ่งเอกสารของ gluetun ไม่แนะนำให้ทำเนื่องจากคำขอไปยังที่อยู่ส่วนตัวจะรั่วไหลออกจาก VPN tunnel กรณีเดียวกันนี้ยังใช้กับการที่คุณรัน Tailscale control server ของคุณเองด้วย Headscale
ไฟล์ compose ฉบับสมบูรณ์สำหรับรูปแบบทั่วไป
ไคลเอนต์ดาวน์โหลดที่อยู่หลัง VPN, เว็บ UI สองรายการที่ตอบสนองเฉพาะบน tailnet และคอนเทนเนอร์หนึ่งรายการที่อ่านฐานข้อมูล PostgreSQL ซึ่งรันอยู่บนโฮสต์
services:
gluetun:
image: qmcgaw/gluetun:latest
container_name: gluetun
cap_add:
- NET_ADMIN
devices:
- /dev/net/tun:/dev/net/tun
ports:
- "127.0.0.1:8000:8000/tcp" # gluetun control server, host only
- "100.101.102.103:8080:8080/tcp" # qBittorrent UI, tailnet only
- "100.101.102.103:9696:9696/tcp" # Prowlarr UI, tailnet only
extra_hosts:
- "host.docker.internal:host-gateway"
volumes:
- ./gluetun:/gluetun
environment:
- VPN_SERVICE_PROVIDER=mullvad
- VPN_TYPE=wireguard
- WIREGUARD_PRIVATE_KEY=${WIREGUARD_PRIVATE_KEY}
- WIREGUARD_ADDRESSES=${WIREGUARD_ADDRESSES}
- SERVER_CITIES=Amsterdam
- FIREWALL_OUTBOUND_SUBNETS=172.17.0.1/32,100.64.7.9/32
- TZ=Europe/Amsterdam
restart: unless-stopped
qbittorrent:
image: lscr.io/linuxserver/qbittorrent:latest
network_mode: "service:gluetun"
environment:
- PUID=1000
- PGID=1000
- TZ=Europe/Amsterdam
- WEBUI_PORT=8080
volumes:
- ./qbittorrent:/config
- /srv/downloads:/downloads
depends_on:
gluetun:
condition: service_healthy
restart: unless-stopped
prowlarr:
image: lscr.io/linuxserver/prowlarr:latest
network_mode: "service:gluetun"
environment:
- PUID=1000
- PGID=1000
- TZ=Europe/Amsterdam
- PROWLARR__POSTGRES__HOST=host.docker.internal
- PROWLARR__POSTGRES__PORT=5432
- PROWLARR__POSTGRES__USER=prowlarr
- PROWLARR__POSTGRES__PASSWORD=${PROWLARR_DB_PASSWORD}
- PROWLARR__POSTGRES__MAINDB=prowlarr-main
- PROWLARR__POSTGRES__LOGDB=prowlarr-log
volumes:
- ./prowlarr:/config
depends_on:
gluetun:
condition: service_healthy
restart: unless-stoppedให้ศึกษารูปแบบจากไฟล์นี้แทนที่จะสนใจชื่อผลิตภัณฑ์ UI ทั้งสองรายการถูกเผยแพร่บน gluetun และผูกไว้กับที่อยู่ tailnet ของโฮสต์ ดังนั้นจึงตอบสนองผ่าน Tailscale เท่านั้นและไม่ตอบสนองจากที่อื่น บรรทัด extra_hosts ยังคงอยู่ที่ gluetun เนื่องจาก Prowlarr จะอ่าน /etc/hosts ของ gluetun เมื่อทำการ resolve host.docker.internal และ Docker จะปฏิเสธบรรทัดนี้หากใส่ไว้ใน Prowlarr โดยตรง FIREWALL_OUTBOUND_SUBNETS ระบุที่อยู่เดี่ยวสองรายการ ได้แก่ ที่อยู่ Docker bridge ของโฮสต์เพื่อให้ Prowlarr สามารถเปิดการเชื่อมต่อฐานข้อมูลได้ และที่อยู่ของ peer ใน tailnet หนึ่งรายการ
เซิร์ฟเวอร์ PostgreSQL ถูกละไว้จากไฟล์นี้โดยเจตนา โดยรันอยู่บน VPS ในฐานะ system service ปกติที่ฟังบน 172.17.0.1:5432 ซึ่งเป็นการจัดเลเยอร์แบบเดียวกับ arr stack บน Docker Compose โดยย้ายฐานข้อมูลออกมาไว้นอก Docker
เก็บ WireGuard private key ไว้นอกไฟล์ compose โดย ${WIREGUARD_PRIVATE_KEY} จะอ่านจากไฟล์ .env ที่วางอยู่ข้างกัน ซึ่งเป็นรูปแบบที่อธิบายไว้ใน env files และ secrets สำหรับ Docker Compose ส่วนคำสั่ง condition: service_healthy ใช้ healthcheck ที่มาพร้อมกับอิมเมจ gluetun อยู่แล้ว ดังนั้นบริการต่างๆ จะไม่เริ่มทำงานจนกว่า tunnel จะรายงานสถานะว่าพร้อมใช้งาน Compose healthchecks อธิบายรูปแบบการใช้งานทั่วไปไว้
การเผยแพร่บนทุกที่อยู่แทนที่จะเป็นเฉพาะ tailnet
ให้ลบ prefix ของที่อยู่และการผูกพอร์ตบน 0.0.0.0 ออก ซึ่งรวมถึง IP สาธารณะของ VPS ด้วย ให้ดำเนินการนี้เฉพาะเมื่ออยู่หลังไฟร์วอลล์ที่คุณควบคุมได้เท่านั้น และโปรดอ่านหมายเหตุเกี่ยวกับ ufw ด้านบนก่อน
ports:
- "8080:8080/tcp"ยืนยันว่า tunnel ยังคงรับส่งข้อมูล
ให้รันคำขอเดิมสองครั้ง ครั้งแรกจากภายใน namespace และครั้งที่สองจาก host จากนั้นนำมาเปรียบเทียบกัน
docker run --rm --network=container:gluetun curlimages/curl:latest -s https://api.ipify.org
curl -s https://api.ipify.orgคำขอแรกควรแสดง exit address ของผู้ให้บริการ VPN ของคุณ ส่วนคำขอที่สองควรแสดง address ของ VPS หากทั้งสองค่าตรงกัน แสดงว่าข้อมูลของ container ไม่ได้ผ่าน tunnel และการแก้ไขทุกอย่างในคู่มือนี้จะไม่มีผลจนกว่าจะแก้ไขปัญหานี้ให้ถูกต้อง
กฎการ routing และตาราง routing จะแสดงให้เห็นว่าข้อมูลใดที่ไม่ได้ผ่าน tunnel
docker run --rm --network=container:gluetun alpine:3.22 sh -c 'ip rule show; ip route show table 51820; ip route show table 199'สำหรับการตั้งค่า WireGuard ในคู่มือนี้ gluetun จะตั้งชื่อ interface ของ tunnel ว่า wg0 ส่วนชื่อ tun0 เป็นค่าเริ่มต้นของ OpenVPN เท่านั้น นอกจากนี้ gluetun ยังแยก default route ของ tunnel ออกจากตาราง routing หลัก โดย ip rule show ควรมีกฎที่ส่งข้อมูลทั้งหมดที่ไม่ได้ถูกทำเครื่องหมายโดย WireGuard เองไปยังตาราง 51820 และตารางนั้นควรมี default route อยู่บน wg0 ตาราง 199 จะเก็บ route หนึ่งรายการต่อหนึ่ง entry ใน FIREWALL_OUTBOUND_SUBNETS ซึ่งแต่ละรายการจะชี้ไปยัง Docker bridge gateway บน eth0 และกฎของตารางนี้จะถูกตรวจสอบก่อนกฎของ tunnel ส่วน ip route show แบบปกติจะยังคงแสดง default route ของ Docker เองบน eth0 ซึ่งเป็นเรื่องปกติและไม่ใช่การรั่วไหลของข้อมูล เนื่องจากกฎทั้งสองของ gluetun จะถูกตรวจสอบก่อนตารางหลัก ข้อมูลใดก็ตามในตาราง 199 ที่คุณไม่ได้ระบุไว้ คือข้อมูลที่ข้ามการใช้งาน VPN ไป
Control server ของ gluetun สามารถรายงาน public IP เดียวกันได้ที่พอร์ต 8000 บน /v1/publicip/ip แต่โดยค่าเริ่มต้นจะทำได้ก็ต่อเมื่อคุณตั้งค่าการยืนยันตัวตนแล้วเท่านั้น เอกสารของ gluetun ระบุว่าเส้นทางของ control server ทั้งหมดถูกตั้งค่าเป็น private โดยค่าเริ่มต้น ดังนั้นคำขอปกติไปยัง path ดังกล่าวจึงล้มเหลว ให้กำหนดค่าโดยใช้ไฟล์ auth ที่ทำ bind mount ไว้ที่ /gluetun/auth/config.toml โดยใช้วิธี basic หรือ apikey จากนั้นจึงรีสตาร์ท gluetun ไฟล์ compose ด้านบนได้ทำการ mount ./gluetun ไว้ที่ /gluetun แล้ว ดังนั้นไฟล์ดังกล่าวจึงต้องวางไว้ที่ ./gluetun/auth/config.toml บน host ตัวแปร HTTP_CONTROL_SERVER_AUTH_DEFAULT_ROLE เป็นวิธีที่รวดเร็วกว่า การตั้งค่าตัวแปรนี้เป็น {"auth":"none"} จะเป็นการปิดการยืนยันตัวตนโดยสมบูรณ์ ซึ่งเอกสารระบุว่าไม่แนะนำอย่างยิ่ง สำหรับเวอร์ชันก่อน v3.39.1 ตัว server จะยังไม่มีการล็อกแบบนี้ และเอกสารเตือนให้คุณเชื่อใจทุกสิ่งที่สามารถเข้าถึง server ได้
ผลกระทบจากการกำหนด subnet ที่ผิดพลาด
FIREWALL_OUTBOUND_SUBNETS คือช่องโหว่ที่คุณจงใจเปิดไว้บนไฟร์วอลล์ ดังนั้นขนาดของช่องโหว่จึงเท่ากับระดับความเสี่ยง นี่คือ 4 วิธีที่ทำให้ช่องโหว่ดังกล่าวใหญ่เกินความจำเป็น:
0.0.0.0/0ส่งทุกอย่างออกไปนอกอุโมงค์ การตรวจสอบ IP สองรายการข้างต้นจะตรวจพบปัญหานี้ในการรันครั้งแรก เพราะจะส่งคืนค่าที่อยู่เดียวกัน- การกำหนดช่วงที่กว้างกว่าเป้าหมาย การเปิด
10.0.0.0/8เพื่อเข้าถึงเครื่องเดียวที่10.0.1.7จะเป็นการเปิดทุกที่อยู่ที่ peer ของ torrent อาจประกาศเข้ามาในช่วงนั้นด้วย ให้ระบุเป็น10.0.1.7/32แทน - ช่วงที่ทับซ้อนกับที่อยู่ของอุโมงค์เอง เอกสารของ gluetun เตือนว่าการทำเช่นนี้จะทำให้ gluetun ส่ง traffic ของ VPN ออกไปทาง bridge แทน ซึ่งจะทำให้การทำ port forwarding ใช้งานไม่ได้ ตรวจสอบค่า
WIREGUARD_ADDRESSESของคุณก่อนเปิดช่วง private range ใดๆ 100.64.0.0/10สำหรับ Tailscale ซึ่งเป็นการเปิดที่อยู่ถึงประมาณสี่ล้านหมายเลขเพื่อให้เข้าถึง peer ได้เพียงเครื่องเดียว ให้ระบุรายการ peer ที่คุณต้องการเป็นรายการ/32แทน
โปรดจำไว้ว่าการตั้งค่านี้ครอบคลุมทั้ง namespace การเปิด subnet เพื่อให้ indexer เข้าถึง host service ได้ จะเป็นการเปิด subnet เดียวกันนั้นให้กับ torrent client ที่แชร์ namespace เดียวกันด้วย ให้รันการตรวจสอบ public IP ซ้ำทุกครั้งหลังเปลี่ยนค่าตัวแปรนี้ เพราะเป็นวิธีทดสอบเดียวที่จะยืนยันได้ว่าการเปลี่ยนแปลงนั้นส่งผลตามที่คุณต้องการจริงหรือไม่
สิ่งที่เกิดขึ้นเมื่อคุณรีสตาร์ท gluetun
เนื่องจาก gluetun เป็นเจ้าของ namespace วงจรชีวิตของ gluetun จึงเท่ากับวงจรชีวิตของ namespace นั้น การเริ่มคอนเทนเนอร์ที่ขึ้นต่อกันในขณะที่ gluetun หยุดทำงานจะล้มเหลวในทันที:
Error response from daemon: cannot join network namespace of a non running container: container <id> is exitedการรีสตาร์ท gluetun โดยตรงเป็นความล้มเหลวที่เงียบเชียบกว่า คอนเทนเนอร์ที่ขึ้นต่อกันจะยังคงทำงานอยู่ ในขณะที่ namespace ที่พวกมันเชื่อมต่ออยู่ถูกสร้างขึ้นใหม่ภายใต้ตัวมันเอง ส่งผลให้ docker ps รายงานว่าทุกอย่างปกติ แต่ไม่มีบริการใดตอบสนอง หลังจากมีการเปลี่ยนแปลงใดๆ กับบริการ gluetun ให้สร้างกลุ่มคอนเทนเนอร์ทั้งหมดขึ้นใหม่แทนการรีสตาร์ทเพียงส่วนใดส่วนหนึ่ง
docker compose up -d --force-recreateกรณีนี้ใช้กับการอัปเดต image ด้วยเช่นกัน การดึง gluetun image ใหม่มาและสร้างบริการนั้นขึ้นมาใหม่เพียงอย่างเดียว จะทำให้บริการอื่นชี้ไปยัง namespace ที่ไม่มีอยู่จริงอีกต่อไป
FAQ
ทำไม Docker ถึงแจ้งเตือนเรื่อง "port publishing and the container type network mode"?
เพราะมีการระบุบล็อก ports: ไว้ใน service ที่ตั้งค่า network_mode: service:gluetun เอาไว้ด้วย การเผยแพร่พอร์ต (port publishing) จะเพิ่มกฎ NAT เพื่อส่งต่อพอร์ตจากโฮสต์เข้าไปยัง network namespace ของคอนเทนเนอร์ แต่คอนเทนเนอร์ที่ใช้โหมดนี้จะไม่มี namespace เป็นของตัวเอง ให้ลบบล็อก ports: ออกจาก service นั้น แล้วย้ายการแมปพอร์ตไปไว้ที่ service ของ gluetun แทน โดยใช้หมายเลขพอร์ตเดิมเนื่องจากแอปพลิเคชันยังคงฟังพอร์ตนั้นอยู่ภายใน namespace ที่ใช้ร่วมกัน
คอนเทนเนอร์อื่นจะเข้าถึงบริการที่อยู่หลัง gluetun ได้อย่างไร?
คอนเทนเนอร์ที่อยู่ใน namespace เดียวกันสามารถเข้าถึงกันได้ผ่าน 127.0.0.1 ส่วนคอนเทนเนอร์ที่อยู่ภายนอกจะต้องเรียกผ่านชื่อ service ของ gluetun ดังนั้น http://gluetun:8080 จึงใช้งานได้ในขณะที่ http://qbittorrent:8080 ใช้งานไม่ได้ เนื่องจากคอนเทนเนอร์ของแอปพลิเคชันไม่มีที่อยู่บนเครือข่าย Docker ใดๆ เซิร์ฟเวอร์ DNS ภายในจึงไม่สามารถหาค่าเพื่อแปลงชื่อได้ ไม่จำเป็นต้องเผยแพร่พอร์ตหากคอนเทนเนอร์ทั้งสองอยู่ใน Compose network เดียวกัน
ควรใส่ค่าอะไรใน FIREWALL_OUTBOUND_SUBNETS?
ให้ใส่เฉพาะที่อยู่ที่คอนเทนเนอร์หลัง gluetun จำเป็นต้องเชื่อมต่อออกไปเท่านั้น โดยระบุให้แคบที่สุดเท่าที่จะทำได้ เครื่องเดียวให้ระบุเป็น /32 รายการที่พบบ่อยคือ Docker host ที่ 172.17.0.1/32 และ /32 สำหรับ Tailscale peer แต่ละตัวที่คุณเรียกใช้งาน ห้ามใส่ 0.0.0.0/0 และห้ามใส่ช่วง IP ที่ทับซ้อนกับที่อยู่ tunnel ของ VPN ของคุณเอง การเชื่อมต่อขาเข้าผ่านพอร์ตที่เผยแพร่ไว้ไม่จำเป็นต้องระบุในส่วนนี้
ทำไมคอนเทนเนอร์ถึงไม่สามารถแปลงชื่อ Tailscale MagicDNS ได้?
MagicDNS ทำงานโดยชี้ตัวแปลงชื่อ (resolver) ของโฮสต์ไปยังเซิร์ฟเวอร์ DNS ของ Tailscale แต่คอนเทนเนอร์ไม่ได้ใช้ resolver ของโฮสต์ มันใช้ /etc/resolv.conf ที่แชร์ร่วมกับ gluetun ซึ่งชี้ไปยังเซิร์ฟเวอร์ DNS ของ gluetun เอง ให้ตรวจสอบด้วย docker exec <container> cat /etc/resolv.conf คุณควรใช้ที่อยู่ 100.x แบบตัวเลขของ peer หรือกำหนดชื่อด้วยรายการ extra_hosts ใน service ของ gluetun ทั้งนี้ gluetun สามารถส่งต่อคำขอไปยัง resolver อื่นได้ด้วย DNS_UPSTREAM_PLAIN_ADDRESSES แต่การทำเช่นนั้นจะเป็นการส่งข้อมูลแบบ plaintext ซึ่งเอกสารแนะนำว่าไม่ควรทำ
จะตรวจสอบได้อย่างไรว่าทราฟฟิกยังคงวิ่งผ่าน VPN?
ให้รันคำสั่งส่งคำขอจากภายใน namespace และรันคำขอเดียวกันจากโฮสต์ จากนั้นเปรียบเทียบผลลัพธ์ docker run --rm --network=container:gluetun curlimages/curl:latest -s https://api.ipify.org ควรแสดงที่อยู่ขาออกของผู้ให้บริการ VPN ของคุณ ในขณะที่ curl -s https://api.ipify.org บน VPS ควรแสดงที่อยู่ของ VPS หากผลลัพธ์ทั้งสองเหมือนกัน แสดงว่า tunnel ไม่ได้นำทราฟฟิกของคอนเทนเนอร์ไป ให้ทำการตรวจสอบนี้ซ้ำทุกครั้งหลังมีการเปลี่ยนแปลงค่า FIREWALL_OUTBOUND_SUBNETS