Kết nối HomeLab từ xa bằng Tailscale chạy trong Docker

Mục Lục

Tailscale tạo một mạng riêng dựa trên WireGuard, giúp truy cập dịch vụ trong HomeLab mà không phải mở từng port ra Internet. Bài này biên tập quy trình chạy Tailscale trong Docker và bật subnet routing cho mạng LAN.

Nguồn tham khảo: i12bretro – Tailscale in Docker . Video gốc thuộc kênh i12bretro trên YouTube .

Chuẩn bị tài khoản Tailscale

Mở login.tailscale.com và đăng nhập bằng một phương thức SSO.
Vào DNS > Add nameserver > Custom....
Nhập IP DNS server dùng trong mạng LAN rồi bấm Save.
Vào Settings > Keys trong phần Personal Settings.
Bấm Generate auth key..., bật Reusable rồi tạo key.
Giữ auth key ở nơi an toàn để dùng ở bước chạy container. Không đưa key thật vào file Markdown, log hoặc Git.

Cài Docker trên Linux host

Trên máy Linux sẽ chạy gateway, cài Docker và bật service:

1
2
3
4
5
6
7
sudo apt install apt-transport-https ca-certificates curl software-properties-common gnupg-agent -y
curl -fsSL https://download.docker.com/linux/$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release)/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=$(dpkg --print-architecture)] https://download.docker.com/linux/$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release) $(lsb_release -cs) stable"
sudo apt install docker-ce docker-compose containerd.io -y
sudo systemctl enable docker && sudo systemctl start docker
sudo usermod -aG docker $USER
su - $USER

Chạy Tailscale container làm subnet router

Thay <AUTH_KEY> bằng key tạo ở bước trên và đổi TS_ROUTES theo subnet LAN thật:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
docker run -d --name=tailscale \
  -v /var/lib:/var/lib \
  -v /dev/net/tun:/dev/net/tun \
  -e TS_ACCEPT_DNS=true \
  --network=host \
  --cap-add=NET_ADMIN \
  --cap-add=NET_RAW \
  --restart=unless-stopped \
  --hostname="ctr-gateway" \
  -e TS_AUTHKEY=<AUTH_KEY> \
  -e TS_ROUTES=192.168.0.0/24 \
  tailscale/tailscale

Quay lại giao diện Tailscale và mở Machines.
Xác nhận máy ctr-gateway đã online.
Mở Settings của máy, chọn Disable key expiry nếu cần gateway hoạt động lâu dài.
Vào Edit route settings....
Chọn Approve all để bật route vào mạng LAN.

Kết nối thiết bị khác

Cài Tailscale client trên máy tính hoặc điện thoại cần truy cập HomeLab.
Đăng nhập bằng cùng phương thức đã dùng để tạo tài khoản.
Khi thiết bị đã kết nối vào tailnet, thử truy cập dịch vụ nội bộ bằng IP LAN.
Chỉ quảng bá các subnet cần thiết; không mở route rộng hơn nhu cầu thực tế.

Lưu ý bảo mật: Auth key có quyền tham gia tailnet. Không commit key vào Docker Compose, shell history công khai hoặc repository. Nếu nghi ngờ key bị lộ, hãy revoke và tạo key mới trong Tailscale.

Nguồn và video

Tutorial gốc: i12bretro 0110
Video gốc: Tailscale in Docker
Tailscale: What is Tailscale?
Docker image: tailscale/tailscale

AIoT.IO.VN