---
title: "一款免費開源類似於 Notion 類知識庫系統 — Outline Wiki 佈署與備份全攻略"
description: "介紹如何用 Docker Compose 架設開源知識庫 Outline Wiki，並搭配 MinIO、PostgreSQL 完成資料備份與還原的完整攻略。"
canonical_url: "https://blog.markkulab.net/post/outline-wiki-knowledge-base-system"
author: "Mark Ku"
author_url: "https://blog.markkulab.net/author/mark-ku"
site: "Mark Ku's Blog"
date_published: "2025-06-11 01:01:35 +0800"
category: "Management"
tags: ["outline", "wiki", "knowledge base", "docker", "minio", "postgresql", "backup", "self-hosted"]
language: "zh-TW"
license: "CC BY 4.0"
license_url: "https://creativecommons.org/licenses/by/4.0/"
attribution: "轉載或引用請註明作者並附上原文連結"
---

# 一款免費開源類似於 Notion 類知識庫系統 — Outline Wiki 佈署與備份全攻略

> **TL;DR** — 歡迎收聽 Mark 的 Tech Insights，我是人工智慧主持人璦廷。在追求高效協作的路上，你是否正尋找一套完美的知識庫系統？ 今天為大家介紹一款免費開源、類似 Notion 的工具：Outline Wiki。它能解決常見限制，提升團隊資訊管理效率。 讓我們來看看它的核心技術。透過 Docker Compose 就能快速佈署。這個重點值得注意，它不支援傳統帳密，而是採用第三方授權，例如企業版 Google、GitHub 或微軟帳號登入。 在實際維護上，若圖片無法顯示，只需在 MinIO 手動建立資料夾。系統資料分為儲存文字紀錄的 PostgreSQL，以及存放檔案的 MinIO。文章提供了完整的備份與還原指令，確保資產安全。 總結來說，Outline 是建立專屬知識庫的優秀選擇。不妨思考看看，你的團隊目前最需要改善的資訊共享痛點是什麼呢？

## 背景介紹

在追求高效資料與知識共享的過程中，許多企業和團隊面臨工具選擇的挑戰。我們嘗試了多種知識庫工具，但從工程師的反饋來看，這些工具仍存在不少限制。經過多方評估與尋找，最終發現 Outline 是一款非常適合團隊協作的知識庫解決方案，能有效提升工作效率與資訊管理。

---

## 什麼是 Outline？

[**Outline**](https://www.getoutline.com/) 是一款簡潔且功能強大的知識庫管理工具，介面與使用體驗類似 Notion。它支援 Markdown 編輯、全文檢索、以及多種第三方登入方式，非常適合企業或團隊搭建共享知識庫。Outline 是開源軟體，功能完整，專為團隊打造，能大幅提升知識管理與協作效率。

---

## 架設指南（使用 Docker Compose 範例）

以下為使用 Docker Compose 快速架設 Outline 的範例設定：

```yaml
version: '3'

services:
  outline:
    image: outlinewiki/outline:latest
    ports:
      - "27777:3000"
    environment:
      - DATABASE_URL=postgres://postgres:postgres@postgres:5432/outline
      - REDIS_URL=redis://redis:6379
      - SECRET_KEY=你的隨機字串
      - UTILS_SECRET=你的隨機字串
      - URL=http://localhost:27777
      - NODE_ENV=production
      - FORCE_HTTPS=false
      - PORT=3000
      - AWS_ACCESS_KEY_ID=minio
      - AWS_SECRET_ACCESS_KEY=minio123
      - AWS_REGION=us-east-1
      - AWS_S3_UPLOAD_BUCKET_URL=http://localhost:9000
      - AWS_S3_UPLOAD_BUCKET_NAME=uploads
      - AWS_S3_FORCE_PATH_STYLE=true
      - AWS_S3_ACL=private
      - AWS_S3_UPLOAD_MAX_SIZE=26214400
      - PGSSLMODE=disable
      - OIDC_CLIENT_ID=你的OIDC客戶端ID
      - OIDC_CLIENT_SECRET=你的OIDC客戶端密鑰
      - OIDC_AUTH_URI=https://github.com/login/oauth/authorize
      - OIDC_TOKEN_URI=https://github.com/login/oauth/access_token
      - OIDC_SCOPES=read:user user:email
      - OIDC_USERINFO_URI=https://api.github.com/user
      - OIDC_USERNAME_CLAIM=name
      - OIDC_DISPLAY_NAME=GitHub
    depends_on:
      - postgres
      - redis
      - minio

  postgres:
    image: postgres:13
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=outline
    volumes:
      - postgres_data:/var/lib/postgresql/data

  redis:
    image: redis:6
    volumes:
      - redis_data:/data

  minio:
    image: minio/minio
    ports:
      - "9000:9000"
      - "9001:9001"
    environment:
      - MINIO_ROOT_USER=minio
      - MINIO_ROOT_PASSWORD=minio123
    volumes:
      - minio_data:/data
    command: server /data --console-address ":9001"

volumes:
  postgres_data:
  redis_data:
  minio_data:
```

啟動服務指令：

```bash
docker-compose up -d
```

P.S. 如果無法上傳 Create Bucket > "uplaods"  

```
http://localhost:9001/
```

---

## 🚪 登入方式說明

Outline 不支援帳密登入，僅支援多種第三方帳號登入，以下為主要選項及注意事項：

* **Google 登入**
  需使用 Google Workspace（企業帳號），不支援個人 Gmail 帳號。

* **GitHub 登入**
  支援個人Github 帳號：[GitHub 應用授權設定](https://github.com/settings/applications/3037670)

* **Microsoft 登入**
  支援 Azure AD（企業帳號）及個人 Microsoft 帳號。  
  [參考資料](https://medium.com/chouhsiang/%E9%96%8B%E7%99%BC%E4%BB%8B%E6%8E%A5azure-ad-1-sso-86d90cdba13)

---

## 修正MinIO 圖片無法正常顯示問題
### 3. 文章圖片無法上傳，登入 MinIO Web UI，手動建立  Blcket "uploads"
### 4. 大頭照無法顯示
```
# 1. 進入 Minio 容器
docker exec -it outline-wiki-minio-1 sh

# 2. 設定 mc 別名
mc alias set myminio http://localhost:9000 account password


# 3. 設定 uploads bucket 為匿名可讀
mc anonymous set download myminio/uploads

# 4. 檢查設定是否成功
mc anonymous get myminio/uploads

# 5. 離開容器
exit
```

## 💾 資料備份要點

Outline 主要包含兩部分資料：

1. **PostgreSQL 資料庫**：儲存頁面內容、使用者資訊及版本歷史
2. **MinIO 儲存空間**：存放所有使用者上傳的圖片及檔案，相當於本地端的 Amazon S3

---

## 訪問
```
http://localhost:27777/
```
![編輯畫面](https://blog.markkulab.net/content/markku/posts/outline-wiki-knowledge-base-system/images/screenshot.png)

## 小bug 
登出後，需要關閉瀏覽器頁籤才有辦法重新登入。

## ✅ 備份

### Step 1：備份 PostgreSQL 資料庫

```bash
docker exec -t $(docker ps -qf name=postgres) pg_dump -U postgres outline > outline_backup.sql
```

> **注意：**
>
> * 匯出檔案為 SQL 格式，會存放於執行目錄。
> * 若容器名稱非 `postgres`，請使用 `docker ps` 查詢並替換。

---

### Step 2：備份 MinIO 資料

```bash
docker run --rm -v minio_data:/volume -v $(pwd):/backup alpine tar czf /backup/minio_backup.tar.gz -C /volume .
```

> **注意：**
>
> * 會將 MinIO volume 內所有檔案壓縮為 `.tar.gz`。
> * `minio_data` 為 MinIO 的 volume 名稱，請依實際情況調整。

---

## ♻️ 還原流程

### 還原 PostgreSQL 資料庫

```bash
cat outline_backup.sql | docker exec -i $(docker ps -qf name=postgres) psql -U postgres -d outline
```

### 還原 MinIO 資料

```bash
docker run --rm -v minio_data:/volume -v $(pwd):/backup alpine sh -c "cd /volume && tar xzf /backup/minio_backup.tar.gz"
```

---

## 關於本文與作者

本文出自 [Mark Ku's Blog](https://blog.markkulab.net/post/outline-wiki-knowledge-base-system)

授權條款： [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) — 轉載或引用請註明作者並附上原文連結

### 關於作者

**[Mark Ku](https://blog.markkulab.net/author/mark-ku)** — Software Solution Provider

- 10+ 年資深軟體工程師，現為 AI 應用 Builder
- 專注大型平台架構設計，從北美電商到AI SaaS訂閱收費系統
- 結合 AI Agent 與自動化，打造高效可演進的產品技術基礎

### 作者開發的免費工具

以下工具皆可免費使用：

- [免費 PDF 簽名工具](https://blog.markkulab.net/tools/pdf-sign): 線上 PDF 簽名工具，瀏覽器內完成手繪、打字、上傳簽名，可拖曳放置、縮放、下載。所有處理都在你的裝置完成，檔案不會上傳。
- [VS Code Refactory](https://blog.markkulab.net/tools/refactory): Refactory 是一款 VS Code 重構擴充套件：34 個重構動作、37 條 code smell 檢查、Code Health 儀表板、18 種語言、534 支測試。懂你的專案慣例：介面放哪、DI 註冊寫在哪、'use client' 該不該加；還會用 git 修改頻率 × 複雜度排出「該先修哪個檔案」，並一鍵把壞味道交給你自己電腦上的 Claude Code 修。免費使用，原始碼不離開你的機器。
- [DB-Kit 資料庫管理工具](https://blog.markkulab.net/tools/db-kit): DB-Kit 是一個用 Tauri + Rust + React 打造的輕量跨平台資料庫管理工具，用單一一致的介面同時管理 MySQL、MariaDB、PostgreSQL、SQL Server、Oracle、SQLite、MongoDB、Redis、Kafka、Elasticsearch 與 RabbitMQ 十一種資料來源：連線密碼以 OS keychain 加密、SSH Tunnel、完整 CRUD、視覺化查詢建構器、多結果集同時顯示、跨連線資料傳輸與比對同步、Excel / CSV 匯入匯出、執行計畫視覺化、ER 圖、排程備份、SQL 壓力測試（p50～p99 延遲百分位）、15 條規則的 SQL 審查、Kafka 訊息瀏覽與監控告警；繁中 / 英文雙語介面，內建 AI 助手（自然語言生成 SQL、AI 審查與調校建議）與命令列工具 dbk。免費開源（MIT），提供 Windows / macOS / Linux 安裝檔。
- [VS Code Super Mermaid](https://blog.markkulab.net/tools/super-mermaid): Super Mermaid 是一款 VS Code 擴充套件：開箱即用的漂亮 Mermaid 圖表，自動上色、即時預覽、滑鼠平移縮放、PNG / SVG 高解析匯出，內建 21 種範本與多種主題。免費開源（MIT）。
- [React Super Mermaid](https://blog.markkulab.net/tools/react-super-mermaid): react-super-mermaid 是一個開源 React 元件庫：一行 <MermaidViewer> 即可渲染漂亮的 Mermaid 圖表，內建 colorful / sketch 主題、平移縮放、圖內搜尋、SVG / PNG 高解析匯出。輕量、SSR 安全、完整 TypeScript 型別。免費開源（MIT）。
- [Jira / Confluence Super Mermaid](https://blog.markkulab.net/tools/jira-super-mermaid): Atlassian Forge app：在 Jira issue 與 Confluence 內文直接寫 Mermaid 語法，畫流程圖、時序圖、狀態機與甘特圖。11 種圖表、SVG / PNG 匯出、明暗主題、完整中日韓文字支援。取得 Runs on Atlassian 資格：圖表存在你自己的站台，app 不呼叫任何第三方服務。免費，即將上架 Atlassian Marketplace。
- [Mermaid 線上預覽](https://blog.markkulab.net/tools/mermaid-preview): 在瀏覽器裡寫 Mermaid、即時看圖，整張圖表壓進網址就能分享。免註冊、不上傳伺服器，相容 mermaid.live 的分享連結。
- [React Intl Phone Number](https://blog.markkulab.net/tools/react-intl-phone-number): react-intl-phone-number 是一個開源 React 元件：framework-agnostic、不依賴 antd，提供 E.164 進出、可搜尋國旗 / 國碼下拉、可配置驗證等級（strict / mobile-strict / loose）、可主題化 CSS 與 i18n，電話邏輯由 google-libphonenumber 驅動。輕量、完整 TypeScript 型別。免費開源（MIT）。
- [Uptime Kuma Cluster](https://blog.markkulab.net/tools/uptime-kuma-cluster): 把單機版 Uptime Kuma 改造成高可用叢集：OpenResty + Lua 智慧負載平衡、MariaDB 共享狀態、健康檢查與自動 Failover，附叢集管理 REST API，一行 Docker Compose 啟動。免費開源（MIT）。
- [特教專案](https://blog.markkulab.net/education): 為特殊教育學生製作的學習教材

### 每日 Podcast

- [科技新鮮事](https://blog.markkulab.net/category/tech-news): 每日精選 AI 與科技趨勢，透過語音摘要快速掌握最新技術動態，涵蓋 AI 應用、軟體架構、DevOps 與工程實戰。 — RSS: https://blog.markkulab.net/feed.xml
- [AI股市蝦聊](https://blog.markkulab.net/category/ai-stock-chat): 每個交易日用 AI 分析台股盤勢，以雙人對話聊當天的盤中觀察與隔日預測。 — RSS: https://blog.markkulab.net/ai-stock-chat/feed.xml

### 電子報

[訂閱電子報](https://blog.markkulab.net/subscribe) — 第一時間收到新文章通知，無垃圾信、隨時可取消訂閱。