dev-sidecar

DNS 최적 선택

도메인별로 복수의 IP를 시도하여 네트워크 상태에 가장 적합한 주소를 선택합니다. 일부 사이트와 라이브러리에 대한 접근이 불가능하거나 느린 문제를 완화하기 위한 기능입니다.

요청 차단 및 미러 전환

정상적으로 열리지 않는 사이트에 대한 요청을 사전에 등록된 미러 사이트로 우회시키며, 복수의 미러를 백업으로 지정할 수 있습니다. 측정 기능이 함께 동작하여 접근 실패 또는 시간 초과 시 자동으로 백업 사이트로 전환됩니다.

GitHub 가속

SNI를 변경하여 github.com으로의 직접 연결을 시도하며, release/source/zip 다운로드, git clone, 프로필 이미지, gist, raw/blame 페이지에 대한 가속을 제공합니다. 일부 기능은 X.I.U의 Tampermonkey 스크립트를 내장하여 구현되었으며, 별도 설치 없이도 동작합니다.

Stack Overflow 가속

ajax.googleapis.com에 대한 요청을 가속 CDN으로 전달하고, reCAPTCHA 이미지 캡차에 대한 접근도 함께 개선합니다.

npm 가속

npm 프록시를 활성화할 수 있으며, 공식 레지스트리와 타오바오 npm 레지스트리를 한 번에 전환하는 기능을 제공합니다.

설치 방법

• Windows에서는 winget 명령으로 설치할 수 있습니다. 패키지 식별자는 docmirror.dev-sidecar입니다.
• macOS 및 Linux에서는 GitHub Releases에서 운영체제별 설치 파일을 내려받아 설치합니다.
• macOS에서는 시스템 환경설정의 보안 및 개인정보 항목에서 개발자 허용 절차가 필요합니다.

초기 설정 절차

• 최초 실행 시 루트 인증서 설치 안내가 표시되며, 안내에 따라 인증서를 설치해야 정상적인 가속이 가능합니다.
• 루트 인증서는 기본적으로 로컬에서 무작위로 생성되며, 가속 서비스 설정에서 사용자가 PEM 형식의 인증서와 개인키로 교체할 수도 있습니다.
• Firefox는 시스템 루트 인증서를 사용하지 않으므로, 브라우저 설정에서 dev-sidecar가 생성한 ca.crt 파일을 별도로 가져와 신뢰하도록 설정해야 합니다.

모드와 활용 예시

응용 프로그램은 안전 모드와 기본 모드를 제공합니다. 안전 모드는 차단과 강화 기능을 끄고 DNS 최적 선택과 측정 기능만 사용하여 인증서 설치 없이도 사용할 수 있습니다. 기본 모드는 차단과 DNS 최적 선택, 원격 설정을 함께 사용하며 SNI 변경을 통한 github.com 직접 접속을 포함해 다양한 가속 기능을 활성화합니다.

실제 활용 예시로 GitHub의 release ZIP 다운로드, git clone, npm install이 원활하지 않을 때 해당 기능을 켜고 다시 시도하는 방식이 README에 안내되어 있습니다.

제한·라이선스·확인사항

• 응용 프로그램은 시작 시 시스템 프록시 설정을 자동으로 변경하므로 다른 프록시 도구와 동시에 사용할 경우 충돌 가능성이 있습니다. Watt Toolkit과는 hosts 모드로 함께 사용할 수 있다고 안내되어 있습니다.
• 일부 구 버전 Windows에서는 dev-sidecar가 켜진 상태에서 시스템을 재부팅하면 네트워크가 끊길 수 있으며, 이 문제는 1.8.9 버전에서 해결되었다고 명시되어 있습니다.
• 응용 프로그램이 예기치 않게 종료되면 시스템 프록시 설정이 원래대로 복구되지 않아 인터넷 접속이 끊길 수 있으며, 이 경우 dev-sidecar를 다시 실행하거나 수동으로 프록시 설정을 해제해야 합니다.
• 소스 코드는 MPL-2.0 라이선스로 배포되며, 라이선스 전문은 저장소의 LICENSE 파일에서 제공됩니다.