SSD Nodes Learn Hosting plans →
가이드 Matt Connor작성자 Matt Connor

dsh 플러그인 작동 원리와 안전한 검증 방법

dsh 플러그인은 에이전트 권한으로 외부 코드를 실행하므로 보안 위험이 존재합니다. 플러그인이 접근 가능한 파일 시스템, 셸, LLM API 키 범위를 확인하고 설치 전 소스 코드를 검증하는 구체적인 보안 가이드를 제공합니다.

dsh 플러그인이란 무엇이며, 어떤 기능을 수행합니까?

dsh 플러그인은 DeepSeek Harness가 자체 프로세스로 로드하는 Node 패키지입니다. 플러그인이 로드되면 에이전트의 권한으로, 에이전트가 접근할 수 있는 머신에서 타인의 코드를 실행합니다. 설치 단계 자체는 이보다 더 엄격하게 보호됩니다. pnpm은 사용자가 승인하기 전까지 의존성 빌드 스크립트 실행을 보류하며, CLI 참조 문서에서는 "번들을 추가, 제거 또는 업데이트한 후에는 해당 프로필을 재시작하십시오"라고 명시하고 있으므로 dsh plugin로 추가된 플러그인은 다음 재시작 시 로드됩니다. 웹 Plugins 페이지에서 설치한 플러그인은 즉시 적용될 수 있습니다. 로드된 플러그인과 하네스의 나머지 부분 사이에는 어떠한 제약도 없습니다. 따라서 플러그인을 설치하기 전에 해당 코드가 무엇에 접근할 수 있는지, 그리고 그 범위를 어떻게 최소화할 것인지 자문해야 합니다.

dsh(DeepSeek Harness)는 Cordis라는 플러그인 프레임워크를 기반으로 구축된 DeepSeek AI의 오픈 소스 에이전트 하네스입니다. 이 중간 단어는 중요한 의미를 갖는데, 에이전트 하네스는 루프, 도구, 권한을 소유한 모델을 감싸는 프로그램이며, 플러그인은 바로 그 수준에서 결합하기 때문입니다. 프로젝트의 README에는 모든 것이 플러그인이라고 명시되어 있습니다. 모델 어댑터도 플러그인이고, 사용자가 입력하는 웹 인터페이스도 플러그인입니다. 프로젝트 외부에서 설치하는 모든 것은 프로젝트와 함께 제공된 구성 요소와 동일한 신뢰 수준을 가진 동일한 트리 구조에 위치합니다. 아직 구축하지 않았다면 VPS에 DeepSeek Harness 설치하기부터 시작한 뒤, 무언가를 추가하기 전에 다시 돌아오십시오.

2026년 8월, 저장소의 AGENTS.md에는 플러그인이 접근할 수 있는 확장 지점이 나열되어 있었으며, 그 범위는 다음과 같습니다.

  • LLM (거대 언어 모델): API 키로 비용을 지불하는 제공자
  • Shell: 로컬 및 pwsh 제공자를 포함한 bash 기능
  • Filesystem: 정책 기반 파일 접근
  • Web: 검색 및 가져오기 제공자
  • Subprocess: 프로세스 트리 제공자
  • Workflow: 워커 스레드
  • Subagent: 하위 에이전트로의 위임
  • Settings and credentials: 저장된 설정 및 환경 변수

해당 목록은 이후 AGENTS.md에서 제외되었습니다. 2026년 11월 17일 기준으로 프로젝트의 docs/architecture.md은 확장 지점을 명칭으로 정의하고 있으며, 기존의 모델, 도구, 셸, 파일 시스템, 하위 에이전트 연결 지점에 샌드박스 백엔드, 지속적 터미널, 백그라운드 작업, 사람의 명령, 웹훅 트리거 세션을 추가했습니다.

또한 플러그인은 ctx.tools에 도구를 등록하며, 문서에는 등록된 도구의 스키마가 프롬프트 구성에 포함된다고 명시되어 있습니다. 이 뒷부분이 사람들이 간과하는 지점입니다. 플러그인은 자체 코드로 특별한 작업을 수행하지 않더라도 에이전트의 판단을 변경할 수 있는데, 이는 플러그인이 제공하는 설명이 모델이 읽는 텍스트가 되기 때문입니다. 이는 코딩 에이전트에 대한 프롬프트 인젝션과 동일한 형태의 문제이지만, 한 가지 차이점이 있습니다. 이 텍스트는 설치 시점에 전달되며 플러그인을 제거할 때까지 유지된다는 점입니다.

dsh는 어떻게 플러그인을 찾고 로드합니까?

전역 플러그인 디렉터리는 존재하지 않습니다. 실행 중인 dsh는 부팅 시점에 순서가 지정된 계층들로 구성된 플러그인 트리이며, 사용자의 선택을 담고 있는 단위는 프로필입니다. $DSH_HOME은 기본적으로 ~/.dsh를 사용하며, 각 프로필은 $DSH_HOME/profiles/<name>에 위치합니다. web 및 headless 프로필은 처음 사용할 때 제공된 템플릿으로부터 자동으로 생성됩니다.

프로필 디렉터리에는 모든 것을 결정하는 두 개의 파일이 있습니다.

  • package.json: 트리 외부 플러그인 의존성과 순서가 지정된 bundles 목록을 담은 dsh.profile 매니페스트를 포함합니다.
  • cordis.patch.yml: 해당 번들 위에 적용되는 사용자의 패치 계층입니다.
ls ~/.dsh
ls ~/.dsh/profiles/web

부팅 시 계층은 다음 순서로 적용되며, 나중에 적용된 계층이 우선합니다.

  1. 빈 루트
  2. 매니페스트에 나열된 순서대로 적용되는 프로필 번들
  3. 프로필의 cordis.patch.yml
  4. $DSH_HOME/cordis.patch.yml
  5. 명령줄에서 전달된 모든 --patch <path> 오버레이

두 개의 플래그를 사용하면 아무것도 시작하지 않고 구성 결과를 출력할 수 있습니다.

dsh --profile web --dump-default-config
dsh --profile web --dump-config

--dump-default-config는 번들 계층만 출력합니다. --dump-config은 프로필, 홈 패치 계층 및 모든 --patch 오버레이를 추가하므로, 다음에 부팅할 때 로드될 항목을 가장 정확하게 파악할 수 있는 방법입니다. 인계받은 장비를 신뢰하기 전에 이 명령을 확인하십시오.

패치 파일에 관한 한 가지 주의 사항이 있습니다. 여기서 설정은 단순한 데이터가 아닙니다. 형식상 플러그인의 config 블록 아래에 !!js로 태그된 값을 허용하기 때문입니다. 포럼 게시물에서 복사한 cordis.patch.yml 조각은 코드이므로, 동일한 출처의 셸 스크립트를 다루는 것과 같은 방식으로 취급해야 합니다.

dsh plugin add은 실제로 무엇을 실행합니까?

dsh plugin --profile <name> <args>는 인수를 해당 프로필 디렉터리 내부의 pnpm으로 전달하므로, pnpm이 PATH에 있어야 합니다. 사용되는 동사는 pnpm의 동사와 동일합니다.

dsh plugin --profile web add '<package-or-git-spec>'
dsh plugin --profile web remove '<package-name>'
dsh plugin --profile web why '<package-name>'
dsh plugin --profile web update

따라서 dsh 플러그인을 설치하는 보안 모델은 npm 방식의 의존성을 설치하는 보안 모델과 동일하며, 결과물이 에이전트에 로드되는 추가 단계가 하나 더 포함됩니다. 패키지는 자체적인 의존성 트리를 가져오며, 해당 트리의 모든 패키지는 동일한 프로세스 내에서 실행됩니다. npm 공급망 공격이 서버에 도달하는 방식에 명시된 모든 내용은 수정 없이 그대로 적용됩니다.

pnpm 10 이상 버전은 기본적으로 의존성의 빌드 스크립트를 실행하지 않으며, pnpm approve-builds 또는 allowBuilds 설정을 통해 패키지별로 승인해야 합니다. pnpm 11에서는 기존 onlyBuiltDependencies 설정이 allowBuilds으로 대체되었으므로, 여전히 onlyBuiltDependencies을 사용하는 가이드나 구형 설정은 현재 pnpm에서 아무것도 승인하지 않습니다. 사용 중인 pnpm 버전을 확인하십시오.

pnpm --version

Git 기반 플러그인에서 이 문제를 가장 먼저 접하게 됩니다. CLI 참조에 따르면 소스를 포함하는 git 플러그인은 설치 중에 prepare 스크립트를 통해 빌드되므로, 첫 번째 add는 pnpm의 allowBuilds 힌트와 함께 실패합니다. 이때 출력된 키를 복사하여 프로필의 pnpm-workspace.yaml에 넣고 다시 실행해야 합니다. 해당 키를 승인하면 저장소의 빌드가 사용자 권한으로 실행됩니다. 빌드된 tarball과 로컬 체크아웃은 별도의 허용이 필요하지 않습니다.

이 기본 설정은 유지할 가치가 있으며, 생태계에서 가장 과대평가된 안전 기능이기도 합니다. 차단된 빌드 스크립트는 설치 중에 코드가 실행되는 것을 방지합니다. 하지만 플러그인 자체에 대해서는 아무런 조치를 취하지 않습니다. 플러그인의 목적 자체가 하네스가 이를 임포트하여 프로필이 재시작될 때, 또는 웹 플러그인 페이지를 통해 설치가 적용되는 즉시 호출하는 것이기 때문입니다. 플러그인은 postinstall 훅이 필요하지 않습니다. 이미 호출되도록 설계되었기 때문입니다.

dsh 플러그인을 설치하기 전에 읽어야 할 내용

배포된 tarball을 다운로드하여 내용을 확인하십시오. 아카이브를 압축 해제한다고 해서 코드가 실행되지는 않습니다.

npm pack '<package-name>@<version>'
tar -tzf '<package-name>-<version>.tgz'
tar -xzf '<package-name>-<version>.tgz'
less package/package.json

package.json에 있는 4개의 필드는 필요한 정보의 대부분을 제공합니다. preinstall, install, postinstall 항목을 확인하려면 scripts을 읽으십시오. 익숙하지 않은 이름이나 기존 이름과 한 글자 차이인 이름은 dependencies에서 확인하십시오. 패키지가 PATH에 추가하려는 항목은 bin에서 확인하십시오. 진입점 파일은 main 또는 exports에서 확인한 뒤, 해당 파일을 열어 내용을 따라가 보십시오.

그다음 실제로 로드될 코드를 읽어보십시오. 알림 도구를 표방하는 플러그인이 ~/.ssh을 읽거나, 들어본 적 없는 호스트에 연결하거나, 셸을 생성할 이유는 없습니다. 패키지가 번들링되거나 최소화된 JavaScript만 제공하고 공개 저장소에 일치하는 소스 코드가 없다면, 그것이 곧 답입니다. 소스 코드를 읽을 수 있는 플러그인을 우선 선택하고, 가급적 규모가 작은 것을 선택하십시오.

아무것도 설치하지 않고도 레지스트리에 질의할 수 있습니다.

pnpm view '<package-name>' dependencies
pnpm view '<package-name>' versions

지난주에 배포되었고, 버전은 하나뿐이며, 저장소 필드가 없고, 인기 있는 패키지의 이름을 도용하는 것은 모든 레지스트리에서 가장 흔히 쓰이는 수법입니다. 체크섬으로 다운로드 검증하기는 바로 옆에 있는 습관입니다. 코드를 실행하기 전에 무엇을 가져왔는지 정확히 파악하십시오.

버전을 고정하고 lockfile을 유지하십시오

유동적인 버전 범위를 사용하면 에이전트 프로세스 내부의 코드가 설치나 업데이트 시마다 사용자의 결정 없이 변경될 수 있습니다. 버전을 고정하십시오.

dsh plugin --profile web add --save-exact '<package-name>@<version>'

플래그 위치는 pnpm 버전에 따라 다르므로 명령어를 맹신하지 말고 결과를 확인하십시오. 이후 프로필의 package.json을 열어 의존성 항목 앞에 ^나 ~ 없이 순수 버전만 명시되어 있는지 확인하십시오. 해당 파일이 설치 내용을 결정합니다.

그다음, 최상위 이름뿐만 아니라 전체 전이적 의존성 트리를 고정하는 lockfile을 유지하십시오:

find ~/.dsh -maxdepth 3 -name 'pnpm-lock.yaml'

이 파일을 프로필의 package.json과 함께 백업 위치에 복사해 두십시오. 이 두 파일이 있으면 새 서버에서도 동일한 트리를 재구축할 수 있습니다. dsh plugin --profile web update는 일상적인 정리 작업이 아니라 버전을 변경하기로 결정했을 때만 실행하고, 실행 후에는 lockfile의 변경 사항을 검토하십시오.

레지스트리가 아닌 git에서 설치한 플러그인의 경우, 브랜치 대신 커밋을 고정하십시오. github:owner/repo#<full commit sha> 형식의 사양을 사용하면 고정된 트리를 얻을 수 있습니다. 브랜치 이름을 사용하면 pnpm이 다음에 해당 브랜치를 해석할 때마다 브랜치가 가리키는 최신 내용을 가져오게 되며, 이는 곧 제어권을 타인에게 넘겨주는 것과 같습니다. 하네스 자체도 동일한 원칙을 따라야 합니다. npm의 latest 릴리스는 릴리스 후보 버전이므로, 버전을 고정하지 않고 설치하면 매번 다른 버전으로 해석될 수 있으며, 이것이 대부분의 dsh 설치 및 버전 오류의 원인이 됩니다.

플러그인 마켓과 "큐레이션"의 가치

dsh에는 마켓플레이스가 있으며, 이는 플러그인 형태로 설치됩니다. 이 사실을 통해 아키텍처의 특성을 파악할 수 있습니다.

dsh plugin --profile web add dshmarket

재시작 후 dsh 0.2.1 버전 이상에서는 Plugins 페이지의 Installed 탭 옆에 나타납니다. 구형 호스트는 Settings에서 Plugin Market을 사용합니다. README에는 제한 사항이 명확히 명시되어 있습니다. 설치는 큐레이션된 레지스트리에 나열된 소스로 제한되며, 그 외의 항목은 거부됩니다. 빌드 스크립트는 기본적으로 차단되며, 이를 활성화하려면 패키지별로 승인이 필요합니다. 터미널 플러그인은 웹 프로필에 적용되기 전에 플래그가 지정됩니다. 가장 중요한 문구는 "목록 등재가 보증을 의미하지 않는다"는 점입니다. 플러그인은 모두 제3자가 작성한 코드이기 때문입니다. 동일한 README에 따르면, 이를 통해 설치된 대부분의 플러그인은 페이지를 새로고침하면 즉시 활성화되므로 재시작이 필요 없습니다. 따라서 클릭 한 번으로 설치한 플러그인이 몇 초 만에 에이전트 내부에서 실행될 수 있습니다.

큐레이션된 목록은 최소한의 안전 기준을 높여줍니다. 하지만 이 목록이 사용자를 대신해 코드를 검토해주지는 않으며, 메인테이너 계정이 변경된 후 플러그인의 다음 버전이 어떤 동작을 할지 보장할 수 없습니다. 클릭 한 번으로 설치하는 플러그인은 동일한 작성자가 만든 curl | bash을 다루는 것과 같은 방식으로 취급하십시오. README에서 한 줄 더 강조할 가치가 있는 내용은, 내보낸 백업 파일에 프로필 설정의 자격 증명이 포함될 수 있다는 점입니다. 따라서 이를 공개 이슈나 코드 공유 사이트에 절대 첨부하지 마십시오. 방법론이 아닌 설치할 만한 플러그인 목록을 찾으신다면, 이 글의 동반 게시물인 설치할 가치가 있는 dsh 플러그인을 참조하십시오.

이제 하네스(harness)에도 자체적인 경로가 생겼습니다. Plugins 페이지에서 활성화할 수 있는 실험적인 Custom plugin indexes 번들은 사용자가 직접 추가한 인덱스 파일을 통해 Discover 탭을 구성합니다. dsh는 기본적으로 제공하는 인덱스 소스가 없으며, 문서에 따르면 인덱스는 제3자 콘텐츠입니다. dsh는 파일 형식만 검사할 뿐, 인덱스가 주장하는 플러그인의 제목, 작성자, 소스에 대해서는 검증하지 않습니다.

dsh를 root가 아닌 전용 사용자로 실행하기

검증은 악성 요소의 침투 빈도를 줄여줍니다. 최소 권한 원칙은 침투가 발생했을 때 피해 범위를 결정합니다. VPS 환경에서 후자는 설정하기 매우 쉽습니다.

dsh를 위한 별도의 유닉스 계정과 홈 디렉터리를 생성하고, 절대 root 권한으로 실행하지 마십시오.

sudo adduser --disabled-password --gecos "" dshrun
sudo -iu dshrun

해당 세션 내부에서 dsh를 시작하여, 해당 계정의 홈 디렉터리에 데이터가 기록되도록 하십시오.

npx @deepseek-ai/dsh web

웹 UI는 기본적으로 http://127.0.0.1:3080에서 서비스됩니다. 이 설정을 유지하십시오. 다른 기기에서 출력된 링크를 클릭했는데 아무런 응답이 없다면, dsh가 해당 주소를 출력할 때의 의미에서 그 이유를 확인할 수 있습니다. 기본 제공되는 웹 구성은 Host 및 Origin 헤더를 검사하며, 모든 Host RPC 메서드와 WebSocket 스트림에 대해 인증된 브라우저 또는 API 피어를 요구합니다. 또한 dsh web은 --host 0.0.0.0을 거부합니다. API 호출자는 /connect를 통해 인증하고 서명된 API 쿠키를 발급받습니다. 이 로그인을 3080 포트를 외부에 공개해도 되는 이유로 생각하지 말고, 두 번째 잠금장치로 취급하십시오. 그 뒤에는 셸을 가진 에이전트가 존재하므로, 세션 토큰이 유출되거나 공개 포트에서 로그인 버그가 발생하면 외부인에게 사용자 권한의 원격 셸과 편리한 인터페이스를 제공하는 꼴이 됩니다. 대신 SSH 터널을 통해 노트북에서 접속하십시오.

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

그런 다음 공개 주소에서 수신 대기 중인 서비스가 없는지 확인하십시오.

ss -lnt | grep 3080

로컬 주소는 127.0.0.1:3080으로 표시되어야 합니다. 만약 0.0.0.0:3080로 표시된다면, 기본 제공되는 dsh web 설정 외의 다른 구성이나 설정 변경이 적용된 것이며, 해당 구성은 자체적인 인증 방식을 따릅니다. 프로젝트 문서에 따르면 기반이 되는 웹 서버는 자체적인 인증이나 Origin 정책을 제공하지 않습니다. 따라서 해당 포트를 무엇이 보호하는지 확실히 알기 전까지는 방화벽만이 외부인과 에이전트 사이의 유일한 방어선이라고 가정하고, 다시 루프백 주소로 변경하십시오. VPS에서 Claude Code를 안전하게 실행하는 방법에 담긴 논리는 dsh에도 그대로 적용됩니다. 에이전트가 망가뜨려도 되는 작업 디렉터리를 하나만 할당하고, 재구축할 수 없는 데이터는 해당 머신에 두지 마십시오. 더 나은 방법은 해당 서버를 코딩 에이전트를 위한 일회용 VM으로 취급하는 것입니다. VPS를 재구축하는 데는 한 시간이 걸리지만, 보안을 감사하는 데는 일주일이 걸리기 때문입니다.

키가 저장되는 위치와 파일 권한의 한계

dsh는 API 키를 $DSH_HOME/.credentials.yaml에, 환경 변수 값을 $DSH_HOME/.env에 저장하며, 활성 프로필의 모델 설정은 cordis.patch.yml에 보관합니다. 2026년 10월 이 가이드를 처음 검토했을 당시, 이전 릴리스의 $DSH_HOME/settings.yaml이 한 번 가져와진 뒤 settings.yaml.imported로 이름이 변경되었습니다. 어떤 키가 어떤 파일에 속하는지, 그리고 각 모드에서 실제로 무엇이 서버 외부로 전송되는지는 dsh의 API 키, 모델 및 엔드포인트 구성에서 다룹니다. 플러그인을 추가하기 전에 이를 확실히 해두는 것이 좋습니다. 연결하는 모든 키는 플러그인이 읽을 수 있는 대상이 하나 더 늘어나는 것과 같기 때문입니다. 다음 두 파일의 보안을 강화하십시오.

chmod 600 ~/.dsh/.credentials.yaml ~/.dsh/.env
ls -l ~/.dsh

600 모드는 소유자에게 읽기 및 쓰기 권한을 부여하고 다른 사용자에게는 아무런 권한도 주지 않습니다. 이는 두 가지 표기법(숫자 및 기호 chmod 모드 비교) 모두에서 알아두어야 할 가치가 있습니다. 이 설정이 제공하는 보호 범위를 정확히 이해해야 합니다. 파일 모드는 서버 내의 다른 계정으로부터 해당 파일들을 보호합니다. 하지만 플러그인에 대해서는 아무런 보호 효과가 없습니다. 플러그인은 해당 파일을 소유한 사용자의 권한으로, 파일을 읽는 프로세스 내부에서 실행되기 때문입니다. 이것이 바로 AI 에이전트가 접근할 수 없는 곳에 비밀 정보 보관하기가 중요한 이유이며, 애초에 기기에 비밀 정보를 두지 않아야 함을 의미합니다. dsh 서버에는 필요한 모델 키 하나만 보관해야 합니다. 클라우드 자격 증명이나 서명 키는 다른 곳에 보관하십시오.

웹을 읽는 플러그인이 위협 모델을 변화시키는 이유

웹 인터페이스는 플러그인에 검색 및 데이터 가져오기 기능을 제공합니다. 사용자의 세션으로 페이지를 불러오는 플러그인은 공격자가 작성할 수 있는 텍스트를 가져오는 것과 같습니다. 모델 프롬프트는 지시 사항과 데이터를 구분하지 않으므로, 가져온 페이지에 에이전트를 대상으로 하는 명령이 포함될 수 있습니다. 셸 실행 권한을 가진 하네스(harness)는 단 한 번의 순종적인 단계만으로 해당 명령을 실행할 수 있습니다.

이러한 제어 기능은 이미 하네스에 존재합니다. dsh-base은 web, headless, sdk 및 acp 프로필의 첫 번째 공통 번들로서, 샌드박스와 승인 정책을 포함하고 있습니다(sdk-minimal 프로필은 의도적으로 이를 제외합니다). 이 기능을 사용하십시오. 신뢰할 수 없는 페이지를 가져올 수 있는 세션은 쓰기나 실행이 발생하는 모든 작업에 대해 승인을 요구해야 합니다. 그래야 가져온 지시 사항이 독단적으로 동작으로 이어지는 것을 방지할 수 있습니다. 에이전트 작업에 대한 승인 절차 도입에서는 이러한 경계를 어디에 설정할지 고려하는 방법을 다룹니다. 이 관계는 양방향으로 작용합니다. 누군가의 에이전트가 사용자의 서버를 페이지로 가져올 수 있기 때문이며, 이는 서버에서 AI 크롤러 차단하기에서 다루는 사례와 같습니다.

플러그인이 무엇을 변경했는지 확인하려면 어떻게 해야 합니까?

설치 전 스냅샷을 생성하고, 설치 후 스냅샷을 생성한 다음 그 차이를 확인하십시오.

dsh --profile web --dump-config > /tmp/dsh-before.txt
dsh plugin --profile web add '<package-name>@<version>'
dsh --profile web --dump-config > /tmp/dsh-after.txt
diff -u /tmp/dsh-before.txt /tmp/dsh-after.txt

diff 결과는 설치 과정에서 어떤 플러그인 항목이 구성 트리(composed tree)에 추가되었는지 보여줍니다. 번들 패치(bundle patch)를 선언한 패키지만 트리에 결합하며, 단순 의존성 패키지는 트리에 아무것도 추가하지 않고 dsh가 이에 대해 한 번 경고를 표시합니다. 작은 기능 하나를 위해 설치한 플러그인이 설명할 수 없는 여러 항목을 추가한다면, 부팅하기 전에 작업을 멈추고 소스 코드를 확인해야 합니다. dsh plugin --profile web why <package-name>는 특정 패키지를 어떤 직접 의존성 패키지가 불러왔는지에 대한 질문에 답을 제공합니다.

설치된 패키지는 프로필 자체의 node_modules 내 $DSH_HOME/profiles/<name>/node_modules 경로에 위치하므로, 디스크상의 트리를 직접 확인할 수도 있습니다.

ls ~/.dsh/profiles/web/node_modules

실험용이 아닌 별도의 프로필을 하나 더 유지하십시오. 설치 후 하네스(harness)가 손상되면, dsh --profile <clean-name>로 부팅하여 플러그인이 원인인지 즉시 확인할 수 있습니다.

dsh 플러그인은 어떻게 제거합니까?

dsh plugin --profile web remove '<package-name>'
dsh --profile web --dump-config > /tmp/dsh-after-removal.txt
diff -u /tmp/dsh-before.txt /tmp/dsh-after-removal.txt

의존성을 제거한다고 해서 설정까지 항상 삭제되는 것은 아닙니다. 프로필의 cordis.patch.yml에 기록된 항목은 그대로 남아 있습니다. 해당 파일은 사용자의 소유이며, 하네스가 사용자를 대신해 파일을 다시 작성하지 않기 때문입니다. 파일을 열고 제거한 패키지 이름이 포함된 블록을 삭제하십시오.

less ~/.dsh/profiles/web/cordis.patch.yml

그다음, 어떤 제거 명령으로도 해결할 수 없는 부분을 처리해야 합니다. 신뢰할 수 없다는 이유로 플러그인을 제거했다면, 해당 플러그인이 읽을 수 있었던 정보는 이미 모두 읽힌 상태입니다. 제공자 콘솔에서 DeepSeek API 키를 교체하고, $DSH_HOME에 저장되어 있던 다른 모든 정보도 교체하십시오. 그 후, 해당 플러그인이 실행된 unix 계정이 네트워크의 나머지 부분에서 어디까지 접근할 수 있었는지 파악하십시오.

요약

  • 설치 전 배포된 tarball을 읽으십시오. scripts와 진입 파일부터 시작합니다.
  • 정확한 버전이나 git spec의 경우 정확한 커밋을 고정하고 lockfile을 유지하십시오.
  • 하나의 프로필에 설치하고, 문제가 발생했을 때 부팅할 수 있는 깨끗한 프로필을 유지하십시오.
  • 설치 전후로 --dump-config의 차이점을 확인하십시오.
  • 하네스를 별도의 unix 사용자로, loopback에서 실행하고, SSH를 통해 접속하십시오.
  • 서버에 하나의 API key만 유지하고, 더 이상 신뢰하지 않는 플러그인을 제거하는 날에 해당 키를 교체하십시오.

이 중 어느 것도 플러그인 사용을 피해야 할 이유는 되지 않습니다. 플러그인 모델 덕분에 dsh가 유용하며, 확장할 수 없는 하네스는 결국 교체하게 될 하네스입니다. 이는 무엇을, 누구로부터, 어떤 버전으로 설치했는지 파악하고, 전체 환경을 재구축할 수 있는 곳에서 실행해야 할 이유입니다.

FAQ

dsh는 플러그인 간에 샌드박스를 적용합니까?

아니요. 플러그인은 Cordis를 통해 하니스(harness) 프로세스로 로드되며, 셸, 파일 시스템, 웹, 서브프로세스, 서브에이전트, 자격 증명을 포함한 문서화된 기능 인터페이스에 접근할 수 있습니다. dsh-base은 web, headless, sdk 및 acp 프로필의 첫 번째 공유 번들로서, 에이전트 도구가 수행할 수 있는 작업을 제어하는 샌드박스 및 승인 정책을 제공하며, 이 정책이 보안의 근간이 됩니다. 플러그인별 권한 경계는 존재하지 않으므로, 플러그인을 설치하는 것은 해당 플러그인 작성자와 그 의존성 트리에 포함된 모든 패키지를 신뢰한다는 의미로 이해해야 합니다.

설치 스크립트를 실행하지 않고 dsh 플러그인을 설치할 수 있습니까?

pnpm 10 이상 버전은 기본적으로 의존성 빌드 스크립트를 차단하며, dsh plugin ... add은 pnpm을 호출하므로 현재 버전의 pnpm에서는 패키지를 명시적으로 승인하지 않는 한 설치 시 패키지 스크립트가 실행되지 않습니다. pnpm --version 명령어로 버전을 확인하십시오. 그렇다고 해서 내용을 확인하지 않은 플러그인이 안전하다는 의미는 아닙니다. 플러그인 코드는 하니스가 이를 로드하는 즉시 실행됩니다. 이는 dsh plugin 설치 후 프로필을 재시작할 때 발생하거나, 웹 플러그인 페이지에서 설치한 경우 즉시 발생할 수 있으며, 설치 시점의 제한 사항은 이에 영향을 주지 않습니다.

dsh 플러그인과 설정 파일은 실제로 어디에 저장됩니까?

$DSH_HOME의 기본 경로는 ~/.dsh입니다. 프로필은 $DSH_HOME/profiles/<name>에 위치하며, 각 프로필은 플러그인 의존성을 포함한 package.json, 정렬된 번들 매니페스트인 dsh.profile, 그리고 cordis.patch.yml 패치 계층을 보유합니다. 설치된 패키지는 각 프로필의 node_modules 내 $DSH_HOME/profiles/<name>/node_modules에 저장됩니다. 키는 $DSH_HOME/.credentials.yaml에, 환경 변수 값은 $DSH_HOME/.env에 위치하며, 홈 디렉터리 수준의 $DSH_HOME/cordis.patch.yml은 모든 프로필에 적용됩니다. 부팅하지 않고 구성된 결과를 확인하려면 dsh --profile web --dump-config를 실행하십시오.

dsh 플러그인 마켓에서 설치하는 것은 안전합니까?

마켓은 설치 대상을 검증된 레지스트리의 소스로 제한하고 패키지별로 승인하지 않는 한 빌드 스크립트를 차단합니다. 이는 채팅창에서 패키지 이름을 복사하여 붙여넣는 방식보다 실질적인 개선입니다. 하지만 마켓의 README에도 명시되어 있듯이, 목록에 포함되었다고 해서 해당 플러그인을 보증하는 것은 아닙니다. 플러그인은 타인이 작성한 서드파티 코드이기 때문입니다. 소스 코드를 직접 확인하고 버전을 고정하십시오. 하니스는 손실을 감수할 수 있는 사용자 계정이나 가급적 별도의 머신에서 실행하는 것이 좋습니다.

이 글이 도움이 되었나요?