背景介紹
在追求高效資料與知識共享的過程中，許多企業和團隊面臨工具選擇的挑戰。我們嘗試了多種知識庫工具，但從工程師的反饋來看，這些工具仍存在不少限制。經過多方評估與尋找，最終發現 Outline 是一款非常適合團隊協作的知識庫解決方案，能有效提升工作效率與資訊管理。
什麼是 Outline？
Outline 是一款簡潔且功能強大的知識庫管理工具，介面與使用體驗類似 Notion。它支援 Markdown 編輯、全文檢索、以及多種第三方登入方式，非常適合企業或團隊搭建共享知識庫。Outline 是開源軟體，功能完整，專為團隊打造，能大幅提升知識管理與協作效率。
架設指南（使用 Docker Compose 範例）
以下為使用 Docker Compose 快速架設 Outline 的範例設定：
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:
啟動服務指令：
docker-compose up -d
P.S. 如果無法上傳 Create Bucket > "uplaods"
http://localhost:9001/
🚪 登入方式說明
Outline 不支援帳密登入，僅支援多種第三方帳號登入，以下為主要選項及注意事項：
-
Google 登入 需使用 Google Workspace（企業帳號），不支援個人 Gmail 帳號。
-
GitHub 登入 支援個人Github 帳號：GitHub 應用授權設定
-
Microsoft 登入 支援 Azure AD（企業帳號）及個人 Microsoft 帳號。
參考資料
修正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 主要包含兩部分資料：
- PostgreSQL 資料庫：儲存頁面內容、使用者資訊及版本歷史
- MinIO 儲存空間：存放所有使用者上傳的圖片及檔案，相當於本地端的 Amazon S3
訪問
http://localhost:27777/
小bug
登出後，需要關閉瀏覽器頁籤才有辦法重新登入。
✅ 備份
Step 1：備份 PostgreSQL 資料庫
docker exec -t $(docker ps -qf name=postgres) pg_dump -U postgres outline > outline_backup.sql
注意：
- 匯出檔案為 SQL 格式，會存放於執行目錄。
- 若容器名稱非
postgres，請使用docker ps查詢並替換。
Step 2：備份 MinIO 資料
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 資料庫
cat outline_backup.sql | docker exec -i $(docker ps -qf name=postgres) psql -U postgres -d outline
還原 MinIO 資料
docker run --rm -v minio_data:/volume -v $(pwd):/backup alpine sh -c "cd /volume && tar xzf /backup/minio_backup.tar.gz"
留言