SSD Nodes Learn Hosting plans →
คู่มือ Matt Connorโดย Matt Connor

วิธีตั้งค่า Docker container ให้เชื่อมต่อผ่าน VPN

แก้ไขปัญหาพอร์ตหายเมื่อใช้ Gluetun ร่วมกับ network namespace ของ Docker เรียนรู้สาเหตุที่ container ไม่สามารถเปิดพอร์ตเองได้และวิธีเขียนไฟล์ compose ที่ถูกต้องเพื่อใช้งาน VPN

เหตุใดพอร์ตจึงหายไปเมื่อคุณกำหนดเส้นทาง Docker container ผ่าน VPN

ในการกำหนดเส้นทาง Docker container ผ่าน VPN คุณต้องให้ container หนึ่งตัวเป็นผู้จัดการอุโมงค์เชื่อมต่อ (tunnel) จากนั้นจึงเชื่อมต่อ container อื่นๆ เข้ากับ network namespace ของ container นั้นด้วย network_mode: "service:gluetun" การเชื่อมต่อในลักษณะนี้เป็นจุดที่ทำให้ผู้ใช้งานหลายคนประหลาดใจ เนื่องจาก container ที่ถูกเชื่อมต่อจะไม่เหลือเครือข่ายเป็นของตัวเองอีกต่อไป พอร์ตที่ประกาศไว้ (published ports) และชื่อบริการ Docker ของ container นั้นจึงหายไปด้วย คุณต้องประกาศพอร์ตบน container ที่ทำหน้าที่เป็น VPN แทน แล้วให้ container อื่นๆ เข้าถึงแอปพลิเคชันผ่านชื่อของ container ที่เป็น VPN นั้น

หากคุณทิ้งบล็อก ports: ไว้ใน container ที่ถูกเชื่อมต่อ Docker จะปฏิเสธการสร้าง container นั้นทันที:

Error response from daemon: conflicting options: port publishing and the container type network mode

เครื่องมือที่ใช้ในที่นี้คือ Gluetun ซึ่งเป็น container ที่เชื่อมต่อกับผู้ให้บริการ VPN (virtual private network) เชิงพาณิชย์ผ่านโปรโตคอล WireGuard หรือ OpenVPN และมีไฟร์วอลล์ในตัว เวอร์ชัน v3.41.3 เป็นเวอร์ชันปัจจุบัน ณ เดือนตุลาคม 2026 ตัวอย่างเหล่านี้ใช้ Mullvad ร่วมกับ WireGuard ดังนั้นคุณจำเป็นต้องมีบัญชีและคีย์จากผู้ให้บริการของคุณ หากคุณต้องการจัดการอุโมงค์เชื่อมต่อบนฮาร์ดแวร์ของคุณเอง การรัน WireGuard server บน VPS ของคุณเอง จะช่วยสร้างปลายทางอีกด้านหนึ่ง และ wg-easy ใน Docker จะช่วยครอบการตั้งค่าเหล่านั้นด้วยอินเทอร์เฟซบนเว็บ

สิ่งที่ network_mode: "service:gluetun" ทำงานจริง

โดยปกติ Docker container แต่ละตัวจะมี network namespace เป็นของตัวเอง ทั้งอินเทอร์เฟซ ตารางเส้นทาง กฎไฟร์วอลล์ และซ็อกเก็ตที่รอรับการเชื่อมต่อ โหมด service: จะข้ามขั้นตอนดังกล่าวและเริ่ม container ภายใน namespace ของ gluetun แทน เมื่อใช้ namespace เดียวกันจึงเท่ากับใช้ IP address เดียวกัน ซึ่งส่งผลต่อ 6 ประเด็นดังนี้

  • แอปพลิเคชันจะไม่มีที่อยู่เป็นของตัวเอง แต่จะใช้ที่อยู่ของ gluetun แทน
  • แอปพลิเคชันไม่ได้เชื่อมต่อกับ Docker network ใดๆ ทำให้ชื่อบริการไม่ถูกลงทะเบียนและไม่สามารถ resolve ได้ คอนเทนเนอร์อื่นต้องใช้ gluetun ในการติดต่อ
  • คอนเทนเนอร์ที่อยู่ภายใน namespace เดียวกันจะสื่อสารกันผ่าน localhost
  • คอนเทนเนอร์สองตัวใน namespace เดียวกันไม่สามารถฟังพอร์ตเดียวกันได้ เอกสารของ gluetun ระบุไว้อย่างชัดเจนว่าไม่มีวิธีแก้ไขปัญหานี้
  • สิทธิ์ (Capabilities) เป็นของคอนเทนเนอร์ ไม่ใช่ของ namespace โดย gluetun จะถือครอง NET_ADMIN และ /dev/net/tun ไว้เนื่องจากเป็นผู้สร้างอินเทอร์เฟซอุโมงค์ (tunnel interface) ส่วนคอนเทนเนอร์ที่แนบมาด้วยจะไม่ได้รับสิทธิ์เหล่านี้สืบทอดไป
  • Compose จะปฏิเสธไฟล์ใดๆ ที่มีการตั้งค่าทั้ง network_mode และ networks ในบริการเดียวกัน ให้คุณแนบ gluetun เข้ากับเครือข่ายของคุณแทน แล้วแอปพลิเคชันจะเชื่อมต่อตามไปเอง

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

ไฟล์ compose ที่ใช้งานได้

services:
  gluetun:
    image: qmcgaw/gluetun:v3
    container_name: gluetun
    cap_add:
      - NET_ADMIN
    devices:
      - /dev/net/tun:/dev/net/tun
    environment:
      - VPN_SERVICE_PROVIDER=mullvad
      - VPN_TYPE=wireguard
      - SERVER_CITIES=Amsterdam
      - TZ=Europe/Amsterdam
    env_file:
      - ./gluetun.env
    volumes:
      - ./gluetun:/gluetun
    ports:
      - 127.0.0.1:8080:8080/tcp
    restart: unless-stopped

  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qbittorrent
    network_mode: "service:gluetun"
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Amsterdam
      - WEBUI_PORT=8080
    volumes:
      - ./qbittorrent:/config
      - ./downloads:/downloads
    depends_on:
      gluetun:
        condition: service_healthy
    restart: unless-stopped

แท็ก :v3 คือรุ่นเสถียรล่าสุดในซีรีส์ v3 ส่วนแท็ก :latest จะชี้ไปยัง commit ล่าสุดของ branch master ซึ่งเป็นรุ่นสำหรับการพัฒนา ดังนั้นให้ระบุเวอร์ชัน :v3 บนเครื่องที่คุณไม่ต้องการเสียเวลาแก้ไขบั๊กในวันอังคาร

WEBUI_PORT=8080 ต้องตรงกับพอร์ตที่เปิดใช้งาน (published port) เพราะ qBittorrent จะผูกการทำงานอยู่ภายใน namespace ของ gluetun และกฎการ publish จะส่ง traffic จากโฮสต์ไปยังพอร์ต 8080 ที่นั่น หากเปลี่ยนตัวเลขตัวหนึ่งโดยไม่เปลี่ยนอีกตัว พอร์ตนั้นจะไม่ตอบสนองใดๆ 127.0.0.1:8080:8080 จะคงหน้าเว็บอินเทอร์เฟซไว้ที่ loopback address ของโฮสต์ การใช้ 8080:8080 เปล่าๆ จะเป็นการ publish บนทุกอินเทอร์เฟซและเขียนกฎ firewall ของตัวเอง ซึ่งเป็นสาเหตุที่ทำให้ พอร์ตที่ Docker publish หลุดรอดการตรวจสอบของ ufw

เริ่มการทำงานของคอนเทนเนอร์ จากนั้นตรวจสอบตามลำดับนี้:

docker compose up -d
docker compose ps
docker compose logs gluetun | tail -30

docker compose ps ควรแสดงสถานะ gluetun เป็น healthy และ qbittorrent เป็น running จากนั้นยืนยันที่อยู่ IP ขาออก (exit address) จากภายใน namespace ซึ่งเป็นการตรวจสอบที่ตัดสินผลลัพธ์ทั้งหมด:

docker run --rm --network=container:gluetun alpine:3.22 sh -c "apk add wget && wget -qO- https://ipinfo.io"

ฟิลด์ ip ใน JSON นั้นควรเป็นที่อยู่ IP ของผู้ให้บริการ VPN ของคุณ หากเป็นที่อยู่ IP ของเซิร์ฟเวอร์คุณเอง แสดงว่าแอปไม่ได้อยู่ใน tunnel และทุกอย่างหลังจากนี้จะไม่ทำงานตามที่อธิบายไว้

เก็บคีย์ไว้ภายนอกไฟล์ compose

gluetun.env ใช้สำหรับเก็บข้อมูลรับรอง และต้องไม่ถูกรวมอยู่ใน git:

WIREGUARD_PRIVATE_KEY=wOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU=
WIREGUARD_ADDRESSES=10.64.222.21/32

ค่าทั้งสองได้มาจากไฟล์การตั้งค่า WireGuard ที่คุณสร้างขึ้นในส่วนบัญชีผู้ให้บริการของคุณ ตั้งค่าไฟล์ให้เป็นโหมด 600 ให้ตระหนักถึงสิ่งที่คุณได้รับจากการทำเช่นนี้: คีย์จะไม่อยู่ใน repository ของคุณ แต่ docker inspect gluetun ยังคงแสดง environment variable ทุกตัวให้กับทุกคนที่สามารถเข้าถึง Docker socket ได้ ไฟล์ environment และความลับใน Docker Compose ครอบคลุมทางเลือกที่มีความปลอดภัยสูงกว่า

วิธีที่คอนเทนเนอร์ภายนอกอุโมงค์สื่อสารกับคอนเทนเนอร์ภายใน

การสื่อสารทำงานได้ทั้งสองทิศทางและแต่ละฝั่งจะใช้ชื่อที่แตกต่างกัน คอนเทนเนอร์ทั้งสองต้องใช้ Docker network ร่วมกัน ซึ่งในกรณีนี้คือเครือข่ายของ gluetun เนื่องจากคอนเทนเนอร์ที่เชื่อมต่อเข้ามาไม่มีเครือข่ายเป็นของตนเอง เนื้อหา วิธีเชื่อมต่อเครือข่ายใน Docker Compose ได้อธิบายค่าเริ่มต้นไว้แล้ว

สำหรับการสื่อสารจากภายนอกเข้าไปภายใน ให้ใช้ชื่อของ gluetun และพอร์ตที่แอปพลิเคชันนั้นเปิดใช้งานอยู่ ตัวอย่างเช่น คอนเทนเนอร์ reverse proxy สามารถเข้าถึงเว็บอินเทอร์เฟซของ qBittorrent ได้ที่ gluetun:8080 โดยไม่จำเป็นต้องตั้งค่า ports: เนื่องจากทราฟฟิกที่สื่อสารระหว่างคอนเทนเนอร์จะอยู่ภายใน Docker network และไม่ผ่านพอร์ตของโฮสต์

สำหรับการสื่อสารจากภายในออกสู่ภายนอก ให้ใช้ชื่อบริการของคอนเทนเนอร์อีกตัวหนึ่ง เช่น postgres:5432 เป็นต้น gluetun สามารถแก้ไขชื่อ (resolve) ของคอนเทนเนอร์อื่นจากภายในเนมสเปซของตนเองได้ตั้งแต่เวอร์ชัน v3.41 เป็นต้นไป ดังนั้นหากชื่อไม่สามารถ resolve ได้ ให้กำหนดเวอร์ชันเป็น v3.41 หรือใหม่กว่า

ไฟร์วอลล์ของ gluetun เป็นตัวตัดสินว่าใครสามารถเปิดการเชื่อมต่อเข้ามาได้ ทราฟฟิกที่มาจาก Docker network ของ gluetun เองจะได้รับอนุญาต หากไคลเอนต์อยู่บนซับเน็ตอื่น เช่น แล็ปท็อปบน LAN ของคุณ หรือคอนเทนเนอร์บน bridge network แยกต่างหาก จำเป็นต้องมีเส้นทางขากลับที่ได้รับอนุญาตจากไฟร์วอลล์และการกำหนดเส้นทางของ gluetun:

FIREWALL_OUTBOUND_SUBNETS=192.168.1.0/24

ความหมายที่ระบุไว้ในเอกสารมีความชัดเจน คือการระบุซับเน็ตโดยคั่นด้วยเครื่องหมายจุลภาค ซึ่ง gluetun และคอนเทนเนอร์ที่ใช้ network stack ร่วมกับมันได้รับอนุญาตให้เข้าถึงได้

การเชื่อมต่อขาเข้าจากอินเทอร์เน็ตเป็นปัญหาที่แยกต่างหาก เนื่องจาก peer ของโปรแกรม torrent จะเชื่อมต่อเข้ามาจากฝั่ง VPN ดังนั้นการเปิดพอร์ต 6881 บนโฮสต์จึงไม่มีผลต่อการเชื่อมต่อเหล่านี้ คุณจำเป็นต้องใช้พอร์ตที่ส่งต่อ (forwarded port) จากผู้ให้บริการของคุณ และต้องระบุพอร์ตนั้นไว้ใน FIREWALL_VPN_INPUT_PORTS เพื่ออนุญาตพอร์ตจากฝั่งเซิร์ฟเวอร์ VPN สำหรับ Mullvad ที่ใช้ในตัวอย่างนี้ไม่รองรับการทำ port forwarding ดังนั้นจึงจำเป็นต้องใช้ผู้ให้บริการที่รองรับฟีเจอร์นี้ นี่คือส่วนที่ media stacks ที่สร้างด้วย Docker Compose ส่วนใหญ่มักจะตั้งค่าไว้ไม่สมบูรณ์

Kill switch: สิ่งที่จะเกิดขึ้นเมื่อ tunnel หลุด

รูปแบบนี้มีความซับซ้อนเนื่องจากเหตุผลด้านความล้มเหลว คอนเทนเนอร์ที่เชื่อมต่ออยู่จะใช้ interface และตาราง routing ร่วมกับ Gluetun โดย firewall ของ Gluetun จะบล็อก traffic อินเทอร์เน็ตปกติที่อยู่นอก tunnel แต่จะอนุญาตให้ traffic ไปยัง VPN server endpoint, traffic ภายใน Docker และข้อยกเว้นที่กำหนดไว้ผ่านไปได้ Firewall นี้เองที่เป็นตัวป้องกันไม่ให้ระบบ fallback ไปใช้ interface ปกติเมื่อ tunnel หลุด จึงไม่มีช่วงเวลาที่แพ็กเก็ตจะรั่วไหลออกทาง interface ปกติในขณะที่ไคลเอนต์กำลังเชื่อมต่อใหม่

Gluetun จะคอยตรวจสอบการเชื่อมต่อของตัวเอง โดยทุกๆ 1 นาทีจะส่ง ICMP echo (ping) ไปยังที่อยู่ตาม HEALTH_ICMP_TARGET_IPS ซึ่งค่าเริ่มต้นคือ 1.1.1.1,8.8.8.8 หากไม่อนุญาตให้ใช้ ICMP การตรวจสอบนี้จะเปลี่ยนไปใช้ plaintext UDP DNS query แทน และทุกๆ 5 นาที ระบบจะทำการ dial แบบเต็มรูปแบบผ่าน TCP และ TLS (transport layer security) ไปยัง HEALTH_TARGET_ADDRESSES ซึ่งค่าเริ่มต้นคือ cloudflare.com:443,github.com:443 เมื่อการตรวจสอบเหล่านี้ล้มเหลว ระบบจะรีสตาร์ท VPN ภายในคอนเทนเนอร์และบันทึก log ไว้:

WARN [vpn] restarting VPN because it failed to pass the healthcheck: periodic check: dialing: dial tcp4: lookup cloudflare.com: i/o timeout

ให้อ่าน log ของคอนเทนเนอร์ที่เชื่อมต่ออยู่โดยคำนึงถึงลำดับนี้ บรรทัดอย่างเช่น connection refused, operation not permitted และ i/o timeout ภายในแอปเป็นผลลัพธ์ที่เกิดจาก tunnel ที่ตายแล้ว ไม่ใช่สาเหตุ เอกสารของ Gluetun ระบุเรื่องนี้ไว้อย่างชัดเจน เพราะผู้ใช้มักรายงานผลลัพธ์ที่เกิดขึ้นและเสียเวลาไล่หาสาเหตุเป็นชั่วโมง

HEALTH_RESTART_VPN=on เป็นค่าเริ่มต้นและควรเปิดไว้ ให้ปิดเฉพาะในขณะที่คุณกำลังดีบั๊กความล้มเหลวเฉพาะจุดเท่านั้น เพราะหากปิดไว้ tunnel ที่ตายแล้วจะยังคงตายอยู่อย่างนั้น

การจัดลำดับ: ป้องกันไม่ให้ stack เริ่มทำงานก่อนที่ tunnel จะพร้อมใช้งาน

อิมเมจนี้มาพร้อมกับ Docker healthcheck:

HEALTHCHECK --interval=5s --timeout=5s --start-period=10s --retries=3 CMD /gluetun-entrypoint healthcheck

คำสั่งดังกล่าวจะรัน gluetun อีกชุดหนึ่งขึ้นมาในช่วงเวลาสั้นๆ เพื่อสอบถามสถานะจาก health server ของตัวที่กำลังทำงานอยู่ที่ http://127.0.0.1:9999/ หาก tunnel ทำงานปกติจะตอบกลับมาเป็น 200 OK แต่หาก tunnel มีปัญหาจะตอบกลับเป็น 500 Internal server error พร้อมข้อความแสดงข้อผิดพลาด และ Docker จะทำเครื่องหมายว่า container ไม่สมบูรณ์ (unhealthy) หลังจากตรวจสอบล้มเหลวติดต่อกัน 3 ครั้ง

condition: service_healthy คือสิ่งที่ใช้รอให้สถานะดังกล่าวพร้อมใช้งาน การใช้เพียง depends_on: [gluetun] จะรอแค่ให้ container เริ่มทำงานเท่านั้น ซึ่งเกิดขึ้นก่อนที่การทำ handshake จะเสร็จสมบูรณ์หลายวินาที ส่งผลให้แอปพลิเคชันเริ่มทำงานในขณะที่เครือข่ายยังใช้งานไม่ได้ และมักจะล้มเหลวในการเชื่อมต่อครั้งแรก Healthchecks ใน Docker Compose ได้อธิบายรายละเอียดเกี่ยวกับไวยากรณ์และฟิลด์การตั้งเวลาไว้แล้ว

มีข้อจำกัดประการหนึ่งที่ผู้ใช้มักพลาด คือ Compose จะประเมินเงื่อนไขนั้นเฉพาะตอนที่เริ่ม stack เท่านั้น มันจะไม่หยุดหรือรีสตาร์ทแอปพลิเคชันในภายหลังหาก gluetun เปลี่ยนสถานะเป็นไม่สมบูรณ์ ซึ่งในกรณีนี้ระบบ auto-healing ภายในของ gluetun จะเป็นผู้จัดการแทน โดยจะรีสตาร์ทเฉพาะกระบวนการ VPN ไม่ใช่รีสตาร์ทตัว container ทั้งหมด

ตรวจสอบการรั่วไหลของ DNS ก่อนที่คุณจะเชื่อมั่นในการตั้งค่า

DNS (domain name system) คือช่องโหว่ที่อาจเกิดขึ้นได้แม้จะทำ tunnel ได้อย่างถูกต้องแล้วก็ตาม Gluetun จะรัน resolver ของตัวเองไว้ภายใน namespace และส่งต่อ query ผ่าน DoT (DNS over TLS) ไปยัง Cloudflare เป็นค่าเริ่มต้น: DNS_UPSTREAM_RESOLVER_TYPE=dot และ DNS_UPSTREAM_RESOLVERS=cloudflare หากคุณไม่แก้ไขค่าทั้งสองนี้ การค้นหาชื่อโดเมนของคุณจะถูกเข้ารหัสและส่งผ่าน tunnel ไป

การตั้งค่าที่ทำให้เกิดปัญหาเมื่อชี้ไปยัง local resolver คือ DNS_UPSTREAM_PLAIN_ADDRESSES ผู้ใช้งานมักจะเปลี่ยนค่านี้เมื่อพบปัญหาการ resolve ชื่อโดเมนไม่สำเร็จ และต้องการให้ router หรือ resolver ของผู้ให้บริการอินเทอร์เน็ตเป็นผู้ตอบแทน เอกสารของ Gluetun ได้เตือนไว้ว่า query ที่ส่งไปยัง resolver บน Docker bridge หรือ LAN ของคุณจะรั่วไหลออกไปนอก VPN tunnel สำหรับ public plaintext resolver นั้น แม้จะได้รับ query ผ่านทาง tunnel แต่ผู้ให้บริการ VPN ก็ยังสามารถอ่านและแก้ไขข้อมูลเหล่านั้นได้ ข้อผิดพลาดในลักษณะเดียวกันสำหรับ WireGuard ได้ถูกอธิบายไว้ใน DNS ที่หยุดทำงานผ่าน WireGuard tunnel

ในการทดสอบ ให้ตั้งค่า SHADOWSOCKS=on และ SHADOWSOCKS_PASSWORD บน gluetun, publish พอร์ต 8388:8388/tcp และ 8388:8388/udp จากนั้นเชื่อมต่อด้วย Shadowsocks client ที่ตั้งค่าให้ทำ tunnel สำหรับ UDP DNS แล้วโหลดหน้าเว็บทดสอบ DNS leak ผลลัพธ์ที่ได้ควรแสดงชื่อผู้ให้บริการ VPN ของคุณหรือ Cloudflare เท่านั้น ห้ามแสดงชื่อ router ที่บ้านของคุณ เอกสารของ Gluetun เองได้เตือนไว้ว่าการทดสอบบางอย่างอาจให้ผลลัพธ์ที่แปลกไป เนื่องจาก resolver ภายใน namespace เป็นเพียงตัวกลางในการแคชข้อมูลในเครื่อง ไม่ใช่เซิร์ฟเวอร์ที่ตอบกลับโดยตรง หากพบชื่อประเทศที่ไม่ถูกต้องหรือพบ resolver ของ ISP ของคุณ ให้ถือว่าเป็นสัญญาณเตือนที่แท้จริงว่ามีการรั่วไหลเกิดขึ้น

การเพิ่ม Tailscale ควบคู่ไปกับ VPN sidecar และการตัดสินว่าตัวใดจะเป็นผู้ควบคุมการเชื่อมต่อ

Tailscale คือ overlay network ที่สร้างบน WireGuard สำหรับเข้าถึงเครื่องของคุณเอง โดยผู้ใช้มักรันควบคู่ไปกับ VPN ของผู้ให้บริการเพื่อรักษาช่องทางสำหรับผู้ดูแลระบบ (admin path) ไว้ การใช้ namespace ร่วมกันหมายถึงการใช้กฎ firewall และการตั้งค่า routing ร่วมกัน ดังนั้นทั้งสองตัวจึงต้องมีการตั้งค่าที่เข้ากันได้ เอกสารของ Tailscale ระบุค่าเริ่มต้นไว้ว่า: มันทำหน้าที่เป็น overlay network โดยจะ route เฉพาะ traffic ระหว่างอุปกรณ์ที่รัน Tailscale เท่านั้น และจะไม่ยุ่งเกี่ยวกับ traffic อินเทอร์เน็ตสาธารณะของคุณ

ดังนั้นคำตอบจึงขึ้นอยู่กับการตั้งค่าเพียงอย่างเดียว

  • Tailscale ใน container ของตัวเองด้วยการตั้งค่าเริ่มต้น: มันจะไม่เห็น traffic ขาออกของแอปพลิเคชัน โดย Gluetun จะเป็นผู้จัดการ traffic ทั้งหมด กระบวนการภายใน container ของ Tailscale จะเข้าถึงแอปที่ gluetun:8080 ผ่าน Docker network ที่ใช้ร่วมกัน การเปิดการเชื่อมต่อดังกล่าวให้แก่ไคลเอนต์ใน tailnet จำเป็นต้องมีการทำ forwarding หรือใช้ proxy
  • Tailscale ที่เชื่อมต่อกับ namespace ของ Gluetun ด้วย network_mode: "service:gluetun": ในโหมด userspace networking เริ่มต้น ซึ่ง TS_USERSPACE ถูกเปิดใช้งานอยู่ tailscaled จะไม่สร้าง interface ใดๆ ขึ้นมา แต่จะทำงานเป็น SOCKS5 หรือ HTTP proxy จึงไม่สามารถเปลี่ยนแปลงการ routing ได้ Gluetun จะยังคงรับหน้าที่จัดการ traffic ขาออกทั่วไป เว้นแต่แอปจะใช้ proxy นั้นโดยเฉพาะ
  • กรณีเดียวกันแต่ใช้ TS_USERSPACE=false: Tailscale จำเป็นต้องมีอุปกรณ์ /dev/net/tun และสิทธิ์การใช้งานของตัวเองเนื่องจากสิ่งเหล่านี้ไม่ได้มาพร้อมกับ namespace tailscaled จะสร้าง tunnel device และบน Linux โดยปกติจะติดตั้งเส้นทาง IPv4 peer /32 แยกกันแทนที่จะเป็นเส้นทางเดียวสำหรับ 100.64.0.0/10 การตั้งค่า TS_USERSPACE=false เพียงอย่างเดียวไม่สามารถเปิดใช้งาน aggregate route ได้ มันจะติดตั้ง subnet route ของโหนดอื่นก็ต่อเมื่อคุณส่ง --accept-routes ผ่าน TS_EXTRA_ARGS เท่านั้น TS_ROUTES จะทำงานในทิศทางตรงกันข้าม คือการประกาศ (advertise) subnet ที่ container นี้สามารถเข้าถึงได้ไปยังส่วนที่เหลือของ tailnet ของคุณ ซึ่งเทียบเท่ากับ tailscale set --advertise-routes= และไม่ได้เพิ่มเส้นทางใดๆ ในที่นี้ traffic สาธารณะจะยังคงออกผ่าน Gluetun
  • Kernel networking ใน namespace ของ Gluetun โดยมีการเลือก exit node ไว้ sudo tailscale set --exit-node=<exit-node-ip>: Tailscale จะติดตั้ง default route ใน namespace นั้น แต่ firewall ของ Gluetun อาจบล็อกเส้นทางดังกล่าวได้ การเลือก exit node ใน container แยกต่างหากจะไม่เปลี่ยนเส้นทางของแอป และโหมด userspace จะรับเฉพาะ traffic ที่ส่งผ่าน proxy ของมันโดยตรงเท่านั้น อย่ารวม default route ที่แย่งกันทำงานใน namespace ของ Gluetun ควรมี default route เพียงหนึ่งเดียวและมีเจ้าของเพียงหนึ่งเดียว

หากเป้าหมายคือการใช้เส้นทางที่ประกาศไว้ (advertised routes) และคุณต้องการให้เครือข่ายส่วนตัวทั้งหมดหลังกล่องสามารถเข้าถึงได้แทนที่จะเข้าถึงได้เพียงตัวกล่อง การรัน Tailscale subnet router บน VPS จะครอบคลุมถึงการอนุมัติเส้นทาง, การทำ IP forwarding และ flag ฝั่งไคลเอนต์ที่ TS_ROUTES ไม่ได้จัดการให้

หาก Tailscale มีไว้เพื่อให้คุณมี URL สำหรับการดูแลระบบแทนที่จะเป็นเส้นทาง tailscale serve และ tailscale funnel จะช่วยวาง HTTPS ไว้หน้าบริการ HTTP ภายใน โดยมีเพียง funnel เท่านั้นที่เปิดให้เข้าถึงผ่านอินเทอร์เน็ตสาธารณะ เอกสารของ Tailscale Serve รองรับเฉพาะ http://127.0.0.1 ในฐานะเป้าหมายของ HTTP proxy เท่านั้น การใช้ Docker network ร่วมกันไม่ทำให้ http://gluetun:8080 เป็นเป้าหมายที่รองรับ ให้ใช้ network namespace ของ Gluetun ร่วมกับ network_mode: "service:gluetun" และกำหนดเป้าหมายไปที่ http://127.0.0.1:8080

ผลข้างเคียงประการหนึ่งจะปรากฏให้เห็นเมื่อ Tailscale รันอยู่ภายใน tunnel โดย peer จะเห็นที่อยู่ IP ของผู้ให้บริการ VPN ดังนั้นจึงมีโอกาสสูงที่จะต้องเปลี่ยนไปใช้ relay บ่อยขึ้น tailscale status จะแสดง relay "..." ข้างชื่อ peer แทนที่จะเป็น direct เมื่อเกิดเหตุการณ์ดังกล่าว การเชื่อมต่อยังคงใช้งานได้แต่จะมีความเร็วที่ช้าลง หาก overlay เป็นสิ่งเดียวที่คุณต้องการจริงๆ ความแตกต่างระหว่าง WireGuard แบบปกติและ Tailscale คือจุดเริ่มต้นที่ดีกว่า

สิ่งที่มักจะเกิดข้อผิดพลาดและข้อความที่คุณจะพบ

Docker ปฏิเสธที่จะสร้าง container ของแอป Error response from daemon: conflicting options: port publishing and the container type network mode หมายความว่ายังมี ports: ค้างอยู่ในบริการที่เชื่อมต่ออยู่ ให้ย้ายส่วนนั้นไปไว้ที่ gluetun

Compose ปฏิเสธไฟล์ทั้งหมด บริการหนึ่งไม่สามารถกำหนดทั้ง network_mode และ networks พร้อมกันได้ ให้ย้ายการตั้งค่า networks ไปไว้ที่ gluetun แทน

container อื่นไม่สามารถ resolve ชื่อแอปได้ curl: (6) Could not resolve host: qbittorrent เป็นพฤติกรรมที่ถูกต้อง เพราะ container ที่เชื่อมต่อไม่ได้เข้าร่วม network ใดและไม่ได้ลงทะเบียนชื่อไว้ ให้ใช้ gluetun และระบุพอร์ตแทน

container ที่สองที่เชื่อมต่ออยู่ไม่ยอมเริ่มทำงาน กระบวนการสองอย่างใน namespace เดียวกันไม่สามารถ bind พอร์ตเดียวกันได้ และกระบวนการที่แพ้จะรายงานว่า address ถูกใช้งานอยู่ ให้เปลี่ยนพอร์ตภายในของแอป หรือรัน gluetun ตัวที่สอง

แอปไม่มีเครือข่ายหลังจากที่คุณแก้ไข gluetun การ restart หรือสร้าง gluetun ใหม่จะทำให้การเชื่อมต่อของทุกสิ่งที่ต่ออยู่กับมันหลุดไป ให้ทำการ restart container เหล่านั้นใหม่

หน้าเว็บขนาดเล็กโหลดได้ แต่หน้าเว็บขนาดใหญ่ค้าง นี่คือปัญหาเรื่อง MTU (maximum transmission unit) อุโมงค์เชื่อมต่อจะเพิ่ม overhead เข้าไป และมีบางอย่างในเส้นทางที่ทิ้ง packet ขนาดใหญ่เกินไปโดยไม่ส่งข้อความแจ้งเตือนกลับมา ให้ตรวจสอบ WIREGUARD_MTU ซึ่งค่าเริ่มต้นใน v3.41.3 คือ 1320 และให้ปรับลดค่าลงหากเส้นทางเครือข่ายต้องการ packet ที่มีขนาดเล็กลง โดย image รุ่น development จะใช้การค้นหา path MTU หากไม่ได้ตั้งค่านี้ไว้

Gluetun ไม่ยอมเปลี่ยนสถานะเป็น healthy การตรวจสอบตอนเริ่มต้นจะระบุผู้ต้องสงสัยกลุ่มแรกไว้คือ WARN [vpn] restarting VPN because it failed to pass the healthcheck: startup check: dialing: dial tcp4: lookup cloudflare.com: i/o timeout ให้ตรวจสอบว่า key หมดอายุหรือไม่ จากนั้นตรวจสอบว่ารายการ server ล้าสมัยหรือไม่ และตรวจสอบว่า firewall ของ host บล็อกการส่งข้อมูล UDP ออกไปหรือไม่

FAQ

ทำไมพอร์ตที่เผยแพร่ (published ports) ของคอนเทนเนอร์ถึงใช้งานไม่ได้เมื่ออยู่หลัง Gluetun?

เพราะ network_mode: "service:gluetun" นำคอนเทนเนอร์เข้าไปอยู่ใน network namespace ของ Gluetun ซึ่ง namespace หนึ่งจะมีเพียงหนึ่ง IP address และหนึ่งชุดของพอร์ตที่เปิดฟัง (listening ports) แอปพลิเคชันยังคงทำงานอยู่ แต่กฎการเผยแพร่พอร์ตต้องไปอยู่ที่คอนเทนเนอร์ที่เป็นเจ้าของ namespace นั้น ให้ย้ายรายการ ports: ไปไว้ที่บริการ Gluetun แทน หากคุณยังคงทิ้งไว้ที่บริการที่เชื่อมต่ออยู่ Docker จะไม่สร้างพอร์ตเหล่านั้นให้: Error response from daemon: conflicting options: port publishing and the container type network mode

ฉันจะเข้าถึงคอนเทนเนอร์ที่อยู่ภายใน VPN tunnel จากคอนเทนเนอร์ที่อยู่นอก tunnel ได้อย่างไร?

ให้ใช้ชื่อบริการของ Gluetun และพอร์ตที่แอปพลิเคชันเปิดฟังอยู่ เช่น gluetun:8080 คอนเทนเนอร์ที่เชื่อมต่ออยู่จะไม่มี Docker network เป็นของตัวเอง ดังนั้นชื่อของมันจึงไม่สามารถ resolve ได้ การสื่อสารระหว่างคอนเทนเนอร์ไม่จำเป็นต้องเผยแพร่พอร์ตใดๆ สำหรับการสื่อสารในทิศทางกลับกัน คอนเทนเนอร์ที่อยู่ภายใน namespace สามารถเข้าถึงคอนเทนเนอร์ภายนอกได้ผ่านชื่อบริการ เช่น postgres:5432 (สำหรับ Gluetun v3.41 ขึ้นไป) ส่วนไคลเอนต์ที่อยู่บน subnet อื่น เช่น แล็ปท็อปใน LAN ของคุณ จำเป็นต้องมีเส้นทางขากลับที่อนุญาตโดย firewall และ routing ของ Gluetun ให้เพิ่ม subnet นั้นลงใน FIREWALL_OUTBOUND_SUBNETS

Gluetun ทำหน้าที่เป็น kill switch เมื่อ VPN หลุดหรือไม่?

ใช่ หากเปิดใช้งาน firewall ของมัน คอนเทนเนอร์ที่เชื่อมต่ออยู่จะใช้ interface และเส้นทางเครือข่ายร่วมกับ Gluetun โดย firewall จะบล็อกการรับส่งข้อมูลอินเทอร์เน็ตปกติที่อยู่นอก tunnel แต่จะอนุญาตการเชื่อมต่อกับ VPN server endpoint, การรับส่งข้อมูลภายใน Docker และข้อยกเว้นที่กำหนดไว้ จากนั้น Gluetun จะรีสตาร์ท VPN ภายในตัวเองและบันทึก log WARN [vpn] restarting VPN because it failed to pass the healthcheck แทนที่จะปิดตัวลง เพราะคอนเทนเนอร์ทุกตัวที่เชื่อมต่ออยู่จะสูญเสียการเชื่อมต่อเครือข่ายหาก Gluetun รีสตาร์ทตัวเอง

Tailscale และ Gluetun ใน stack เดียวกัน: ตัวไหนเป็นตัวจัดการการรับส่งข้อมูลขาออก?

Gluetun จะเป็นตัวจัดการการรับส่งข้อมูลขาออกปกติ เว้นแต่คุณจะกำหนดให้ส่งผ่าน Tailscale อย่างชัดเจน โดยปกติแล้ว Tailscale จะทำหน้าที่เพียงกำหนดเส้นทางรับส่งข้อมูลระหว่างอุปกรณ์ใน tailnet ของคุณเท่านั้น และจะไม่ยุ่งกับการรับส่งข้อมูลสาธารณะ ในโหมด userspace เริ่มต้นของ container image มันจะไม่มีการสร้าง interface ใดๆ ขึ้นมา จึงไม่ส่งผลต่อการกำหนดเส้นทาง (routing) ด้วย TS_USERSPACE=false โดยปกติ Linux จะได้รับเส้นทาง IPv4 peer /32 แยกแต่ละรายการแทนที่จะเป็นเส้นทางรวม 100.64.0.0/10 บวกกับเส้นทาง subnet ของโหนดอื่นหากคุณเพิ่ม --accept-routes ผ่าน TS_EXTRA_ARGS ส่วน TS_ROUTES จะประกาศ subnet ของคอนเทนเนอร์นี้ไปยัง tailnet ของคุณและไม่เพิ่มเส้นทางภายในเครื่อง การเลือก exit node ด้วย sudo tailscale set --exit-node=<exit-node-ip> จะติดตั้งเส้นทางเริ่มต้น (default routes) เฉพาะใน namespace ที่ใช้ kernel networking ของ Tailscale เท่านั้น คอนเทนเนอร์แยกต่างหากจะไม่เปลี่ยนเส้นทางของแอปพลิเคชัน และโหมด userspace จะจัดการเฉพาะการรับส่งข้อมูลที่ส่งผ่าน proxy ของมันเท่านั้น ควรเลือกผลิตภัณฑ์เพียงตัวเดียวให้เป็นผู้จัดการเส้นทางเริ่มต้นแทนการใช้งานร่วมกันทั้งสองตัว

บทความนี้มีประโยชน์หรือไม่