ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

ChatLab 安裝指南:Desktop、CLI 與 Docker 三種部署方式全解析

ChatLab 安裝指南:Desktop、CLI 與 Docker 三種部署方式全解析 数据分析人工智能AI 应用AI Agent桌面应用CLIMCP 服务AI 技能【免费下载链接】ChatLabLocal-first chat history analyzer with AI. | 本地优先的 AI 聊天记录分析工具项目地址https://gitcode.com/ChatLab/ChatLab点击查看免费下载ChatLab 是一套「本地優先」的 AI 聊天記錄分析工具安裝方式分為 Desktop 桌面版、CLI 命令列與 Docker 容器三種分別對應圖形化使用、腳本 / AI Agent 自動化與伺服器常駐部署三類場景。本文以官方安裝文檔 docs/tw/usage/installation.md 為主體結合倉庫內 CLI 與配置模組的實際原始碼完整說明每一種安裝方式的環境要求、操作步驟、啟動選項與安全注意事項讀完即可在個人電腦或伺服器上把 ChatLab 跑起來。三種安裝方式總覽安裝方式適用場景運行形態Desktop普通使用者想要圖形介面一鍵安裝Electron 桌面應用隨開隨用CLI開發者、腳本 / AI Agent 使用者Node.js 程式提供clb web啟動 API Web UIDocker伺服器常駐、容器化部署官方容器映像含linux/amd64與linux/arm64三種方式使用同一套使用者資料預設位於主機的~/.chatlab因此可以在不同方式之間切換不需要複製資料具體做法見下文 Docker 小節。Desktop圖形化安裝前往 ChatLab 官網或 GitHub Releases 頁面下載對應作業系統的安裝程式執行安裝即可。安裝完成後直接啟動應用即可在首頁拖入聊天記錄檔案開始使用。需要特別注意的硬體限制macOS 桌面版目前僅支援搭載 Apple 晶片M 系列的 Mac。Intel Mac 使用者可以改用下方的 CLI Web 方式——CLI 在 Intel Mac 上照常執行透過瀏覽器獲得與桌面版一致的 Web UI 體驗。從倉庫結構看桌面端是基於 Electron 構建的應用見 apps/desktop/package.json內部依賴electron-builder進行各平台打包其本體與 CLI 共用同一套openchatlab/*核心套件這也解釋了為何不同安裝方式可以讀取同一份使用者資料。CLINode.js 環境與 npm 全域安裝CLI 安裝包名為chatlab-cli需要Node.js 22.19 或更新版本——這與倉庫內 apps/cli/package.json 中宣告的engines: { node: 22.19.0 }完全一致低於此版本的 Node 將無法安裝或運行。npm install --global chatlab-cli安裝完成後系統會同時提供兩個命令名稱。查看 apps/cli/package.json 的bin欄位可以確認bin: { chatlab: bin/chatlab.mjs, clb: bin/chatlab.mjs }官方建議使用更短的clb舊的chatlab命令仍會保留以相容既有腳本與使用習慣。可以先用clb --version確認安裝成功該選項在 apps/cli/src/cli.ts 中註冊同時支援-v。啟動 API Web UIclb web 的三種模式CLI 的核心啟動命令是clb web別名start根據參數可以呈現三種運行模式clb web # 啟動 API Web UI並在瀏覽器中開啟 clb web --no-open # 啟動 API Web UI但不自動開啟瀏覽器 clb web --headless # 僅啟動 API不提供 Web UI供腳本 / AI Agent 呼叫這些選項的實際實現在 apps/cli/src/cli.ts 的web命令定義中預設會先檢查dist-cli-web/目錄是否存在以決定是否提供 Web UI--headless時直接跳過 Web UI 靜態資源的掛載只啟動 HTTP API。啟動成功後終端會輸出 Web UI / API 位址與自動產生的 Bearer Token例如ChatLab v0.x.x Web UI: http://127.0.0.1:3110/ API: http://127.0.0.1:3110 Token: 自動產生的令牌常用啟動選項選項說明預設值--port 連接埠服務監聽連接埠3110--host 位址監聽位址127.0.0.1--token 令牌自訂 Bearer Token省略時由 ChatLab 讀取或自動產生自動產生--headless僅啟動 API不提供 Web UI關閉--require-auth除 API 路由外也要求 Web UI 路由使用 Bearer 驗證關閉--no-open啟動後不自動開啟瀏覽器自動開啟--socket 路徑改用 Unix 網域通訊端監聽不佔用 TCP 連接埠TCP--daemon註冊為系統常駐服務登入時自動啟動macOS / Linux關閉其中--port的預設值直接來自配置套件匯出的DEFAULT_API_PORT--host的預設值為127.0.0.1見 apps/cli/src/cli.ts。啟動前 CLI 會先對端口做預檢若被佔用會輸出明確的EADDRINUSE提示並快速失敗避免初始化到一半才報錯。進階Unix Socket 監聽與反向代理在 macOS 和 Linux 上可以讓 ChatLab 不佔用 TCP 連接埠改用 Unix 網域通訊端clb web --socket /tmp/chatlab.sock --no-open啟動後可使用curl直接透過通訊端存取請將YOUR_TOKEN替換為啟動時顯示的令牌curl --unix-socket /tmp/chatlab.sock -H Authorization: Bearer YOUR_TOKEN http://localhost/api/v1/status也可以在其前方設定反向代理把 HTTP 請求轉發到該通訊端再由代理對外提供標準 HTTP 介面。需要留意兩點通訊端權限若反向代理以另一個 Unix 使用者執行請在 ChatLab 啟動後為代理所屬群組授予通訊端存取權限sudo chgrp 代理群組 /tmp/chatlab.sock sudo chmod 660 /tmp/chatlab.sock由於每次重新啟動都會重建通訊端權限設定也需要每次重新套用建議使用服務管理器的啟動後掛鉤post-start hook自動完成。ChatLab 與代理以相同使用者執行時通常不需要修改權限。Web UI 驗證如果代理可從本機信任環境之外存取請使用--require-auth啟動 ChatLab或在代理層強制驗證身分避免 Web UI 路由和權杖設定公開暴露。從原始碼看--require-auth的機制位於 apps/cli/src/http/auth.ts/api/開頭的路由始終要求 Bearer Token而/_web/開頭的 Web UI 靜態路由只有開啟requireAuthEnabled時才要求驗證。換句話說--require-auth是專門為「Web UI 可能暴露在非本機環境」設計的安全開關。常駐服務clb web --daemon / clb status / clb stop若要讓服務常駐後台、登入時自動啟動可以使用常駐服務模式僅 macOS / Linuxclb web --daemon # 註冊為系統服務登入時自動啟動macOS / Linux clb status # 查看常駐狀態 clb stop # 停止並移除系統服務從 apps/cli/src/daemon/service.ts 的實作可以看到底層機制macOS寫入~/Library/LaunchAgents/fun.chatlab.daemon.plist透過 launchd 的RunAtLoadKeepAlive實現登入自啟與崩潰重啟Linux寫入~/.config/systemd/user/chatlab.service透過 systemd 使用者單元systemctl --user enable --now實現同樣效果並帶有Restartalways服務日誌寫入~/.chatlab/logs/daemon.log安裝資訊記錄在~/.chatlab/daemon.jsonclb status會顯示服務是否安裝、是否運行、監聽位址與自動啟動狀態與 apps/cli/src/cli.ts 中的status命令相對應Windows 目前不支援 daemon 模式原始碼中會直接提示改用clb web前台運行另外--daemon與--socket也不能同時使用原始碼會在組合使用時直接報錯退出。Docker容器化部署速覽需要容器部署時請查看完整的 Docker 部署文檔。官方映像為ghcr.io/chatlab/chatlab-cli提供linux/amd64與linux/arm64兩種架構容器預設以clb web --no-open --host 0.0.0.0啟動並已內建本地向量模型與簡體中文斷詞詞典所需的執行元件首次啟動無需下載額外的 Node 相依套件或詞典。資料共用的關鍵ChatLab Desktop、CLI 和 Docker 都使用主機的~/.chatlab。在本機運行 Docker 時建議掛載此目錄這樣無論是先 Docker 後 Desktop / CLI還是先 Desktop / CLI 後 Docker都能直接讀取原有的設定、聊天資料庫和 AI 資料完全不需要複製資料。推薦的掛載方式是mkdir -p $HOME/.chatlab $HOME/Downloads docker run --name chatlab \ -p 127.0.0.1:3110:3110 \ --user $(id -u):$(id -g) \ --mount typebind,source$HOME/.chatlab,target/home/node/.chatlab \ --mount typebind,source$HOME/Downloads,target/home/node/Downloads \ -e HOME/home/node \ -e CHATLAB_DATA_DIR/home/node/.chatlab/data \ ghcr.io/chatlab/chatlab-cli:latest這組命令的細節值得展開映像預設使用非特權node使用者UID/GID 1000執行--user讓容器程序使用主機目前使用者的 UID/GIDHOME確保系統目錄仍是/home/node/.chatlab而CHATLAB_DATA_DIR將使用者資料固定到容器可存取的/home/node/.chatlab/data避免主機config.toml中的絕對路徑在容器內失效。Windows PowerShell 使用者去掉--user與--mount語法差異後即可直接使用。容器啟動後開啟 http://127.0.0.1:3110/ 即可。如果是在伺服器上部署、明確不想與主機共用資料則改用 Docker named volume-v chatlab-data:/home/node/.chatlab但要注意 Desktop 和主機 CLI不會自動看到其中的資料升級容器時務必保留該資料卷。文檔中也提供了透過環境變數自訂使用者資料目錄、以start --port ... --headless --no-open覆寫容器預設命令、以及 Docker Compose 一鍵部署等進階方案均收錄於 docs/tw/usage/docker.md。安裝後的資料與配置要點安裝完成後的第一步安裝完成後建議繼續閱讀 快速開始指南把第三方工具匯出的聊天記錄檔案直接拖入 ChatLab 首頁匯出方式見 如何匯出聊天記錄匯入細節見 匯入聊天記錄指南然後在設定中接入 AI 模型即可透過自然語言探索聊天歷史。配置優先順序與環境變數ChatLab 對配置欄位的讀取遵循以下優先順序實現在 packages/config/src/loader.tsCHATLAB_*環境變數~/.chatlab/config.toml或相容的config.json內建預設值常用設定環境變數與其對應的配置欄位如下映射規則同樣見 packages/config/src/loader.ts環境變數對應配置欄位說明CHATLAB_DATA_DIRdata.user_data_dir覆寫使用者資料目錄設定後需另外掛載所選目錄CHATLAB_API_PORTapi.portAPI 連接埠容器場景請用--port設定服務CHATLAB_API_HOSTapi.hostAPI 監聽位址容器場景請用--hostCHATLAB_LLM_PROVIDERllm.providerAI 模型提供者CHATLAB_LLM_MODELllm.modelAI 模型名稱CHATLAB_LLM_BASE_URLllm.base_urlAI 服務基礎 URLCHATLAB_LOCALE_LANGlocale.lang介面語言CHATLAB_CLI_ALLOW_RAWcli.allow_raw設為1或true時允許查詢命令輸出未經隱私預處理的--raw結果此外還有幾個運行時環境變數值得留意CHATLAB_LOG_LEVEL日誌層級預設INFO、CHATLAB_SKIP_UPDATE_CHECK停用 CLI 更新檢查、CHATLAB_DISABLE_NATIVE_PERF停用原生解析器加速等。而 Bearer Token、無介面模式、Web UI 驗證與瀏覽器開啟行為則只能透過對應的命令列選項設定ChatLab 不為這些選項提供環境變數別名——這也解釋了 Docker 部署中為何要用--token而非環境變數來傳遞令牌。總結ChatLab 的三種安裝方式覆蓋了從普通使用者到伺服器運維的完整需求Desktop 適合圖形化日常使用注意 macOS 僅支援 Apple 晶片CLI 依賴 Node.js 22.19一條npm install --global chatlab-cli即可獲得clb web的 API Web UI 組合並可用--socket、--require-auth與--daemon構建安全的常駐服務Docker 則提供多架構官方映像透過掛載主機~/.chatlab實現與 Desktop / CLI 的無縫資料共用。三種方式共用同一套使用者資料與配置體系安裝完成後即可匯入聊天記錄並接入 AI開始用自然語言探索你的聊天歷史。赞分享数据分析人工智能AI 应用AI Agent桌面应用CLIMCP 服务AI 技能【免费下载链接】ChatLabLocal-first chat history analyzer with AI. | 本地优先的 AI 聊天记录分析工具项目地址https://gitcode.com/ChatLab/ChatLab点击查看免费下载相关推荐ChatLab 安装全指南Desktop、CLI 与 Docker 三种部署方式详解ChatLab 安装全指南Desktop、CLI 与 Docker 三种部署方式详解 ChatLab 是一款本地优先的 AI 聊天记录分析工具将聊天历史的解ChatLab 安装指南Desktop、CLI 与 Docker 三种部署方式详解ChatLab 安装指南Desktop、CLI 与 Docker 三种部署方式详解 ChatLab 是一款本地优先的 AI 聊天记录分析工具支持以桌面应用、ChatLab 安装指南Desktop、CLI 与 Docker 三端部署以及 clb web 本地服务配置详解ChatLab 安装指南Desktop、CLI 与 Docker 三端部署以及 clb web 本地服务配置详解 ChatLab 是一款本地优先local上一篇Tiled地图编辑器从像素艺术到游戏世界的桥梁下一篇STDF-Viewer完整指南半导体测试工程师的终极数据分析工具创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表