아이패드에서 코딩하기 — code-server + Tailscale로 어디서든 개발환경 접속
외부에서 아이패드를 개발 장비로 만드는 셋팅 방법
아이패드로 코딩한다고 하면 보통 두 가지 반응이 돌아옵니다. "그게 되나요?" 아니면 "그걸 왜 하나요?".
근데 됩니다. 그것도 꽤 쾌적하게.
저는 이미 맥 세 대를 Tailscale + SSH로 하나의 네트워크로 묶어놓은 상태였습니다. 해당 과정이 궁금하시다면 이전에 작성한 홈서버 구축기를 참고하시면 됩니다. 맥북에어에서 맥북프로로 SSH 붙어서 작업하는 건 됐는데, 아이패드에서도 같은 걸 하고 싶었습니다.
SSH 터미널만으로는 한계가 있거든요. 코드 읽기가 불편하고, 파일 네비게이션이 답답하고, 멀티 파일 수정은 더 귀찮습니다. 그래서 아이패드 브라우저에서 VS Code를 그대로 띄우는 방법을 찾았고, code-server로 해결했습니다.
이 글에서는 처음부터 셋팅하는 과정을 정리합니다.
code-server란
code-server는 VS Code를 웹 브라우저에서 돌릴 수 있게 해주는 오픈소스 프로젝트입니다. Microsoft의 VS Code 코드베이스를 기반으로 만들어졌고, 서버에서 실행하면 브라우저로 접속해서 사용할 수 있습니다.
구조는 이렇습니다.
맥북프로에서 code-server 실행
→ 웹 서버가 뜸 (localhost:8080)
→ 아이패드 브라우저에서 접속
→ VS Code UI가 그대로 나옴
맥북프로의 파일 시스템, 터미널, 확장 프로그램, 테마까지 전부 브라우저에서 그대로 씁니다. SSH 터미널이 아니라 진짜 VS Code 화면이 나옵니다.
필요한 것
- 개발환경이 세팅된 맥 (또는 리눅스)
- 아이패드 (+ 블루투스 키보드 추천)
- Tailscale (외부 네트워크에서도 접속하려면)
같은 와이파이에서만 쓸 거면 Tailscale 없이도 됩니다. 근데 카페, 이동 중에도 접속하려면 Tailscale이 필요합니다.
Step 1. code-server 설치
macOS 기준입니다. Homebrew로 한 줄이면 끝납니다.
brew install code-server리눅스라면 공식 설치 스크립트를 쓰면 됩니다.
curl -fsSL https://code-server.dev/install.sh | sh설치 확인:
code-server --version
# 4.x.xStep 2. 설정 파일 수정
처음 실행하면 설정 파일이 자동으로 생성됩니다.
code-server
# 최초 실행 → ~/.config/code-server/config.yaml 생성
# Ctrl+C로 종료설정 파일을 열어서 수정합니다.
bind-addr: 0.0.0.0:8080
auth: password
password: 원하는비밀번호
cert: false각 항목을 설명하면:
bind-addr
0.0.0.0:8080으로 설정하면 같은 네트워크의 다른 기기에서 접속할 수 있습니다. 127.0.0.1이면 로컬에서만 접속 가능합니다.
127.0.0.1로 바인딩해도 Tailscale의 tailscale serve 기능으로 접근 가능합니다. 근데 간단하게 0.0.0.0으로 열고 Tailscale 네트워크 안에서만 쓰는 게 더 편합니다.auth
인증 방식입니다. password로 하면 접속 시 비밀번호를 입력해야 합니다. password 항목에 원하는 비밀번호를 직접 지정할 수 있습니다.
Tailscale 네트워크 안에서만 접속한다면 auth: none으로 해도 됩니다. Tailscale 자체가 인증 레이어 역할을 하니까요. 근데 보안 습관상 password를 권장합니다.
cert
HTTPS 인증서 설정입니다. false면 HTTP로 동작합니다. 로컬/Tailscale 환경에서는 HTTP로 충분합니다.
Step 3. code-server 실행
code-server터미널에 이런 로그가 나옵니다.
[2026-03-27T10:00:00.000Z] info code-server 4.x.x
[2026-03-27T10:00:00.000Z] info HTTP server listening on http://0.0.0.0:8080
맥 브라우저에서 localhost:8080으로 접속해보면 VS Code가 나타납니다. 여기까지 되면 서버 쪽은 끝입니다.
Step 4. 아이패드에서 접속
같은 와이파이일 때
맥의 로컬 IP를 확인합니다.
ipconfig getifaddr en0
# 192.168.0.x아이패드 Safari에서 http://192.168.0.x:8080으로 접속합니다.
다른 네트워크일 때 (Tailscale)
맥의 Tailscale IP를 확인합니다.
tailscale ip -4
# 100.112.xxx.xx아이패드에서도 Tailscale 앱(App Store)을 설치하고 같은 계정으로 로그인합니다. VPN 프로필 허용 팝업이 뜨는데 승인하면 됩니다.
이후 아이패드 Safari에서 http://100.112.xxx.xx:8080으로 접속합니다.
비밀번호를 입력하면 VS Code가 브라우저에 뜹니다. 프로젝트 폴더, 터미널, 확장 프로그램, 설정까지 전부 맥에 있는 그대로 나옵니다.
Step 5. 자동 실행 설정
매번 터미널을 열어서 code-server를 수동으로 실행하기 귀찮으면, macOS가 켜질 때 자동으로 시작되게 합니다.
brew services start code-server이러면 맥을 재부팅해도 code-server가 자동으로 뜹니다. 아이패드에서 주소만 입력하면 바로 접속됩니다.
자동 실행 상태 확인:
brew services list | grep code-server
# code-server started chahyunwoo ~/Library/LaunchAgents/...중지하려면:
brew services stop code-server실사용 팁
키보드 단축키
아이패드에 블루투스 키보드를 연결하면 VS Code 단축키가 거의 다 동작합니다.
잘 되는 것들:
Cmd+P— 파일 찾기Cmd+Shift+P— 커맨드 팔레트Cmd+B— 사이드바 토글- `Cmd+`` — 터미널 토글
Cmd+S— 저장
안 되는 것들:
Cmd+Tab— 아이패드 앱 전환으로 먹힘Cmd+W— Safari 탭 닫기로 먹힘 (주의)
이건 아이패드 OS 레벨 제약이라 어쩔 수 없습니다.
터미널
code-server 터미널은 맥의 실제 쉘을 띄웁니다. git, pnpm, node, docker 전부 그대로 실행됩니다. 빌드도 맥에서 도는 거라 아이패드 스펙과 무관합니다.
확장 프로그램
대부분 동작합니다. 근데 code-server는 Microsoft 마켓플레이스 대신 Open VSX 레지스트리를 사용합니다. 대부분의 인기 확장은 양쪽에 다 있는데, 일부는 Open VSX에 없을 수 있습니다.
확실히 잘 되는 것들:
- Biome, ESLint, Prettier
- GitLens
- Tailwind CSS IntelliSense
- 테마, 아이콘 팩
보안
Tailscale을 쓰고 있다면 보안 걱정은 크게 할 필요 없습니다. Tailscale 네트워크는 WireGuard 암호화를 사용하고, 외부에서는 접근 자체가 불가능합니다.
근데 한 가지 주의할 점이 있습니다. bind-addr: 0.0.0.0:8080 + auth: none 조합으로 공용 와이파이에서 쓰면 같은 네트워크의 누구나 내 VS Code에 접속할 수 있습니다. Tailscale 없이 쓸 때는 반드시 auth: password를 설정하세요.
정리
좋은 점
- 아이패드만 있으면 어디서든 메인 개발환경 접속
- 셋팅이 간단함 (brew install + config 수정 + Tailscale)
- 맥의 리소스를 그대로 쓰기 때문에 빌드/실행 속도 그대로
- 확장 프로그램, 터미널, 파일 시스템 전부 동작
고려할 점
- 네트워크 필수 (오프라인 코딩 불가)
- 일부 VS Code 확장이 Open VSX에 없을 수 있음
- 아이패드 OS 레벨 단축키 충돌 (
Cmd+Tab,Cmd+W) - 메인 작업보다는 이동 중 보조 용도에 적합
이미 Tailscale을 쓰고 있다면 셋팅은 5분이면 끝납니다. SSH 터미널만으로 원격 작업하던 분들이라면 확실히 한 단계 업그레이드된 경험이 될 겁니다.
