Bỏ qua để đến nội dung
Octoboard Tài liệu

Trình duyệt qua Tailscale

Mở Octoboard trong trình duyệt trên một máy tính khác qua mạng Tailscale của riêng bạn, không cần SSH hay điều khiển máy từ xa. Máy đích là máy tính chạy Octoboard: một máy Mac, một PC Windows hoặc một máy chủ Linux chạy octoboardd. Đăng nhập SSH (Đăng nhập từ xa trên macOS) có thể để tắt.

Chưa chắc đây là cách phù hợp với bạn? Xem Chọn cách kết nối.

Trình duyệt trên máy tính của bạn → chương trình chuyển tiếp trên máy tính của bạn (127.0.0.1) ⟷ Tailscale ⟷ chương trình chuyển tiếp trên máy đích (127.0.0.1) → Octoboard

Mới làm quen?
  • Tailscale: một dịch vụ nối các thiết bị của bạn thành một mạng riêng qua internet, dù chúng ở đâu. Bạn đăng nhập vào nó bằng tài khoản của riêng mình.
  • Tailnet: mạng Tailscale của bạn: các thiết bị đã đăng nhập vào tài khoản Tailscale của bạn.
  • 127.0.0.1 (loopback): một địa chỉ luôn có nghĩa là “chính máy tính này”.
  • Cổng: một con số chọn ra một chương trình trên máy tính, giống số cửa. 127.0.0.1:3369 là cổng 3369 trên máy tính này.
  • socat: một chương trình nhỏ, miễn phí, chuyển một kết nối từ nơi này sang nơi khác. Ở đây nó là chương trình chuyển tiếp.
  • Tailscale Serve: một lệnh của Tailscale chia sẻ một cổng chỉ với tailnet của bạn. Lệnh anh em của nó, Tailscale Funnel, sẽ chia sẻ cổng đó với cả internet; tuyệt đối không dùng ở đây.
  • Terminal: cửa sổ để bạn gõ lệnh: Terminal trên macOS, PowerShell trên Windows.

Để an toàn, Octoboard chỉ nhận một trình duyệt mở nó tại 127.0.0.1, một địa chỉ luôn có nghĩa là “chính máy tính này” (còn gọi là loopback). Vì vậy bạn không thể chỉ gõ địa chỉ Tailscale của máy đích vào trình duyệt. Thay vào đó, bạn chạy một chương trình chuyển tiếp nhỏ trên mỗi máy tính: trên máy của bạn, nó làm cho máy đích trông như ở ngay trên máy tại 127.0.0.1; trên máy đích, nó chuyển kết nối cho Octoboard. Tailscale mang lưu lượng giữa hai bên.

  • Tailscale trên cả hai máy tính, đã đăng nhập vào cùng một tailnet. Hãy dùng một tailnet chỉ chứa thiết bị của riêng bạn: mọi thiết bị mà nó cho phép tới máy đích đều tới được cổng bạn chia sẻ.

  • socat trên mỗi máy tính là Mac hoặc chạy Linux. Máy tính Windows không cần nó.

    Hãy cài Homebrew trước nếu bạn chưa có (macOS không kèm công cụ nào làm được việc này), rồi chạy lệnh sau trong Terminal:

    Terminal window
    brew install socat
  • Hai hoặc ba cửa sổ để mở trong lúc làm việc: chương trình chuyển tiếp và Tailscale Serve trên máy đích (trừ chương trình chuyển tiếp trên Windows), và chương trình chuyển tiếp trên máy tính của bạn (trừ trên Windows).

  1. Lấy địa chỉ trình duyệt, nó mang khóa dùng để đăng nhập trình duyệt.

    Trong Octoboard, mở Cài đặt › Truy cập từ xa, bật Cho phép truy cập từ xa rồi chọn Cho phép để xác nhận. Hai thẻ sẽ hiện ra bên dưới công tắc. Trên thẻ Trình duyệt, chọn Sao chép địa chỉ trong mục Bước 2: địa chỉ trình duyệt.

    Hãy chuyển địa chỉ này sang máy tính kia theo cách chỉ mình bạn đọc được, chẳng hạn một ghi chú gửi cho chính mình: địa chỉ này có tác dụng như mật khẩu.

    Bỏ qua Bước 1: chuyển tiếp SSH. Phần cài đặt của ứng dụng nhắc đến SSH ở nhiều chỗ; bạn có thể bỏ qua ở đây, vì hướng dẫn này chỉ dùng địa chỉ trình duyệt.

    Hãy để Octoboard tiếp tục chạy: nếu bạn thoát ứng dụng, truy cập từ xa sẽ dừng.

  2. Khởi động chương trình chuyển tiếp trên máy đích, nó nối một cổng trên 127.0.0.1 của máy đích với Octoboard. Cổng này là cổng của máy đích trong các bước bên dưới.

    Chạy lệnh này trong Terminal và để cửa sổ mở. Nó chỉ lắng nghe tại 127.0.0.1:3370.

    Terminal window
    socat TCP-LISTEN:3370,bind=127.0.0.1,reuseaddr,fork UNIX-CONNECT:"$HOME/.octoboard/browser.sock"

    Cổng của máy đích là 3370.

  3. Chia sẻ cổng của máy đích với tailnet của bạn bằng Tailscale Serve, và để cửa sổ mở. Tuyệt đối không dùng Tailscale Funnel, vì nó sẽ đưa cổng này lên internet công khai.

    Terminal window
    tailscale serve --tcp=3370 tcp://127.0.0.1:3370

    Với ứng dụng Tailscale từ App Store, hãy chạy lệnh bằng /Applications/Tailscale.app/Contents/MacOS/Tailscale thay cho tailscale. Với ứng dụng bản độc lập, hãy cài lệnh trước từ phần cài đặt của nó, mục CLI integration.

    Để kiểm tra, chạy tailscale serve status trong một cửa sổ khác: nó phải liệt kê cổng của máy đích.

  1. Tìm máy đích trong ứng dụng Tailscale trên máy tính này, và ghi lại tên của nó (chẳng hạn my-mac) hoặc địa chỉ của nó (một số dạng 100.x.y.z).

  2. Khởi động chương trình chuyển tiếp trên máy tính này, nó làm cho máy đích hiện ra tại 127.0.0.1:3369 trên máy này. Nếu cổng 3369 đã bị chiếm trên máy tính này, hãy chọn cổng khác và đổi cả trong địa chỉ trình duyệt.

    Trong lệnh dưới đây, thay <host> bằng tên hoặc địa chỉ của máy đích, và <host port> bằng cổng của máy đích.

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:<host>:<host port>

    Ví dụ, với máy đích là Mac tên my-mac:

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:my-mac:3370

    Chạy nó trong Terminal và để cửa sổ mở.

  3. Mở địa chỉ trình duyệt bạn đã sao chép trên máy đích. Nó bắt đầu bằng http://127.0.0.1:3369/.

Bạn sẽ biết là đã thành công khi Octoboard mở trong thẻ trình duyệt mà không yêu cầu bạn đăng nhập.

  • Trang không tải: một trong các cửa sổ đã bị đóng, hoặc lệnh của nó đã dừng. Kiểm tra các chương trình chuyển tiếp và Tailscale Serve vẫn đang chạy, và tailscale serve status trên máy đích có liệt kê cổng của máy đích.
  • socat báo “Address already in use”: cổng đó đã bị chiếm trên máy tính đó. Hãy chọn cổng khác; trên máy tính của bạn, đổi cả trong địa chỉ trình duyệt.
  • Trang bị từ chối hoặc trống: kiểm tra bạn đã mở địa chỉ tại 127.0.0.1, không phải tên Tailscale của máy đích hay địa chỉ 100.x.y.z.
  • Chương trình chuyển tiếp trên máy đích in “Connection refused” hoặc “No such file or directory” khi bạn mở trang: Cho phép truy cập từ xa đang tắt, hoặc Octoboard không chạy trên máy đích (trên Linux, là octoboardd không chạy).
  • Trên máy tính bạn đã dùng để duyệt web: dừng socat bằng Ctrl+C, hoặc trên Windows thì xóa chuyển tiếp trong PowerShell chạy với quyền quản trị viên:

    Terminal window
    netsh interface portproxy delete v4tov4 listenaddress=127.0.0.1 listenport=3369
  • Trên máy đích: dừng lệnh Tailscale Serve và socat bằng Ctrl+C. Dùng tailscale serve status để kiểm tra không còn gì được chia sẻ; nếu cổng vẫn còn trong danh sách, gỡ nó bằng tailscale serve --tcp=3370 off (trên Windows là tailscale serve --tcp=3369 off).

  • Trên máy đích Mac hoặc Windows, tắt Cho phép truy cập từ xa khi bạn không cần nữa. Việc này đóng lối vào của trình duyệt và ngắt mọi trang đã mở bằng khóa.

  • Nếu địa chỉ có thể đã bị lộ, hãy cấp cho nó một khóa mới bằng Đổi khóa trên thẻ Trình duyệt, hoặc trên Linux bằng octoboardd address --rotate. Các trang đang mở bằng địa chỉ cũ sẽ bị ngắt.

  • Địa chỉ chính là mật khẩu: khóa của nó cho toàn quyền điều khiển Octoboard trên máy đích, kể cả chạy bất kỳ lệnh nào. Nó có hiệu lực cho đến khi bạn đổi khóa. Nó nằm lại trong lịch sử và dấu trang của trình duyệt, đồng thời đồng bộ sang các thiết bị khác của bạn nếu bật đồng bộ trình duyệt.
  • Ai tới được nó: bất kỳ ai tới được cổng của máy đích và có khóa. Các chương trình chuyển tiếp chỉ lắng nghe tại 127.0.0.1, nên các thiết bị khác trong mạng của máy đích hay mạng của bạn không tới được; Tailscale Serve chỉ làm cho cổng của máy đích tới được từ tailnet của bạn, trong phạm vi các quy tắc truy cập của nó cho phép.
  • Chỉ dùng trên những máy mà không ai khác đăng nhập: một tài khoản người dùng khác trên máy đích hoặc trên máy tính của bạn có thể kết nối tới các cổng 127.0.0.1 này, và khi một chương trình chuyển tiếp không chạy, nó có thể chiếm cổng đó và nhận được khóa khi trình duyệt của bạn kết nối lại. Kết nối qua SSH không có điểm yếu này trên máy đích Mac hoặc Linux, và máy tính của bạn cũng không có khi dùng ứng dụng máy tính. Nhưng trong trình duyệt, máy tính của bạn vẫn có điểm yếu này, vì chuyển tiếp SSH ở đó cũng lắng nghe trên một cổng 127.0.0.1.
  • Không bao giờ dùng Funnel: Tailscale Funnel sẽ đưa cổng này lên cả internet.