作數(shù)據(jù)全在自己手里)
AppFlowy Cloud 快速部署指南三步完成自托管協(xié)作數(shù)據(jù)全在自己手里【免費(fèi)下載鏈接】AppFlowy-CloudBring projects, wikis, and teams together with AI. AppFlowy is the AI collaborative workspace where you achieve more without losing control of your data. The leading open source Notion alternative.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ap/AppFlowy-CloudAppFlowy Cloud 是開源協(xié)作工作區(qū) AppFlowy 的后端服務(wù)負(fù)責(zé)賬號(hào)認(rèn)證、實(shí)時(shí)協(xié)作與文件存儲(chǔ)。本文帶你從零完成自托管部署改一個(gè)配置文件、跑一條 docker compose 命令就能得到一個(gè)可以登錄使用的協(xié)作平臺(tái)數(shù)據(jù)全部存在你自己的服務(wù)器上。?? 最小環(huán)境要求動(dòng)手前先確認(rèn)服務(wù)器達(dá)到下表門檻。項(xiàng)目最低推薦操作系統(tǒng)任意已裝 Docker 的 LinuxUbuntu 22.04 / Debian 12CPU2 核4 核內(nèi)存4 GB8 GB磁盤10 GB 可用20 GB SSD網(wǎng)絡(luò)能拉取 Docker Hub 鏡像有域名或固定公網(wǎng) IP核心部署流程三步完成拿文件、生成配置、啟動(dòng)服務(wù)。1. 拉取部署文件克隆倉(cāng)庫到目標(biāo)服務(wù)器獲得 compose 編排與配置模板git clone https://gitcode.com/GitHub_Trending/ap/AppFlowy-Cloud判斷方式進(jìn)入目錄后能看到docker-compose.yml和deploy.env即成功。2. 生成配置文件deploy.env是生產(chǎn)配置模板docker compose 實(shí)際讀取的是根目錄的.env先復(fù)制再修改cd AppFlowy-Cloud cp deploy.env .env打開.env至少改掉這幾項(xiàng)FQDN你的域名本機(jī)測(cè)試保持localhost即可、POSTGRES_PASSWORD、GOTRUE_JWT_SECRET、GOTRUE_ADMIN_EMAIL和GOTRUE_ADMIN_PASSWORD管理后臺(tái)登錄賬號(hào)。其中APPFLOWY_BASE_URL是必填項(xiàng)缺失時(shí) MinIO 容器會(huì)直接報(bào)錯(cuò)拒絕啟動(dòng)。判斷方式執(zhí)行g(shù)rep APPFLOWY_BASE_URL .env能輸出你的地址即成功。3. 啟動(dòng)全部服務(wù)后臺(tái)啟動(dòng) 9 個(gè)容器首次會(huì)自動(dòng)拉取鏡像并執(zhí)行數(shù)據(jù)庫遷移耗時(shí)幾分鐘docker compose up -d判斷方式docker compose ps里所有容器顯示 Up 或 healthy 即成功。如何確認(rèn)跑通了通過 nginx 請(qǐng)求核心服務(wù)的健康檢查接口curl http://localhost/api/health預(yù)期輸出為OK認(rèn)證服務(wù)可用curl http://localhost/gotrue/health同樣驗(yàn)證。成功后立即要做的第一件事瀏覽器打開http://localhost/console用.env里的GOTRUE_ADMIN_EMAIL/GOTRUE_ADMIN_PASSWORD登錄管理后臺(tái)然后去/創(chuàng)建第一個(gè)正式用戶并注冊(cè)登錄走通一遍完整流程。進(jìn)階定制以下三項(xiàng)均為可選用不到可以直接跳過。啟用 AI 功能可選在.env填入AI_OPENAI_API_KEY再執(zhí)行docker compose up -d讓 ai 容器讀到新值。文檔索引、語義搜索和 AI 摘要隨即可用留空則核心功能不受影響。接入第三方 OAuth 登錄可選以 Google 為例在.env中將GOTRUE_EXTERNAL_GOOGLE_ENABLED設(shè)為true填入GOTRUE_EXTERNAL_GOOGLE_CLIENT_ID和GOTRUE_EXTERNAL_GOOGLE_SECRET回調(diào)地址已默認(rèn)指向${API_EXTERNAL_URL}/callback無需另配。GitHub、Discord 的寫法相同細(xì)節(jié)見 doc/AUTHENTICATION.md。配置企業(yè) SAML 單點(diǎn)登錄可選用 Okta 等 IdP 時(shí)將GOTRUE_SAML_ENABLED設(shè)為true并填入GOTRUE_SAML_PRIVATE_KEY然后在/console的 SSO 頁面創(chuàng)建對(duì)應(yīng)集成操作順序與字段含義見 doc/OKTA_SAML.md。常見問題速查啟動(dòng)或登錄異常時(shí)先對(duì)照下表定位?，F(xiàn)象可能原因一句話解法minio 容器反復(fù)退出.env缺少必填變量重新從deploy.env復(fù)制生成.env補(bǔ)全變量后再啟動(dòng)/console打不開或登錄被拒JWT 密鑰或管理員憑據(jù)仍是默認(rèn)值修改GOTRUE_JWT_SECRET與管理員賬號(hào)后docker compose up -d注冊(cè)后收不到驗(yàn)證郵件未配置 SMTP 且自動(dòng)確認(rèn)為false把GOTRUE_MAILER_AUTOCONFIRM設(shè)為true或補(bǔ)全GOTRUE_SMTP_*參數(shù)80 端口被占用nginx 與已有服務(wù)沖突在.env中把NGINX_PORT改成其他端口日志里報(bào)連接數(shù)據(jù)庫失敗密碼含特殊字符未做 URL 編碼按deploy.env注釋把等字符改成%40形式下一步可以把nginx/ssl里的占位證書換成真實(shí)域名的證書并啟用 TLS更完整的生產(chǎn)部署細(xì)節(jié)見 doc/DEPLOYMENT.md?！久赓M(fèi)下載鏈接】AppFlowy-CloudBring projects, wikis, and teams together with AI. AppFlowy is the AI collaborative workspace where you achieve more without losing control of your data. The leading open source Notion alternative.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ap/AppFlowy-Cloud創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 AppFlowy Cloud 快速部署指南：三步完成自托管，協(xié)作數(shù)據(jù)全在自己手里
AppFlowy Cloud 快速部署指南三步完成自托管協(xié)作數(shù)據(jù)全在自己手里【免費(fèi)下載鏈接】AppFlowy-CloudBring projects, wikis, and teams together with AI. AppFlowy is the AI collaborative workspace where you achieve more without losing control of your data. The leading open source Notion alternative.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ap/AppFlowy-CloudAppFlowy Cloud 是開源協(xié)作工作區(qū) AppFlowy 的后端服務(wù)負(fù)責(zé)賬號(hào)認(rèn)證、實(shí)時(shí)協(xié)作與文件存儲(chǔ)。本文帶你從零完成自托管部署改一個(gè)配置文件、跑一條 docker compose 命令就能得到一個(gè)可以登錄使用的協(xié)作平臺(tái)數(shù)據(jù)全部存在你自己的服務(wù)器上。?? 最小環(huán)境要求動(dòng)手前先確認(rèn)服務(wù)器達(dá)到下表門檻。項(xiàng)目最低推薦操作系統(tǒng)任意已裝 Docker 的 LinuxUbuntu 22.04 / Debian 12CPU2 核4 核內(nèi)存4 GB8 GB磁盤10 GB 可用20 GB SSD網(wǎng)絡(luò)能拉取 Docker Hub 鏡像有域名或固定公網(wǎng) IP核心部署流程三步完成拿文件、生成配置、啟動(dòng)服務(wù)。1. 拉取部署文件克隆倉(cāng)庫到目標(biāo)服務(wù)器獲得 compose 編排與配置模板git clone https://gitcode.com/GitHub_Trending/ap/AppFlowy-Cloud判斷方式進(jìn)入目錄后能看到docker-compose.yml和deploy.env即成功。2. 生成配置文件deploy.env是生產(chǎn)配置模板docker compose 實(shí)際讀取的是根目錄的.env先復(fù)制再修改cd AppFlowy-Cloud cp deploy.env .env打開.env至少改掉這幾項(xiàng)FQDN你的域名本機(jī)測(cè)試保持localhost即可、POSTGRES_PASSWORD、GOTRUE_JWT_SECRET、GOTRUE_ADMIN_EMAIL和GOTRUE_ADMIN_PASSWORD管理后臺(tái)登錄賬號(hào)。其中APPFLOWY_BASE_URL是必填項(xiàng)缺失時(shí) MinIO 容器會(huì)直接報(bào)錯(cuò)拒絕啟動(dòng)。判斷方式執(zhí)行g(shù)rep APPFLOWY_BASE_URL .env能輸出你的地址即成功。3. 啟動(dòng)全部服務(wù)后臺(tái)啟動(dòng) 9 個(gè)容器首次會(huì)自動(dòng)拉取鏡像并執(zhí)行數(shù)據(jù)庫遷移耗時(shí)幾分鐘docker compose up -d判斷方式docker compose ps里所有容器顯示 Up 或 healthy 即成功。如何確認(rèn)跑通了通過 nginx 請(qǐng)求核心服務(wù)的健康檢查接口curl http://localhost/api/health預(yù)期輸出為OK認(rèn)證服務(wù)可用curl http://localhost/gotrue/health同樣驗(yàn)證。成功后立即要做的第一件事瀏覽器打開http://localhost/console用.env里的GOTRUE_ADMIN_EMAIL/GOTRUE_ADMIN_PASSWORD登錄管理后臺(tái)然后去/創(chuàng)建第一個(gè)正式用戶并注冊(cè)登錄走通一遍完整流程。進(jìn)階定制以下三項(xiàng)均為可選用不到可以直接跳過。啟用 AI 功能可選在.env填入AI_OPENAI_API_KEY再執(zhí)行docker compose up -d讓 ai 容器讀到新值。文檔索引、語義搜索和 AI 摘要隨即可用留空則核心功能不受影響。接入第三方 OAuth 登錄可選以 Google 為例在.env中將GOTRUE_EXTERNAL_GOOGLE_ENABLED設(shè)為true填入GOTRUE_EXTERNAL_GOOGLE_CLIENT_ID和GOTRUE_EXTERNAL_GOOGLE_SECRET回調(diào)地址已默認(rèn)指向${API_EXTERNAL_URL}/callback無需另配。GitHub、Discord 的寫法相同細(xì)節(jié)見 doc/AUTHENTICATION.md。配置企業(yè) SAML 單點(diǎn)登錄可選用 Okta 等 IdP 時(shí)將GOTRUE_SAML_ENABLED設(shè)為true并填入GOTRUE_SAML_PRIVATE_KEY然后在/console的 SSO 頁面創(chuàng)建對(duì)應(yīng)集成操作順序與字段含義見 doc/OKTA_SAML.md。常見問題速查啟動(dòng)或登錄異常時(shí)先對(duì)照下表定位?，F(xiàn)象可能原因一句話解法minio 容器反復(fù)退出.env缺少必填變量重新從deploy.env復(fù)制生成.env補(bǔ)全變量后再啟動(dòng)/console打不開或登錄被拒JWT 密鑰或管理員憑據(jù)仍是默認(rèn)值修改GOTRUE_JWT_SECRET與管理員賬號(hào)后docker compose up -d注冊(cè)后收不到驗(yàn)證郵件未配置 SMTP 且自動(dòng)確認(rèn)為false把GOTRUE_MAILER_AUTOCONFIRM設(shè)為true或補(bǔ)全GOTRUE_SMTP_*參數(shù)80 端口被占用nginx 與已有服務(wù)沖突在.env中把NGINX_PORT改成其他端口日志里報(bào)連接數(shù)據(jù)庫失敗密碼含特殊字符未做 URL 編碼按deploy.env注釋把等字符改成%40形式下一步可以把nginx/ssl里的占位證書換成真實(shí)域名的證書并啟用 TLS更完整的生產(chǎn)部署細(xì)節(jié)見 doc/DEPLOYMENT.md?！久赓M(fèi)下載鏈接】AppFlowy-CloudBring projects, wikis, and teams together with AI. AppFlowy is the AI collaborative workspace where you achieve more without losing control of your data. The leading open source Notion alternative.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ap/AppFlowy-Cloud創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考