Folio Writer ☰

自行架設 Folio Writer Cloud

只要一個 docker compose 檔案，就能在你自己的機器上執行與 cloud.foliowriter.app 背後相同的伺服器：即時共同編輯、端到端加密專案、排版預覽，以及 PDF / Word / LaTeX 匯出——Pandoc 與 Typst 都已內建在映像檔中。個人使用免費。

mkdir folio && cd folio
curl -fsSLO https://foliowriter.app/selfhost/docker-compose.yml
FOLIO_DOMAIN=folio.example.com docker compose up -d

你需要準備什麼

• 一台 Linux 伺服器——起步時 1 CPU / 2 GB RAM 就綽綽有餘——並安裝 Docker Engine + Compose。映像檔 foliowriter/folio-web 提供 amd64 與 arm64 版本。
• 一個指向該伺服器的網域或子網域，並開放 80/443 連接埠（若只在區域網路或 localhost 上試用，可略過）。

你的第一個（管理員）帳戶

啟動伺服器時，把你的電子郵件地址填入 FOLIO_ADMIN_EMAILS：

FOLIO_DOMAIN=folio.example.com FOLIO_ADMIN_EMAILS=you@example.com \
  docker compose up -d

列在這裡的每個地址永遠都是管理員——沒有配額限制，還能使用 /admin 管理面板（帳戶、專案、儲存空間、流量）。用該電子郵件登入；若未設定 SMTP，魔法登入連結會印在伺服器日誌中，而不是以電子郵件寄出：

docker compose logs folio-web | grep -i http

開啟印出的連結，你就登入了。若要實際寄送電子郵件，請設定 SMTP_* 變數——任何轉寄伺服器都可以——並設定 PUBLIC_BASE_URL，讓郵件中的連結使用你的網域。

設定

一切都透過環境變數設定。把它們放在 docker-compose.yml 旁的 .env 檔案中（Compose 會自動讀取）：

FOLIO_DOMAIN=folio.example.com
PUBLIC_BASE_URL=https://folio.example.com
FOLIO_ADMIN_EMAILS=you@example.com
FOLIO_LIMIT_PROJECTS=0        # 0 = unlimited
FOLIO_LIMIT_STORAGE_MB=0      # 0 = unlimited
FOLIO_ENC_KEY=…               # openssl rand -hex 32

更新、備份與還原

更新：docker compose pull && docker compose up -d。如果你偏好固定版本而不是追蹤 latest，也有帶標記的版本（foliowriter/folio-web:0.2.0）可用。

一切——專案、帳戶、工作階段——都存放在 compose 檔案旁的 ./data 中。備份就是備份這一個資料夾：

docker compose stop folio-web
tar czf folio-backup-$(date +%F).tgz data
docker compose start folio-web

要還原——或搬遷伺服器——只需把 data/ 放回去，再執行 docker compose up -d。