
AppFlowy Cloud 快速部署指南三步完成自托管协作数据全在自己手里【免费下载链接】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.项目地址: https://gitcode.com/GitHub_Trending/ap/AppFlowy-CloudAppFlowy Cloud 是开源协作工作区 AppFlowy 的后端服务负责账号认证、实时协作与文件存储。本文带你从零完成自托管部署改一个配置文件、跑一条 docker compose 命令就能得到一个可以登录使用的协作平台数据全部存在你自己的服务器上。⚙️ 最小环境要求动手前先确认服务器达到下表门槛。项目最低推荐操作系统任意已装 Docker 的 LinuxUbuntu 22.04 / Debian 12CPU2 核4 核内存4 GB8 GB磁盘10 GB 可用20 GB SSD网络能拉取 Docker Hub 镜像有域名或固定公网 IP核心部署流程三步完成拿文件、生成配置、启动服务。1. 拉取部署文件克隆仓库到目标服务器获得 compose 编排与配置模板git clone https://gitcode.com/GitHub_Trending/ap/AppFlowy-Cloud判断方式进入目录后能看到docker-compose.yml和deploy.env即成功。2. 生成配置文件deploy.env是生产配置模板docker compose 实际读取的是根目录的.env先复制再修改cd AppFlowy-Cloud cp deploy.env .env打开.env至少改掉这几项FQDN你的域名本机测试保持localhost即可、POSTGRES_PASSWORD、GOTRUE_JWT_SECRET、GOTRUE_ADMIN_EMAIL和GOTRUE_ADMIN_PASSWORD管理后台登录账号。其中APPFLOWY_BASE_URL是必填项缺失时 MinIO 容器会直接报错拒绝启动。判断方式执行grep APPFLOWY_BASE_URL .env能输出你的地址即成功。3. 启动全部服务后台启动 9 个容器首次会自动拉取镜像并执行数据库迁移耗时几分钟docker compose up -d判断方式docker compose ps里所有容器显示 Up 或 healthy 即成功。如何确认跑通了通过 nginx 请求核心服务的健康检查接口curl http://localhost/api/health预期输出为OK认证服务可用curl http://localhost/gotrue/health同样验证。成功后立即要做的第一件事浏览器打开http://localhost/console用.env里的GOTRUE_ADMIN_EMAIL/GOTRUE_ADMIN_PASSWORD登录管理后台然后去/创建第一个正式用户并注册登录走通一遍完整流程。进阶定制以下三项均为可选用不到可以直接跳过。启用 AI 功能可选在.env填入AI_OPENAI_API_KEY再执行docker compose up -d让 ai 容器读到新值。文档索引、语义搜索和 AI 摘要随即可用留空则核心功能不受影响。接入第三方 OAuth 登录可选以 Google 为例在.env中将GOTRUE_EXTERNAL_GOOGLE_ENABLED设为true填入GOTRUE_EXTERNAL_GOOGLE_CLIENT_ID和GOTRUE_EXTERNAL_GOOGLE_SECRET回调地址已默认指向${API_EXTERNAL_URL}/callback无需另配。GitHub、Discord 的写法相同细节见 doc/AUTHENTICATION.md。配置企业 SAML 单点登录可选用 Okta 等 IdP 时将GOTRUE_SAML_ENABLED设为true并填入GOTRUE_SAML_PRIVATE_KEY然后在/console的 SSO 页面创建对应集成操作顺序与字段含义见 doc/OKTA_SAML.md。常见问题速查启动或登录异常时先对照下表定位。现象可能原因一句话解法minio 容器反复退出.env缺少必填变量重新从deploy.env复制生成.env补全变量后再启动/console打不开或登录被拒JWT 密钥或管理员凭据仍是默认值修改GOTRUE_JWT_SECRET与管理员账号后docker compose up -d注册后收不到验证邮件未配置 SMTP 且自动确认为false把GOTRUE_MAILER_AUTOCONFIRM设为true或补全GOTRUE_SMTP_*参数80 端口被占用nginx 与已有服务冲突在.env中把NGINX_PORT改成其他端口日志里报连接数据库失败密码含特殊字符未做 URL 编码按deploy.env注释把等字符改成%40形式下一步可以把nginx/ssl里的占位证书换成真实域名的证书并启用 TLS更完整的生产部署细节见 doc/DEPLOYMENT.md。【免费下载链接】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.项目地址: https://gitcode.com/GitHub_Trending/ap/AppFlowy-Cloud创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考