휴대폰에서 다운로드 폴더를 하루에 다섯 번씩 여는 사람이라면, 문제는 서버가 아닙니다. 그 폴더가 브라우저 탭 안에 살고 있다는 것이 문제입니다. 탭은 새로고침하면 마지막 위치를 잊고, 주소창은 화면 절반을 먹습니다.

Banyan은 Go 단일 바이너리로 배포되는 셀프호스팅 파일 브라우저입니다. 파일 하나, Docker 없음, 데이터베이스 없음. 같은 바이너리가 LAN에서 웹 UI를 서비스하고, 같은 페이지에서 Android APK도 내려받을 수 있습니다. 다만 다른 것보다 시간을 더 잡아먹는 조건이 하나 있습니다: APK는 arm64 전용입니다.

1. 준비물

  • 휴대폰과 같은 네트워크에 있는 서버: 라즈베리파이, 미니 PC, NAS, 아무 Linux 머신.
  • 기기에 맞는 패키지: 64비트 파이는 banyan_linux_arm64_20261118.zip, x86은 banyan_linux_amd64_20261118.zip, 구형 파이는 banyan_linux_armv7_20261118.zip.
  • APK: https://banyan.ikootoo.com/release/banyan_android_arm64_20261118.apk, 약 19 MB.

프로젝트 사이트: https://banyan.ikootoo.com/
다운로드: https://banyan.ikootoo.com/#download
소스: https://github.com/nbmany-web/banyan (MIT)

2. APK는 두 번째 동기화 엔진이 아닙니다

설치 전에 이 부분을 이해하는 게 좋습니다. APK는 파일을 휴대폰으로 내려받아 동기화 상태로 유지하지 않습니다. 같은 웹 UI를 껍데기에 넣은 것이고, 미리보기는 여전히 서버에서 렌더링됩니다. 휴대폰은 이미 만들어진 썸네일을 받기 때문에 200 MB PDF나 영상도 전체 전송 없이 열립니다.

서버가 응답하지 않으면 APK도 응답하지 않습니다. 서버가 꺼져 있으면 볼 로컬 사본이 없습니다. 결함이 아니라, 바이너리가 동기화 큐를 운영하는 대신 20 MB로 유지되는 이유입니다.

3. 내려받기 전에 ABI부터 확인

adb shell getprop ro.product.cpu.abi 
  • arm64-v8a — APK 사용 가능.
  • armeabi-v7a — 아닙니다. 32비트 기기에 APK를 설치하지 말고, 같은 서버를 브라우저로 열어 홈 화면에 바로가기를 두세요.

adb가 없으면 설치 → App not installed 확인 → 브라우저로 돌아오는 우회도 같은 결론입니다. 명령 한 줄이 그 왕복을 아껴 줍니다.

4. 서버 먼저 띄우기

mkdir -p ~/banyan && cd ~/banyan curl -LO https://banyan.ikootoo.com/release/banyan_linux_arm64_20261118.zip unzip banyan_linux_arm64_20261118.zip # -> banyan/banyan + config.json chmod +x banyan/banyan ./banyan/banyan -headless 

프로세스가 수신 주소를 출력합니다. 같은 Wi-Fi에서 그 주소를 휴대폰에 넣으세요. 수동 실행이 싫다면 systemd 유닛:

[Unit] Description=Banyan file browser After=network-online.target [Service] ExecStart=/home/pi/banyan/banyan -headless Restart=always [Install] WantedBy=multi-user.target 

5. APK 설치

  1. 파일을 휴대폰으로 옮깁니다(케이블, scp, 또는 휴대폰 브라우저에서 직접).
  2. 파일을 엽니다. Android가 해당 출처에서의 설치를 허용하라고 요청합니다. 앱 단위 권한이며 전역 권한이 아니고, 나중에 되돌릴 수 있습니다.
  3. App not installed가 뜨면 원인은 둘입니다. ABI 불일치(3번) 또는 다른 서명의 패키지가 이미 설치된 경우입니다. 이전 버전을 삭제하고 다시 시도하세요.

6. "PC에서는 열리는데 휴대폰에서는 안 열린다" — 원인은 늘 두 가지

  • 서버가 localhost에만 바인딩되어 있습니다. 그러면 그 머신에서만 되고 다른 곳에서는 안 됩니다. LAN 인터페이스에 바인딩하세요.
  • 휴대폰이 게스트 네트워크에 있거나 클라이언트 격리가 켜진 SSID에 있습니다. 많은 공유기가 게스트 VLAN에서 기기 간 통신을 기본 차단하며, 어떤 앱도 이를 우회할 수 없습니다.

서버에서 한 줄 점검:

ss -lntp | grep 8688 

127.0.0.1:8688만 보인다면 범인을 찾은 것입니다.

7. 포트를 인터넷에 열지 마세요

이 앱에는 로그인 화면이 없습니다. 서버에도 없습니다. 설계상 그렇습니다. 계정도 ACL도 없고, 권한은 OS의 일이고 공유는 만료되는 링크입니다. 그래서 공유기에서 포트 포워딩을 하면 안 됩니다. 외부에서 써야 한다면 VPN(WireGuard, Tailscale)이나 TLS 리버스 프록시 + 허용 목록을 쓰세요.

files.example.com { reverse_proxy 127.0.0.1:8688 } 

8. 탭보다 APK가 맞는 경우

  • 같은 폴더를 하루에도 여러 번 열고, 떠난 위치가 유지되길 원한다.
  • 탭 사이에 묻히지 않는 홈 화면 아이콘이 필요하다.
  • 태블릿을 주방이나 TV 화면으로 두고 한 번의 터치로 들어가고 싶다.

셋 다 해당하지 않으면 웹 UI가 같은 UI입니다. 홈 화면 바로가기로 충분합니다. 타협이 아니라 올바른 선택입니다.

정리

arm64 전용, 19 MB, 출처별 권한으로 설치, 서버 주소 직접 입력, 포트는 절대 외부에 노출하지 않음. 기기가 32비트라면 브라우저가 같은 일을 합니다.