# 라즈베리파이 셋팅 A to Z

- Author: @baealex
- Published: 2021-09-10
- Updated: 2021-09-10
- Source: http://blex.me/@baealex/%EB%9D%BC%EC%A6%88%EB%B2%A0%EB%A6%AC%ED%8C%8C%EC%9D%B4
- Tags: 리눅스, 라즈베리파이

---

라즈베리파이를 간만에 상자에서 꺼내었다. 문제는 셋팅하던 기억들도 그 위에 덮여진 먼지처럼 희미했다. 나중에 다시 셋팅하는 순간을 대비해 이 기회에 메뉴얼을 작성해 두고자 한다. 모니터를 일체 연결하지 않고 설정할 것이며 오직 원격으로민 사용할 예정이다.

#### 1. 설치

###### Raspberry Pi OS [#](https://www.raspberrypi.org/software/operating-systems/)

위 홈페이지에 접속하여 라즈비안 이미지 파일을 다운로드 하자. 3가지로 분류되어 있는데 자신의 필요에 따라서 설치하면 된다. 참고로 토렌트로 받는게 빠르다.

- 데스크톱 + 권장 소프트웨어 : GUI 환경과 다양한 기본 소프트웨어가 포함된 버전 (2GB)
- 데스크톱 : GUI 환경만 포함된 버전 (1GB)
- 라이트 : CLI 환경만 포함된 버전 (500MB)

필자는 권장 소프트웨어 포함된 버전을 설치하였다.

###### Win32 Disk Imager [#](https://sourceforge.net/projects/win32diskimager/)

![](https://static.blex.me/images/content/2021/8/19/5_wcLk367T7NzK7VTxrI9x.jpg)

다운받은 이미지를 SD카드에 넣어야 하는데 위 응용 프로그램을 이용하여 넣을 수 있다. 위에서 다운받은 이미지(.img)를 선택하고 SD카드 리더기를 컴퓨터에 꼽아 디스크를 선택한 후 `Write` 버튼을 눌러주면 된다.

#### 2. 네트워크 설정

대부분의 경우 라즈베리파이를 부팅하여 모니터와 연결하여 SSH와 네트워크를 활성화 시키는데 필자는 모니터를 연결할 수 없는 상황이므로 다른 방법을 찾아야 했다. 다행이 headless로 설정할 수 있는 방법이 있었다. SD카드에 이미지가 정상적으로 복사되었다면 해당 디스크가 `boot` 라고 표기될 것이다. 여기에 몇 가지 파일을 생성하면 된다.

- ssh를 활성화 시키려면 boot에 `ssh` 파일을 (내용은 비운채) 생성하자.
- 무선랜을 잡으려면 boot에 `wpa_supplicant.conf` 파일을 생성한 후 아래 내용을 입력하자.

```bash
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
network={
    ssid="WIFI_NAME"
    psk="WIFI_PASSWORD"
}
```

![](https://static.blex.me/images/content/2021/8/25/10_3sCqxFLRBXSSPaVK5viq.jpg)

그럼 boot에 위 두 파일이 생겼다. 이제 라즈베리파이가 부팅이 되면 공유기 관리자 페이지로 접속하여 (iptime의 경우 [192.168.0.1](http://192.168.0.1)) 라즈베리파이의 아이피를 알아내자, 이후 해당 아이피로 `SSH` 접속을 요청한다. 기본 계정은 아래와 같다.

- 아이디 : `pi`
- 패스워드 : `raspberry`

접속후 `passwd` 명령어를 입력하여 패스워드를 변경하자.

#### 3. RDP

데스크톱 환경이 필요한 경우 `XRDP Server`를 설치하자. 윈도우에 기본적으로 `RDP` 클라이언트 앱이 존재하여 `VNC`보다 접속이 더 편리하다. 라즈베리파이에서 다음 명령어를 입력하자.

```bash
sudo apt-get update 
sudo apt-get install -y xrdp 
sudo service xrdp restart 
```

이후 윈도우키 누른 후 `Remote Desktop Connection`를 검색하여 앱을 실행한다. 라즈베리파이 아이피로 접속을 요청한다. 위 `SSH` 연결시 사용한 계정을 그대로 입력한다.

#### 4. 한글 설정

라즈비안에는 기본적으로 한글 폰트가 없어서 한글이 깨져서 보여진다. 아래 명령어를 입력하여 한글 폰트를 설치하자.

```bash
sudo apt install -y fonts-unfonts-core
```

다음은 한글 입력기를 설치하자. 필자는 본래 리눅스에서 `fcitx`를 애용하나 라즈베리파이에선 다소 설정이 상이하여 `ibus`를 사용했다.

```bash
sudo apt-get install -y ibus ibus-hangul
```

![](https://static.blex.me/images/content/2021/8/18/16_Zc6E3jn9oOwz5lwJD7V9.jpg)

설치가 완료된 경우 위 경로에서 `IBus Preferernces`를 실행시킨다. 아마 실행이 안될거다. 이 경우 `~/.bashrc`에 다음 내용을 추가한다.

```bash
export GTK_IM_MODULE=ibus
export XOMODIFIERS=@im=ibus
export QT_IM_MODULE=ibus
```

이제 재시작을 한 후 다시 실행시키면 정상적으로 켜진다.

#### 5, 기타등등

###### 개발환경 구축

Debian 계열이므로 아래 글을 참고하여 대부분(!)의 환경은 동일하게 설치할 수 있다.

- [Ubuntu(Debian) 개발환경 구축](https://blex.me/@baealex/ubuntudebian-%EA%B0%9C%EB%B0%9C%ED%99%98%EA%B2%BD-%EA%B5%AC%EC%B6%95)

###### Docker

```bash
sudo apt-get update && sudo apt-get upgrade -y
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
```

위 명령어를 입력하면 설치가 완료되며 도커 명령어는 아래 글을 참고하자.

- [Docker 명령어 정리](https://blex.me/@baealex/%EB%8F%84%EC%BB%A4docker-%EB%AA%85%EB%A0%B9%EC%96%B4-%EC%A0%95%EB%A6%AC)
- 참고한 글 : [How to Install Docker on Raspberry Pi](https://phoenixnap.com/kb/docker-on-raspberry-pi)