You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -10,8 +10,6 @@ This guide will help you get started debugging your Node.js apps and scripts.
10
10
11
11
## Enable Inspector
12
12
13
-
**NOTE**: The `--inspect` option and [Inspector Protocol][] are _experimental_ and may change.
14
-
15
13
When started with the **--inspect** switch, a Node.js process listens via WebSockets
16
14
for diagnostic commands as defined by the [Inspector Protocol][],
17
15
by default at host and port 127.0.0.1:9229. Each process is also assigned a
@@ -55,8 +53,6 @@ it will activate the Inspector API.
55
53
56
54
## 인스펙터 활성화
57
55
58
-
**NOTE**: `--inspect` 옵션과 [Inspector 프로토콜][]은 _실험 단계_이고 변경될 수 있습니다.
59
-
60
56
**--inspect** 스위치로 시작하면 Node.js 프로세스가 [Inspector 프로토콜][]에서 정의된
61
57
진단 명령어를 웹소켓으로 받습니다. [Inspector 프로토콜][]은 기본적으로 127.0.0.1:9229를
62
58
사용합니다. 각 프로세스에는 고유한 [UUID][](예: `0f2c936f-b1cd-4ac9-aab3-f63b0f33d55e`)도
@@ -90,6 +86,69 @@ HTTP 요청을 보내서 이 메타데이터를 받을 수 있습니다. 이는
90
86
Node 8 부터는 인스펙터 API를 활성화할 것입니다.
91
87
92
88
---
89
+
<!-- ## Security Implications
90
+
91
+
Since the debugger has full access to the Node.js execution environment, a
92
+
malicious actor able to connect to this port may be able to execute arbitrary
93
+
code on behalf of the Node process. It is important to understand the security
94
+
implications of exposing the debugger port on public and private networks. -->
95
+
96
+
## 보안 관련
97
+
98
+
디버거가 Node.js 실행 환경에 완전히 액세스하기 때문에 이 포트에 연결할 수 있는 공격자가 노드 프로세스를 대신하여 임의의 코드를 실행할 수 있습니다. 디버거 포트를 공용 및 개인 네트워크에 노출하는 경우 보안에 미치는 영향을 이해하는 것은 중요합니다.
99
+
100
+
<!-- ### Exposing the debug port publicly is unsafe
101
+
102
+
If the debugger is bound to a public IP address, or to 0.0.0.0, any clients that
103
+
can reach your IP address will be able to connect to the debugger without any
104
+
restriction and will be able to run arbitrary code.
105
+
106
+
By default `node --inspect` binds to 127.0.0.1. You explicitly need to provide a
107
+
public IP address or 0.0.0.0, etc., if you intend to allow external connections
108
+
to the debugger. Doing so may expose you a potentially significant security
109
+
threat. We suggest you ensure appropriate firewalls and access controls in place
110
+
to prevent a security exposure.
111
+
112
+
See the section on '[Enabling remote debugging scenarios](#enabling-remote-debugging-scenarios)' on some advice on how
113
+
to safely allow remote debugger clients to connect. -->
114
+
115
+
### 디버그 포트를 공개적으로 노출하는 것은 안전하지 않습니다.
116
+
117
+
디버거가 퍼블릭 IP 주소 또는 0.0.0.0에 바인딩 될 경우 IP 주소에 접근할 수 있는 어떤 클라이언트든 아무 제약 없이 디버거에 접속할 수 있고 임의의 코드를 실행할 수 있습니다.
118
+
119
+
기본적으로 `node --inspect`는 127.0.0.1에 바인딩 합니다. 디버거에 외부 접속을 허용하려 할 경우 퍼블릭 IP 주소 또는 0.0.0.0 등을 명시적으로 제공해야 합니다. 이렇게 하면 잠재적으로 심각한 보안 위협에 노출될 수 있습니다. 보안 노출을 방지하기 위해 적절한 방화벽과 액세스 제어를 유지하는 것이 좋습니다.
120
+
121
+
원격 디버거 클라이언트의 접근을 안전하게 허용하는 방법은 '[원격 디버깅 활성화 시나리오](#enabling-remote-debugging-scenarios)' 섹션을 참조하십시오.
122
+
123
+
<!-- ### Local applications have full access to the inspector
124
+
125
+
Even if you bind the inspector port to 127.0.0.1 (the default), any applications
126
+
running locally on your machine will have unrestricted access. This is by design
127
+
to allow local debuggers to be able to attach conveniently. -->
128
+
129
+
### 로컬 애플리케이션은 인스펙터에 완전히 액세스 할 수 있습니다.
130
+
131
+
인스펙터 포트를 127.0.0.1(기본값)에 바인딩하더라도 시스템에서 로컬로 실행되는 애플리케이션들은 제한 없이 액세스 할 수 있습니다. 이것은 로컬 디버거를 편리하게 부착할 수 있도록 의도적으로 설계되었습니다.
132
+
133
+
<!-- ### Browsers, WebSockets and same-origin policy
134
+
135
+
Websites open in a web-browser can make WebSocket and HTTP requests under the
136
+
browser security model. An initial HTTP connection is necessary to obtain a
137
+
unique debugger session id. The same-origin-policy prevents websites from being
138
+
able to make this HTTP connection. For additional security against
verifies that the 'Host' headers for the connection either
141
+
specify an IP address or `localhost` or `localhost6` precisely. -->
142
+
143
+
### 브라우저, 웹소켓, 동일 출처 정책
144
+
145
+
웹 브라우저에서 열리는 웹사이트는 브라우저 보안 모델에 따라 웹소켓과 HTTP 요청을 할 수 있습니다. 고유한 디버거 세션 ID를 얻으려면 초기 HTTP 연결이 필요합니다. 동일 출처 정책은 이 HTTP 연결을 만들 수 없도록 합니다. [DNS 리바인딩 공격](https://en.wikipedia.org/wiki/DNS_rebinding)에 대한 추가 보안을 위해 Node.js는 연결의 'Host' 헤더가 IP 주소나 `localhost` 또는 `localhost6`을 정확하게 지정하는지 검증합니다.
146
+
147
+
<!-- These security policies disallow connecting to a remote debug server by
148
+
specifying the hostname. You can work-around this restriction by specifying
149
+
either the IP address or by using ssh tunnels as described below. -->
150
+
151
+
이러한 보안 정책은 호스트 이름을 지정하여 원격 디버그 서버에 접속할 수 없도록 합니다. IP 주소를 지정하거나 아래에 설명된 것과 같이 ssh 터널을 사용하여 이 제한사항을 해결할 수 있습니다.
93
152
94
153
<!--
95
154
## Inspector Clients
@@ -133,11 +192,16 @@ Node 인스펙터에 접속할 수 있는 여러 상용 도구와 오픈소스
<li>사용자의 스크립트를 --inspect 플래그로 실행하는 자식 프로세스를 생성하고 CLI 디버거 실행에 메인 프로세스를 사용합니다.</li>
370
+
<li><i>port</i> 포트에서 수신 (기본값: 9229)</li>
282
371
</ul>
283
372
</td>
284
373
</tr>
285
374
</table>
286
375
287
376
---
288
377
378
+
<!-- ## Enabling remote debugging scenarios -->
379
+
## 원격 디버깅 활성화 시나리오
380
+
381
+
<!--
382
+
We recommend that you never have the debugger listen on a public IP address. If
383
+
you need to allow remote debugging connections we recommend the use of ssh
384
+
tunnels instead. We provide the following example for illustrative purposes only.
385
+
Please understand the security risk of allowing remote access to a privileged
386
+
service before proceeding.
387
+
-->
388
+
디버거가 퍼블릭 IP 주소에서 수신하지 않는 것을 권장합니다. 만약 원격 디버깅 연결을 허용해야 하는 경우 ssh 터널링을 대신 사용할 것을 권장합니다. 설명을 위해 아래 예제를 제공합니다. 진행하기 전 권한을 가진 서비스에 원격 액세스를 허용할 경우 발생할 수 있는 보안 위험을 이해하시기 바랍니다.
389
+
390
+
<!--
391
+
Let's say you are running Node on remote machine, remote.example.com, that you
392
+
want to be able to debug. On that machine, you should start the node process
393
+
with the inspector listening only to localhost (the default).
394
+
-->
395
+
디버깅하기를 원하는 remote.example.com 원격 시스템에서 노드가 실행 중이라고 가정하겠습니다. 해당 시스템에서 localhost(기본값)만 수신하는 인스펙터로 노드 프로세스를 시작해야 합니다.
396
+
397
+
```bash
398
+
$ node --inspect server.js
399
+
```
400
+
401
+
<!--
402
+
Now, on your local machine from where you want to initiate a debug client
403
+
connection, you can setup an ssh tunnel:
404
+
-->
405
+
이제 디버그 클라이언트 연결을 시작하려는 로컬 시스템에서 ssh 터널을 설정할 수 있습니다.
This starts a ssh tunnel session where a connection to port 9221 on your local
413
+
machine will be forwarded to port 9229 on remote.example.com. You can now attach
414
+
a debugger such as Chrome DevTools or Visual Studio Code to localhost:9221,
415
+
which should be able to debug as if the Node.js application was running locally.
416
+
-->
417
+
그러면 로컬 시스템의 9221 포트에서 remote.example.com의 9229 포트로 전달되는 ssh 터널 세션이 시작됩니다. Chrome DevTools 또는 Visual Studio Code 등의 디버거로 localhost:9221에 연결 할 수 있으며 Node.js 애플리케이션이 로컬에서 실행 중인 것처럼 디버깅할 수 있습니다.
0 commit comments