label studio 외부 공유 방법(1)

 

label studio 라벨링 작업을 동료들에게 부탁하기 위해서 외부에 공유가 필요함.

이를 위해서 링크 제공하는 방법을 사용하기로 했다.

 

가독성과 정리가 조금 번잡하므로 GPT 답변은 네모 박스 안에 넣을 것임. 참고해서 정리하고 추후 확인하면 더 편할 듯

---

Label Studio는 기본적으로 로컬 호스트(http://127.0.0.1:8080 또는 http://localhost:8080)에서 실행됩니다. 127.0.0.1은 로컬 컴퓨터에서만 접근할 수 있는 내부 네트워크 주소입니다. 다른 컴퓨터에서 접근하려면 이 서버를 외부 네트워크로 노출해야 합니다.

---

2. 공유 가능한 설정 방법 방법 1: 로컬 네트워크에서 공유 서버를 특정 IP로 바인딩 기본 실행 명령어에 --host 옵션을 추가합니다. 예: --host 0.0.0.0: 서버를 모든 네트워크 인터페이스에서 접근 가능하도록 설정. --port 8080: 사용 포트 (8080은 기본값이지만 원하는 번호로 변경 가능). 같은 네트워크에 있는 사용자와 공유 실행한 컴퓨터의 로컬 IP 주소를 찾습니다. 예: Windows: ipconfig Mac/Linux: ifconfig 또는 ip a IP 주소가 192.168.x.x 형식이라면, 다른 사용자에게 http://192.168.x.x:8080 링크를 공유합니다. 방화벽 확인 로컬 네트워크에서 공유하려면, 방화벽이 해당 포트를 차단하지 않도록 설정해야 합니다. 방법 2: 외부 네트워크에서 공유 (인터넷 공유) 만약 다른 네트워크(외부 사용자)에서 접근할 수 있도록 하려면: 포트 포워딩 설정 공유하려는 컴퓨터가 연결된 라우터에서 8080 포트를 포워딩 설정합니다. 라우터 설정 페이지(일반적으로 192.168.1.1)에 로그인. 8080 포트를 컴퓨터의 로컬 IP로 포워딩. 공용 IP 주소 확인 구글에서 "what is my IP"로 검색하여 공용 IP 주소를 확인한 뒤, 링크를 http://<공용 IP>:8080 형태로 공유합니다. HTTPS를 원하면 로컬 서버를 인터넷에 노출하면 보안 문제가 생길 수 있으므로, ngrok 같은 도구를 사용해 안전하게 공유합니다. 명령어 실행 후 생성된 공개 URL을 공유하면 안전하게 접근 가능합니다. 방법 3: 클라우드 서버에 배포 공유를 자주 해야 한다면 로컬 대신 클라우드 서버(AWS, GCP, Azure 등)에 설치하여 공유하는 방법도 고려해 보세요. 클라우드에 배포하면 공용 URL을 사용해 언제든지 접근 가능합니다. 요약 같은 네트워크에서는 로컬 IP를 공유하면 충분. 다른 네트워크에서는 포트 포워딩 또는 ngrok 같은 도구가 필요. 보안이 중요하다면 HTTPS나 클라우드 배포를 검토하세요. 추가 설정이 필요하면 더 도와드릴게요! 😊

---

이를 위해서 서버를 설정함고 여러 사용자가 동시에 접근할 수 있도록 환경을 구성하기로 함

 

3 가지 방법이 있는데, 일단 클라우드 서버에 배포는 어떻게 하는지도 모르고, 돈이 들 거 같아서 다른 네트워크 공유 방법으로 진행하기로 했다.

1. 로컬에서 협업하려면 로컬에서 실행된 Label Studio를 네트워크 상에서 동료와 공유하려면: A. 같은 네트워크 안에 있는 경우 Label Studio 실행 다음 명령어로 실행하여 서버를 네트워크에서 접근 가능하도록 설정합니다: label-studio start --host 0.0.0.0 --port 8080 --host 0.0.0.0 옵션은 모든 네트워크 인터페이스에서 접근 가능하도록 함. --port는 기본값 8080을 사용하거나 다른 포트를 설정 가능. 로컬 IP 찾기 실행 중인 컴퓨터의 로컬 IP 주소를 찾습니다. Windows: ipconfig Mac/Linux: ifconfig 또는 ip a 예: 192.168.1.100과 같은 주소. 동료들에게 링크 공유 동료들에게 **http://<로컬 IP>:8080**을 공유하세요. 예: http://192.168.1.100:8080 방화벽 설정 확인 사용 중인 컴퓨터의 방화벽이 해당 포트를 차단하지 않도록 허용하세요. B. 다른 네트워크(인터넷)에서 협업해야 할 경우 ngrok 사용 ngrok을 사용하면 로컬 서버를 안전한 URL로 공개할 수 있습니다. ngrok 설치 후 실행: ngrok http 8080 실행하면 http://<생성된 ngrok 주소>가 표시됩니다. 이 링크를 동료들과 공유하면 다른 네트워크에서도 접근 가능. 포트 포워딩 설정 라우터 설정에서 실행 중인 컴퓨터의 포트를 공개하려면: 라우터에서 8080 포트를 실행 중인 컴퓨터의 로컬 IP로 포워딩. 공용 IP 주소를 확인(what is my IP 검색)하고 **http://<공용 IP>:8080**을 공유.

나는 다른 네트워크(인터넷)에서 협업해야 하므로, ngrok을 사용하기로 했다.

 

ngrok  사용 방법

나는 다른 네트워크(인터넷)에서 협업해야 하므로, ngrok을 사용하기로 했다.

1. ngrok을 사용한 간단한 방법 ngrok은 로컬 서버를 외부에 안전하게 공유할 수 있는 도구입니다. 설정이 간단하고 보안도 기본적으로 제공됩니다. 설정 단계 ngrok 설치 ngrok 공식 사이트(https://ngrok.com/)에서 설치 파일을 다운로드하고 설치합니다. 또는 터미널에서 설치: ngrok 인증 ngrok 계정을 만들고, 제공된 auth token을 터미널에 등록합니다: ngrok config add-authtoken YOUR_AUTH_TOKEN Label Studio 실행 기존처럼 로컬에서 Label Studio를 실행합니다: label-studio start --host 0.0.0.0 --port 8080 ngrok 실행 터미널에서 다음 명령어를 입력합니다: ngrok http 8080 실행하면 ngrok이 로컬 서버를 외부에 노출시키고 공유 가능한 URL을 생성합니다. 예: https://abcd-1234.ngrok.io 공유 ngrok에서 생성된 URL을 동료들에게 공유하면, 동료들은 인터넷을 통해 접근 가능합니다.

 

---

이런 방법으로 

label-studio start --host 0.0.0.0 --port 8080

을 실행했지만 아래와 같은 창 나옴 첨엔 뭐가 잘못된건가 했다

에러가 발생한 이유는 브라우저에서 http://0.0.0.0/를 입력했기 때문입니다. 0.0.0.0은 모든 네트워크 인터페이스를 나타내는 IP 주소로, 실제로 브라우저에서 접근할 때 사용할 주소는 아닙니다. 해결 방법 Label Studio 서버의 로컬 IP로 접속 0.0.0.0 대신 실행 중인 컴퓨터의 로컬 IP 주소를 사용해야 합니다.

그래서  ipconfig로 내 IP주소 확인, IPv4 주소 항목을 찾았음

 

브라우저에서 http://localhost:8080(뒤의 8080이 이미 실행중이면 8081, 8082, 8083,,, 등등 무한 생성임)

정리 --host 0.0.0.0 설정은 맞습니다! 하지만 브라우저에서 접근할 때는: 로컬에서: http://127.0.0.1:8080 네트워크에서: http://<실제 로컬 IP>:8080

 

뭔 일처리를 이렇게 헷갈리게 해야하노

GPT가 windows 방화벽 설정이라는 것도 알려줬는데

당췌 못 알아듣겠어서 좀 화났음

 

뭐라뭐라 알려줬는데, 현재 알아들을 수 있는건 이 정도

비교

방법설정 난이도보안추천 상황

ngrok	간단	기본 HTTPS	빠르게 공유하고 싶을 때
포트 포워딩	보통	낮음	외부 네트워크 사용자와 공유할 때
클라우드 서버	어려움	높음	안정적이고 장기적인 환경이 필요할 때
Docker (클라우드 포함)	보통	높음	컨테이너 기반 환경에서 실행

 

--host 0.0.0.0의 역할 0.0.0.0은 특정 IP에 국한되지 않고 현재 컴퓨터의 모든 네트워크 인터페이스(예: Wi-Fi, 이더넷)에 연결되도록 서버를 실행합니다. 이 설정을 사용하면, 실행한 컴퓨터의 IP 주소를 사용해서 접근할 수 있습니다: 같은 컴퓨터에서는 http://127.0.0.1:8080 또는 http://localhost:8080로 접근. 같은 네트워크에서는 해당 컴퓨터의 로컬 IP 주소(예: 192.168.x.x)를 사용. 외부 네트워크에서는 공용 IP 주소(포트 포워딩 또는 ngrok 필요)를 사용.

 

그래서 잠깐 헷갈려서 딴 길로 빠졌다가 ngrok 사용으로 다시 진행함

실행 로그 확인 Label Studio가 정상적으로 실행 중인지 터미널 로그를 확인하세요. label-studio start --host 0.0.0.0 --port 8080 명령어를 실행했을 때 실행 로그에 다음과 같은 메시지가 표시되어야 합니다: Starting development server at http://0.0.0.0:8080/ 이 메시지가 없다면 실행이 제대로 되지 않은 것이니 다시 시도해보세요.

일단 label studio가 정상적으로 작동되는지 확인하고

3. ngrok 실행 Label Studio 실행 정상적으로 실행 중인지 확인: label-studio start --host 0.0.0.0 --port 8080 실행 로그에 Starting development server at http://0.0.0.0:8080/가 보이면 성공입니다. http://localhost:8080 또는 **http://127.0.0.1:8080**로 접속 테스트. ngrok으로 로컬 서버 노출 ngrok 설치 및 token 등록. ngrok을 실행해 8080 포트를 외부 URL로 공개: ngrok http 8080 ngrok이 실행되면 아래와 같은 메시지가 표시됩니다: Forwarding                    https://abcd-1234.ngrok.io -> http://localhost:8080 여기서 **https://abcd-1234.ngrok.io**가 외부에서 접근 가능한 URL입니다. 공유 동료들에게 생성된 URL(예: https://abcd-1234.ngrok.io)을 공유하면 인터넷을 통해 접속할 수 있습니다.

 

GPT 가 친절하게 알려줬지만 나는 cmd 창을 전혀 몰라서 어디다가 ngrok를 실행시켜야하는지도 물어봤음...

1. ngrok 실행 위치 Label Studio가 이미 실행 중인 상태여야 합니다: Label Studio는 한 터미널 창(CMD)에서 실행 중이어야 합니다: label-studio start --host 0.0.0.0 --port 8080 이 창은 닫지 말고 그대로 두세요. 다른 터미널 창을 열어 ngrok 실행 같은 컴퓨터에서 새로운 터미널 또는 명령 프롬프트 창을 엽니다. 새 창에서 ngrok http 8080 명령을 입력합니다.       2. ngrok 실행 과정 새로운 터미널/명령 프롬프트 창에서 다음을 입력: ngrok http 8080 실행하면 아래와 같은 화면이 나타납니다: Session Status                online Account                       Your Account (Plan: Free) Forwarding                    https://abcd-1234.ngrok.io -> http://localhost:8080 여기서 **https://abcd-1234.ngrok.io**가 외부에서 접근 가능한 URL입니다. 3. 동료들과 URL 공유 동료들에게 **https://abcd-1234.ngrok.io**를 공유하면 인터넷을 통해 Label Studio에 접근할 수 있습니다. 외부 사용자들은 이 URL을 브라우저에 입력하면 바로 접속 가능합니다. 4. 주의 사항 ngrok은 실행 중인 동안에만 URL이 유효합니다. 터미널을 닫거나 ngrok 세션을 종료하면 URL이 더 이상 작동하지 않습니다. 무료 플랜에서는 매번 URL이 새로 생성되니, 동일한 URL을 유지하려면 유료 플랜을 고려하세요. 요약 Label Studio 실행: 한 터미널에서 실행. ngrok 실행: 다른 터미널에서 실행. ngrok이 제공한 URL로 외부 사용자와 공유.

 

그래서 링크를 다른 기기에서 열었는데, 로그인이 안되는 문제가 발생

해결하기 위해서 다양한 시도를 했는데 생각보다 간단한 해결방법이 있었다.(그건 다음 포스트에서)

 

 GPT가 계정을 다시 만들라고 함

계정 생성 확인 방법 Label Studio 접속 브라우저에서 http://127.0.0.1:8081 또는 **http://localhost:8081**로 접속합니다. ngrok을 통해 외부 URL로 접속하는 경우, ngrok에서 제공한 URL을 사용하세요. 로그인 테스트 위에서 생성한 계정 정보로 로그인: Username: admin Password: sercotec2024 성공적으로 로그인되면 계정이 생성된 것입니다. 계정 확인 실패 시 조치 만약 로그인이 실패하거나 계정 생성이 제대로 이루어지지 않았다면, 다음을 시도하세요: 새 계정 강제 생성 Label Studio는 기본적으로 초기 실행 시 사용자 계정을 생성하도록 설계되어 있습니다. 그러나 CLI를 통해 명시적으로 다시 생성할 수도 있습니다. label-studio start --username new_admin --password new_password 데이터베이스 초기화 이미 사용 중인 데이터베이스에 문제가 있을 경우, 데이터를 초기화한 후 다시 실행합니다: label-studio reset_password --username admin --password new_password

근데 뭔가 안 만들어지더라

 

이렇게 자꾸 뻘짓하다가 진짜진쨔 간단한 방법을 알아냄 !!