cors-anywhere - GitLite

KO | EN

gitlite — search

#ai #llm #golang #go #android #machine-learning #deep-learning #linux #java #awesome #cli #kubernetes #awesome-list #security

cors-anywhere

(★ 9,376)

CORS Anywhere는 프록시된 요청에 CORS 헤더를 추가해 주는 NodeJS 리버스 프록시입니다.

파일 탐색기

최종 버전 다운로드 (.zip)

- cors-anywhere.js
- help.txt
- rate-limit.js
- regexp-top-level-domain.js
- cert.pem
- child.js
- customHelp.html
- customHelp.txt
- dummy.txt
- key.pem
- setup.js
- test-examples.js
- test-memory.js
- test-ratelimit.js
- test.js
.eslintignore
.eslintrc
.gitignore
.travis.yml
demo.html
LICENSE
package.json
Procfile
README.md
server.js

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/Rob--W/cors-anywhere

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd cors-anywhere

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm start

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Build Status](https://travis-ci.com/Rob--W/cors-anywhere.svg?branch=master)](https://travis-ci.com/Rob--W/cors-anywhere)
[![Coverage Status](https://coveralls.io/repos/github/Rob--W/cors-anywhere/badge.svg?branch=master)](https://coveralls.io/github/Rob--W/cors-anywhere?branch=master)
\*\*CORS Anywhere\*\*는 프록시 요청에 CORS 헤더를 추가하는 NodeJS 프록시입니다.
프록시할 URL은 경로에서 그대로 가져와서, 유효성 검사를 거친 후 프록시됩니다. 프록시할 URI의 프로토콜 부분은 선택 사항이며, 기본값은 "http"입니다. 포트 443이 지정된 경우 프로토콜의 기본값은 "https"입니다.
이 패키지는 쿠키를 제외하고는 HTTP 메서드나 헤더에 어떠한 제한도 두지 않습니다. [사용자 자격 증명](http://www.w3.org/TR/cors/#user-credentials) 요청은 허용되지 않습니다.
이 앱은 브라우저에서 직접 방문하는 것을 방지하는 등, 프록시 요청 시 헤더가 필수로 포함되도록 설정할 수 있습니다.

## 예제
```javascript
// Listen on a specific host via the HOST environment variable
var host = process.env.HOST || '0.0.0.0';
// Listen on a specific port via the PORT environment variable
var port = process.env.PORT || 8080;
var cors\_proxy = require('cors-anywhere');
cors\_proxy.createServer({
originWhitelist: [], // Allow all origins
requireHeader: ['origin', 'x-requested-with'],
removeHeaders: ['cookie', 'cookie2']
}).listen(port, host, function() {
console.log('Running CORS Anywhere on ' + host + ':' + port);
});
```

요청 예제:
\* `http://localhost:8080/http://google.com/` - CORS 헤더가 포함된 Google.com
\* `http://localhost:8080/google.com` - 이전과 동일합니다.
\* `http://localhost:8080/google.com:443` - `https://google.com/`을 프록시합니다.
\* `http://localhost:8080/` - `lib/help.txt`에 정의된 사용법 텍스트를 표시합니다.
\* `http://localhost:8080/favicon.ico` - 404 Not found 응답을 반환합니다.

라이브 예제:
\* https://cors-anywhere.herokuapp.com/
\* https://robwu.nl/cors-anywhere.html - 이 데모는 API 사용 방법을 보여줍니다.

## 문서
### 클라이언트
API를 사용하려면 URL 앞에 API URL을 붙이기만 하면 됩니다. 예제는 [demo.html](demo.html)을 참조하세요.
문서의 간략한 요약은 [lib/help.txt](lib/help.txt)에 제공되어 있습니다.

\*\*참고: 2021년 2부터 데모 서버에 접근하려면 사전 동의(opt-in)가 필요합니다\*\*,
참조: https://github.com/Rob--W/cors-anywhere/issues/301

필요할 때 크로스 도메인 요청을 자동으로 활성화하려면 다음 스니펫을 사용하세요:
```javascript
(function() {
var cors\_api\_host = 'cors-anywhere.herokuapp.com';
var cors\_api\_url = 'https://' + cors\_api\_host + '/';
var slice = [].slice;
var origin = window.location.protocol + '//' + window.location.host;
var open = XMLHttpRequest.prototype.open;
XMLHttpRequest.prototype.open = function() {
var args = slice.call(arguments);
var targetOrigin = /^https?:\/\/([^\/]+)/i.exec(args[1]);
if (targetOrigin && targetOrigin[0].toLowerCase() !== origin &&
targetOrigin[1] !== cors\_api\_host) {
args[1] = cors\_api\_url + args[1];
}
return open.apply(this, args);
};
})();
```

jQuery를 사용하는 경우, 이전 코드 \*\*대신\*\* 다음 코드를 사용할 수도 있습니다:
```javascript
jQuery.ajaxPrefilter(function(options) {
if (options.crossDomain && jQuery.support.cors) {
options.url = 'https://cors-anywhere.herokuapp.com/' + options.url;
}
});
```

### 서버
이 모듈은 프록시 요청을 처리하는 서버를 생성하는 `createServer(options)`를 내보냅니다. 다음 옵션이 지원됩니다:
\* 함수 `getProxyForUrl` - 설정된 경우, 주어진 URL에 사용할 중간 프록시를 지정합니다.
반환 값이 void인 경우 직접 요청이 전송됩니다. 기본 구현은 [`proxy-from-env`](https://github.com/Rob--W/proxy-from-env)이며, 이는 표준 프록시 환경 변수(예: `https\_proxy`, `no\_proxy` 등)를 따릅니다.
\* 문자열 배열 `originBlacklist` - 설정된 경우, 출처(origin)가 목록에 있는 요청은 차단됩니다.
예제: `['https://bad.example.com', 'http://bad.example.com']`
\* 문자열 배열 `originWhitelist` - 설정된 경우, 출처(origin)가 목록에 없는 요청은 차단됩니다.
만약 t

이 목록이 비어 있으면 모든 origin이 허용됩니다.
Example: `['https://good.example.com', 'http://good.example.com']`
\* function `handleInitialRequest` - 설정된 경우, 요청, 응답 및 요청된 목적지의 파싱된 URL(사용할 수 없는 경우 null)과 함께 호출됩니다. 함수가 true를 반환하면 해당 요청은 더 이상 처리되지 않습니다. 이 경우 함수가 요청을 처리할 책임이 있습니다.
이 기능은 로깅(false 반환) 등 요청을 수동적으로 모니터링하는 데 사용할 수 있습니다.
\* function `checkRateLimit` - 설정된 경우, 요청의 origin(문자열)과 함께 호출됩니다. 이 함수가 비어 있지 않은 문자열을 반환하면 요청이 거부되고 해당 문자열이 클라이언트로 전송됩니다.
\* boolean `redirectSameOrigin` - true인 경우, 동일한 origin의 URL에 대한 요청은 프록시되지 않고 리디렉션됩니다.
이 옵션의 주된 목적은 요청을 클라이언트에 위임하여 서버 리소스를 절약하는 것입니다(동일 origin 요청은 프록시 없이도 항상 성공해야 하므로).
\* array of strings `requireHeader` - 설정된 경우, 요청에 이 헤더가 포함되어야 하며 그렇지 않으면 API가 프록시를 거부합니다.
사용자가 일반 브라우징에 프록시를 사용하는 것을 방지하려는 경우 권장됩니다.
Example: `['Origin', 'X-Requested-With']`.
\* array of lowercase strings `removeHeaders` - 요청에 포함될 특정 헤더들을 제외합니다.
Example: `["cookie"]`
\* dictionary of lowercase strings `setHeaders` - 요청에 대한 헤더를 설정합니다(기존 헤더 덮어쓰기).
Example: `{"x-powered-by": "CORS Anywhere"}`
\* number `corsMaxAge` - 설정된 경우, 이 값(초 단위)을 가진 Access-Control-Max-Age 요청 헤더가 추가됩니다.
Example: `600` - 브라우저가 CORS 프리플라이트 요청을 10분 동안 캐시하도록 허용합니다.
\* string `helpFile` - 도움말 파일을 설정합니다(홈페이지에 표시됨).
Example: `"myCustomHelpText.txt"`
고급 사용자를 위해 다음 옵션들도 제공됩니다.
\* `httpProxyOptions` - 내부적으로 [http-proxy](https://github.com/nodejitsu/node-http-proxy)를 사용하여 요청을 프록시합니다. http-proxy에 옵션을 반드시 전달해야 하는 경우 이 옵션을 사용하세요. 이 옵션들에 대한 문서는 [여기](https://github.com/nodejitsu/node-http-proxy#options)에서 확인할 수 있습니다.
\* `httpsOptions` - 설정된 경우 `https.Server`가 생성됩니다. 지정된 옵션은 [`https.createServer`](https://nodejs.org/api/https.html#https\_https\_createserver\_options\_requestlistener) 메서드로 전달됩니다.
더욱 고급 사용법(CORS Anywhere 기반 확장)에 대해서는 [test/test-examples.js](test/test-examples.js)의 예제 코드를 참조하세요.
### 데모 서버
CORS Anywhere의 공개 데모는 https://cors-anywhere.herokuapp.com에서 사용할 수 있습니다. 이 서버는 CORS Anywhere를 쉽고 빠르게 체험해 볼 수 있도록 하기 위해서만 제공됩니다. 모든 사용자가 서비스를 계속 이용할 수 있도록, 명시적으로 화이트리스트에 등록된 origin으로부터의 요청을 제외하고는 일정 기간 동안의 요청 수가 제한됩니다.
\*\*참고: 2021년 2부부터 데모 서버에 액세스하려면 명시적 동의(opt-in)가 필요합니다\*\*,
참조: https://github.com/Rob--W/cors-anywhere/issues/301
트래픽이 많을 것으로 예상되는 경우, CORS Anywhere의 자체 인스턴스를 직접 호스팅하고, 다른 사람이 CORS Anywhere 인스턴스를 오픈 프록시로 사용하는 것을 방지하기 위해 CORS Anywhere 서버가 본인의 사이트만 화이트리스트에 등록하도록 하세요.
예를 들어, 포트 8080에서 일부 example.com 사이트의 모든 요청을 수락하는 CORS Anywhere 서버를 실행하려면 다음을 사용하세요.
```
export PORT=8080
export CORSANYWHERE\_WHITELIST=https://example.com,http://example.com,http://example.com:8080
node server.js
```
이 애플리케이션은 Heroku에서 즉시 실행할 수 있으며, 지침은 https://devcenter.heroku.com/articles/nodejs를 참조하세요. Heroku의 [허용 사용 정책(Acceptable Use Policy)](https://www.heroku.com/policy/aup)에서는 오픈 프록시 운영을 위한 Heroku 사용을 금지하고 있으므로, 위와 같이 화이트리스트를 적용하거나 요청 수를 엄격하게 제한해야 합니다.
예를 들어, abuse.example.com을 블랙리스트에 추가하고, my.example.com과 my2.example.com을 제외한 모든 요청을 3분당 50개로 속도 제한(rate-limit)하려면(

(무제한일 수도 있음)를 원하면 다음을 사용하세요:
```
export PORT=8080
export CORSANYWHERE\_BLACKLIST=https://abuse.example.com,http://abuse.example.com
export CORSANYWHERE\_RATELIMIT='50 3 my.example.com my2.example.com'
node server.js
```
## 라이선스
Copyright (C) 2013 - 2021 Rob Wu 
본 소프트웨어 및 관련 문서 파일(이하 "소프트웨어")의 복사본을 얻는 모든 사람에게 제한 없이 소프트웨어를 사용할 수 있는 권한이 무료로 부여됩니다. 여기에는 소프트웨어의 복사본 사용, 복사, 수정, 병합, 배포, 서브라이선스 및/또는 판매 권한이 포함되며, 소프트웨어가 제공된 사람들도 다음 조건을 준수하는 것을 전제로 합니다:
위의 저작권 고지 및본 허가 고지는 소프트웨어의 모든 복사본이나 중요한 부분에 포함되어야 합니다.
본 소프트웨어는 상품성, 특정 목적에의 적합성, 비침해성에 대한 보증을 포함하 어떠한 종류의 명시적이거나 묵시적인 보증 없이 "있는 그대로" 제공됩니다. 어떠한 경우에도 저작자나 저작권자는 소프트웨어와 관련하여 또는 소프트웨어의 사용이나 기타 거래와 M래하여 발생하는 계약, 불법행위 또는 기타 소송에 대해 어떠한 청구, 손해 또는 기타 책임에 대해서도 책임을 지지 않습니다.