SSD Nodes Learn Hosting plans →
가이드 Matt Connor작성자 Matt Connor · 업데이트됨 2026-11-06

VPS DSH 웹 UI 접속 방법: 127.0.0.1:3080 해결법

DSH 웹 UI가 127.0.0.1:3080에 바인딩되어 로컬에서 접속되지 않는 문제를 해결합니다. SSH 터널링과 프록시를 활용하여 보안을 유지하면서 VPS의 웹 UI에 안전하게 접근하는 3가지 방법을 상세히 안내합니다.

노트북에서 DSH 웹 UI가 열리지 않는 이유

DSH 웹 UI는 루프백 인터페이스에 바인딩되므로, 터미널에 출력된 URL은 해당 URL을 출력한 머신에서만 작동합니다. npx @deepseek-ai/dsh web는 http://127.0.0.1:3080/?token=... 형식의 실행 URL을 보고하며, 127.0.0.1는 어떤 컴퓨터가 이 주소를 읽든 "이 주소를 읽고 있는 컴퓨터"를 의미합니다. 노트북이 이 주소를 읽으면 자신의 루프백 인터페이스를 확인하게 되는데, 그곳에는 아무것도 수신 대기 중인 서비스가 없습니다. 주소 자체를 이해하기 어렵다면 DSH가 왜 http://127.0.0.1:3080를 출력하는지에 대한 설명을 참조하십시오. DSH가 바인딩하는 대상을 변경해서는 안 됩니다. 대신 노트북에서 VPS의 루프백 주소로 연결되는 인증된 경로를 구축하십시오.

루프백 기본값은 올바른 설정이며, 이 페이지에 소개된 모든 방법은 이를 유지합니다. 포트 3080 뒤에서 실행되는 것은 서버에서 셸 명령을 수행하는 에이전트이며, 웹 UI에는 별도의 로그인 페이지가 포함되어 있지 않습니다. 현재 DSH는 실행 토큰을 사용하여 브라우저를 인증합니다. 프로세스가 시작될 때마다 새로운 토큰이 생성되고 출력된 URL에 이 토큰이 포함되며, 첫 방문 시 이 토큰을 세션 쿠키로 교환합니다. 해당 토큰은 URL에 포함된 단일 베어러 자격 증명이므로, 루프백은 여전히 가장 중요한 보안 계층입니다. 소켓에 대한 직접 연결은 SSH나 프록시를 통해 전달되는 연결을 포함하여, 반드시 VPS 내부에서 시작되어야 합니다.

DSH가 바인딩하는 대상과 확인 방법

2026년 11월 4일 확인된 DeepSeek Harness README에 따르면, DSH는 npx @deepseek-ai/dsh web "기본적으로 http://127.0.0.1:3080에서 웹 UI를 시작합니다". 동일 저장소의 CLI 참조 문서는 기본 포트가 3080로 유지된다고 명시하며, --host는 "와일드카드가 아닌 구체적인 로컬 주소를 지정해야 한다"고 설명합니다. 또한 --host 0.0.0.0은 사용법 오류와 함께 종료됩니다. DSH는 개발자 프리뷰 버전이며, README는 대문자로 호환성을 깨뜨리는 변경 사항이 발생할 것임을 경고합니다. 이 페이지를 포함한 어떠한 문서도 맹신하지 말고, 본인의 설치 환경에서 두 값을 직접 확인하십시오.

dsh --profile web --dump-config
ss -ltnp | grep 3080

--dump-config은 에이전트를 부팅하지 않고 구성된 설정 트리를 출력하지만, 표현식을 평가하지 않고 애플리케이션 인수를 해석하지 않으므로 최종 런타임 호스트와 포트의 덤프가 아닙니다. ss은 현재 실제로 리스닝 중인 항목을 보여줍니다. 정상적인 출력은 다음과 같습니다.

LISTEN 0  511  127.0.0.1:3080  0.0.0.0:*  users:(("node",pid=8123,fd=24))

피어 주소가 아닌 로컬 리스닝 주소를 확인하십시오. 127.0.0.1:3080는 루프백 전용이며, 이는 의도한 설정입니다. 127/8, ::1 및 이들의 루프백 매핑 형태에 있는 다른 주소들 역시 DSH를 로컬로 유지합니다. 루프백이 아닌 주소는 해당 주소가 속한 네트워크로 서비스를 제공하며, 이는 공용 네트워크일 수 있습니다. ss가 아무런 줄도 출력하지 않는다면 포트 3080에서 리스닝 중인 프로세스가 없는 것입니다. 터널을 설정하기 전에 DSH가 중단되었는지 혹은 다른 포트를 사용하는지 확인하십시오. 해당 단계에 도달하는 방법은 VPS에서 DeepSeek Harness 설치 및 실행하기에서 다룹니다.

플래그는 1회 실행에만 적용됩니다. 값을 고정하려면 프로필 패치 레이어를 수정하십시오. dsh --profile <name>은 $DSH_HOME/profiles/<name>에서 프로필을 부팅하며, 레이어는 번들 패치, 프로필 자체의 cordis.patch.yml, 홈 수준의 $DSH_HOME/cordis.patch.yml, 그리고 --patch 오버레이 순으로 쌓입니다. 리스닝 설정은 @deepseek-ai/dsh-host-webserver 플러그인 하위의 host 및 port에 위치합니다. 웹 프로필은 첫 부팅 시 제공된 템플릿에서 스스로를 작성하며 프리뷰 버전에서는 해당 템플릿의 구조가 계속 변경되므로, 수정하기 전에 --dump-config로 직접 구성된 트리를 읽어보십시오.

시작 라인은 자격 증명이 생성되는 지점이기도 합니다. DSH는 token 쿼리에 프로세스 토큰을 포함한 루트 URL을 출력하며, 브라우저는 이를 GET /?token=...으로만 제시할 수 있고 Authorization 헤더로는 제시할 수 없습니다. 브라우저가 아닌 API 호출자를 위한 별도의 GET /connect?token=... 교환 방식이 존재합니다. 루트 요청은 서명된 호스트 전용 HttpOnly, SameSite=Strict 쿠키를 설정하고 깔끔한 URL로 리다이렉트합니다. 프로세스가 시작될 때마다 새로운 토큰이 생성되며, 쿠키는 cookieMaxAgeDays에 의해 설정된 기본값인 30일 후에 만료됩니다. 유효한 자격 증명 없이 문서나 API를 요청하면 401 오류가 발생하며, 정적 자산은 공개 상태로 유지됩니다. 아래의 모든 방법은 출력된 URL을 여는 것으로 마무리되므로, 토큰을 포함한 전체 URL을 복사하십시오.

두 번째 관문: /api 신뢰 울타리

포트 3080으로 패킷을 전달하는 것은 문제의 절반에 불과합니다. DSH에는 두 번째 확인 절차가 있으며, 이 과정에서 페이지는 로드되고 레이아웃은 나타나지만 아무것도 작동하지 않는 혼란스러운 오류가 발생합니다.

@deepseek-ai/dsh-client-connection 플러그인에는 trustedHosts 설정이 있습니다. README에 명시된 규칙은 다음과 같습니다. Host 헤더는 루프백 주소, 리스너가 바인딩된 자체 주소(포트 무관), 또는 trustedHosts 항목과 일치해야 하며, 브라우저가 Origin 헤더를 전송할 때 동일한 권한(authority)을 명시해야 합니다. 이 울타리는 모든 요청의 인증 단계 이전에 실행되며, 조건을 충족하지 못하는 모든 /api 요청을 거부합니다. 브라우저는 이 거부 상황을 다음과 같이 보고합니다.

transport failure for /api/host.describe: HTTP 403

따라서 DSH 앞에 배치하는 모든 프록시는 브라우저에 입력된 이름을 선언해야 합니다. CLI는 --trusted-host <authority> 옵션을 사용하며, 이 옵션은 반복해서 지정할 수 있습니다.

dsh web --trusted-host dsh.example.com

이 울타리는 호스트와 포트를 포함한 권한을 대조하며, 리스너의 스킴에 따른 기본 포트를 정규화합니다. dsh.example.com와 같이 포트가 없는 항목은 해당 이름의 모든 포트와 일치하므로 dsh.example.com:8443도 포함합니다. dsh.example.com:8443처럼 포트가 포함된 항목은 해당 호스트와 포트만 정확히 일치시킵니다. 루프백은 별도의 항목이 필요하지 않으므로 localhost:3080와 127.0.0.1:3080은 모두 통과합니다. 원인을 알 수 없는 403 오류는 거의 항상 URL 표시줄의 이름과 신뢰 목록에 있는 이름이 일치하지 않아서 발생합니다. 401 오류는 다른 문제입니다. 이는 울타리를 통과했으나 브라우저에 해당 권한에 대한 유효한 세션 쿠키가 없는 경우입니다.

이 울타리는 오리진(origin) 확인 절차입니다. 인증이 아닙니다. 브라우저는 자체 보안 정책에 따라 Host 헤더를 설정할 수 없으므로, 이 확인 절차는 다른 사이트의 페이지가 사용자의 에이전트를 조작하는 것을 방지합니다. 브라우저가 아닌 클라이언트는 해당 헤더를 자유롭게 작성할 수 있습니다. trustedHosts는 프록시 호환성 및 브라우저 요청 방어 설정으로만 취급해야 하며, 인증이나 포트 접근 제한 수단으로 사용해서는 안 됩니다.

옵션 1: SSH 로컬 포워딩

서버에 아무것도 추가하지 않으므로 가장 먼저 고려해야 할 방법입니다.

ssh -N -L 127.0.0.1:3080:127.0.0.1:3080 you@your-vps

-L은 노트북에서 리스너를 열고 각 연결을 VPS에서 해석된 127.0.0.1:3080로 전달합니다. -N은 "원격 명령을 실행하지 않음"을 의미하므로, 세션은 포워딩 기능만 수행합니다. 로컬 측을 단순히 3080이 아닌 127.0.0.1:3080로 작성한 것은 의도적인 것입니다. 이는 노트북 측 리스너를 루프백으로 고정하여, SSH 클라이언트 설정의 GatewayPorts 옵션이 에이전트를 현재 연결된 네트워크로 몰래 재공개하는 것을 방지합니다.

이제 DSH가 출력한 토큰이 포함된 시작 URL을 노트북 브라우저에서 엽니다. 포워딩이 127.0.0.1:3080에서 대기하므로 출력된 http://127.0.0.1:3080/?token=...은 그대로 작동합니다. 새로운 브라우저 세션에서는 단순히 http://localhost:3080만으로는 부족합니다. 쿠키가 없으면 DSH는 401 오류를 반환합니다. 첫 방문 이후에는 쿠키가 세션을 유지하지만, 쿠키는 호스트 전용이므로 처음 접속한 도메인을 계속 사용해야 합니다. 127.0.0.1로 설정된 쿠키는 localhost으로 전송되지 않기 때문입니다. Host 헤더는 루프백 권한이므로 /api 방화벽은 별도 설정 없이 통과합니다. 현재 DSH UUID 구현은 crypto.getRandomValues()를 사용하므로, 부팅을 위해 보안 컨텍스트 전용인 crypto.randomUUID()에 더 이상 의존하지 않습니다.

인증이 완료되면 ssh가 백그라운드로 이동하도록 -f을 추가하십시오.

ssh -f -N -L 127.0.0.1:3080:127.0.0.1:3080 you@your-vps

이 방법은 정직한 절충안입니다. 공용 주소에서 새로 대기하는 프로세스가 없고 방화벽 규칙 변경도 없으므로, 노출 위험을 최소화할 수 있습니다. 전체 접근 제어는 SSH 설정에 의존하므로, 비밀번호 로그인을 비활성화한 키 기반 SSH는 선택 사항이 아닌 필수 전제 조건입니다. 단점은 터널이 단일 클라이언트 세션에 종속된다는 점입니다. 노트북이 절전 모드로 전환되면 터널이 끊기며, 수동으로 재시작해야 하고, 휴대폰에서는 사용할 수 없습니다.

옵션 2: VPS에서 Tailscale serve 사용하기

Tailscale은 사용자 기기 간의 사설 네트워크를 구축합니다. VPS에 이를 설치하면 해당 장비에 Tailscale을 통해 접근 가능한 100.x.y.z 주소가 할당되며, 접근 제어 정책에 따라 어떤 기기가 연결할 수 있는지 결정됩니다. 장비 공유 기능을 사용하면 외부 사용자의 기기까지 접근 권한을 확장할 수 있습니다.

네트워크에 참여하는 것만으로는 부족하며, 많은 사용자가 이 지점에서 어려움을 겪습니다. DSH는 루프백(loopback) 주소에서 대기 중이므로 100.x.y.z 주소에서는 대기하지 않습니다. http://100.x.y.z:3080로 접속을 시도하면 해당 주소에 바인딩된 소켓이 없기 때문에 연결이 거부됩니다. --host은 해당 주소를 허용하지만, 루프백이 아닌 주소에 바인딩하면 TLS를 설정하지 않는 한 일반 HTTP로 서비스됩니다. DSH는 시작 시 루프백이 아닌 HTTP 바인딩에 대해 경고를 표시하지만, 여기서 사용하는 루프백 리스너는 해당 경고를 발생시키지 않습니다. 현재의 UUID 구현은 보안 컨텍스트 없이도 작동하지만, 일반 HTTP는 해당 HTTP 구간에서 실행 토큰과 쿠키를 노출합니다.

tailscale serve은 이 둘을 연결하는 구성 요소입니다. VPS에서 실행되며 사설 네트워크로부터 트래픽을 받아 로컬 주소로 프록시합니다.

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
sudo tailscale serve --bg --https=443 localhost:3080
tailscale serve status

tailscale serve status은 https://<machine>.<tailnet>.ts.net/ 형식의 URL을 출력합니다. 해당 이름을 신뢰하도록 설정하고 DSH를 시작하십시오. 그렇지 않으면 /api이 앞서 설명한 대로 403 오류를 반환합니다.

dsh web --public-url https://your-vps.your-tailnet.ts.net/ --trusted-host your-vps.your-tailnet.ts.net

--public-url은 출력 및 실행되는 시작 URL인 DSH_WEB_URL와 에이전트 런타임 컨텍스트의 웹 GUI URL을 설정합니다. 따라서 실행 URL은 tailnet 이름으로 생성되며 휴대폰에서 그대로 열립니다. 이 설정 자체만으로는 아무것도 허용하지 않으므로 --trusted-host이 여전히 필요합니다. 출력된 URL에는 활성 자격 증명이 포함되어 있으므로 본인의 기기에만 붙여넣으십시오.

Tailscale은 해당 이름으로 발급된 인증서를 사용하여 실제 HTTPS를 종료하며, 브라우저와 VPS 사이의 실행 토큰 및 세션 쿠키를 보호합니다. 서비스는 공용 인터넷에 노출되지 않으며, serve는 장비 공유를 통해 부여된 접근 권한을 포함하여 Tailscale 트래픽만 허용합니다.

여기서 tailscale funnel를 대신 사용하지 마십시오. 이는 공용 인터넷을 대상으로 하는 동일한 명령어 계열이며, 누구나 해석할 수 있는 호스트 이름에 셸 접근 권한이 있는 에이전트를 배치하게 됩니다. 명령어를 입력하기 전에 serve가 트래픽을 tailnet 내부에 유지하는 방식과 funnel이 이를 공개하는 방식의 차이를 읽어보십시오. 이 전체 설정을 휴대폰에서 사용하는 방법은 휴대폰에서 직접 호스팅하는 에이전트에 접근하기를 참조하십시오.

이 방식의 단점은 의존성입니다. UI가 필요한 모든 기기는 tailnet이나 장비 공유를 통해 VPS에 접근할 수 있는 Tailscale을 사용해야 하며, 사용자가 직접 운영하지 않는 조정 서버(coordination server)가 네트워크 멤버십을 관리합니다. 이것이 허용되지 않는다면 직접 호스팅하는 Headscale 제어 서버를 통해 본인 소유의 하드웨어에서 동일한 프로토콜을 사용할 수 있습니다.

옵션 3: 인증된 TLS 리버스 프록시

브라우저가 사설 네트워크에 접속할 수 없는 경우(예: 관리 권한이 없는 장비)에 이 방식을 사용합니다. 이제 호스트 이름을 인터넷에 공개하는 것이므로, 인증은 실제적이어야 하며 프록시 단에서 이루어져야 합니다. DSH의 실행 토큰은 URL에 포함된 하나의 베어러 자격 증명일 뿐이며, 이를 가진 모든 사람이 공유하므로 별도의 인증 계층으로 간주하지 않습니다.

TLS는 https://의 기반이 되는 암호화 기술인 전송 계층 보안을 의미합니다. nginx를 루프백 포트로 지정하고 그 앞에 비밀번호를 설정하십시오. map 블록은 http 컨텍스트에 속하므로, /etc/nginx/conf.d/ 아래에 별도의 파일로 작성하십시오.

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

그다음 사이트 설정입니다.

server {
    listen 443 ssl;
    server_name dsh.example.com;

    ssl_certificate     /etc/letsencrypt/live/dsh.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/dsh.example.com/privkey.pem;

    auth_basic           "dsh";
    auth_basic_user_file /etc/nginx/dsh.htpasswd;

    location / {
        proxy_pass http://127.0.0.1:3080;
        proxy_http_version 1.1;
        proxy_set_header Host              $host;
        proxy_set_header Upgrade           $http_upgrade;
        proxy_set_header Connection        $connection_upgrade;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cookie_flags ~ secure;
        proxy_read_timeout 3600s;
        proxy_buffering    off;
    }
}

비밀번호 파일을 생성하고, 테스트한 뒤 다시 불러오십시오.

sudo apt install -y apache2-utils
sudo htpasswd -c /etc/nginx/dsh.htpasswd you
sudo nginx -t && sudo systemctl reload nginx

nginx -t은 syntax is ok 및 test is successful를 출력해야 합니다. 오류가 출력되면 nginx는 이전 설정을 유지하므로 서비스는 중단되지 않습니다. 그 후 공개 이름을 신뢰하도록 설정하여 DSH를 시작하십시오. proxy_set_header Host $host이 dsh.example.com를 전달하며, 그렇지 않으면 펜스(fence)가 이를 거부하기 때문입니다. --public-url를 사용하면 출력되는 실행 URL이 해당 이름을 사용하므로 바로 열 수 있습니다.

dsh web --public-url https://dsh.example.com/ --trusted-host dsh.example.com

여기서 세 가지 지시어가 핵심적인 역할을 합니다. Upgrade 및 Connection 헤더는 UI가 WebSocket 연결을 설정할 수 있게 하며, 없으면 업그레이드가 실패합니다. proxy_read_timeout 3600s은 업스트림 읽기 간격 제한을 기본값인 60초에서 1시간으로 늘립니다. 이는 전체 에이전트 실행 시간에 대한 제한이 아닙니다. proxy_cookie_flags ~ secure는 HTTPS 구간에서 DSH의 세션 쿠키를 Secure으로 표시합니다. DSH의 공개 배포 가이드는 일반 HTTP 백엔드가 쿠키를 발행할 때 이 설정을 프록시에서 수행하도록 권장합니다. DSH는 --tls-cert 및 --tls-key를 사용하여 직접 HTTPS를 제공할 수도 있지만, 인증서를 발급하거나 갱신하지 않으며 비밀번호를 추가하지 않으므로 여기서는 프록시를 대체할 수 없습니다. 나머지 설정에 대한 이유는 nginx 리버스 프록시 설정 지시어별 상세 설명에서 확인할 수 있으며, 프록시 선택에 관한 내용은 nginx와 Caddy 및 Traefik 비교를 참조하십시오.

기본 인증(basic auth)이 제공하는 보안 수준을 명확히 이해해야 합니다. 이는 무작위 스캐너의 접근을 차단하며, 포트를 완전히 개방하는 것보다 훨씬 안전합니다. 하지만 이는 셸 앞에 놓인 하나의 공유 비밀번호일 뿐이며, 2단계 인증이 없고 모든 사용자가 동일한 로그인을 공유하므로 특정 사용자의 권한만 취소할 수 없습니다. 비밀번호를 알고 실행 URL이나 세션 쿠키를 가진 사람은 누구나 DSH가 실행 중인 사용자의 권한으로 명령을 실행할 수 있습니다. 여러 사람이 접근해야 한다면 그 앞에 실제 ID 프록시를 배치하고, 범위를 더 넓히기 전에 VPS에서 코딩 에이전트를 실행하기 위한 안전 규칙을 읽어보십시오.

0.0.0.0에 바인딩하고 포트를 개방하면 발생하는 일

가장 쉬운 방법은 재바인딩 후 방화벽을 여는 것입니다. 하지만 DSH는 와일드카드 바인딩을 차단합니다. --host은 0.0.0.0를 거부하며, @deepseek-ai/dsh-host-webserver 플러그인은 설정이 로드될 때 0.0.0.0, :: 및 IPv4 매핑 형태를 포함하여 명시되지 않은 주소를 모두 거부합니다. host이 허용하는 것은 구체적인 IPv4 또는 IPv6 주소 리터럴뿐이므로, 공인 IP를 직접 지정하는 설정은 DSH에서 사용할 수 있습니다. 와일드카드 거부 기능을 우회하기 위해 웹 서버 행을 대체하는 커뮤니티 플러그인들이 존재합니다. 해당 플러그인들은 경고와 함께 제공되며, 그 경고는 정확합니다. 동일한 플러그인 계층은 에이전트가 수행할 수 있는 작업을 제한하는 지출 한도 및 도구 권한 규칙과 같이 반대 방향으로 사용할 때 훨씬 더 유용합니다.

TLS 없이 공인 IP에 바인딩할 경우 실제로 발생하는 상황은 다음과 같습니다. 포트 3080은 일반 HTTP를 통해 공인 IP 주소에서 응답합니다. DSH는 루프백이 아닌 주소에서 일반 HTTP를 서비스할 때 시작 시 경고를 출력하지만, 이는 단순한 경고일 뿐이며 리스너는 여전히 열립니다. 로그인 페이지는 존재하지 않습니다. 실행 토큰이 유일한 잠금 장치인데, 이 토큰은 URL 내에서 평문으로 인터넷을 통과하며 그 뒤를 따르는 세션 쿠키도 마찬가지입니다. /api 펜스는 비브라우저 클라이언트가 스스로 작성하는 Host 헤더를 검사하지만, 어차피 어떤 포트에서든 바인딩 주소를 허용하므로 trustedHosts에 주소를 나열하는 것은 curl를 가진 공격자에게 아무런 변화를 주지 못합니다. DSH 배포 가이드 자체에서도 광고된 URL이나 펜스 모두 리스닝 포트 자체를 보호하지는 못한다고 명시합니다. 해당 포트 뒤에는 사용자의 권한으로 셸 명령을 실행하는 에이전트가 있으며, DSH가 프로필과 API 키를 보관하는 $DSH_HOME 아래의 자격 증명도 함께 노출됩니다. 토큰이나 쿠키를 하나라도 탈취당하면 서버에서 원격 코드 실행이 가능해지며, 이는 곧 사용자의 비용 청구로 이어집니다. 스캐너는 전체 주소 공간을 지속적으로 훑고 있으므로, 주소를 공개하지 않는 것만으로는 통제 수단이 될 수 없습니다. 에이전트가 읽을 수 있는 모든 비밀은 셸과 함께 유출됩니다.

위에서 언급한 모든 방법은 이러한 위험을 방지하기 위해 존재합니다. 한 명의 사용자가 노트북 한 대를 사용할 때는 SSH 포워딩이 올바른 기본값입니다. 모바일 기기를 사용하거나 정식 인증서가 필요한 경우에는 tailscale serve로 전환하십시오. 관리하지 않는 브라우저에서 UI에 접근해야 하는 경우에는 그 앞에 실제 인증을 둔 공인 리버스 프록시를 사용하십시오.

FAQ

왜 http://127.0.0.1:3080이 제 노트북에서 열리지 않습니까?

127.0.0.1는 "이 주소를 읽는 기기"를 의미하기 때문입니다. DSH는 VPS에서 이를 출력하며, 그곳에서는 올바른 주소입니다. 노트북에서 같은 문자열을 읽으면 자신의 루프백 인터페이스를 바라보게 되는데, 그곳에는 아무것도 실행 중이지 않습니다. VPS에서 ss -ltnp | grep 3080 명령으로 서버 측 상태를 확인하십시오. 127.0.0.1:3080이 포함된 줄이 보인다면 DSH가 의도적으로 루프백에 바인딩되어 실행 중이라는 뜻입니다. 필요한 것은 바인딩 주소 변경이 아니라 터널이나 프록시이며, 그 후 토큰이 포함된 전체 실행 URL을 사용해야 합니다.

dsh web을 --host 0.0.0.0으로 실행할 수 있습니까?

아니요. 2026년 11월 4일에 확인한 저장소 CLI 참조에 따르면 --host은 와일드카드가 아닌 구체적인 로컬 주소 하나를 지정해야 하며, --host 0.0.0.0를 사용하면 사용법 오류와 함께 종료됩니다. 웹 서버 플러그인은 설정이 로드될 때 해당 주소를 거부합니다. 공인 IP와 같은 구체적인 주소는 허용되지만, TLS 없이는 일반 HTTP로 서비스되므로 DSH는 시작 시 경고를 표시하며, 셸을 보호하는 실행 토큰이 네트워크를 통해 평문으로 전송됩니다. 커뮤니티 플러그인은 와일드카드 검사를 우회합니다. 이를 사용하는 경우 방화벽과 전송 보안은 사용자의 책임입니다.

리버스 프록시 뒤에서 모든 /api 호출이 왜 HTTP 403을 반환합니까?

/api 신뢰 장벽은 Host 헤더가 루프백 주소, 리스너의 바인딩 주소, 또는 trustedHosts에 나열된 주소가 아닌 모든 요청을 거부합니다. 프록시 뒤에서는 해당 헤더에 사용자의 공인 도메인 이름이 포함되므로 장벽이 이를 거부하고 브라우저 로그에 transport failure for /api/host.describe: HTTP 403이 기록됩니다. --trusted-host <your name> 옵션을 사용하여 DSH를 시작하고 URL 표시줄의 이름과 일치시키십시오. 포트가 없는 항목은 해당 이름의 모든 포트와 일치하며, 포트가 있는 항목은 호스트와 포트가 정확히 일치해야 합니다. 호출이 401을 반환한다면 장벽은 통과했으나 브라우저에 해당 권한에 대한 유효한 세션이 없는 것이므로, 토큰이 포함된 전체 실행 URL을 여십시오.

DSH UI는 로드되는데 왜 일반 HTTP 환경에서 시작이 완료되지 않습니까?

현재 DSH UUID 구현은 crypto.getRandomValues()를 사용하며, 이는 보안 컨텍스트 외부에서도 작동하므로 이전의 crypto.randomUUID() 부팅 실패는 더 이상 이 증상을 설명하지 않습니다. 브라우저의 실패한 요청을 확인하십시오. 403은 Host/Origin 장벽을 의미하고, 401은 자격 증명이 없거나 유효하지 않음을 의미합니다. 토큰이 포함된 전체 실행 URL을 열고 브라우저에 표시된 권한과 --trusted-host을 대조하십시오. 일반 HTTP는 여전히 실행 토큰과 세션 쿠키를 노출하므로 원격 접근 시에는 HTTPS나 SSH 포워딩을 유지하십시오.

단일 개발자는 어떤 방법을 사용해야 합니까?

SSH 로컬 포워딩을 사용하십시오. 서버에 아무것도 추가하지 않고, 방화벽 규칙을 변경하지 않으며, 이미 신뢰하는 SSH 키를 재사용합니다. ssh -f -N -L 127.0.0.1:3080:127.0.0.1:3080 you@your-vps을 실행한 다음, 토큰이 포함된 DSH 출력 실행 URL인 http://127.0.0.1:3080/?token=...를 여십시오. 휴대폰에서 UI를 사용하거나 노트북이 절전 모드로 전환되어도 접근을 유지하려면 tailscale serve으로 이동하십시오.

이 글이 도움이 되었나요?