sitecli (No External Dependencies / 외부 의존성 없음)

sitecli is a command-line interface (CLI) tool built entirely with Node.js's built-in modules, meaning it has no external dependencies. It allows you to set named target website URLs and then serve their content locally via a proxy server. This enables you to interact with a live website through your local environment, which can be useful for development, testing, or simply viewing how a remote site behaves through a local server.

sitecli는 Node.js 내장 모듈만으로 구축된 명령줄 인터페이스(CLI) 도구이며, 외부 의존성이 없습니다. 이 도구를 사용하면 이름 지정된 대상 웹사이트 URL을 설정하고 프록시 서버를 통해 해당 콘텐츠를 로컬에서 서비스할 수 있습니다. 이는 개발, 테스트 또는 원격 사이트가 로컬 서버를 통해 어떻게 작동하는지 확인하는 데 유용할 수 있습니다.

Features / 기능

• No External Dependencies / 외부 의존성 없음: Built purely with Node.js built-in modules (fs, path, http, https, url, child_process). Node.js 내장 모듈(fs, path, http, https, url, child_process)만을 사용하여 순수하게 구축되었습니다.
• Named Target URLs / 이름 지정된 대상 URL: Easily set and manage multiple remote websites you want to proxy using custom names. 사용자 정의 이름을 사용하여 프록시하려는 여러 원격 웹사이트를 쉽게 설정하고 관리합니다.
• Local Proxy Server / 로컬 프록시 서버: Run a local HTTP server that fetches and serves content from the specified target URL in real-time. 지정된 대상 URL에서 실시간으로 콘텐츠를 가져와 서비스하는 로컬 HTTP 서버를 실행합니다.
• Status Check / 상태 확인: View all currently configured target URLs. 현재 구성된 모든 대상 URL을 확인합니다.
• Clear URLs / URL 지우기: Remove specific or all configured target URLs. 특정 또는 모든 구성된 대상 URL을 제거합니다.
• Open in Browser / 브라우저에서 열기: Automatically open the proxied URL in your default web browser. 기본 웹 브라우저에서 프록시된 URL을 자동으로 엽니다.

Installation / 설치

1. Navigate to your sitecli-app directory / sitecli-app 디렉토리로 이동: Ensure you are in the sitecli-app directory where package.json and index.js are located. package.json과 index.js가 있는 sitecli-app 디렉토리에 있는지 확인하십시오.

2. No npm install needed for dependencies / 종속성 설치 필요 없음: Since this tool uses no external packages, you do not need to run npm install. 이 도구는 외부 패키지를 사용하지 않으므로 npm install을 실행할 필요가 없습니다.

3. Link the CLI tool globally / CLI 도구 전역 연결:

   npm link

   This command creates a symbolic link, allowing you to run sitecli from any directory in your terminal. 이 명령어는 심볼릭 링크를 생성하여 터미널의 모든 디렉토리에서 sitecli를 실행할 수 있도록 합니다.

Usage / 사용법

1. Set a Target URL / 대상 URL 설정

You need to tell sitecli which website to proxy and assign it a name. If you don't specify a name, 'default' will be used. sitecli에 어떤 웹사이트를 프록시할지 알려주고 이름을 할당해야 합니다. 이름을 지정하지 않으면 'default'가 사용됩니다.

sitecli set <name> <URL>

• <name>: A unique name for this target URL (e.g., mywebsite, google). / 이 대상 URL의 고유한 이름(예: mywebsite, google).
• <URL>: The full URL of the remote website (e.g., https://www.google.com). / 원격 웹사이트의 전체 URL(예: https://www.google.com).

Examples / 예시:

sitecli set default https://www.google.com
sitecli set myapp http://localhost:8000

(Remember to include http:// or https:// in the URL.) (URL에 http:// 또는 https://를 포함해야 합니다.)

You will see a confirmation message: 대상 URL 'mygoogle'이(가) 'https://www.google.com'(으)로 설정되었습니다.

2. Start the Local Proxy Server / 로컬 프록시 서버 시작

Once a target URL is set, you can start the proxy server for a specific named URL. 대상 URL이 설정되면 특정 이름의 URL에 대한 프록시 서버를 시작할 수 있습니다.

sitecli server [name] [port]

• [name]: (Optional) The name of the target URL to proxy. Defaults to 'default' if not specified. / (선택 사항) 프록시할 대상 URL의 이름입니다. 지정하지 않으면 기본값은 'default'입니다.
• [port]: (Optional) The port number you want the server to listen on. If not specified, it defaults to 3000. You can also use -p <port> or --port <port>. / (선택 사항) 서버가 수신할 포트 번호입니다. 지정하지 않으면 기본값은 3000입니다. -p <포트> 또는 --포트 <포트>를 사용할 수도 있습니다.

Examples / 예시:

sitecli server
# Starts server for 'default' URL on http://localhost:3000
# 'default' URL에 대한 서버를 http://localhost:3000에서 시작

sitecli server myapp 8080
# Starts server for 'myapp' URL on http://localhost:8080
# 'myapp' URL에 대한 서버를 http://localhost:8080에서 시작

sitecli server --port 5000
# Starts server for 'default' URL on http://localhost:5000
# 'default' URL에 대한 서버를 http://localhost:5000에서 시작

After starting the server, open your web browser and navigate to http://localhost:<PORT> (e.g., http://localhost:3000). You will see the content of your target URL served through your local proxy. 서버가 시작되면 웹 브라우저를 열고 http://localhost:<PORT> (예: http://localhost:3000)로 이동하십시오. 로컬 프록시를 통해 대상 URL의 콘텐츠가 제공되는 것을 볼 수 있습니다.

To stop the server, press Ctrl+C in the terminal where the server is running. 서버를 중지하려면 서버가 실행 중인 터미널에서 Ctrl+C를 누르십시오.

3. Check Status / 상태 확인

View all currently configured target URLs. 현재 구성된 모든 대상 URL을 확인합니다.

sitecli status

4. Clear Target URLs / 대상 URL 지우기

Remove a specific named target URL or all of them. 특정 이름의 대상 URL 또는 모든 대상 URL을 제거합니다.

sitecli clear [name]

• [name]: (Optional) The name of the target URL to clear. If not specified, all configured URLs will be cleared. / (선택 사항) 지울 대상 URL의 이름입니다. 지정하지 않으면 구성된 모든 URL이 지워집니다.

Examples / 예시:

sitecli clear myapp
# Clears the 'myapp' target URL
# 'myapp' 대상 URL을 지웁니다.

sitecli clear
# Clears all configured target URLs
# 구성된 모든 대상 URL을 지웁니다.

5. Open in Browser / 브라우저에서 열기

Automatically open the currently set target URL (or a named one) in your default web browser. 현재 설정된 대상 URL(또는 이름 지정된 URL)을 기본 웹 브라우저에서 자동으로 엽니다.

sitecli open [name]

• [name]: (Optional) The name of the target URL to open. Defaults to 'default' if not specified. / (선택 사항) 열 대상 URL의 이름입니다. 지정하지 않으면 기본값은 'default'입니다.

Examples / 예시:

sitecli open
# Opens the 'default' target URL in your browser
# 'default' 대상 URL을 브라우저에서 엽니다.

sitecli open myapp
# Opens the 'myapp' target URL in your browser
# 'myapp' 대상 URL을 브라우저에서 엽니다.

Ethical and Legal Considerations / 윤리적 및 법적 고려사항

Please use sitecli responsibly. When proxying content from other websites, be aware of: sitecli를 책임감 있게 사용하십시오. 다른 웹사이트의 콘텐츠를 프록시할 때는 다음 사항에 유의하십시오.

• Terms of Service / 서비스 약관: Many websites have terms of service that prohibit unauthorized scraping, framing, or redistribution of their content. Always ensure you have permission or are compliant with the website's policies. 많은 웹사이트에는 무단 스크래핑, 프레이밍 또는 콘텐츠 재배포를 금지하는 서비스 약관이 있습니다. 항상 권한이 있거나 웹사이트 정책을 준수하는지 확인하십시오.
• Copyright / 저작권: Respect intellectual property rights. Do not use this tool to infringe upon copyrighted material. 지적 재산권을 존중하십시오. 이 도구를 사용하여 저작권이 있는 자료를 침해하지 마십시오.
• Privacy / 개인 정보 보호: Be mindful of any sensitive data that might be processed or displayed. 처리되거나 표시될 수 있는 민감한 데이터에 유의하십시오.

sitecli is a tool designed for convenience and development purposes. It is your responsibility to ensure its usage complies with all applicable laws and website policies. sitecli는 편의성과 개발 목적을 위해 설계된 도구입니다. 모든 관련 법률 및 웹사이트 정책을 준수하는 것은 사용자님의 책임입니다.