AFFiNE 是一款開源的本地優先知識管理工具，融合文檔、白板、數據庫等多維功能，支持自由拖拽混搭內容模塊。它將 Notion 的塊編輯與 Miro 的無限畫布結合，允許在同一頁面無縫切換文檔、思維導圖和表格視圖。同時支持雲端實時協作與跨設備同步，並支持私有化部署。
準備服務器
這裡我使用騰訊雲來演示，搜索進入騰訊雲官網，購買雲服務器（新用戶支持免費試用一個月），我使用的操作系統是Ubuntu24.04。購買完成之後進入控制檯
進入雲服務器
登錄服務器
默認root無密碼，直接點擊登錄
安裝1Panel
粘貼這行命令（終端中粘貼快捷鍵為Ctrl+Shift+V）回車執行
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh
輸入2回車選擇中文
填寫安裝目錄，我這裡使用默認，直接回車
配置鏡像加速，輸入y回車
設置服務端口，這裡我選擇默認，直接回車
安全入口默認
設置1Panel用戶名，不填的話就使用默認，我設置為了admin
設置密碼
到這裡就安裝完成了，複製這裡的外部地址，記住端口號
放行端口
來源選擇全部IPV4地址，端口填入剛剛的端口，填完確定
部署服務
瀏覽器地址欄粘貼剛剛複製的外部地址，登錄1Panel
安裝PostgreSQL和Redis
選什麼都可以
安裝AFFiNE
填入管理員郵箱和管理員密碼
這裡最好勾選上允許外部訪問，如果服務器開啟了防火牆不勾選就無法訪問服務
等待安裝，過程可能比較長。
訪問使用AFFiNE
回到騰訊雲服務器的防火牆，放行3010端口
隨後在瀏覽器地址欄輸入 <你的IP>:3010 即可訪問，填寫管理員賬戶(之前在1Panel中填寫的好像無效了，不過沒影響)
你可以重新打開<你的IP>:3010 進入網頁版的AFFiNE，可以直接在瀏覽器中使用。
在客戶端添加服務器
填入服務器地址
填入郵箱密碼登錄。
啟動雲同步，這樣本地文檔就會同步在服務器了。
自定義雲服務名
默認的名字是My Selfhosted AFFiNE Cloud，可以通過修改配置來修改名字
回到1Panel，打開配置文件路徑
依次打開 data>config>affine.js
可以在這裡修改名字，修改完之後保存並重啟affine應用就好了
配置郵件服務(多人協作)
多人協作需要邀請用戶加入工作區，被邀請的用戶需要在你的服務器上註冊（就是上面那個affine的網頁），如果不配置郵件服務，被邀請的用戶就無法收到同意鏈接。1Panel無法直接配置，需要手動修改容器的環境變量。這裡的郵件服務以QQ郵箱為例
打開QQ郵箱的 賬號與安全>安全設置 ，開啟此服務，複製並保存好授權碼
回到1Panel，打開容器，找到帶有 affine 字樣的容器，點擊編輯
到最下方找到環境變量，粘貼一下內容，將郵箱替換為你的郵箱，密碼為剛剛的授權碼。
注意不要有空行，否則可能會出錯
MAILER_HOST=smtp.qq.com
MAILER_PORT=465
MAILER_USER=<你的QQ郵箱>
MAILER_PASSWORD=<授權碼>
MAILER_SENDER=<你的QQ郵箱>
MAILER_SECURE=true
點擊確定之後容器會重建，重建完成之後需要重新登錄。
隨後在 設置>成員 中可以邀請成員加入。