安裝一套獨立伺服器

本節適用於獨立 Linux x86-64 試用伺服器，已安裝 Docker Engine、Compose v2、Python 3、curl 與 tar。客戶既有 Nextcloud 請由 IT 先確認相容性，不能直接覆蓋。

可先估 4 vCPU、16 GB RAM、100 GB SSD，再依文件、OCR、版本與備份需求調整。這是起始估算，不是容量保證。

下載與安裝

在新的目錄執行以下指令。下載包不包含任何現有公司的資料、密碼或模型 Token。

mkdir knowledge-pilot && cd knowledge-pilot
base=https://makalot-knowledge-handbook.pages.dev/downloads
curl -fLO "$base/knowledge-server-0.3.0-pilot.1.tar.gz"
curl -fLO "$base/knowledge-server-0.3.0-pilot.1.tar.gz.sha256"
sha256sum -c knowledge-server-0.3.0-pilot.1.tar.gz.sha256
tar -xzf knowledge-server-0.3.0-pilot.1.tar.gz
bash knowledge-server/delivery/server/install.sh http://localhost:18090

初次建置需要下載基底映像及 Rust 依賴。終端會顯示建置進度，耗時依網路與主機而異。完成後，本機可開啟 http://localhost:18090。

從其他電腦試用時，以 SSH 轉送該 loopback 端口，不要直接把測試 HTTP 暴露到網際網路。

ssh -L 18090:127.0.0.1:18090 你的伺服器別名

管理員帳號與密碼

安裝程序為每套環境產生獨立的管理員、資料庫及橋接密碼，保存於 delivery/server/.env、credentials.txt 與 state/knowledge/private/bridge-key。檔案權限為僅擁有者可讀寫。請用安全管道交付，勿貼到聊天、截圖或本網站。

重跑安裝會沿用現有設定與資料，不重新產生密碼。安裝中斷時先檢查日誌，修正後重跑；不要刪除 state 來處理故障。

五個服務

cd knowledge-server/delivery/server
./knowledgectl status
docker compose ps

此獨立安裝包提供 Nextcloud、PostgreSQL、Redis、cron 與知識庫背景服務五個容器。5090 現有環境另有 Cloudflare Tunnel，所以是六個。客戶的 HTTPS 入口由自己的反向代理或 Tunnel 提供。

資料庫、Redis 與背景 8097 端口都不對外映射。Nextcloud HTTP 只綁 127.0.0.1。

對外網址與 HTTPS

若已有 HTTPS 反向代理，可以在初次安裝時指定實際網域：

bash knowledge-server/delivery/server/install.sh https://knowledge.example.com

代理需能轉送至伺服器 loopback 的 18090 端口，並正確保留主機名稱與 HTTPS 資訊。此指令不會替你註冊網域或取得憑證。代理完成前，從遠端連線還不能視為驗收成功。

裝好後還要做什麼

1. 登入 Nextcloud，建立真實帳號、部門群組及審核人。
2. 完成生成模型與部門設定。
3. 上傳去識別文件，實際檢查自動收錄、生成與來源。
4. 執行驗收表，確認權限、重啟及還原。

試用包固定應用與 OpenWiki 版本，但部分基底映像仍是版本系列標籤。正式發佈還須鎖定所有映像 digest，完成來源版本一致性修正、商業模型接入確認與容量測試。