一鍵部署 Outline Wiki v1.4 搭配 Keycloak 身份驗證，支援自訂用戶管理。
- Outline Wiki v1.4 - 現代化團隊知識庫
- Keycloak - 自建身份驗證，支援任意 Email 登入
- 自動 SSL - Let's Encrypt 憑證
- 一鍵部署 - 互動式安裝腳本
Internet → Nginx (80/443)
├── wiki.example.com → Outline (3000)
└── auth.example.com → Keycloak (8080)
↓
PostgreSQL + Redis
- Docker 和 Docker Compose
- 兩個網域（例如
wiki.example.com和auth.example.com） - 防火牆開放 port 80 和 443
git clone https://github.com/你的帳號/outline-docker.git
cd outline-docker./scripts/setup.sh腳本會請你輸入：
- Wiki 網域（例如
wiki.example.com） - Keycloak 網域（例如
auth.example.com） - Email（用於 SSL 憑證）
- 用戶資訊（Email 和名稱）
將你的兩個網域指向伺服器 IP：
wiki.example.com→ 你的 IPauth.example.com→ 你的 IP
# 啟動基礎服務
docker compose up -d postgres redis nginx
# 建立 Keycloak 資料庫
docker compose exec postgres createdb -U outline keycloak
# 取得 SSL 憑證（將網域和 Email 換成你的）
docker run --rm \
-v $(pwd)/nginx/certs:/etc/letsencrypt \
-v $(pwd)/nginx/www:/var/www/certbot \
certbot/certbot certonly --webroot \
-w /var/www/certbot \
-d wiki.example.com -d auth.example.com \
--email your@email.com --agree-tos --non-interactive# 切換到 SSL 設定
cp nginx/conf.d/outline.conf.ssl nginx/conf.d/outline.conf
# 啟動所有服務
docker compose up -d訪問 https://wiki.example.com，使用 Keycloak 登入。
# 服務管理
docker compose up -d # 啟動
docker compose down # 停止
docker compose restart # 重啟
docker compose ps # 狀態
# 查看日誌
docker compose logs -f outline
docker compose logs -f keycloak
docker compose logs -f nginx
# 資料庫操作
docker compose exec postgres psql -U outline # 進入 PostgreSQL# PostgreSQL（包含 Outline 和 Keycloak 資料）
docker compose exec postgres pg_dump -U outline outline > outline-backup.sql
docker compose exec postgres pg_dump -U outline keycloak > keycloak-backup.sql
# 上傳的檔案
tar -czvf data-backup.tar.gz data/
# 環境變數
cp .env .env.backupcat outline-backup.sql | docker compose exec -T postgres psql -U outline outline
cat keycloak-backup.sql | docker compose exec -T postgres psql -U outline keycloak
tar -xzvf data-backup.tar.gz訪問 https://auth.example.com/admin
使用 setup.sh 產生的 admin 密碼登入（在終端輸出中）。
- 登入 Keycloak 管理後台
- 選擇 Realm：
outline - 左側選單 → Users → Add user
- 填入 Email、名稱
- Credentials 標籤設定密碼
- Users → 選擇用戶
- Credentials 標籤
- Reset password
Let's Encrypt 憑證 90 天到期：
# 手動更新
docker run --rm \
-v $(pwd)/nginx/certs:/etc/letsencrypt \
-v $(pwd)/nginx/www:/var/www/certbot \
certbot/certbot renew
# 重載 Nginx
docker compose exec nginx nginx -s reload建議設定 crontab 自動更新：
0 0 1 * * cd /path/to/outline-docker && docker run --rm -v $(pwd)/nginx/certs:/etc/letsencrypt -v $(pwd)/nginx/www:/var/www/certbot certbot/certbot renew && docker compose exec nginx nginx -s reloadoutline-docker/
├── docker-compose.yml # 服務定義
├── .env # 環境變數（敏感）
├── .env.example # 環境變數範例
├── scripts/
│ ├── setup.sh # 安裝腳本
│ └── init-keycloak-db.sql # Keycloak 資料庫初始化
├── data/ # Outline 檔案儲存
├── keycloak/
│ └── outline-realm.json # Keycloak Realm 設定
└── nginx/
├── templates/ # Nginx 設定模板
│ ├── outline.conf.template
│ └── outline-temp.conf.template
├── conf.d/ # 執行時設定（由 setup.sh 生成）
│ └── outline.conf
├── certs/ # SSL 憑證
└── www/ # Let's Encrypt 驗證
docker compose ps
docker compose logs [服務名稱]- 確認 DNS 設定正確
- 確認 port 80/443 已開放
- 檢查
docker compose logs nginx
docker compose logs keycloak確認 Realm outline 已建立。
chmod 777 data/MIT License