Termux에서 SillyTavern 고치기: 업데이트, 삭제, start.sh 오류

최종 업데이트: 2026년 9월 20일 · Android · LonelyTavern 개발자 작성 · 명령어는 공식 SillyTavern Android 가이드를 따릅니다

이 글은 SillyTavern을 대체하는 방법이 아니라 SillyTavern 자체를 고치는 방법입니다. 증상에 맞는 섹션으로 바로 가세요.

1. Termux에서 아무것도 설치하거나 업데이트할 수 없다

새로 설정했을 때 가장 흔한 근본 원인은 Play 스토어 버전의 Termux입니다. 더 이상 관리되지 않고 오래된 패키지를 제공합니다. 이를 삭제하고 F-Droid(권장)나 Termux의 GitHub 릴리스에서 Termux를 설치하세요. 그런 다음 모든 것을 최신으로 올리세요.

pkg update && pkg upgrade

패키지 다운로드가 멈추거나 시간 초과되면 termux-change-repo를 실행해 다른 미러를 고른 뒤 다시 시도하세요.

2. 잘 되던 start.sh가 이제 안 된다

흔한 경우는 이렇습니다. 패키지 업그레이드로 SillyTavern이 쓰던 Node가 바뀌었거나, 애초에 Node를 LTS가 아닌 빌드로 설치한 것입니다. 공식 가이드는 nodejs-lts를 지정하지만, 많은 동영상 튜토리얼은 pkg install nodejs라고 안내합니다. 이 차이 하나로 "지난주엔 됐는데"의 상당수가 설명됩니다. 다음 순서대로 하나씩 시도하세요.

pkg update && pkg upgrade
pkg install nodejs-lts
cd ~/SillyTavern && git pull --rebase --autostash
bash start.sh

그래도 실패하면 데이터는 유지한 채 새로 클론하세요.

mv ~/SillyTavern ~/SillyTavern-old
git clone https://github.com/SillyTavern/SillyTavern -b release
cp -r ~/SillyTavern-old/data ~/SillyTavern/
cd ~/SillyTavern && bash start.sh

채팅, 캐릭터, 설정은 data 폴더에 있습니다. 모든 것이 제대로 옮겨졌다고 확신할 때까지 기존 설치는 ~/SillyTavern-old에 남아 있습니다.

3. 화면이 잠기면 서버가 꺼진다

Android는 백그라운드 프로세스를 적극적으로 회수하며, Termux 안의 Node 서버는 주요 표적입니다. 효과가 큰 순서대로 정리했습니다.

긴 세션 전에 termux-wake-lock을 실행하세요(또는 Termux 알림에서 Acquire wakelock을 탭하세요).
Termux를 배터리 최적화에서 제외하세요: Settings → Apps → Termux → Battery → Unrestricted(설정 → 애플리케이션 → Termux → 배터리 → 제한 없음). 메뉴 이름은 제조사마다 다르며, 일부 제조사(특히 Android를 많이 수정한 스킨)는 그래도 백그라운드 앱을 종료합니다.
긴 채팅에서는 Termux를 완전히 백그라운드로 보내지 말고 화면 분할로 보이게 두세요.

4. 설치 중에 npm이 죽는다(오류 코드 134)

npm install 중 발생하는 오류 134는 거의 항상 RAM이 적은 휴대폰의 메모리 부족 때문입니다. 다른 앱을 모두 닫고 설치를 다시 실행하세요. Node가 LTS 빌드(pkg install nodejs-lts)인지 확인하세요. 32비트 기기에서는 공식 가이드가 추가로 pkg install esbuild를 요구합니다.

5. 모든 게 느리다

확인할 것이 두 가지 있습니다.

config.yaml 설정 세 가지. 공식 Android 가이드는 사양이 낮은 기기에서 검토할 설정으로 캐릭터 지연 로딩, 디스크 캐싱, 자동 채팅 백업을 꼽습니다. 현재 권장 값은 문서에 있습니다.
라이브러리 크기. 휴대폰 저장소는 느립니다. 아주 큰 채팅 파일과 카드 수백 장짜리 라이브러리는 로딩 시간을 실제로 잡아먹으므로, 기기 안의 라이브러리는 가볍게 유지하세요.

6. 채팅이나 캐릭터가 사라졌다

데이터 손실 보고는 쓰기가 중단된 경우에 몰려 있습니다. 저장 중에 앱이나 휴대폰이 종료되었거나, 업데이트가 잘못된 경우입니다. 복구보다 예방이 낫습니다. 공유 저장소에 접근할 수 있도록 termux-setup-storage를 한 번 실행한 다음, 업데이트할 때마다 먼저 백업하세요.

cp -r ~/SillyTavern/data ~/storage/shared/SillyTavern-backup

이미 무언가 사라졌다면, 멈추고 더 이상 쓰지 마세요. 최악을 가정하기 전에 data 안에 있는 SillyTavern 자체 백업 폴더(backups)를 확인하세요.

7. 휴대폰을 잠그거나 앱을 전환하면 답장이 끊긴다

이건 서버 문제가 아닙니다. 브라우저 문제입니다. 답장은 실시간 연결을 통해 열린 탭으로 스트리밍되는데, 모바일 브라우저는 배터리를 아끼려고 몇 초 만에 백그라운드 탭을 일시 중지하고, 그러면 스트림이 끊깁니다. 도움이 되는 것은 세 가지입니다.

생성이 끝날 때까지 화면을 켜 두세요.
화면 분할을 써서 탭이 완전히 백그라운드로 가지 않게 하세요.
응답 길이를 줄여 답장이 더 빨리 끝나게 하세요.

Android의 Firefox는 Chrome보다 백그라운드 탭을 조금 더 오래 살려 두는 편입니다.

8. 삭제하거나 깨끗하게 다시 시작하기

제거 프로그램은 없습니다. SillyTavern은 Termux 안의 폴더 하나이므로, 삭제한다는 것은 그 폴더를 지우거나 Termux 자체를 지우는 것입니다. 두 방법 모두 채팅도 함께 지워지므로, 먼저 data를 공유 저장소에 백업하세요.

채팅을 유지하는 깨끗한 재설치까지 포함한 전체 단계는 여기에 있습니다. SillyTavern 삭제하는 방법.

휴대폰에서 서버를 돌리고 싶지 않다면

위의 모든 내용은 SillyTavern 자체를 계속 돌리기 위한 것입니다. 그걸 원한다면 공식 문서도 좋고 커뮤니티도 도움이 됩니다.

실제로 필요한 것이 내 캐릭터, 내 API 키, 내 휴대폰이라면, 그래서 저희가 LonelyTavern을 만들었습니다. V3 캐릭터 카드와 World Info 로어북을 가져오고, 내 키로 OpenAI 호환 프로바이더라면 어디든 연결하며, 모든 것을 기기에 보관하는 Android·iPhone 네이티브 앱입니다.

무료, 계정 없음, 광고 없음, 새벽 2시에 관리할 일도 없음. 완전한 SillyTavern은 아닙니다. 확장 기능도, 그룹 채팅도 없습니다. 핵심 기능은 설치하면 바로 쓸 수 있습니다.

SillyTavern과 Termux는 각 제작자의 독립된 프로젝트입니다. LonelyTavern은 두 프로젝트 어느 쪽과도 제휴하거나 보증을 받지 않았습니다. 이 글의 명령어는 docs.sillytavern.app의 공식 SillyTavern 문서를 따르며, 최신 안내는 항상 그곳에서 확인하세요.