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內建的 Caddy 會為你的網域取得並更新 Let’s Encrypt 憑證，並代理 HTTPS 以及協作用的 WebSocket。接著開啟 https://folio.example.com。還沒有網域？執行 docker compose up folio-web，然後開啟 http://localhost:8787。
你需要準備什麼
- 一台 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 [email protected] \
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
[email protected]
FOLIO_LIMIT_PROJECTS=0 # 0 = unlimited
FOLIO_LIMIT_STORAGE_MB=0 # 0 = unlimited
FOLIO_ENC_KEY=… # openssl rand -hex 32| 變數 | 作用 |
|---|---|
FOLIO_DOMAIN | Caddy 提供服務並為其取得憑證的網域（預設為 localhost）。 |
PUBLIC_BASE_URL | 登入郵件與分享連結中使用的絕對來源網址。 |
FOLIO_ADMIN_EMAILS | 以逗號分隔、永遠具有管理員身分的電子郵件地址——不受配額限制，可使用 /admin。 |
SMTP_HOST / PORT / USER / PASS / SECURE / FROM | 用於魔法連結登入的外寄郵件設定。未設定 → 連結會印在容器日誌中。 |
FOLIO_LIMIT_PROJECTS | 每個帳戶的專案數（預設 2）。0 = 無限制——大多數自行架設者都會這樣設定。 |
FOLIO_LIMIT_STORAGE_MB | 每個帳戶的儲存空間，以 MB 計（預設 50）。0 = 無限制。 |
FOLIO_DEMOS | 以逗號分隔的專案 ID，作為會自動重置的示範沙盒提供。 |
FOLIO_ALLOW_GUEST_PROJECTS | 設為 1 可讓訪客不登入就建立專案（預設情況下建立專案需要帳戶；示範專案則永遠開放）。 |
FOLIO_ENC_KEY | 64 個十六進位字元的金鑰，用於加密儲存中的驗證器密鑰。 |
更新、備份與還原
更新：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。
授權
個人使用免費。此映像檔為專有軟體，但為你自己、你的家人以及你個人的合作者自行架設完全免費。
團隊與組織需要商業授權。為公司、學校或其他組織執行，或在其內部執行——或用於商業用途——都需要授權；免費方案正是靠這個維持營運。與我們聯絡，我們會很快為你處理好。
不得再散布、更換品牌或製作衍生作品；完整條款隨映像檔文件一同提供。根本不想自己執行伺服器？cloud.foliowriter.app 就是代管版本——可免費開始使用。