官方網站
Git 儲存庫產品說明
Shiori 是一款基於 Go 語言開發的開源書籤管理器，設計初衷是作為 Pocket 或 Instapaper 的輕量級自架替代方案。它不僅僅是一個儲存網址的工具，更是一個強大的「網頁存檔庫」。
與傳統瀏覽器書籤不同，Shiori 會在您儲存網頁時，自動抓取該頁面的內容並建立「離線存檔」。這意味著即使原始網站倒閉或刪除文章，您仍然可以在 Shiori 中閱讀完整的內容。它提供了一個乾淨、無廣告的 Web 閱讀介面，同時也保留了強大的命令列介面（CLI），非常適合開發者或喜歡終端機操作的使用者。
由於它是編譯後的單一執行檔（Single binary），安裝極度簡單，無需繁雜的依賴環境，是自架服務（Self-hosted）愛好者的首選工具之一。
核心特色：
- 網頁永久存檔：自動下載網頁內容並建立離線複本（支援文字與 HTML 模式），防止「連結失效 (Link Rot)」。
- 單一執行檔：基於 Go 語言編寫，下載後即可直接執行，支援 Windows、Linux、macOS，也可透過 Docker 快速部署。
- 雙重介面：提供美觀的 Web 管理介面（支援 RWD 手機瀏覽）與高效率的 CLI 模式。
- 閱讀模式：內建類似 Safari 的閱讀器模式，去除網頁廣告與雜訊，專注於閱讀體驗。
- 資料庫支援：預設使用 SQLite（方便遷移），但也可配置為 PostgreSQL 或 MySQL 以應對大量數據。
常用指令與快捷鍵
Shiori 可以完全透過終端機進行管理，這使得它非常適合整合到自動化腳本中。以下是核心操作指令：
啟動與基礎操作
Shiori 下載後通常需要先加入系統 PATH，或者直接在目錄下執行。
# 啟動 Web 伺服器 (預設埠號 8080)
shiori serve
# 指定埠號啟動
shiori serve --port 9000
命令列書籤管理 (CLI)
如果您不習慣使用 Web 介面，可以直接用指令存取書籤：
| 指令 | 功能說明 |
|---|---|
shiori add [URL] | 新增書籤 (會自動抓取標題與內容) |
shiori add [URL] -t tag1,tag2 | 新增書籤並加上標籤 |
shiori print | 列出最近儲存的書籤 |
shiori search [keyword] | 搜尋書籤 (支援標題與內容搜尋) |
shiori update [ID] | 更新現有書籤的快取內容 |
shiori delete [ID] | 刪除指定 ID 的書籤 |
shiori open [ID] | 在瀏覽器中開啟原始連結 |
Docker 部署 (推薦)
對於長期運作，使用 Docker 是最方便的方式：
docker run -d --name shiori
-p 8080:8080
-v $(pwd)/shiori-data:/srv/shiori
ghcr.io/go-shiori/shiori
(預設登入帳號：shiori / 密碼：gopher)
操作介面
Web 介面亮點：
Shiori 的 Web 介面採用極簡設計，主畫面以卡片式或列表式呈現書籤，並顯示縮圖與摘要。
- 夜間模式：自動適應或手動切換深色主題。
- 標籤過濾：左側欄位可快速篩選特定標籤的書籤。
- 閱讀器視窗：點擊書籤後，會進入「閱讀模式」，以統一的字體與排版呈現內容，類似電子書的閱讀體驗。
