> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dwe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Raspberry Pi에 고정 IP 주소 설정하기

> 이 가이드에서는 Raspberry Pi에 고정 IP 주소를 구성하는 방법을 설명합니다.

<Note>
  이 가이드는 Raspberry Pi에서 sudo 권한을 가지고 있고 터미널 사용에 익숙하다고 가정합니다.
</Note>

<Card title="PhoenixNAP 가이드" icon="link" href="https://phoenixnap.com/kb/raspberry-pi-static-ip">
  이 가이드는 다음 자료를 기반으로 작성되었습니다! 더 자세한 정보가 필요하면 여기를 클릭하세요.
</Card>

## Raspberry Pi에서 터미널 창 열기

모니터와 키보드를 Raspberry Pi에 직접 연결하여 사용 중이라면, 터미널 아이콘을 클릭하거나 `Ctrl` + `Alt` + `T`를 눌러 터미널을 열 수 있습니다.

SSH로 연결되어 있다면 이미 터미널 세션에 있는 것입니다.

<Card title="SSH 안내" icon="link" href="/ko/dwe-os/guides/ssh-rpi">
  Raspberry Pi용 SSH 가이드입니다.
</Card>

## 네트워크 인터페이스와 현재 IP 확인하기

<Steps>
  <Step title="네트워크 인터페이스 목록 표시">
    터미널에서 다음 명령을 실행하여 네트워크 인터페이스 목록을 확인합니다:

    ```
    ip addr
    ```
  </Step>

  <Step title="사용 중인 인터페이스 식별">
    사용 중인 인터페이스(예: 유선 연결의 경우 `eth0`, 무선 연결의 경우 `wlan0`)를 확인하고, 인터페이스 이름을 적어 둡니다.
  </Step>

  <Step title="현재 IP 주소 찾기">
    해당 인터페이스 아래의 `inet` 줄을 확인하여 현재 IP 주소를 찾습니다. IP 주소, 서브넷 마스크, 라우터(게이트웨이), DNS 서버를 적어 둡니다.
  </Step>
</Steps>

## `dhcpcd` 구성 파일 편집하기

<Steps>
  <Step title="구성 파일 열기">
    `nano`와 같은 텍스트 편집기로 `dhcpcd.conf` 파일을 편집합니다:

    ```
    sudo nano /etc/dhcpcd.conf
    ```
  </Step>

  <Step title="고정 IP 구성 추가">
    파일 끝까지 스크롤하고, 자리 표시자를 실제 네트워크 정보로 바꾸어 다음 줄을 추가합니다:

    ```
    interface <your_interface_name>
    static ip_address=<desired_static_ip_address>/<subnet_mask>
    static routers=<your_router_ip>
    ```

    <Note>
      **BlueOS 예시:**

      ```
      interface eth0
      static ip_address=192.168.2.2/24
      static routers=192.168.2.1
      ```
    </Note>
  </Step>

  <Step title="저장 및 종료">
    `Ctrl` + `X`를 눌러 종료한 다음, `Y`를 눌러 변경사항을 저장하고, `Enter`로 파일 이름을 확인합니다.
  </Step>
</Steps>

## Raspberry Pi 재부팅

변경 사항을 적용하기 위해 Raspberry Pi를 재부팅합니다:

```
sudo reboot -h now
```

## 고정 IP 구성 확인하기

재부팅한 후, Raspberry Pi의 터미널을 열고 다음을 실행합니다:

```
ip addr
```

인터페이스에 설정한 고정 IP 주소가 적용되었는지 확인합니다.

<Note>
  고정 IP 설정 후 Raspberry Pi에 연결할 수 없는 경우, IP 주소가 네트워크 범위 내에 있고 다른 장치와 충돌하지 않는지 확인하세요.
</Note>