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설치할 것이 없습니다. Windows 호스트는 이미
127.0.0.1포트로 브라우저를 제공하고, 브라우저를 쓰는 Windows 컴퓨터는 기본 제공 명령을 대신 씁니다.Terminal window sudo apt install socatapt가 아니라면 배포판의 패키지 관리자(dnf,pacman등)를 쓰세요. -
작업하는 동안 열어 둘 창 두세 개: 호스트의 중계 프로그램과 Tailscale Serve(Windows의 중계 프로그램은 제외), 그리고 내 컴퓨터의 중계 프로그램(Windows는 제외)입니다.
호스트에서
섹션 제목: “호스트에서”-
브라우저 주소를 가져오세요. 이 주소에 브라우저를 로그인시키는 키가 들어 있습니다.
Octoboard에서 설정 › 원격 접근을 열고 원격 접근 허용을 켠 다음 허용을 눌러 확인하세요. 스위치 아래에 탭 두 개가 나타납니다. 브라우저 탭의 2단계: 브라우저 주소 아래에서 주소 복사를 누르세요.
주소는 다른 컴퓨터로 가져가야 하는데, 비밀번호와 같으니 본인만 볼 수 있는 방법(예: 나에게 쓰는 메모)으로 옮기세요.
1단계: SSH 포워드는 건너뛰세요. 앱 설정 곳곳에 SSH가 나오지만, 이 가이드는 브라우저 주소만 쓰므로 여기서는 무시해도 됩니다.
Octoboard을(를) 계속 실행해 두세요. 종료하면 원격 접근이 멈춥니다.
Octoboard에서 설정 › 원격 접근을 열고 원격 접근 허용을 켠 다음 허용을 눌러 확인하세요. 스위치 아래에 탭 두 개가 나타납니다. 브라우저 탭의 2단계: 브라우저 주소 아래에서 주소 복사를 누르세요. 브라우저 포트 아래의 숫자도 적어 두세요.
주소는 다른 컴퓨터로 가져가야 하는데, 비밀번호와 같으니 본인만 볼 수 있는 방법(예: 나에게 쓰는 메모)으로 옮기세요.
1단계: SSH 포워드는 건너뛰세요. 앱 설정 곳곳에 SSH가 나오지만, 이 가이드는 브라우저 주소만 쓰므로 여기서는 무시해도 됩니다.
Octoboard을(를) 계속 실행해 두세요. 종료하면 원격 접근이 멈춥니다.
octoboardd를 실행하는 사용자로 이 명령을 실행하고, 출력된
http://127.0.0.1:3369/(으)로 시작하는 주소를 복사하세요. 그 뒤에 출력되는 SSH 명령은 무시하세요.Terminal window octoboardd address -
호스트에서 중계 프로그램을 시작하세요. 호스트의
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입니다.실행할 것이 없습니다. Octoboard이(가) 직접 브라우저 포트에서,
127.0.0.1에서만 연결을 받습니다. 호스트 포트는 브라우저 포트입니다(바꾸지 않았다면 3369).같은 사용자로 터미널이나 계속 열어 둘
tmux세션에서 이 명령을 실행하세요.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입니다. -
Tailscale Serve로 호스트 포트를 내 테일넷에 공유하고, 창을 열어 두세요. 공개 인터넷에 포트를 내놓게 되는 Tailscale Funnel은 절대 쓰지 마세요.
Terminal window tailscale serve --tcp=3370 tcp://127.0.0.1:3370App Store의 Tailscale 앱을 쓴다면
tailscale대신/Applications/Tailscale.app/Contents/MacOS/Tailscale(으)로 명령을 실행하세요. 독립 실행형 앱이라면 먼저 앱 설정의 CLI integration에서 명령을 설치하세요.PowerShell이나 명령 프롬프트에서 실행하세요.
Terminal window tailscale serve --tcp=3369 tcp://127.0.0.1:3369브라우저 포트를 바꿨다면 바꾼 포트를 쓰세요.
Terminal window tailscale serve --tcp=3370 tcp://127.0.0.1:3370Tailscale이 권한이 없다고 하면
sudo tailscale set --operator="$USER"(으)로 내 사용자가 Tailscale을 관리하도록 한 번 허용하거나, 명령을sudo로 실행하세요.확인하려면 다른 창에서
tailscale serve status을(를) 실행하세요. 목록에 호스트 포트가 나와야 합니다.
브라우저를 쓸 컴퓨터에서
섹션 제목: “브라우저를 쓸 컴퓨터에서”-
이 컴퓨터의 Tailscale 앱에서 호스트를 찾아 이름(예:
my-mac)이나 주소(100.x.y.z같은 숫자)를 적어 두세요. -
이 컴퓨터에서 중계 프로그램을 시작하세요. 호스트가 여기서
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터미널에서 실행하고 창을 열어 두세요.
PowerShell을 관리자 권한으로 여세요. 아래 명령에서
<host IP>을(를) 호스트의100.x.y.z주소로(이 명령은 숫자 주소가 필요하며 이름은 안 됩니다),<host port>을(를) 호스트 포트로 바꾸세요.Terminal window netsh interface portproxy add v4tov4 listenaddress=127.0.0.1 listenport=3369 connectaddress=<host IP> connectport=<host port>이 포워드는 재시작해도 삭제할 때까지(아래 참고) 그대로 남아 있으므로, 열어 둘 창이 없습니다. 기본으로 실행 중인 IP Helper 서비스가 필요합니다.
-
호스트에서 복사한 브라우저 주소를 여세요.
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은 포트를 전체 인터넷에 공개합니다.