安裝 SillyTavern（酒館）之前需要先知道什麼？

SillyTavern（華語圈玩家俗稱 「酒館」 或 ST）並不是傳統那種點兩下安裝精靈的 .exe 軟體或手機 App，而是一個用 Node.js 寫成的輕量本地網頁伺服器。當你啟動它時，背景會開著一個小小的黑色終端機視窗，接著你就可以在瀏覽器打開 http://localhost:8000 進入聊天介面。

因為酒館本身只負責管理介面、組裝提示詞與保存對話紀錄，真正吃算力的 AI 推理全都在你串接的雲端 API 伺服器上跑，所以你完全不需要電競電腦或獨立顯示卡（GPU）——任何一般文書筆電、桌機或近幾年的 Android 手機都能跑得非常順。以下所有安裝指令與設定參數，均已於 2026 年 11 月對照 SillyTavern 官方說明文件 核實。

如何在 Windows 電腦安裝 SillyTavern？

在 Windows 10 或 Windows 11 上，最乾淨、日後最好更新的裝法，就是先裝好 Node.js 與 Git，再用指令拉取官方的 release 穩定分支。

注意： 根據 SillyTavern 官方 Windows 安裝指南 的兩條紅線警告：絕對不要把酒館裝在 Windows 系統受控資料夾（如 C:\Program Files、C:\Windows\System32）或 OneDrive 雲端同步資料夾裡；啟動時也絕對不要對著 Start.bat 按右鍵選「以系統管理員身分執行（Run as administrator）」。這兩種做法都會在 Node.js 安裝套件時弄壞檔案權限而導致報錯。（此外 Windows 7 因無法支援新版 Node.js，官方已不再支援。）

Windows 安裝 6 步驟

  1. 安裝 Node.js LTS： 前往 nodejs.org 下載標有 LTS（長期維護版） 的安裝檔，打開後一路照預設值按 Next 裝完。
  2. 安裝 Git for Windows： 前往 gitforwindows.org 下載安裝檔，同樣照預設選項一路按 Next 安裝完成。
  3. 挑選一個乾淨的資料夾： 按 Win + E 打開檔案總管，進到一般磁碟路徑（例如 C:\Games、C:\AI 或你的使用者個人資料夾）。
  4. 在該資料夾打開命令提示字元（CMD）： 用滑鼠直接點一下檔案總管最上方的「路徑列」，輸入 cmd 然後按 Enter，就會直接在該路徑下彈出黑色的命令提示字元視窗。
  5. 下載酒館穩定版（release 分支）： 在黑色視窗裡貼上以下指令並按 Enter：
bash
git clone https://github.com/SillyTavern/SillyTavern -b release
  1. 啟動 SillyTavern： 回到檔案總管，點進剛剛建立好的 SillyTavern 資料夾，直接左鍵雙擊 Start.bat（如果你的電腦隱藏了副檔名，它會顯示為 Start）。

第一次啟動時，黑色視窗會花一兩分鐘自動下載必要的 npm 套件，跑完後就會自動在你的預設瀏覽器打開 http://127.0.0.1:8000。記得聊天時要讓那個黑色視窗留在背景開著，關掉視窗就等於關掉酒館伺服器了。

提示： 喜歡有圖形化選單可以一鍵更新和備份嗎？官方團隊另外維護了一套啟動器 SillyTavern-Launcher，下載後執行裡面的 installer.bat，就能用視覺化按鈕來管理與更新酒館。

如何在 Android 手機用 Termux 安裝 SillyTavern？

SillyTavern 官方並沒有推出獨立的 .apk 安裝包。在 Android 手機上，我們是利用免費的 Linux 終端機模擬器 Termux，在手機本地跑跟電腦一模一樣的 Node.js 伺服器，再用手機上的 Chrome、Firefox 或 Brave 瀏覽器打開酒館網頁。

注意： 千萬不要從 Google Play 商店下載 Termux！ 正如 SillyTavern 官方 Android 安裝文件 特別警告的，Google Play 商店上的版本早已停止維護，裡面的套件源是壞掉且過期的。如果你已經裝了 Play 商店版，請務必先解除安裝。

Android (Termux) 安裝 5 步驟

  1. 從 F-Droid 或 GitHub 安裝 Termux： 請前往 F-Droid（最推薦）或 Termux 官方 GitHub Releases 頁面 下載並安裝新版 Termux APK。
  2. 切換鏡像源並更新基礎套件： 打開 Termux，先執行換源指令挑選離你近的伺服器，接著更新所有系統套件（途中若跳出詢問，輸入 Y 並按 Enter）：
bash
termux-change-repo
pkg update && pkg upgrade
  1. 安裝 Git、Node.js LTS 與 Nano 編輯器： 貼上這行指令一次裝齊三個必備工具：
bash
pkg install git nodejs-lts nano
  1. 下載 SillyTavern： 將穩定的 release 分支複製到 Termux 家目錄：
bash
git clone https://github.com/SillyTavern/SillyTavern -b release
  1. 啟動酒館伺服器： 進入資料夾並執行啟動腳本：
bash
cd ~/SillyTavern
bash start.sh

當終端機畫面跳出 SillyTavern is listening on IPv4: 127.0.0.1:8000 時，就代表啟動成功了！這時打開手機瀏覽器，在網址列輸入 http://localhost:8000 即可開始使用。下次要玩時，只需要打開 Termux 執行第 5 步的兩行指令即可。

安卓玩家必調的兩個防閃退、防殺背景設定

  • 開啟 Termux 喚醒鎖（Acquire wakelock）： Android 系統為了省電，非常喜歡在背景偷偷砍掉終端機程序。請拉下手機頂端的通知欄，找到 Termux 的常駐通知，點一下上面的 Acquire wakelock；同時建議進到手機的「設定 → 應用程式 → Termux → 電池」，將用電限制改為「不受限制（Unrestricted）」，這樣你切回瀏覽器打字時，酒館才不會突然斷線。
  • 角色卡太多時開啟延遲載入（Lazy Load）： 如果你在手機裡塞了好幾百張角色卡導致開網頁變慢，可以在 Termux 輸入 nano ~/SillyTavern/config.yaml，找到 performance: 區塊，將裡面的 lazyLoadCharacters: 改為 true、並將 useDiskCache: 改為 false（改好後依序按 Ctrl + X → Y → Enter 存檔）。

如何在 iPhone 或 iPad 上使用 SillyTavern？

因為 Apple 的 iOS 系統嚴格禁止 App 在背景執行本地 Node.js 伺服器，所以 SillyTavern 無法直接安裝在 iPhone 或 iPad 本機裡（如果在 App Store 看到名字很像的付費 App，都不是官方的）。iOS 玩家的標準做法是「把酒館跑在別台機器上，再用 iPhone 的 Safari 打開網頁」——酒館的網頁介面會自動排版成適合手機單手操作的畫面。

根據你的使用習慣，共有三種連線方案可以選：

方案一：電腦開著酒館，iPhone 連同一個家用 Wi-Fi 玩（免費且隱私最安全）

如果你平常都是在家裡躺在床上或沙發上用手機玩，只要讓家裡的電腦開著酒館，iPhone 就能透過區網直接連過去：

  1. 先在電腦上啟動一次 SillyTavern 讓它產生設定檔，然後關掉酒館視窗。
  2. 用記事本打開酒館根目錄下的 /SillyTavern/config.yaml。*（請特別注意：要改的是根目錄的 /SillyTavern/config.yaml，千萬別改錯成 /SillyTavern/default/config.yaml，改在 default 裡是不會生效的！）*
  3. 對照 官方遠端連線說明文件，找到 listen: false，把它改成 listen: true。
  4. 設定存取控制（必填）： 為了防止別人隨便連進你的酒館，當 listen: true 時，SillyTavern 強制要求一定要設定 IP 白名單或帳號密碼，否則伺服器會拒絕啟動。在家用 Wi-Fi 環境下，最方便的做法是在 config.yaml 的 whitelist: 區塊加入常見的區網網段：
yaml
listen: true
whitelistMode: true
whitelist:
  - ::1
  - 127.0.0.1
  - 192.168.0.0/16
  - 10.0.0.0/8
  - 172.16.0.0/12
  1. 查詢你電腦的區網 IPv4 位址：在 Windows 按 Win + R 輸入 cmd，執行 ipconfig，找到 IPv4 位址 / IPv4 Address（通常長得像 192.168.1.25）。
  2. 重新啟動電腦上的 SillyTavern（若 Windows 防火牆跳出詢問，請勾選允許「私人網路」存取）。接著拿起連上同一個 Wi-Fi 的 iPhone，打開 Safari 輸入 http://192.168.1.25:8000（請注意開頭是 http:// 而不是 https://）就能直接進酒館了！

方案二：出門在外用行動網路，透過 Tailscale 連回家裡電腦（免費且加密）

千萬不要直接在你家路由器的設定裡把 8000 連接埠對外公開到公網。如果你想在通勤或出門時用 4G/5G 連回家裡電腦的酒館，SillyTavern 官方內網穿透指南 首推使用免費的虛擬區網工具 Tailscale。

  1. 在你的電腦與 iPhone（從 App Store 下載）分別安裝 Tailscale，並登入同一個帳號。
  2. 打開電腦上的 /SillyTavern/config.yaml，將 listen 設為 true、將 whitelistMode 設為 false，並開啟帳號密碼保護（basicAuthMode: true）：
yaml
listen: true
whitelistMode: false
basicAuthMode: true
basicAuthUser:
  username: "yourname"
  password: "a-strong-password"
  1. 重新啟動電腦上的 SillyTavern。在 iPhone 上打開 Tailscale 開關，從 Tailscale App 裡複製你電腦被分配到的 100.x.y.z 專屬 IP，接著在 Safari 打開 http://100.x.y.z:8000，輸入你剛剛設的帳號密碼就能安全連線。（你也可以點一下 Safari 底部的「分享 → 加入主畫面」，把酒館變成桌面捷徑圖示，用起來就跟原生 App 沒兩樣。）

方案三：雲端託管酒館（玩家俗稱的「雲酒館」）

如果你身邊沒有電腦，或是不想讓家裡電腦 24 小時開機，也可以租一台小型雲端主機（VPS）自己架設，或是使用現成的雲端託管服務（社群裡常稱為 「雲酒館」）。

  • 優點： 隨時隨地用 iPhone 或 iPad 打開網址就能聊，完全不用開著家裡的電腦。
  • 費用與隱私取捨（務必留意）： 自己租一台私人 VPS 每個月大約只需幾美金，但需要一點點基礎 Linux 操作；至於網路上來路不明、由陌生人合租或代管的廉價「共享雲酒館」，請務必提高警覺——因為誰掌握那台伺服器，誰就能直接打開你的 data/ 資料夾，看光你的私人聊天紀錄、自製角色卡，甚至直接偷走你存在裡面的 API 金鑰。如果你決定走雲端路線，強烈建議自己租獨立的 VPS，並務必透過 HTTPS 開啟 basicAuthMode: true 密碼保護。

SillyTavern 頂端那排 9 個圖示分別是做什麼的？

第一次打開 http://localhost:8000 時，看到畫面上方一整排共 9 個圖示，新手常常會不知道該先點哪一個。下面我們照由左到右的順序，用白話整理每個圖示的用途：

順序官方英文面板名稱圖示長相白話功能說明
1AI Response Configuration三條水平滑桿控制回覆字數上限、溫度（Temperature）等採樣參數，以及最重要的 Chat Completion Prompt Manager（提示詞與預設管理器）——匯入預設跟開關提示詞條目都在這裡。
2API Connections電線插頭負責把酒館連上你的 AI 模型服務——在這裡選擇 Chat Completion、貼上 API 網址與金鑰，並從下拉選單挑選模型。
3Advanced Formatting大寫字母 A控制本地 Text Completion（文字補全）模型的 Context 與 Instruct 模板；如果你接的是 Claude、Gemini、DeepSeek 等 Chat Completion 接口，這個分頁完全不用動。
4World Info地球加書本建立與匯入 世界書（Lorebooks）——只要對話中提到設定好的關鍵字，就會自動把對應的世界觀設定塞進該輪提示詞裡。
5User Settings小人加齒輪調整酒館的介面佈景主題、字體大小、對話框樣式與操作習慣。
6Backgrounds風景畫框更換聊天視窗背後的背景桌布。
7Extensions三個立體方塊管理酒館內建擴充功能（例如 Regex 正則腳本、對話自動摘要、圖片與語音外掛），也可以貼上 GitHub 網址安裝第三方插件。
8Persona Management微笑臉孔設定你在故事裡扮演的 {{user}} 是誰——包含你的名字、頭像與人物設定，還能針對不同角色卡綁定不同的玩家人設。
9Characters最右側的名片夾打開你的角色卡列表，在這裡匯入 .png 或 .json 格式的角色卡、開啟新對話，或是建立多角色群聊房間。

如何串接 API 並開始第一場角色扮演對話？

因為 SillyTavern 本身沒有內建 AI 模型，裝好之後的第一步就是點選頂端第 2 個「插頭圖示（API Connections）」把模型接起來。以下示範如何在兩分鐘內串接 TavernAPI 並載入我們的角色扮演專用預設：

  1. 打開 API Connections（插頭圖示）： 將 API 設為 Chat Completion（對話補全），並將 Chat Completion Source 設為 Custom (OpenAI-compatible)。
  2. 填入端點網址與 API 金鑰：
    • Custom Endpoint (Base URL)： 填入 https://tavernapi.com/v1 （請勿在結尾加上 /chat/completions）
    • Custom API Key： 貼上你從 TavernAPI 控制台複製的 sk-tav-... 金鑰。
  3. 連線並選擇模型： 點一下 Connect（連線），接著打開 Available Models 下拉選單，挑選我們提供的五款官方 1M 上下文模型之一——例如 gemini-4-argon、claude-opus-5.5 或 deepseek-v4-pro（如果拿不準哪款模型的文風最適合你，可以先看我們的 5 款角色扮演模型實測評比）。
  4. 匯入 TavernAPI 專用預設： 從控制台下載預設 JSON 檔，點選酒館頂端最左邊的滑桿圖示（AI Response Configuration），再點一下 Chat Completion Presets 旁邊的 Import（匯入）按鈕。匯入後，你可以在下方的提示詞列表裡自由開關回覆字數、強制繁體中文輸出、防搶話（禁止 AI 代寫 {{user}}）等本地選項；而鎖定的核心寫作條目（[[tav:...]]）會在請求經過我們的伺服器時自動展開，並搭配自動提示詞快取幫你省下長篇聊天的 Token 費用。

如果在連線時遇到任何錯誤碼（如 401、402 或 429），或想深入了解伺服器鎖定預設的運作細節，歡迎查看我們的 SillyTavern API 詳細串接與排錯指南、閱讀 內建 RP 預設運作原理、比較 其他 AI 角色扮演工具，或前往 模型與價格頁面 與 常見問題（FAQ）。