콘텐츠로 이동
Octoboard 문서

Tailscale로 브라우저 연결

SSH나 원격 데스크톱 없이, 내 Tailscale 네트워크를 통해 다른 컴퓨터의 브라우저에서 Octoboard을(를) 엽니다. 호스트는 Octoboard이(가) 실행되는 컴퓨터로, Mac, Windows PC 또는 octoboardd가 실행 중인 Linux 서버입니다. SSH 로그인(macOS의 원격 로그인)은 꺼 둬도 됩니다.

이 방법이 맞는지 잘 모르겠나요? 연결 방법 선택을 보세요.

내 컴퓨터의 브라우저 → 내 컴퓨터의 중계 프로그램(127.0.0.1) ⟷ Tailscale ⟷ 호스트의 중계 프로그램(127.0.0.1) → Octoboard

처음이라면
  • Tailscale: 기기가 어디에 있든 인터넷으로 연결해 하나의 비공개 네트워크로 묶어 주는 서비스입니다. 내 계정으로 로그인해서 씁니다.
  • 테일넷(tailnet): 내 Tailscale 네트워크, 즉 내 Tailscale 계정에 로그인한 기기들입니다.
  • 127.0.0.1(루프백): 항상 “바로 이 컴퓨터”를 뜻하는 주소입니다.
  • 포트: 컴퓨터 안의 프로그램 하나를 가리키는 번호로, 문 번호와 같습니다. 127.0.0.1:3369은(는) 이 컴퓨터의 3369번 포트입니다.
  • socat: 한 곳의 연결을 다른 곳으로 넘겨 주는 작은 무료 프로그램입니다. 여기서는 중계 프로그램 역할을 합니다.
  • Tailscale Serve: 포트를 내 테일넷에만 공유하는 Tailscale 명령입니다. 비슷한 Tailscale Funnel은 전체 인터넷에 공유하므로 여기서는 절대 쓰지 마세요.
  • 터미널: 명령을 입력하는 창입니다. macOS에서는 터미널, Windows에서는 PowerShell입니다.

안전을 위해 Octoboard은(는) 127.0.0.1에서 연 브라우저만 받습니다. 이 주소는 항상 “바로 이 컴퓨터”를 뜻합니다(루프백이라고도 합니다). 그래서 호스트의 Tailscale 주소를 브라우저에 그냥 입력할 수는 없습니다. 대신 두 컴퓨터에서 각각 작은 중계 프로그램을 실행합니다. 내 컴퓨터에서는 호스트가 127.0.0.1에 있는 것처럼 보이게 하고, 호스트에서는 연결을 Octoboard에 넘겨 줍니다. 두 컴퓨터 사이의 트래픽은 Tailscale이 실어 나릅니다.

  • 두 컴퓨터 모두에 Tailscale을 설치하고, 같은 테일넷에 로그인하세요. 내 기기만 있는 테일넷을 쓰세요. 테일넷에서 호스트에 닿을 수 있는 기기는 모두 공유한 포트에 접속할 수 있습니다.

  • Mac이거나 Linux를 쓰는 컴퓨터마다 socat. Windows 컴퓨터에는 필요 없습니다.

    Homebrew가 없다면 먼저 설치하세요(macOS에는 이 일을 할 도구가 기본으로 없습니다). 그런 다음 터미널에서 이 명령을 실행하세요.

    Terminal window
    brew install socat
  • 작업하는 동안 열어 둘 창 두세 개: 호스트의 중계 프로그램과 Tailscale Serve(Windows의 중계 프로그램은 제외), 그리고 내 컴퓨터의 중계 프로그램(Windows는 제외)입니다.

  1. 브라우저 주소를 가져오세요. 이 주소에 브라우저를 로그인시키는 키가 들어 있습니다.

    Octoboard에서 설정 › 원격 접근을 열고 원격 접근 허용을 켠 다음 허용을 눌러 확인하세요. 스위치 아래에 탭 두 개가 나타납니다. 브라우저 탭의 2단계: 브라우저 주소 아래에서 주소 복사를 누르세요.

    주소는 다른 컴퓨터로 가져가야 하는데, 비밀번호와 같으니 본인만 볼 수 있는 방법(예: 나에게 쓰는 메모)으로 옮기세요.

    1단계: SSH 포워드는 건너뛰세요. 앱 설정 곳곳에 SSH가 나오지만, 이 가이드는 브라우저 주소만 쓰므로 여기서는 무시해도 됩니다.

    Octoboard을(를) 계속 실행해 두세요. 종료하면 원격 접근이 멈춥니다.

  2. 호스트에서 중계 프로그램을 시작하세요. 호스트의 127.0.0.1 포트를 Octoboard에 연결해 줍니다. 이 포트가 아래 단계에서 말하는 호스트 포트입니다.

    터미널에서 이 명령을 실행하고 창을 열어 두세요. 127.0.0.1:3370에서만 연결을 받습니다.

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

    호스트 포트는 3370입니다.

  3. Tailscale Serve로 호스트 포트를 내 테일넷에 공유하고, 창을 열어 두세요. 공개 인터넷에 포트를 내놓게 되는 Tailscale Funnel은 절대 쓰지 마세요.

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

    App Store의 Tailscale 앱을 쓴다면 tailscale 대신 /Applications/Tailscale.app/Contents/MacOS/Tailscale(으)로 명령을 실행하세요. 독립 실행형 앱이라면 먼저 앱 설정의 CLI integration에서 명령을 설치하세요.

    확인하려면 다른 창에서 tailscale serve status을(를) 실행하세요. 목록에 호스트 포트가 나와야 합니다.

  1. 이 컴퓨터의 Tailscale 앱에서 호스트를 찾아 이름(예: my-mac)이나 주소(100.x.y.z 같은 숫자)를 적어 두세요.

  2. 이 컴퓨터에서 중계 프로그램을 시작하세요. 호스트가 여기서 127.0.0.1:3369에 있는 것처럼 보이게 해 줍니다. 이 컴퓨터에서 3369번 포트를 이미 쓰고 있다면 다른 포트를 고르고, 브라우저 주소의 포트도 바꾸세요.

    아래 명령에서 <host>을(를) 호스트의 이름이나 주소로, <host port>을(를) 호스트 포트로 바꾸세요.

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

    예를 들어 이름이 my-mac인 Mac 호스트라면 다음과 같습니다.

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

    터미널에서 실행하고 창을 열어 두세요.

  3. 호스트에서 복사한 브라우저 주소를 여세요. http://127.0.0.1:3369/(으)로 시작합니다.

로그인하라는 요청 없이 브라우저 탭에서 Octoboard이(가) 열리면 성공입니다.

  • 페이지가 열리지 않을 때: 창 하나를 닫았거나 그 명령이 멈췄습니다. 중계 프로그램과 Tailscale Serve가 아직 실행 중인지, 호스트에서 tailscale serve status을(를) 실행했을 때 호스트 포트가 목록에 나오는지 확인하세요.
  • socat이 “Address already in use”라고 할 때: 그 컴퓨터에서 그 포트를 이미 쓰고 있습니다. 다른 포트를 고르세요. 내 컴퓨터라면 브라우저 주소의 포트도 바꾸세요.
  • 페이지가 거부되거나 비어 있을 때: 호스트의 Tailscale 이름이나 100.x.y.z 주소가 아니라 127.0.0.1의 주소로 열었는지 확인하세요.
  • 페이지를 열 때 호스트의 중계 프로그램이 “Connection refused” 또는 “No such file or directory”라고 출력할 때: 원격 접근 허용이 꺼져 있거나 호스트에서 Octoboard이(가) 실행 중이 아닙니다(Linux에서는 octoboardd가 실행 중이 아닙니다).
  • 브라우저를 쓴 컴퓨터에서: Ctrl+C로 socat을 멈추세요. Windows에서는 관리자 권한으로 연 PowerShell에서 포워드를 삭제하세요.

    Terminal window
    netsh interface portproxy delete v4tov4 listenaddress=127.0.0.1 listenport=3369
  • 호스트에서: Ctrl+C로 Tailscale Serve 명령과 socat을 멈추세요. tailscale serve status(으)로 더 이상 공유되는 것이 없는지 확인하고, 포트가 아직 목록에 있으면 tailscale serve --tcp=3370 off(으)로 지우세요(Windows에서는 tailscale serve --tcp=3369 off).

  • Mac이나 Windows 호스트에서는 더 이상 필요 없을 때 원격 접근 허용을 끄세요. 브라우저 입구가 닫히고, 그 키로 열린 모든 페이지의 연결이 끊어집니다.

  • 주소가 유출됐을 수 있다면 브라우저 탭의 키 교체로, Linux에서는 octoboardd address --rotate(으)로 새 키를 만드세요. 이전 주소로 열려 있던 페이지는 연결이 끊어집니다.

  • 주소가 곧 비밀번호: 주소의 키는 호스트의 Octoboard에 대한 전체 제어 권한을 주며, 어떤 명령이든 실행할 수 있습니다. 키를 교체하기 전까지 유효합니다. 브라우저 방문 기록과 북마크에 남으며, 브라우저 동기화를 켜 두면 다른 기기에도 동기화됩니다.
  • 누가 접속할 수 있나: 호스트 포트에 닿을 수 있고 키를 가진 사람은 누구든 접속할 수 있습니다. 중계 프로그램은 127.0.0.1에서만 연결을 받으므로 호스트나 내 로컬 네트워크의 다른 기기는 닿을 수 없습니다. Tailscale Serve는 접근 규칙이 허용하는 범위에서 호스트 포트를 내 테일넷에서만 닿게 합니다.
  • 나 혼자 로그인하는 컴퓨터에서만: 호스트나 내 컴퓨터의 다른 사용자 계정이 이 127.0.0.1 포트에 연결할 수 있고, 중계 프로그램이 실행 중이 아닐 때는 그 포트를 가로채 브라우저가 다시 연결할 때 키를 받을 수 있습니다. SSH로 연결하면 Mac이나 Linux 호스트에는 이 약점이 없고, 데스크톱 앱을 쓸 때는 내 컴퓨터에도 없습니다. 하지만 브라우저를 쓸 때는 브라우저를 쓰는 컴퓨터에 약점이 남습니다. 그곳에서도 SSH 포워드가 127.0.0.1 포트에서 대기하기 때문입니다.
  • Funnel은 절대 금지: Tailscale Funnel은 포트를 전체 인터넷에 공개합니다.