Sửa SillyTavern trên Termux: lỗi cập nhật, gỡ cài đặt và lỗi start.sh

Cập nhật lần cuối ngày 20 tháng 9, 2026 · Android · Do nhà phát triển LonelyTavern viết · Các lệnh theo hướng dẫn Android chính thức của SillyTavern

Bài này nói về việc sửa chính SillyTavern, không phải thay thế nó. Hãy chuyển thẳng tới phần khớp với triệu chứng của bạn.

1. Termux không cài đặt hay cập nhật được gì

Nguyên nhân gốc phổ biến nhất trên một bản cài mới: phiên bản Termux trên Play Store, vốn không còn được duy trì và đi kèm các gói đã lỗi thời. Hãy gỡ nó và cài Termux từ F-Droid (khuyến nghị) hoặc từ trang GitHub releases của Termux. Sau đó cập nhật mọi thứ lên bản mới nhất:

pkg update && pkg upgrade

Nếu việc tải gói bị treo hoặc hết thời gian chờ, hãy chạy termux-change-repo, chọn một máy chủ mirror khác, rồi thử lại.

2. start.sh từng chạy được — giờ thì không

Chuyện thường gặp: một lần nâng cấp gói đã âm thầm thay đổi Node mà SillyTavern đang dựa vào, hoặc ngay từ đầu Node đã được cài bản không phải LTS. Hướng dẫn chính thức chỉ định nodejs-lts; nhiều video hướng dẫn lại bảo pkg install nodejs — chỉ riêng khác biệt đó đã giải thích được rất nhiều trường hợp “tuần trước còn chạy được”. Hãy thử lần lượt theo các bước sau:

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

Nếu vẫn thất bại, hãy clone lại từ đầu — mà vẫn giữ dữ liệu của bạn:

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

Cuộc trò chuyện, nhân vật và cài đặt của bạn nằm trong thư mục data; bản cài cũ vẫn nằm trong ~/SillyTavern-old cho đến khi bạn chắc chắn mọi thứ đã được chuyển sang.

3. Máy chủ bị tắt khi màn hình khóa

Android thu hồi các tiến trình chạy nền rất mạnh tay, và một máy chủ Node trong Termux là mục tiêu hàng đầu. Theo thứ tự hiệu quả:

Chạy termux-wake-lock (hoặc chạm Acquire wakelock trong thông báo của Termux) trước những phiên dài.
Miễn Termux khỏi chế độ tối ưu hóa pin: Settings (Cài đặt) → Apps (Ứng dụng) → Termux → Battery (Pin) → Unrestricted (Không hạn chế). Tên menu khác nhau tùy nhà sản xuất, và một số hãng (đặc biệt là những giao diện Android tùy biến nặng) vẫn tắt ứng dụng chạy nền bất kể thế nào.
Với những cuộc trò chuyện dài, hãy giữ Termux hiển thị ở chế độ chia đôi màn hình thay vì để hẳn xuống chạy nền.

4. npm bị sập khi cài đặt (mã lỗi 134)

Lỗi 134 khi chạy npm install gần như luôn là do cạn bộ nhớ trên điện thoại ít RAM. Hãy đóng mọi ứng dụng khác rồi chạy lại lệnh cài; đảm bảo Node là bản LTS (pkg install nodejs-lts). Trên thiết bị 32-bit, hướng dẫn chính thức còn yêu cầu thêm pkg install esbuild.

5. Mọi thứ đều chậm

Có hai điều cần kiểm tra.

Ba thiết lập trong config.yaml. Hướng dẫn Android chính thức nêu tên việc tải nhân vật theo nhu cầu (lazy loading), bộ nhớ đệm trên đĩa và sao lưu cuộc trò chuyện tự động là những thiết lập cần xem lại trên thiết bị ít tài nguyên. Tài liệu ghi các giá trị khuyến nghị hiện hành.
Kích thước thư viện của bạn. Bộ nhớ lưu trữ của điện thoại chậm. Các tệp trò chuyện rất lớn và thư viện hàng trăm thẻ làm tăng đáng kể thời gian tải, nên hãy giữ thư viện trên thiết bị gọn nhẹ.

6. Cuộc trò chuyện hoặc nhân vật biến mất

Các báo cáo mất dữ liệu thường xoay quanh những lần ghi bị gián đoạn — ứng dụng hoặc điện thoại bị tắt giữa lúc đang lưu, hoặc một lần cập nhật gặp trục trặc. Phòng ngừa tốt hơn khôi phục. Chạy termux-setup-storage một lần để có quyền truy cập bộ nhớ dùng chung, rồi sao lưu trước mỗi lần cập nhật:

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

Nếu có thứ đã biến mất: dừng lại, đừng tiếp tục ghi, và kiểm tra thư mục sao lưu riêng của SillyTavern bên trong data trước khi nghĩ đến điều tồi tệ nhất.

7. Câu trả lời bị ngắt khi bạn khóa điện thoại hoặc chuyển ứng dụng

Lỗi này không phải do máy chủ, mà do trình duyệt. Câu trả lời được truyền vào tab đang mở qua một kết nối đang mở, và trình duyệt di động tạm dừng các tab chạy nền chỉ trong vài giây để tiết kiệm pin, làm luồng dữ liệu bị cắt. Có ba cách giúp ích:

Giữ màn hình sáng cho đến khi tạo xong câu trả lời.
Dùng chế độ chia đôi màn hình, để tab không bao giờ bị đưa hẳn xuống nền.
Giảm độ dài câu trả lời, để câu trả lời hoàn tất sớm hơn.

Firefox trên Android thường giữ các tab chạy nền sống lâu hơn Chrome một chút.

8. Gỡ cài đặt, hoặc cài lại từ đầu

Không có trình gỡ cài đặt. SillyTavern là một thư mục bên trong Termux, nên gỡ nó nghĩa là xóa thư mục đó, hoặc xóa chính Termux. Hãy sao lưu data sang bộ nhớ dùng chung trước, vì cả hai cách đều xóa luôn cuộc trò chuyện của bạn.

Các bước đầy đủ, kể cả cách cài lại sạch mà vẫn giữ cuộc trò chuyện: cách gỡ cài đặt SillyTavern.

Nếu bạn không muốn chạy máy chủ trên điện thoại

Mọi thứ ở trên giúp chính SillyTavern tiếp tục chạy. Nếu đó là điều bạn muốn, tài liệu chính thức rất tốt và cộng đồng rất nhiệt tình.

Nếu thứ bạn thực sự cần là nhân vật, khóa API và điện thoại của mình, thì chúng tôi làm ra LonelyTavern chính là vì điều đó. Đây là ứng dụng gốc cho Android và iPhone, nhập được thẻ nhân vật V3 và sổ tri thức world-info, dùng được với bất kỳ nhà cung cấp nào tương thích với OpenAI bằng khóa của riêng bạn, và giữ mọi thứ trên thiết bị của bạn.

Miễn phí, không tài khoản, không quảng cáo, và không có gì phải bảo trì lúc 2 giờ sáng. Đây không phải là SillyTavern đầy đủ: không có tiện ích mở rộng và không có trò chuyện nhóm. Với những gì cốt lõi, chỉ cần cài là dùng.

Hướng dẫn liên quan: SillyTavern trên iPhone: ba cách hiệu quả · Chai: xuất và sao lưu đoạn chat · Character.AI: xuất và giữ lại đoạn chat · tất cả hướng dẫn.

SillyTavern và Termux là các dự án độc lập của tác giả tương ứng. LonelyTavern không liên kết với dự án nào trong hai dự án này và cũng không được dự án nào bảo trợ. Các lệnh ở đây theo tài liệu chính thức của SillyTavern tại docs.sillytavern.app — luôn kiểm tra ở đó để có hướng dẫn mới nhất.