Linux 서버에 설치하기

서버에 SSH로 접속하기

내 PC에서 명령 창을 엽니다. Windows는 PowerShell, Mac은 터미널 앱입니다. 사용자이름과 서버주소를 내 서버의 값으로 바꿔 실행합니다.

ssh 사용자이름@서버주소

SSH 키 파일을 받았다면 ssh -i 키파일경로 사용자이름@서버주소처럼 -i로 키 파일을 지정합니다. 클라우드 콘솔의 SSH 단추로 연 창을 써도 됩니다.

처음 접속하면 Are you sure you want to continue connecting (yes/no/[fingerprint])?라고 묻습니다. yes를 입력하고 Enter를 누릅니다. 비밀번호는 입력해도 화면에 보이지 않습니다.

✓사용자이름@서버이름:~$ 모양의 명령 줄이 보입니다. 이 문서의 나머지 명령은 모두 이 창에서 실행합니다.

설치할 수 있는 서버인지 확인하기

CPU 종류, Ubuntu 버전, 지금 사용자를 차례로 출력합니다.

uname -m
grep PRETTY_NAME /etc/os-release
whoami

adduser orke

usermod -aG sudo orke

mkdir -p /home/orke/.ssh && \
  cp ~/.ssh/authorized_keys /home/orke/.ssh/ && \
  chown -R orke:orke /home/orke/.ssh

✓x86_64, Ubuntu 24.04, root가 아닌 사용자 이름이 보입니다.

필요한 프로그램 설치하기

먼저 설치할 수 있는 패키지 목록을 새로 받습니다. 처음 sudo를 쓰면 내 비밀번호를 물을 수 있습니다.

sudo apt-get update

이어서 orke가 쓰는 패키지를 설치합니다. 여러 줄이지만 하나의 명령이니 한 번에 복사해 붙여 넣습니다.

sudo apt-get install -y libicu74 ca-certificates procps curl git tar gzip coreutils \
  xvfb libnss3 libgtk-3-0t64 libatk1.0-0t64 libatk-bridge2.0-0t64 \
  libcups2t64 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 \
  libxrandr2 libgbm1 libasound2t64

서버 안에서 웹 페이지를 띄우는 웹 창 기능의 패키지도 들어 있습니다. orke 설치 프로그램이 이 목록을 모두 확인하므로 터미널만 쓸 때도 설치합니다.

✓오류 없이 명령 줄로 돌아옵니다. 중간에 보라색 안내 화면이 나오면 막혔을 때를 보세요.

orke 설치하기

sudo 없이, orke를 쓸 사용자로 실행합니다. 가장 최근 Linux 판을 받아 확인한 뒤 내 홈 폴더에 설치합니다. 프로그램은 ~/.local/share/orke, 설정과 기록은 ~/.orke에 둡니다.

curl -fsSL https://orke.bomtobe.com/install.sh | bash

설치되면 다음과 같은 줄이 나옵니다. 판 번호는 설치할 때의 최신 판입니다.

Installed orke 3.4.6: /home/사용자이름/.local/share/orke
Command: /home/사용자이름/.local/bin/orke → /home/사용자이름/.local/share/orke/orke

Ubuntu 24.04에서는 이어서 Warning:으로 시작하는 두 줄과 virtual browser 안내가 나옵니다. 웹 창 기능에 대한 안내라 터미널·AI·원격 접속에는 영향이 없으니 지금은 넘어갑니다. 그 뒤의 Next steps 안내는 이 문서의 다음 단계들과 같은 내용입니다.

Error: Required packages are missing가 나오면 그 아래에 나오는 sudo apt-get … 명령을 그대로 복사해 실행한 뒤 이 설치 명령을 다시 실행합니다.

✓Installed orke로 시작하는 줄이 보입니다.

orke 명령을 바로 쓸 수 있게 하기

orke 명령은 ~/.local/bin에 있습니다. 이 폴더는 다음 로그인부터 자동으로 쓰입니다. 지금 창에서 바로 쓰려면 한 번 실행합니다.

export PATH="$HOME/.local/bin:$PATH"

orke 명령이 보이는지 확인합니다.

command -v orke

✓/home/사용자이름/.local/bin/orke가 출력됩니다.

서버에 ngrok 설치하기

ngrok 공식 apt 저장소로 설치합니다. 아래 명령을 위에서부터 하나씩 실행합니다.

curl -fsSL https://ngrok-agent.s3.amazonaws.com/ngrok.asc \
  | sudo tee /etc/apt/trusted.gpg.d/ngrok.asc >/dev/null

echo 'deb https://ngrok-agent.s3.amazonaws.com bookworm main' \
  | sudo tee /etc/apt/sources.list.d/ngrok.list

sudo apt-get update

sudo apt-get install -y ngrok

설치된 판을 확인합니다. orke에는 ngrok 3.39.9 이상이 필요합니다.

ngrok version

✓ngrok version 3.으로 시작하는 판 번호가 보입니다.

ngrok에 가입하고 주소와 토큰 찾기

PC 브라우저에서 ngrok 가입 화면을 열어 무료 계정을 만듭니다. Google 계정으로 가입해도 됩니다. 가입하면 대시보드가 열립니다.

대시보드 왼쪽 메뉴에서 두 가지를 찾습니다.

• Domains: 무료 고정 주소가 하나 있습니다. 이름.ngrok-free.app 또는 이름.ngrok-free.dev 모양입니다. 목록이 비어 있으면 그 화면에서 무료 주소를 하나 만듭니다. 이 주소를 메모해 둡니다.
• Your Authtoken: ngrok이 내 계정을 알아보는 비밀값입니다. Copy를 누르면 복사됩니다. 비밀번호처럼 다른 사람에게 보이지 마세요.

✓고정 주소를 메모했고 Authtoken을 복사할 수 있습니다.

원격 접속 정보 저장하기

SSH 창으로 돌아와 실행합니다. 먼저 Found ngrok: … 줄로 6단계에서 설치한 ngrok을 찾았다고 알려 준 뒤 네 가지를 차례로 묻습니다. 질문은 영어로 나옵니다.

orke remote setup

잘못 입력하면 그 자리에서 다시 묻습니다. 끝에 다음 줄이 보이면 저장된 것입니다.

Remote settings saved: https://name.ngrok-free.app (allowed Google email: you@example.com). Connects automatically when orke starts.

이어지는 orke will connect using this address on its next start.는 다음 단계에서 orke를 시작하면 이 주소로 연결한다는 뜻입니다.

✓Remote settings saved 줄이 보입니다.

orke를 서비스로 시작하기

orke를 서버의 서비스로 등록하고 시작합니다. 이제 SSH 창을 닫아도 orke가 계속 실행되고, 서버를 다시 켜면 저절로 시작합니다. 준비를 확인하느라 잠시(길면 1분 30초) 걸릴 수 있습니다.

orke service install

sudo loginctl enable-linger "$(id -un)"

✓The orke service is ready 줄이 보입니다.

ngrok 연결 확인하기

서비스 상태와 ngrok 연결 기록을 봅니다.

orke service status

orke service (/home/사용자이름/.config/systemd/user/orke.service)
  State: running (active/running, pid 1234)
  …
ngrok: /home/사용자이름/.orke/remote-access/tools/ngrok → /usr/local/bin/ngrok
Last ngrok error: none (no ngrok error line in daemon.log)
Recent ngrok record: 연결됐습니다. — …

State: running과 연결됐습니다.가 보이면 주소가 열린 것입니다. 연결 줄이 아직 없으면 10초쯤 뒤 다시 실행합니다. Last ngrok error에 ERR_NGROK_로 시작하는 번호가 보이면 막혔을 때를 보세요.

✓State: running과 연결됐습니다.가 보입니다.

주소를 열고 Google로 로그인하기

PC 브라우저의 주소창에 https://를 붙인 내 ngrok 주소(예: https://name.ngrok-free.app)를 입력합니다. 8단계의 Remote settings saved: 줄에 나온 주소를 그대로 써도 됩니다.

무료 주소에서는 ngrok의 안내 화면이 먼저 나옵니다. Visit Site를 누릅니다. 같은 브라우저에서도 7일마다 다시 나올 수 있습니다.

Google 로그인 화면에서 8단계에 입력한 이메일의 계정을 고릅니다. 다른 계정으로는 들어갈 수 없습니다.

✓orke 화면이 열리고 아래쪽에 아이콘 줄(Dock)이 보입니다.

화면을 한국어로 바꾸기

처음에는 영어로 보입니다. Dock 맨 오른쪽의 톱니바퀴(Settings)를 누르고, General의 Display language에서 한국어를 고릅니다.

바로 바뀌고 이 브라우저에 저장됩니다. 다른 브라우저나 폰에서 처음 열 때는 한 번 더 고릅니다.

✓메뉴와 단추가 한국어로 보입니다.

첫 터미널 열기

Dock 맨 왼쪽의 터미널 단추를 누르면 「새 세션」 창이 열립니다. 에이전트에서 터미널을 고르고, 작업 폴더는 그대로 둔 채 시작을 누릅니다.

열린 터미널에 다음을 입력합니다.

whoami
hostname

서버의 사용자 이름과 서버 이름이 나오면 원격 연결을 마친 것입니다. 이 터미널은 서버에서 실행되므로 브라우저를 닫아도 서버의 orke가 켜져 있는 동안 남아 있습니다.

✓SSH 창에서 본 것과 같은 사용자 이름과 서버 이름이 보입니다.