Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Hướng dẫn kết nối và làm việc với Remote Azure VM

Tài liệu này hướng dẫn chi tiết cách thiết lập, kết nối và tối ưu hóa môi trường làm việc với máy ảo Microsoft Azure (Azure Virtual Machine — cả Linux VM và Windows VM) từ ba hệ điều hành máy trạm: Ubuntu (Linux), macOS và Windows.

Môi trường phát triển từ xa (Remote Development) trên Azure VM giúp đồng nhất cấu hình nhóm, tận dụng tài nguyên điện toán lớn (CPU/RAM/GPU) trên đám mây, và giảm tải cho máy trạm cục bộ mà vẫn giữ trải nghiệm lập trình mượt mà như thao tác trên máy local.


1. Kiến trúc và Mô hình Kết nối

Tùy thuộc vào chính sách bảo mật mạng của hạ tầng đám mây, kết nối tới Azure VM thường theo hai mô hình chính:

Mô hình 1: Kết nối trực tiếp qua Public IP (Kiểm soát bằng NSG)
[Máy trạm: Ubuntu / macOS / Windows]
        │
        ▼ (Internet / Encrypted Traffic: Port 22 SSH hoặc Port 3389 RDP)
[Azure NSG (Chỉ cho phép IP máy trạm)] ──→ [Azure VM (Linux / Windows)]

Mô hình 2: Kết nối bảo mật qua Azure Bastion (Không Public IP)
[Máy trạm (Azure CLI / Browser)]
        │
        ▼ (HTTPS Port 443 / TLS)
[Azure Bastion Subnet] ──────────────────→ [Azure VM trong Private Subnet]

Nguyên tắc bảo mật bắt buộc

  • Tuyệt đối không mở port 22 (SSH) hoặc 3389 (RDP) ra toàn bộ Internet (0.0.0.0/0) trên Network Security Group (NSG). Chỉ cấu hình Source IP khớp với Public IP hiện tại của bạn (My IP), hoặc dải IP mạng nội bộ cơ quan/VPN.
  • Bắt buộc dùng xác thực khóa SSH (SSH Key-based Authentication) cho Linux VM. Tắt hoàn toàn xác thực mật khẩu thông thường (PasswordAuthentication no) trong sshd_config.
  • Thiết lập TCP KeepAlive: Azure Virtual Network áp dụng quy tắc ngắt kết nối không hoạt động (Idle Timeout) sau 4 phút mặc định. Cần cấu hình SSH Client gửi gói tin giữ kết nối (keepalive) định kỳ để tránh phiên làm việc bị đóng băng đột ngột.

2. Khởi tạo và Cấu hình SSH Key chuẩn

Chuẩn khóa hiện đại và an toàn nhất hiện nay là Ed25519 (nhỏ gọn, an toàn và hiệu năng ký vượt trội so với RSA truyền thống).

Bước 2.1: Tạo cặp khóa SSH Ed25519

Trên Terminal máy trạm (Ubuntu, macOS hoặc Windows PowerShell):

mkdir -p "$HOME/.ssh"
chmod 700 "$HOME/.ssh"
ssh-keygen -t ed25519 -a 100 -C "azure-dev-vm" -f "$HOME/.ssh/id_ed25519_azure"
  • Hệ thống sẽ yêu cầu nhập passphrase để bảo vệ khóa riêng (Private Key). Hãy đặt passphrase an toàn để phòng trường hợp máy trạm bị thất lạc.
  • Đầu ra tạo thành 2 file:
    • Khóa riêng (Private Key): ~/.ssh/id_ed25519_azure (bảo mật tuyệt đối, quyền 600).
    • Khóa công khai (Public Key): ~/.ssh/id_ed25519_azure.pub (dùng để đăng ký lên Azure VM).

Bước 2.2: Đăng ký Public Key lên Azure VM

  • Khi tạo mới VM trên Azure Portal hoặc Azure CLI: Chọn mục Authentication type là SSH public key, sau đó dán nội dung file id_ed25519_azure.pub vào ô nhập liệu.
  • Nếu VM đã hoạt động sẵn: Đăng nhập vào VM bằng phương thức hiện có, mở file ~/.ssh/authorized_keys trên VM và nối thêm dòng khóa công khai:
# Thực hiện trên Azure VM
mkdir -p "$HOME/.ssh"
chmod 700 "$HOME/.ssh"
echo "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5... azure-dev-vm" >> "$HOME/.ssh/authorized_keys"
chmod 600 "$HOME/.ssh/authorized_keys"

3. Cấu hình SSH Client đa nền tảng (~/.ssh/config)

Để không phải ghi nhớ địa chỉ IP, username và chỉ định đường dẫn khóa mỗi lần kết nối, hãy tạo hoặc bổ sung vào file cấu hình SSH Client:

  • Đường dẫn trên Linux/macOS: ~/.ssh/config
  • Đường dẫn trên Windows: %USERPROFILE%\.ssh\config (ví dụ C:\Users\username\.ssh\config)

Nội dung file cấu hình mẫu:

# Cấu hình chung chống ngắt kết nối trên hạ tầng Azure
Host *
    ServerAliveInterval 60
    ServerAliveCountMax 3
    TCPKeepAlive yes
    IdentitiesOnly yes

# Máy ảo Azure Linux DEV
Host azure-linux
    HostName 203.0.113.10
    User azureuser
    Port 22
    IdentityFile ~/.ssh/id_ed25519_azure

# Máy ảo Azure qua Jump Host / Bastion nội bộ (nếu áp dụng)
Host azure-private
    HostName 10.0.1.4
    User azureuser
    ProxyJump bastion-gateway
    IdentityFile ~/.ssh/id_ed25519_azure

Lưu ý phân quyền: Trên Linux/macOS, file config bắt buộc phải có quyền sở hữu an toàn:

chmod 600 ~/.ssh/config ~/.ssh/id_ed25519_azure

Sau khi cấu hình, bạn chỉ cần gõ lệnh sau để kết nối:

ssh azure-linux

4. Hướng dẫn chi tiết từ Ubuntu (Linux)

4.1. Kết nối qua Terminal & SSH Agent

Khởi chạy SSH Agent để không phải gõ lại passphrase nhiều lần trong phiên:

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519_azure
ssh-add -l

Kết nối vào Azure VM:

ssh azure-linux

4.2. Lập trình bằng VS Code Remote - SSH

  1. Cài đặt tiện ích mở rộng Remote - SSH (ms-vscode-remote.remote-ssh) trong VS Code:
    code --install-extension ms-vscode-remote.remote-ssh
    
  2. Mở Command Palette trên VS Code (Ctrl + Shift + P), gõ và chọn: Remote-SSH: Connect to Host...
  3. Chọn host azure-linux đã khai báo trong ~/.ssh/config.
  4. Một cửa sổ VS Code mới sẽ mở ra, tự động cài đặt VS Code Server trên máy ảo Azure. Bạn có thể mở thư mục dự án trên VM (ví dụ /home/azureuser/workspace), cài đặt các extension Python, Go, Node.js hoặc Rust trực tiếp trên remote server và tận dụng terminal tích hợp.

4.3. Kết nối Remote Desktop (RDP) lên Azure Windows VM

Khi cần làm việc với giao diện đồ họa trên máy ảo Azure Windows từ Ubuntu, công cụ mã nguồn mở tối ưu nhất là Remmina:

# Cài đặt Remmina và plugin RDP
sudo apt update
sudo apt install -y remmina remmina-plugin-rdp
  1. Mở Remmina từ menu ứng dụng.
  2. Chọn giao thức RDP, nhập địa chỉ Public IP hoặc DNS của Azure Windows VM.
  3. Trong tab Basic:
    • Điền User name và Password của tài khoản Windows trên VM.
  4. Trong tab Advanced:
    • Quality: Chọn Poor hoặc Medium nếu mạng chậm, chọn Best nếu mạng ổn định.
    • Sound: Chọn Off hoặc Local tùy nhu cầu.
    • Share folder: Chọn một thư mục trên Ubuntu để chia sẻ trực tiếp sang ổ đĩa Windows VM (rất tiện khi cần luân chuyển file).
  5. Nhấn Save and Connect.

Ngoài ra, nếu muốn kết nối nhanh qua dòng lệnh bằng FreeRDP:

sudo apt install -y freerdp3-x11
xfreerdp /v:203.0.113.20 /u:azureuser /p:"YourPassword" /size:1920x1080 /dynamic-resolution +clipboard /drive:share,/home/user/share

4.4. Chuyển tiếp cổng (Port Forwarding / SSH Tunneling)

Khi chạy ứng dụng web (port 3000, 8080) hoặc cơ sở dữ liệu (PostgreSQL 5432) trên Azure VM nhưng không muốn mở port công khai trên NSG:

# Chuyển tiếp port 5432 trên Azure VM về cổng 5432 trên máy trạm Ubuntu
ssh -N -L 5432:localhost:5432 azure-linux

Giờ đây bạn có thể mở công cụ DBeaver hoặc trình duyệt trên Ubuntu và kết nối tới localhost:5432.


5. Hướng dẫn chi tiết từ macOS

5.1. Tích hợp SSH Agent với Apple Keychain

macOS hỗ trợ lưu passphrase của khóa SSH trực tiếp vào Apple Keychain, giúp nạp khóa tự động mỗi khi mở máy:

  1. Thêm khóa vào Keychain:
    ssh-add --apple-use-keychain ~/.ssh/id_ed25519_azure
    
  2. Cập nhật ~/.ssh/config trên macOS để nạp tự động:
    Host *
        AddKeysToAgent yes
        UseKeychain yes
        ServerAliveInterval 60
        TCPKeepAlive yes
        IdentityFile ~/.ssh/id_ed25519_azure
    

5.2. VS Code Remote - SSH trên macOS

  1. Mở VS Code, nhấn Cmd + Shift + P → Remote-SSH: Connect to Host....
  2. Chọn azure-linux.
  3. VS Code tận dụng SSH Agent của macOS thông qua Keychain, kết nối tức thì mà không cần nhập lại passphrase.

5.3. Kết nối RDP lên Windows VM bằng Microsoft Remote Desktop

  1. Tải ứng dụng chính chủ Microsoft Remote Desktop từ Mac App Store.
  2. Nhấn biểu tượng + → chọn Add PC.
  3. Cấu hình các thông số:
    • PC name: Nhập Public IP hoặc hostname của Azure Windows VM.
    • User account: Chọn Add User Account…, điền username và password quản trị của VM.
    • Display: Bật Optimize for Retina displays và chọn độ phân giải mong muốn.
    • Folders: Tích chọn Redirect local folders và chỉ định thư mục trên Mac để chia sẻ sang máy ảo.
  4. Nhấn Save, sau đó nhấp đúp vào thẻ kết nối để bắt đầu phiên làm việc.

6. Hướng dẫn chi tiết từ Windows

6.1. Sử dụng OpenSSH Client và Windows Terminal

Windows 10 (từ bản 1809 trở lên) và Windows 11 đã tích hợp sẵn OpenSSH Client.

  1. Mở PowerShell (hoặc Windows Terminal):
    # Kiểm tra OpenSSH Client đã sẵn sàng chưa
    ssh -V
    
  2. Bật và khởi động dịch vụ OpenSSH Authentication Agent để lưu khóa:
    Get-Service ssh-agent | Set-Service -StartupType Automatic
    Start-Service ssh-agent
    ssh-add $HOME\.ssh\id_ed25519_azure
    
  3. Tạo file %USERPROFILE%\.ssh\config:
    Host azure-linux
        HostName 203.0.113.10
        User azureuser
        Port 22
        IdentityFile ~/.ssh/id_ed25519_azure
        ServerAliveInterval 60
        TCPKeepAlive yes
    
  4. Kết nối trực tiếp:
    ssh azure-linux
    

6.2. VS Code Remote - SSH trên Windows

  1. Cài đặt tiện ích mở rộng Remote - SSH trên VS Code for Windows.
  2. Nhấn Ctrl + Shift + P → Remote-SSH: Connect to Host... → chọn azure-linux.
  3. Nếu gặp lỗi đường dẫn SSH client, vào Settings (Ctrl + ,), tìm remote.SSH.path và đặt thành: C:\Windows\System32\OpenSSH\ssh.exe.

6.3. Kết nối RDP lên Azure Windows VM bằng mstsc.exe

Công cụ có sẵn trên mọi máy Windows là Remote Desktop Connection (mstsc):

  1. Nhấn Win + R, gõ mstsc và nhấn Enter.
  2. Trong ô Computer, nhập địa chỉ Public IP của Azure Windows VM.
  3. Nhấn Show Options để tinh chỉnh:
    • Display: Chọn dùng toàn màn hình (Full Screen) hoặc chọn chế độ đa màn hình (Use all my monitors for the remote session).
    • Local Resources:
      • Clipboard: Đánh dấu chọn để copy/paste văn bản và dữ liệu qua lại.
      • More… → Đánh dấu chọn ổ đĩa (Drives) cục bộ muốn hiển thị trong máy ảo.
    • Experience: Chọn Auto-detect connection quality.
  4. Nhấn Save As… để lưu cấu hình thành file azure-vm.rdp trên Desktop, giúp kết nối nhanh bằng một cú nhấp chuột trong các lần tiếp theo.

6.4. Kết nối từ môi trường WSL2 (Windows Subsystem for Linux)

Nếu bạn lập trình trong WSL2 (Ubuntu trên Windows) và muốn kết nối tới Azure VM:

  • Bạn có thể liên kết thư mục .ssh của Windows sang WSL2 để dùng chung cặp khóa:
    mkdir -p ~/.ssh
    cp /mnt/c/Users/<WindowsUser>/.ssh/id_ed25519_azure ~/.ssh/
    chmod 600 ~/.ssh/id_ed25519_azure
    
  • Hoặc dùng chính lệnh ssh.exe của host Windows từ bên trong WSL2.

7. Kết nối qua Azure Bastion (Bảo Mật Cao, Không Cần Public IP)

Trong các dự án doanh nghiệp tuân thủ nghiêm ngặt chuẩn an ninh, máy ảo Azure DEV không có Public IP mà nằm hoàn toàn trong mạng riêng (Private Subnet). Khi đó, kết nối bắt buộc phải đi qua Azure Bastion.

Bước 7.1: Cài đặt và Đăng nhập Azure CLI

  • Ubuntu: sudo apt install azure-cli
  • macOS: brew install azure-cli
  • Windows: winget install Microsoft.AzureCLI hoặc choco install azure-cli

Đăng nhập tài khoản Azure:

az login

Bước 7.2: SSH trực tiếp qua Azure Bastion CLI

Sử dụng lệnh az network bastion ssh để mở phiên terminal an toàn:

az network bastion ssh \
  --name "myBastionHost" \
  --resource-group "myResourceGroup" \
  --target-resource-id "/subscriptions/<Sub-ID>/resourceGroups/<RG>/providers/Microsoft.Compute/virtualMachines/myVM" \
  --auth-type "ssh-key" \
  --username "azureuser" \
  --ssh-key "~/.ssh/id_ed25519_azure"

Bước 7.3: Mở Tunnel qua Bastion để dùng VS Code hoặc RDP native

Khi cần dùng VS Code Remote - SSH hoặc phần mềm RDP thông thường qua Bastion, hãy thiết lập một đường ống (Native Tunnel):

# Mở tunnel cho SSH (chuyển tiếp cổng 22 của VM về cổng 50022 trên localhost)
az network bastion tunnel \
  --name "myBastionHost" \
  --resource-group "myResourceGroup" \
  --target-resource-id "<VM_Resource_ID>" \
  --resource-port 22 \
  --port 50022

Khi tunnel đang chạy, cấu hình trong ~/.ssh/config của máy trạm:

Host azure-bastion-vm
    HostName 127.0.0.1
    Port 50022
    User azureuser
    IdentityFile ~/.ssh/id_ed25519_azure

Bây giờ bạn có thể kết nối ssh azure-bastion-vm hoặc dùng VS Code Remote trỏ tới azure-bastion-vm.


8. Kinh nghiệm và Thực Chiến Tối Ưu Môi Trường Remote

8.1. Sử dụng tmux chống đứt kết nối giữa chừng

Khi chạy các lệnh build lâu, migration database, hoặc chạy batch job dài hạn, nếu mạng Wi-Fi của máy trạm chập chờn, phiên SSH sẽ bị đứt và tiến trình bị hủy bỏ. Hãy luôn chạy công việc trong tmux trên remote Linux VM:

# Cài đặt tmux trên VM (nếu chưa có)
sudo apt install -y tmux

# Mở một session mới có tên 'work'
tmux new -s work

# Tách khỏi session (Detach): Nhấn tổ hợp phím Ctrl + B rồi nhấn phím D

# Khi kết nối lại vào VM, khôi phục session cũ:
tmux attach -t work

8.2. An toàn danh tính Git và Tránh rò rỉ khóa

  • Không bao giờ tạo Private Key của tài khoản Git cá nhân rồi lưu trên Remote VM.
  • Sử dụng SSH Agent Forwarding có chọn lọc. Trong ~/.ssh/config trên máy trạm:
    Host azure-linux
        ForwardAgent yes
    
    Khi bật tính năng này, Remote VM có thể mượn khóa SSH từ máy trạm để xác thực git pull / git push về GitHub/GitLab mà không cần lưu khóa trên ổ đĩa của VM.
  • Đặt danh tính Git chuẩn trên VM:
    git config --global user.name "Dev Name"
    git config --global user.email "dev@example.org"
    

8.3. Đồng bộ mã nguồn nhanh bằng rsync

Khi cần đẩy hoặc kéo thư mục mã nguồn/tệp tin cấu hình lớn giữa máy trạm và Azure VM:

# Đẩy thư mục dự án từ máy trạm lên Azure VM (bỏ qua git và node_modules)
rsync -avzP --exclude '.git' --exclude 'node_modules' ./my-project/ azure-linux:~/my-project/

# Tải kết quả build/log từ Azure VM về máy trạm
rsync -avzP azure-linux:~/my-project/build/ ./build-output/

8.4. Giám sát tài nguyên và phân vùng ổ đĩa VM

Máy ảo Azure thường chia thành hai loại đĩa: OS Disk (chứa hệ điều hành) và Temporary Storage (ổ tạm gắn liền với host, dữ liệu sẽ mất khi Deallocate VM).

# Kiểm tra phân vùng đĩa
df -hT

# Theo dõi mức tiêu thụ RAM, CPU và các tiến trình
htop

Cảnh báo: Trên Azure Linux VM, phân vùng gắn tại /mnt thường là Resource Disk (đĩa tạm thời). Tuyệt đối không lưu mã nguồn, cơ sở dữ liệu hoặc cấu hình lâu dài tại /mnt mà phải lưu trong thư mục $HOME (thuộc OS Disk) hoặc ổ đĩa dữ liệu được gắn thêm (Data Disk).


9. Bảng Xử Lý Sự Cố Thường Gặp (Troubleshooting)

Hiện tượng lỗiNguyên nhân gốc rễCách khắc phục
Connection timed out (Port 22/3389)1. Azure NSG chưa mở rule Inbound cho IP máy trạm.
2. VM đang ở trạng thái Stopped (Deallocated).
3. Firewall trên VM (ufw / Windows Firewall) đang chặn.
• Kiểm tra trạng thái VM trên Azure Portal (Running).
• Cập nhật Inbound Security Rule trên NSG với Source IP là IP hiện tại của bạn.
• Trên VM Linux: sudo ufw allow 22/tcp.
Permission denied (publickey)1. Chưa thêm Public Key vào ~/.ssh/authorized_keys.
2. Phân quyền file sai trên VM.
3. Dùng sai username (mặc định Azure thường là azureuser).
• Kiểm tra phân quyền trên VM: chmod 700 ~/.ssh và chmod 600 ~/.ssh/authorized_keys.
• Chạy lệnh SSH debug: ssh -v azure-linux để xem khóa nào được gửi.
• Đảm bảo username đúng với khai báo lúc khởi tạo VM.
Host key verification failedMáy ảo được Re-create hoặc được cấp lại Public IP mới, khiến Host Key không khớp với cache cũ.Chạy lệnh xóa Host Key cũ trên máy trạm:
ssh-keygen -R 203.0.113.10
Kết nối SSH bị đóng băng sau vài phút không gõ phímAzure Virtual Network Idle Timeout (4 phút) tự động ngắt kết nối không có lưu lượng.Thêm ServerAliveInterval 60 và TCPKeepAlive yes vào file ~/.ssh/config trên máy trạm.
RDP màn hình đen hoặc độ phân giải bị vỡ trên macOSSai cấu hình hiển thị hoặc codec đồ họa chưa tương thích.Trong Microsoft Remote Desktop, vào Edit PC → Tab Display → chọn Optimize for Retina displays và đặt resolution thủ công (ví dụ 1920x1080).